X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gas%2Fdoc%2Fc-m68k.texi;h=e3a37133bd253f69293ff00edb203bc100cb86c2;hb=39d911fc3c6519799ca1af4365d4b56f9d71ca94;hp=d3c849c39182d7ec7e1be40eff96bb4a66924232;hpb=2da5c03714e1f97bb83d05114e97dcf92eb17b64;p=deliverable%2Fbinutils-gdb.git diff --git a/gas/doc/c-m68k.texi b/gas/doc/c-m68k.texi index d3c849c391..e3a37133bd 100644 --- a/gas/doc/c-m68k.texi +++ b/gas/doc/c-m68k.texi @@ -1,5 +1,4 @@ -@c Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000, 2003, -@c 2004 Free Software Foundation, Inc. +@c Copyright (C) 1991-2016 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC @@ -32,6 +31,51 @@ dependent options: @table @samp +@cindex @samp{-march=} command line option, M680x0 +@item -march=@var{architecture} +This option specifies a target architecture. The following +architectures are recognized: +@code{68000}, +@code{68010}, +@code{68020}, +@code{68030}, +@code{68040}, +@code{68060}, +@code{cpu32}, +@code{isaa}, +@code{isaaplus}, +@code{isab}, +@code{isac} and +@code{cfv4e}. + + +@cindex @samp{-mcpu=} command line option, M680x0 +@item -mcpu=@var{cpu} +This option specifies a target cpu. When used in conjunction with the +@option{-march} option, the cpu must be within the specified +architecture. Also, the generic features of the architecture are used +for instruction generation, rather than those of the specific chip. + +@cindex @samp{-m[no-]68851} command line option, M680x0 +@cindex @samp{-m[no-]68881} command line option, M680x0 +@cindex @samp{-m[no-]div} command line option, M680x0 +@cindex @samp{-m[no-]usp} command line option, M680x0 +@cindex @samp{-m[no-]float} command line option, M680x0 +@cindex @samp{-m[no-]mac} command line option, M680x0 +@cindex @samp{-m[no-]emac} command line option, M680x0 +@item -m[no-]68851 +@itemx -m[no-]68881 +@itemx -m[no-]div +@itemx -m[no-]usp +@itemx -m[no-]float +@itemx -m[no-]mac +@itemx -m[no-]emac + +Enable or disable various architecture specific features. If a chip +or architecture by default supports an option (for instance +@option{-march=isaaplus} includes the @option{-mdiv} option), +explicitly disabling the option will override the default. + @cindex @samp{-l} option, M680x0 @item -l You can use the @samp{-l} option to shorten the size of references to undefined @@ -68,7 +112,7 @@ at the beginning of a line. @cindex @samp{--base-size-default-16} @cindex @samp{--base-size-default-32} -@item --base-size-default-16 --base-size-default-32 +@item --base-size-default-16 --base-size-default-32 If you use an addressing mode with a base register without specifying the size, @code{@value{AS}} will normally use the full 32 bit value. For example, the addressing mode @samp{%a0@@(%d0)} is equivalent to @@ -165,19 +209,19 @@ Assemble for the 68060. Assemble for the CPU32 family of chips. @item -m5200 -@item -m5202 -@item -m5204 -@item -m5206 -@item -m5206e -@item -m521x -@item -m5249 -@item -m528x -@item -m5307 -@item -m5407 -@item -m547x -@item -m548x -@item -mcfv4 -@item -mcfv4e +@itemx -m5202 +@itemx -m5204 +@itemx -m5206 +@itemx -m5206e +@itemx -m521x +@itemx -m5249 +@itemx -m528x +@itemx -m5307 +@itemx -m5407 +@itemx -m547x +@itemx -m548x +@itemx -mcfv4 +@itemx -mcfv4e Assemble for the ColdFire family of chips. @item -m68881 @@ -240,7 +284,7 @@ The following addressing modes are understood: @item Address Register @samp{%a0} through @samp{%a7}@* -@samp{%a7} is also known as @samp{%sp}, i.e. the Stack Pointer. @code{%a6} +@samp{%a7} is also known as @samp{%sp}, i.e., the Stack Pointer. @code{%a6} is also known as @samp{%fp}, the Frame Pointer. @item Address Register Indirect @@ -301,8 +345,8 @@ The following additional addressing modes are understood: @table @dfn @item Address Register Indirect -@samp{(%a0)} through @samp{(%a7)}@* -@samp{%a7} is also known as @samp{%sp}, i.e. the Stack Pointer. @code{%a6} +@samp{(%a0)} through @samp{(%a7)}@* +@samp{%a7} is also known as @samp{%sp}, i.e., the Stack Pointer. @code{%a6} is also known as @samp{%fp}, the Frame Pointer. @item Address Register Postincrement @@ -398,6 +442,25 @@ aligns the output to an even byte boundary. @cindex @code{skip} directive, M680x0 @item .skip This directive is identical to a @code{.space} directive. + +@cindex @code{arch} directive, M680x0 +@item .arch @var{name} +Select the target architecture and extension features. Valid values +for @var{name} are the same as for the @option{-march} command line +option. This directive cannot be specified after +any instructions have been assembled. If it is given multiple times, +or in conjunction with the @option{-march} option, all uses must be for +the same architecture and extension set. + +@cindex @code{cpu} directive, M680x0 +@item .cpu @var{name} +Select the target cpu. Valid valuse +for @var{name} are the same as for the @option{-mcpu} command line +option. This directive cannot be specified after +any instructions have been assembled. If it is given multiple times, +or in conjunction with the @option{-mopt} option, all uses must be for +the same cpu. + @end table @need 2000 @@ -545,14 +608,29 @@ branch instructions allow both word and long displacements. @subsection Special Characters @cindex special characters, M680x0 -@cindex M680x0 immediate character -@cindex immediate character, M680x0 + @cindex M680x0 line comment character @cindex line comment character, M680x0 @cindex comments, M680x0 -The immediate character is @samp{#} for Sun compatibility. The -line-comment character is @samp{|} (unless the @samp{--bitwise-or} -option is used). If a @samp{#} appears at the beginning of a line, it -is treated as a comment unless it looks like @samp{# line file}, in -which case it is treated normally. +Line comments are introduced by the @samp{|} character appearing +anywhere on a line, unless the @option{--bitwise-or} command line option +has been specified. + +An asterisk (@samp{*}) as the first character on a line marks the +start of a line comment as well. + +@cindex M680x0 immediate character +@cindex immediate character, M680x0 + +A hash character (@samp{#}) as the first character on a line also +marks the start of a line comment, but in this case it could also be a +logical line number directive (@pxref{Comments}) or a preprocessor +control command (@pxref{Preprocessing}). If the hash character +appears elsewhere on a line it is used to introduce an immediate +value. (This is for compatibility with Sun's assembler). + +@cindex M680x0 line separator +@cindex line separator, M680x0 +Multiple statements on the same line can appear if they are separated +by the @samp{;} character.