From: Ken Raeburn <raeburn@cygnus>
Date: Fri, 14 May 1993 11:00:17 +0000 (+0000)
Subject: Updated list of m68k options, described required-register-prefix hack.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=342143440acde7ba91044dd7532cb1f395dd9f02;p=binutils-gdb.git

Updated list of m68k options, described required-register-prefix hack.
Added a tiny bit of documentation on MIPS target.
Minor tweaks to `-a' description.
---

diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index 2bd08503e3f..09f643e83a4 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -175,7 +175,7 @@ Here is a brief summary of how to invoke @code{@value{AS}}.  For details,
 @c We don't use deffn and friends for the following because they seem
 @c to be limited to one line for the header.
 @smallexample
-  @value{AS} [ -a | -al | -as ] [ -D ] [ -f ]
+  @value{AS} [ -a[dhlns] ] [ -D ] [ -f ]
    [ -I @var{path} ] [ -K ] [ -L ]
    [ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
 @ifset A29K
@@ -196,7 +196,10 @@ Here is a brief summary of how to invoke @code{@value{AS}}.  For details,
    [ -b ] [ -norelax ]
 @end ifset
 @ifset M680X0
-   [ -l ] [ -mc68000 | -mc68010 | -mc68020 ]
+   [ -l ] [ -m68000 | -m68010 | -m68020 | ... ]
+@end ifset
+@ifset MIPS
+   [ -nocpp ] [ -EL ] [ -EB ] [ -G @var{num} ]
 @end ifset
    [ -- | @var{files} @dots{} ]
 @end smallexample
@@ -208,10 +211,10 @@ Turn on listings;
 @samp{-ah}, include high-level source,
 @samp{-al}, assembly listing,
 @samp{-an}, no forms processing,
-@samp{-as}, symbols.  These options may be combined; @emph{e.g.},
-@samp{-aln} for assembly listing without forms processing.
-By itself, @samp{-a} defaults to @samp{-ahls} --- that is, all listings
-turned on.
+@samp{-as}, symbols.
+These options may be combined; @emph{e.g.}, @samp{-aln} for assembly
+listing without forms processing.  By itself, @samp{-a} defaults to
+@samp{-ahls} --- that is, all listings turned on.
 
 @item -D
 This option is accepted only for script compatibility with calls to
@@ -278,7 +281,8 @@ Motorola 68000 series.
 @item -l
 Shorten references to undefined symbols, to one word instead of two.
 
-@item -m68000 | -m68008 | -m68010 | -m68020 | -m68030 | -m68040 | -mcpu32
+@item -m68000 | -m68008 | -m68010 | -m68020 | -m68030 | -m68040
+@itemx | -m68302 | -m68331 | -m68332 | -m68333 | -m68340 | -mcpu32
 Specify what processor in the 68000 family is the target.  The default
 is normally the 68020, but this can be changed at configuration time.
 
@@ -309,6 +313,25 @@ Warn when the assembler switches to another architecture.
 @end table
 @end ifset
 
+@ifset MIPS
+The following options are available when @value{AS} is configured for
+the MIPS R2000/R3000 processors.
+
+@table @code
+
+@item -G @var{num}
+This option sets the largest size of an object that can be referenced
+implicitly with the @code{gp} register.  It is only accepted for targets
+that use ECOFF format, such as a DECstation running Ultrix.
+
+@item -nocpp
+@itemx -EB, -EL
+These options are ignored.  They are accepted for compatibility with the
+native tools.
+
+@end table
+@end ifset
+
 @menu
 * Manual::                      Structure of this Manual
 * GNU Assembler::               @value{AS}, the GNU Assembler
@@ -5375,6 +5398,14 @@ by @samp{:b}, @samp{:w}, or @samp{:l}.
 @end ignore
 @end table
 
+For some configurations, especially those where the compiler normally
+does not prepend an underscore to the names of user variables, the
+assembler requires a @samp{%} before any use of a register name.  This
+is intended to let the assembler distinguish between user variables and
+registers named @samp{a0} through @samp{a7}, et cetera.  The @samp{%} is
+always accepted, but is only required for some configurations, notably
+@samp{m68k-coff}.
+
 @node M68K-Float
 @section Floating Point
 
@@ -6497,12 +6528,31 @@ set addr(rd),imm4       subl rrd,addr(rs)
 @end iftex
 
 @end ifset
+
+@ifset MIPS
+@ifset GENERIC
+@page
+@node MIPS-Dependent
+@chapter MIPS Dependent Features
+@end ifset
+@ifclear GENERIC
+@node Machine Dependencies
+@chapter MIPS Dependent Features
+@end ifclear
+The MIPS @value{AS} supports the MIPS R2000 and R3000 processors.
+
+It ignores the @kbd{-nocpp}, @kbd{-EL}, and @kbd{-EB} options.
+
+@i{FIXME: What other information do we need to note here?}
+
+@end ifset
+
 @ifset GENERIC
 @c reverse effect of @down at top of generic Machine-Dep chapter
 @up
 @end ifset
 
-@ignore
+@ifset INTERNALS
 @c pesch@cygnus.com: we ignore the following chapters, since internals are
 @c                   changing rapidly.  These may need to be moved to another
 @c                   book anyhow, if we adopt the model of user/modifier
@@ -7418,7 +7468,7 @@ usually only needed by the machine-independent part of
 @code{@value{AS}}.
 
 @end table
-@end ignore
+@end ifset
 
 @ifset GENERIC
 @include gpl.texinfo