aboutsummaryrefslogtreecommitdiff
path: root/gas/doc
diff options
context:
space:
mode:
authorRoland Pesch <pesch@cygnus>1992-04-27 20:51:53 +0000
committerRoland Pesch <pesch@cygnus>1992-04-27 20:51:53 +0000
commit8038106352563be3c643c835eb8d7d73ca9b42c0 (patch)
tree38c26e7d255af3132a37df631dfcc4907106f66f /gas/doc
parente6498b10d7b48d63217c6ab0f04c70b5194b609a (diff)
downloadgdb-8038106352563be3c643c835eb8d7d73ca9b42c0.zip
gdb-8038106352563be3c643c835eb8d7d73ca9b42c0.tar.gz
gdb-8038106352563be3c643c835eb8d7d73ca9b42c0.tar.bz2
Former -k option now -K to avoid conflict with Sun assembler.
(-K [nee -k] gives warning when difference tables altered by assembler)
Diffstat (limited to 'gas/doc')
-rw-r--r--gas/doc/as-all.texinfo15
-rw-r--r--gas/doc/as.texinfo73
2 files changed, 49 insertions, 39 deletions
diff --git a/gas/doc/as-all.texinfo b/gas/doc/as-all.texinfo
index cf0d98b..c4105c1 100644
--- a/gas/doc/as-all.texinfo
+++ b/gas/doc/as-all.texinfo
@@ -4,8 +4,9 @@
@setfilename as.info
@settitle Using as
@setchapternewpage odd
-@c @smallbook
-@c @cropmarks
+@input smpklug.texi
+@smallbook
+@cropmarks
@c %**end of header
@ifinfo
@@ -137,7 +138,7 @@ Here is a brief summary of how to invoke @code{as}. For details,
@c to be limited to one line for the header.
@smallexample
as [ -a | -al | -as ] [ -D ] [ -f ]
- [ -I @var{path} ] [ -k ] [ -L ]
+ [ -I @var{path} ] [ -K ] [ -L ]
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
@c am29k has no machine-dependent assembler options
@c h8/300 has no machine-dependent assembler options
@@ -163,7 +164,7 @@ other assemblers; it has no effect on @code{as}.
@item -I @var{path}
Add @var{path} to the search list for @code{.include} directives
-@item -k
+@item -K
Issue warnings when difference tables altered for long displacements.
@item -L
@@ -515,15 +516,15 @@ working directory is always searched first; after that, @code{as}
searches any @samp{-I} directories in the same order as they were
specified (left to right) on the command line.
-@section Difference Tables: @code{-k}
+@section Difference Tables: @code{-K}
-@kindex -k
+@kindex -K
@cindex difference tables, warning
@cindex warning for altered difference tables
@code{as} sometimes alters the code emitted for directives of the form
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}.
-You can use the @samp{-k} option if you want a warning issued when this
+You can use the @samp{-K} option if you want a warning issued when this
is done.
@section Include Local Labels: @code{-L}
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index bb51118..7f3d80f 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -12,10 +12,19 @@ _if__(!_GENERIC__)
@settitle Using _AS__ (_HOST__)
_fi__(!_GENERIC__)
@setchapternewpage odd
-@c @smallbook
-@c @cropmarks
+@input smpklug.texi
+@smallbook
+@cropmarks
@c %**end of header
+@ifinfo
+@format
+START-INFO-DIR-ENTRY
+* As: (as). The GNU assembler.
+END-INFO-DIR-ENTRY
+@end format
+@end ifinfo
+
@finalout
@syncodeindex ky cp
@@ -88,8 +97,9 @@ done.
\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$
\xdef\manvers{\$Revision$} % For use in headers, footers too
{\parskip=0pt
-\hfill \manvers\par
+\hfill {\it Using {\tt _AS__}} \manvers\par
\hfill \TeX{}info \texinfoversion\par
+\hfill Edited by Roland Pesch for Cygnus Support\par
}
%"boxit" macro for figures:
%Modified from Knuth's ``boxit'' macro from TeXbook (answer to exercise 21.3)
@@ -99,8 +109,6 @@ done.
\gdef\ibox#1#2{\hbox to #1{#2\hfil}\kern8pt}% invisible box
@end tex
-Edited by Roland Pesch for Cygnus Support.
-
@vskip 0pt plus 1filll
Copyright @copyright{} 1991 Free Software Foundation, Inc.
@@ -163,7 +171,7 @@ Here is a brief summary of how to invoke @code{_AS__}. For details,
@c to be limited to one line for the header.
@smallexample
_AS__ [ -a | -al | -as ] [ -D ] [ -f ]
- [ -I @var{path} ] [ -k ] [ -L ]
+ [ -I @var{path} ] [ -K ] [ -L ]
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
_if__(_A29K__)
@c am29k has no machine-dependent assembler options
@@ -197,7 +205,7 @@ other assemblers; it has no effect on @code{_AS__}.
@item -I @var{path}
Add @var{path} to the search list for @code{.include} directives
-@item -k
+@item -K
_if__((!_GENERIC__) && !_DIFFTABKLUG__)
This option is accepted but has no effect on the _HOST__ family.
_fi__((!_GENERIC__) && !_DIFFTABKLUG__)
@@ -568,7 +576,7 @@ _if__(_GENERIC__)
to particular machine architectures.
_fi__(_GENERIC__)
-@section @code{-a}, @code{-al}, @code{-as}
+@section Enable Listings: @code{-a}, @code{-al}, @code{-as}
@kindex -a
@kindex -al
@@ -625,9 +633,9 @@ working directory is always searched first; after that, @code{_AS__}
searches any @samp{-I} directories in the same order as they were
specified (left to right) on the command line.
-@section Difference Tables: @code{-k}
+@section Difference Tables: @code{-K}
-@kindex -k
+@kindex -K
_if__((!_GENERIC__) && (!_DIFFTABKLUG__))
On the _HOST__ family, this option is allowed, but has no effect. It is
permitted for compatibility with the GNU assembler on other platforms,
@@ -642,7 +650,7 @@ _if__(_GENERIC__ || _DIFFTABKLUG__ )
@cindex warning for altered difference tables
@code{_AS__} sometimes alters the code emitted for directives of the form
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}.
-You can use the @samp{-k} option if you want a warning issued when this
+You can use the @samp{-K} option if you want a warning issued when this
is done.
_fi__(_GENERIC__ || _DIFFTABKLUG__ )
@@ -863,7 +871,6 @@ of @code{_AS__}.
@node Symbol Intro, Statements, Comments, Syntax
@section Symbols
-@cindex symbols
@cindex characters used in symbols
A @dfn{symbol} is one or more characters chosen from the set of all
letters (both upper and lower case), digits and
@@ -2366,8 +2373,6 @@ _fi__( _BOUT__ && (! _COFF__))
@section @code{.align @var{abs-expr} , @var{abs-expr}}
@cindex padding the location counter
-@cindex advancing location counter
-@cindex location counter, advancing
@cindex @code{align} directive
Pad the location counter (in the current subsection) to a particular
storage boundary. The first expression (which must be absolute) is the
@@ -3122,9 +3127,9 @@ Assemble the following code into end of subsection numbered
@node Set, Short, Section, Pseudo Ops
_fi__(_COFF__)
-_if__(_BOUT__)
+_if__(_BOUT__&&!_COFF__)
@node Set, Short, Scl, Pseudo Ops
-_fi__(_BOUT__)
+_fi__(_BOUT__&&!_COFF__)
_if__(!(_COFF__||_BOUT__))
@node Set, Short, Quad, Pseudo Ops
_fi__(!(_COFF__||_BOUT__))
@@ -3198,17 +3203,17 @@ ignores it.
_fi__(_BOUT__)
_fi__(_COFF__||_BOUT__)
-_if__(_H8__)
+_if__(_H8__&&!_GENERIC__)
@node Space, Tag, Size, Pseudo Ops
-_fi__(_H8__)
-_if__(!_H8__)
+_fi__(_H8__&&!_GENERIC__)
+_if__(_GENERIC__||!_H8__)
_if__(_COFF__||_BOUT__)
@node Space, Stab, Size, Pseudo Ops
_fi__(_COFF__||_BOUT__)
_if__(!(_COFF__||_BOUT__))
@node Space, Stab, Single, Pseudo Ops
_fi__(!(_COFF__||_BOUT__))
-_fi__(!_H8__)
+_fi__(_GENERIC__||!_H8__)
_if__(_GENERIC__ || !_A29K__)
@section @code{.space @var{size} , @var{fill}}
@@ -3220,9 +3225,10 @@ and @var{fill} are omitted, @var{fill} is assumed to be zero.
_fi__(_GENERIC__ || !_A29K__)
_if__(_A29K__)
+_if__(!_GENERIC__)
@section @code{.space}
-
@cindex @code{space} directive
+_fi__(!_GENERIC__)
On the AMD 29K, this directive is ignored; it is accepted for
compatibility with other AMD 29K assemblers.
@@ -3300,12 +3306,12 @@ _fi__(_AOUT__||_BOUT__||_COFF__)
_fi__(_GENERIC__||!_H8__)
_if__(_COFF__||_BOUT__)
-_if__(!_H8__)
+_if__(_GENERIC__||!_H8__)
@node Tag, Text, Stab, Pseudo Ops
-_fi__(!_H8__)
-_if__(_H8__)
+_fi__(_GENERIC__||!_H8__)
+_if__(_H8__&&!_GENERIC__)
@node Tag, Text, Space, Pseudo Ops
-_fi__(_H8__)
+_fi__(_H8__&&!_GENERIC__)
@section @code{.tag @var{structname}}
@cindex COFF structure debugging
@@ -3702,9 +3708,12 @@ Unconditional branch.
@end table
@item j@var{COND}
@var{COND} may be any one of the conditional branches
-@code{neq nequ eql eqlu gtr geq lss gtru lequ vc vs gequ cc lssu cs}.
+@code{neq}, @code{nequ}, @code{eql}, @code{eqlu}, @code{gtr},
+@code{geq}, @code{lss}, @code{gtru}, @code{lequ}, @code{vc}, @code{vs},
+@code{gequ}, @code{cc}, @code{lssu}, @code{cs}.
@var{COND} may also be one of the bit tests
-@code{bs bc bss bcs bsc bcc bssi bcci lbs lbc}.
+@code{bs}, @code{bc}, @code{bss}, @code{bcs}, @code{bsc}, @code{bcc},
+@code{bssi}, @code{bcci}, @code{lbs}, @code{lbc}.
@var{NOTCOND} is the opposite condition to @var{COND}.
@table @asis
@item (byte displacement)
@@ -4463,8 +4472,8 @@ for the linker to resolve.
@node Compare-and-branch-i960, , callj-i960, Opcodes for i960
_CHAPSEC__(2+_GENERIC__) Compare-and-Branch
-@cindex i960 compare and branch instructions
-@cindex compare and branch instructions, i960
+@cindex i960 compare/branch instructions
+@cindex compare/branch instructions, i960
The 960 architectures provide combined Compare-and-Branch instructions
that permit you to store the branch target in the lower 13 bits of the
instruction word itself. However, if you specify a branch target far
@@ -4579,7 +4588,7 @@ bits). This may be useful if you want the object file to be as small as
possible, and you know that the relevant symbols will be less than 17
bits away.
-@cindex @code{-m68000} and related options, M680x0
+@cindex @code{-m68000} and related options
@cindex architecture options, M680x0
@cindex M680x0 architecture options
The 680x0 version of @code{_AS__} is most frequently used to assemble
@@ -4759,10 +4768,10 @@ cases that are more fully described after the table:
@smallexample
Displacement
- +---------------------------------------------------------
+ +-------------------------------------------------
| 68020 68000/10
Pseudo-Op |BYTE WORD LONG LONG non-PC relative
- +---------------------------------------------------------
+ +-------------------------------------------------
jbsr |bsrs bsr bsrl jsr jsr
jra |bras bra bral jmp jmp
* jXX |bXXs bXX bXXl bNXs;jmpl bNXs;jmp