Former -k option now -K to avoid conflict with Sun assembler.

(-K [nee -k] gives warning when difference tables altered by assembler)
This commit is contained in:
Roland Pesch
1992-04-27 20:51:53 +00:00
parent e6498b10d7
commit 8038106352
2 changed files with 49 additions and 39 deletions

View File

@ -4,8 +4,9 @@
@setfilename as.info @setfilename as.info
@settitle Using as @settitle Using as
@setchapternewpage odd @setchapternewpage odd
@c @smallbook @input smpklug.texi
@c @cropmarks @smallbook
@cropmarks
@c %**end of header @c %**end of header
@ifinfo @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. @c to be limited to one line for the header.
@smallexample @smallexample
as [ -a | -al | -as ] [ -D ] [ -f ] as [ -a | -al | -as ] [ -D ] [ -f ]
[ -I @var{path} ] [ -k ] [ -L ] [ -I @var{path} ] [ -K ] [ -L ]
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ] [ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
@c am29k has no machine-dependent assembler options @c am29k has no machine-dependent assembler options
@c h8/300 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} @item -I @var{path}
Add @var{path} to the search list for @code{.include} directives Add @var{path} to the search list for @code{.include} directives
@item -k @item -K
Issue warnings when difference tables altered for long displacements. Issue warnings when difference tables altered for long displacements.
@item -L @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 searches any @samp{-I} directories in the same order as they were
specified (left to right) on the command line. 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 difference tables, warning
@cindex warning for altered difference tables @cindex warning for altered difference tables
@code{as} sometimes alters the code emitted for directives of the form @code{as} sometimes alters the code emitted for directives of the form
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}. @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. is done.
@section Include Local Labels: @code{-L} @section Include Local Labels: @code{-L}

View File

@ -12,10 +12,19 @@ _if__(!_GENERIC__)
@settitle Using _AS__ (_HOST__) @settitle Using _AS__ (_HOST__)
_fi__(!_GENERIC__) _fi__(!_GENERIC__)
@setchapternewpage odd @setchapternewpage odd
@c @smallbook @input smpklug.texi
@c @cropmarks @smallbook
@cropmarks
@c %**end of header @c %**end of header
@ifinfo
@format
START-INFO-DIR-ENTRY
* As: (as). The GNU assembler.
END-INFO-DIR-ENTRY
@end format
@end ifinfo
@finalout @finalout
@syncodeindex ky cp @syncodeindex ky cp
@ -88,8 +97,9 @@ done.
\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$ \def\$#1${{#1}} % Kluge: collect RCS revision info without $...$
\xdef\manvers{\$Revision$} % For use in headers, footers too \xdef\manvers{\$Revision$} % For use in headers, footers too
{\parskip=0pt {\parskip=0pt
\hfill \manvers\par \hfill {\it Using {\tt _AS__}} \manvers\par
\hfill \TeX{}info \texinfoversion\par \hfill \TeX{}info \texinfoversion\par
\hfill Edited by Roland Pesch for Cygnus Support\par
} }
%"boxit" macro for figures: %"boxit" macro for figures:
%Modified from Knuth's ``boxit'' macro from TeXbook (answer to exercise 21.3) %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 \gdef\ibox#1#2{\hbox to #1{#2\hfil}\kern8pt}% invisible box
@end tex @end tex
Edited by Roland Pesch for Cygnus Support.
@vskip 0pt plus 1filll @vskip 0pt plus 1filll
Copyright @copyright{} 1991 Free Software Foundation, Inc. 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. @c to be limited to one line for the header.
@smallexample @smallexample
_AS__ [ -a | -al | -as ] [ -D ] [ -f ] _AS__ [ -a | -al | -as ] [ -D ] [ -f ]
[ -I @var{path} ] [ -k ] [ -L ] [ -I @var{path} ] [ -K ] [ -L ]
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ] [ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
_if__(_A29K__) _if__(_A29K__)
@c am29k has no machine-dependent assembler options @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} @item -I @var{path}
Add @var{path} to the search list for @code{.include} directives Add @var{path} to the search list for @code{.include} directives
@item -k @item -K
_if__((!_GENERIC__) && !_DIFFTABKLUG__) _if__((!_GENERIC__) && !_DIFFTABKLUG__)
This option is accepted but has no effect on the _HOST__ family. This option is accepted but has no effect on the _HOST__ family.
_fi__((!_GENERIC__) && !_DIFFTABKLUG__) _fi__((!_GENERIC__) && !_DIFFTABKLUG__)
@ -568,7 +576,7 @@ _if__(_GENERIC__)
to particular machine architectures. to particular machine architectures.
_fi__(_GENERIC__) _fi__(_GENERIC__)
@section @code{-a}, @code{-al}, @code{-as} @section Enable Listings: @code{-a}, @code{-al}, @code{-as}
@kindex -a @kindex -a
@kindex -al @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 searches any @samp{-I} directories in the same order as they were
specified (left to right) on the command line. 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__)) _if__((!_GENERIC__) && (!_DIFFTABKLUG__))
On the _HOST__ family, this option is allowed, but has no effect. It is On the _HOST__ family, this option is allowed, but has no effect. It is
permitted for compatibility with the GNU assembler on other platforms, permitted for compatibility with the GNU assembler on other platforms,
@ -642,7 +650,7 @@ _if__(_GENERIC__ || _DIFFTABKLUG__ )
@cindex warning for altered difference tables @cindex warning for altered difference tables
@code{_AS__} sometimes alters the code emitted for directives of the form @code{_AS__} sometimes alters the code emitted for directives of the form
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}. @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. is done.
_fi__(_GENERIC__ || _DIFFTABKLUG__ ) _fi__(_GENERIC__ || _DIFFTABKLUG__ )
@ -863,7 +871,6 @@ of @code{_AS__}.
@node Symbol Intro, Statements, Comments, Syntax @node Symbol Intro, Statements, Comments, Syntax
@section Symbols @section Symbols
@cindex symbols
@cindex characters used in symbols @cindex characters used in symbols
A @dfn{symbol} is one or more characters chosen from the set of all A @dfn{symbol} is one or more characters chosen from the set of all
letters (both upper and lower case), digits and letters (both upper and lower case), digits and
@ -2366,8 +2373,6 @@ _fi__( _BOUT__ && (! _COFF__))
@section @code{.align @var{abs-expr} , @var{abs-expr}} @section @code{.align @var{abs-expr} , @var{abs-expr}}
@cindex padding the location counter @cindex padding the location counter
@cindex advancing location counter
@cindex location counter, advancing
@cindex @code{align} directive @cindex @code{align} directive
Pad the location counter (in the current subsection) to a particular Pad the location counter (in the current subsection) to a particular
storage boundary. The first expression (which must be absolute) is the 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 @node Set, Short, Section, Pseudo Ops
_fi__(_COFF__) _fi__(_COFF__)
_if__(_BOUT__) _if__(_BOUT__&&!_COFF__)
@node Set, Short, Scl, Pseudo Ops @node Set, Short, Scl, Pseudo Ops
_fi__(_BOUT__) _fi__(_BOUT__&&!_COFF__)
_if__(!(_COFF__||_BOUT__)) _if__(!(_COFF__||_BOUT__))
@node Set, Short, Quad, Pseudo Ops @node Set, Short, Quad, Pseudo Ops
_fi__(!(_COFF__||_BOUT__)) _fi__(!(_COFF__||_BOUT__))
@ -3198,17 +3203,17 @@ ignores it.
_fi__(_BOUT__) _fi__(_BOUT__)
_fi__(_COFF__||_BOUT__) _fi__(_COFF__||_BOUT__)
_if__(_H8__) _if__(_H8__&&!_GENERIC__)
@node Space, Tag, Size, Pseudo Ops @node Space, Tag, Size, Pseudo Ops
_fi__(_H8__) _fi__(_H8__&&!_GENERIC__)
_if__(!_H8__) _if__(_GENERIC__||!_H8__)
_if__(_COFF__||_BOUT__) _if__(_COFF__||_BOUT__)
@node Space, Stab, Size, Pseudo Ops @node Space, Stab, Size, Pseudo Ops
_fi__(_COFF__||_BOUT__) _fi__(_COFF__||_BOUT__)
_if__(!(_COFF__||_BOUT__)) _if__(!(_COFF__||_BOUT__))
@node Space, Stab, Single, Pseudo Ops @node Space, Stab, Single, Pseudo Ops
_fi__(!(_COFF__||_BOUT__)) _fi__(!(_COFF__||_BOUT__))
_fi__(!_H8__) _fi__(_GENERIC__||!_H8__)
_if__(_GENERIC__ || !_A29K__) _if__(_GENERIC__ || !_A29K__)
@section @code{.space @var{size} , @var{fill}} @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__) _fi__(_GENERIC__ || !_A29K__)
_if__(_A29K__) _if__(_A29K__)
_if__(!_GENERIC__)
@section @code{.space} @section @code{.space}
@cindex @code{space} directive @cindex @code{space} directive
_fi__(!_GENERIC__)
On the AMD 29K, this directive is ignored; it is accepted for On the AMD 29K, this directive is ignored; it is accepted for
compatibility with other AMD 29K assemblers. compatibility with other AMD 29K assemblers.
@ -3300,12 +3306,12 @@ _fi__(_AOUT__||_BOUT__||_COFF__)
_fi__(_GENERIC__||!_H8__) _fi__(_GENERIC__||!_H8__)
_if__(_COFF__||_BOUT__) _if__(_COFF__||_BOUT__)
_if__(!_H8__) _if__(_GENERIC__||!_H8__)
@node Tag, Text, Stab, Pseudo Ops @node Tag, Text, Stab, Pseudo Ops
_fi__(!_H8__) _fi__(_GENERIC__||!_H8__)
_if__(_H8__) _if__(_H8__&&!_GENERIC__)
@node Tag, Text, Space, Pseudo Ops @node Tag, Text, Space, Pseudo Ops
_fi__(_H8__) _fi__(_H8__&&!_GENERIC__)
@section @code{.tag @var{structname}} @section @code{.tag @var{structname}}
@cindex COFF structure debugging @cindex COFF structure debugging
@ -3702,9 +3708,12 @@ Unconditional branch.
@end table @end table
@item j@var{COND} @item j@var{COND}
@var{COND} may be any one of the conditional branches @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 @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}. @var{NOTCOND} is the opposite condition to @var{COND}.
@table @asis @table @asis
@item (byte displacement) @item (byte displacement)
@ -4463,8 +4472,8 @@ for the linker to resolve.
@node Compare-and-branch-i960, , callj-i960, Opcodes for i960 @node Compare-and-branch-i960, , callj-i960, Opcodes for i960
_CHAPSEC__(2+_GENERIC__) Compare-and-Branch _CHAPSEC__(2+_GENERIC__) Compare-and-Branch
@cindex i960 compare and branch instructions @cindex i960 compare/branch instructions
@cindex compare and branch instructions, i960 @cindex compare/branch instructions, i960
The 960 architectures provide combined Compare-and-Branch instructions The 960 architectures provide combined Compare-and-Branch instructions
that permit you to store the branch target in the lower 13 bits of the 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 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 possible, and you know that the relevant symbols will be less than 17
bits away. bits away.
@cindex @code{-m68000} and related options, M680x0 @cindex @code{-m68000} and related options
@cindex architecture options, M680x0 @cindex architecture options, M680x0
@cindex M680x0 architecture options @cindex M680x0 architecture options
The 680x0 version of @code{_AS__} is most frequently used to assemble 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 @smallexample
Displacement Displacement
+--------------------------------------------------------- +-------------------------------------------------
| 68020 68000/10 | 68020 68000/10
Pseudo-Op |BYTE WORD LONG LONG non-PC relative Pseudo-Op |BYTE WORD LONG LONG non-PC relative
+--------------------------------------------------------- +-------------------------------------------------
jbsr |bsrs bsr bsrl jsr jsr jbsr |bsrs bsr bsrl jsr jsr
jra |bras bra bral jmp jmp jra |bras bra bral jmp jmp
* jXX |bXXs bXX bXXl bNXs;jmpl bNXs;jmp * jXX |bXXs bXX bXXl bNXs;jmpl bNXs;jmp