OpenE2K
/
binutils-gdb
12
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

* doc/as.texinfo: Fix cross reference usage, typos and grammar. 

(Overview): Skip cross reference in man page.
This commit is contained in:
Bob Wilson 2006-09-20 21:25:10 +00:00
parent 2e9f762528
commit 96e9638b14
2 changed files with 60 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gas/ChangeLog
View File

@ -1,3 +1,8 @@
2006-09-20 Bob Wilson <bob.wilson@acm.org>
* doc/as.texinfo: Fix cross reference usage, typos and grammar.
(Overview): Skip cross reference in man page.
2006-09-20 Kai Tietz <Kai.Tietz@onevision.com> 2006-09-20 Kai Tietz <Kai.Tietz@onevision.com>
* configure.in: Add new target x86_64-pc-mingw64. * configure.in: Add new target x86_64-pc-mingw64.

104
gas/doc/as.texinfo
View File

@ -209,7 +209,7 @@ code for @value{TARGET} architectures.
@cindex option summary @cindex option summary
@cindex summary of options @cindex summary of options
Here is a brief summary of how to invoke @command{@value{AS}}. For details, Here is a brief summary of how to invoke @command{@value{AS}}. For details,
@pxref{Invoking,,Command-Line Options}. see @ref{Invoking,,Command-Line Options}.
@c man title AS the portable GNU assembler. @c man title AS the portable GNU assembler.
@ -489,7 +489,10 @@ listing without forms processing. The @samp{=file} option, if used, must be
the last one. By itself, @samp{-a} defaults to @samp{-ahls}. the last one. By itself, @samp{-a} defaults to @samp{-ahls}.
@item --alternate @item --alternate
Begin in alternate macro mode, see @ref{Altmacro,,@code{.altmacro}}. Begin in alternate macro mode.
@ifclear man
@xref{Altmacro,,@code{.altmacro}}.
@end ifclear
@item -D @item -D
Ignored. This option is accepted for script compatibility with calls to Ignored. This option is accepted for script compatibility with calls to
@ -1512,7 +1515,8 @@ because many of them aren't supposed to happen.
@cindex options, all versions of assembler @cindex options, all versions of assembler
This chapter describes command-line options available in @emph{all} This chapter describes command-line options available in @emph{all}
versions of the @sc{gnu} assembler; @pxref{Machine Dependencies}, for options specific versions of the @sc{gnu} assembler; see @ref{Machine Dependencies},
for options specific
@ifclear GENERIC @ifclear GENERIC
to the @value{TARGET} target. to the @value{TARGET} target.
@end ifclear @end ifclear
@ -1612,7 +1616,8 @@ listing-control directives have no effect.
The letters after @samp{-a} may be combined into one option, The letters after @samp{-a} may be combined into one option,
@emph{e.g.}, @samp{-aln}. @emph{e.g.}, @samp{-aln}.
Note if the assembler source is coming from the standard input (eg because it Note if the assembler source is coming from the standard input (e.g.,
because it
is being created by @code{@value{GCC}} and the @samp{-pipe} command line switch is being created by @code{@value{GCC}} and the @samp{-pipe} command line switch
is being used) then the listing will not contain any comments or preprocessor is being used) then the listing will not contain any comments or preprocessor
directives. This is because the listing code buffers input source lines from directives. This is because the listing code buffers input source lines from
@ -1682,8 +1687,8 @@ alteration on other platforms.
@ifset DIFF-TBL-KLUGE @ifset DIFF-TBL-KLUGE
@cindex difference tables, warning @cindex difference tables, warning
@cindex warning for altered difference tables @cindex warning for altered difference tables
@command{@value{AS}} sometimes alters the code emitted for directives of the form @command{@value{AS}} sometimes alters the code emitted for directives of the
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}. form @samp{.word @var{sym1}-@var{sym2}}. @xref{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.
@end ifset @end ifset
@ -1716,9 +1721,11 @@ On the HPPA local labels begin with @samp{L$}.
The listing feature of the assembler can be enabled via the command line switch The listing feature of the assembler can be enabled via the command line switch
@samp{-a} (@pxref{a}). This feature combines the input source file(s) with a @samp{-a} (@pxref{a}). This feature combines the input source file(s) with a
hex dump of the corresponding locations in the output object file, and displays hex dump of the corresponding locations in the output object file, and displays
them as a listing file. The format of this listing can be controlled by pseudo them as a listing file. The format of this listing can be controlled by
ops inside the assembler source (@pxref{List} @pxref{Title} @pxref{Sbttl} directives inside the assembler source (i.e., @code{.list} (@pxref{List}),
@pxref{Psize} @pxref{Eject}) and also by the following switches: @code{.title} (@pxref{Title}), @code{.sbttl} (@pxref{Sbttl}),
@code{.psize} (@pxref{Psize}), and
@code{.eject} (@pxref{Eject}) and also by the following switches:
@table @gcctabopt @table @gcctabopt
@item --listing-lhs-width=@samp{number} @item --listing-lhs-width=@samp{number}
@ -2080,7 +2087,7 @@ anything else you may get from your C compiler's preprocessor. You can
do include file processing with the @code{.include} directive do include file processing with the @code{.include} directive
(@pxref{Include,,@code{.include}}). You can use the @sc{gnu} C compiler driver (@pxref{Include,,@code{.include}}). You can use the @sc{gnu} C compiler driver
to get other ``CPP'' style preprocessing by giving the input file a to get other ``CPP'' style preprocessing by giving the input file a
@samp{.S} suffix. @xref{Overall Options,, Options Controlling the Kind of @samp{.S} suffix. @xref{Overall Options, ,Options Controlling the Kind of
Output, gcc.info, Using GNU CC}. Output, gcc.info, Using GNU CC}.
Excess whitespace, comments, and character constants Excess whitespace, comments, and character constants
@ -2217,7 +2224,7 @@ extends to the end of the line.
To be compatible with past assemblers, lines that begin with @samp{#} have a To be compatible with past assemblers, lines that begin with @samp{#} have a
special interpretation. Following the @samp{#} should be an absolute special interpretation. Following the @samp{#} should be an absolute
expression (@pxref{Expressions}): the logical line number of the @emph{next} expression (@pxref{Expressions}): the logical line number of the @emph{next}
line. Then a string (@pxref{Strings,, Strings}) is allowed: if present it is a line. Then a string (@pxref{Strings, ,Strings}) is allowed: if present it is a
new logical file name. The rest of the line, if any, should be whitespace. new logical file name. The rest of the line, if any, should be whitespace.
If the first non-whitespace characters on the line are not numeric, If the first non-whitespace characters on the line are not numeric,
@ -2292,8 +2299,8 @@ constants are an exception: they do not end statements.
@end ifclear @end ifclear
@ifset GENERIC @ifset GENERIC
A @dfn{statement} ends at a newline character (@samp{\n}) or line A @dfn{statement} ends at a newline character (@samp{\n}) or line
separator character. (The line separator is usually @samp{;}, unless separator character. (The line separator is usually @samp{;}, unless this
this conflicts with the comment character; @pxref{Machine Dependencies}.) The conflicts with the comment character; see @ref{Machine Dependencies}.) The
newline or separator character is considered part of the preceding newline or separator character is considered part of the preceding
statement. Newlines and separators within character constants are an statement. Newlines and separators within character constants are an
exception: they do not end statements. exception: they do not end statements.
@ -3077,8 +3084,8 @@ You
can also use the @code{.subsection} directive (@pxref{SubSection}) can also use the @code{.subsection} directive (@pxref{SubSection})
to specify a subsection: @samp{.subsection @var{expression}}. to specify a subsection: @samp{.subsection @var{expression}}.
@end ifset @end ifset
@var{Expression} should be an absolute expression. @var{Expression} should be an absolute expression
(@xref{Expressions}.) If you just say @samp{.text} then @samp{.text 0} (@pxref{Expressions}). If you just say @samp{.text} then @samp{.text 0}
is assumed. Likewise @samp{.data} means @samp{.data 0}. Assembly is assumed. Likewise @samp{.data} means @samp{.data 0}. Assembly
begins in @code{text 0}. For instance: begins in @code{text 0}. For instance:
@smallexample @smallexample
@ -3117,7 +3124,7 @@ The @code{.lcomm} pseudo-op defines a symbol in the bss section; see
@ref{Lcomm,,@code{.lcomm}}. @ref{Lcomm,,@code{.lcomm}}.
The @code{.comm} pseudo-op may be used to declare a common symbol, which is The @code{.comm} pseudo-op may be used to declare a common symbol, which is
another form of uninitialized symbol; see @xref{Comm,,@code{.comm}}. another form of uninitialized symbol; see @ref{Comm,,@code{.comm}}.
@ifset GENERIC @ifset GENERIC
When assembling for a target which supports multiple sections, such as ELF or When assembling for a target which supports multiple sections, such as ELF or
@ -3188,8 +3195,8 @@ equals sign @samp{=}@samp{=} here represents an equivalent of the
Symbol names begin with a letter or with one of @samp{._}. On most Symbol names begin with a letter or with one of @samp{._}. On most
machines, you can also use @code{$} in symbol names; exceptions are machines, you can also use @code{$} in symbol names; exceptions are
noted in @ref{Machine Dependencies}. That character may be followed by any noted in @ref{Machine Dependencies}. That character may be followed by any
string of digits, letters, dollar signs (unless otherwise noted in string of digits, letters, dollar signs (unless otherwise noted for a
@ref{Machine Dependencies}), and underscores. particular target machine), and underscores.
@end ifclear @end ifclear
@ifset SPECIAL-SYMS @ifset SPECIAL-SYMS
@ifset H8 @ifset H8
@ -3220,7 +3227,7 @@ To define a local symbol, write a label of the form @samp{@b{N}:} (where @b{N}
represents any positive integer). To refer to the most recent previous represents any positive integer). To refer to the most recent previous
definition of that symbol write @samp{@b{N}b}, using the same number as when definition of that symbol write @samp{@b{N}b}, using the same number as when
you defined the label. To refer to the next definition of a local label, write you defined the label. To refer to the next definition of a local label, write
@samp{@b{N}f}--- The @samp{b} stands for``backwards'' and the @samp{f} stands @samp{@b{N}f}---the @samp{b} stands for ``backwards'' and the @samp{f} stands
for ``forwards''. for ``forwards''.
There is no restriction on how you can use these labels, and you can reuse them There is no restriction on how you can use these labels, and you can reuse them
@ -3251,9 +3258,9 @@ label_4: branch label_3
Local symbol names are only a notational device. They are immediately Local symbol names are only a notational device. They are immediately
transformed into more conventional symbol names before the assembler uses them. transformed into more conventional symbol names before the assembler uses them.
The symbol names stored in the symbol table, appearing in error messages and The symbol names are stored in the symbol table, appear in error messages, and
optionally emitted to the object file. The names are constructed using these are optionally emitted to the object file. The names are constructed using
parts: these parts:
@table @code @table @code
@item L @item L
@ -3286,20 +3293,20 @@ So for example, the first @code{1:} is named @code{L1@kbd{C-B}1}, the 44th
@cindex dollar local symbols @cindex dollar local symbols
@code{@value{AS}} also supports an even more local form of local labels called @code{@value{AS}} also supports an even more local form of local labels called
dollar labels. These labels go out of scope (ie they become undefined) as soon dollar labels. These labels go out of scope (i.e., they become undefined) as
as a non-local label is defined. Thus they remain valid for only a small soon as a non-local label is defined. Thus they remain valid for only a small
region of the input source code. Normal local labels, by contrast, remain in region of the input source code. Normal local labels, by contrast, remain in
scope for the entire file, or until they are redefined by another occurrence of scope for the entire file, or until they are redefined by another occurrence of
the same local label. the same local label.
Dollar labels are defined in exactly the same way as ordinary local labels, Dollar labels are defined in exactly the same way as ordinary local labels,
except that instead of being terminated by a colon, they are terminated by a except that instead of being terminated by a colon, they are terminated by a
dollar sign. eg @samp{@b{55$}}. dollar sign, e.g., @samp{@b{55$}}.
They can also be distinguished from ordinary local labels by their transformed They can also be distinguished from ordinary local labels by their transformed
name which uses ASCII character @samp{\001} (control-A) as the magic character names which use ASCII character @samp{\001} (control-A) as the magic character
to distinguish them from ordinary labels. Thus the 5th definition of @samp{6$} to distinguish them from ordinary labels. For example, the fifth definition of
is named @samp{L6@kbd{C-A}5}. @samp{6$} is named @samp{L6@kbd{C-A}5}.
@node Dot @node Dot
@section The Special Dot Symbol @section The Special Dot Symbol
@ -3730,7 +3737,7 @@ Some machine configurations provide additional directives.
@end ifset @end ifset
@ifclear GENERIC @ifclear GENERIC
@ifset machine-directives @ifset machine-directives
@xref{Machine Dependencies} for additional directives. @xref{Machine Dependencies}, for additional directives.
@end ifset @end ifset
@end ifclear @end ifclear
@ -4270,7 +4277,7 @@ Force a page break at this point, when generating assembly listings.
@cindex @code{else} directive @cindex @code{else} directive
@code{.else} is part of the @command{@value{AS}} support for conditional @code{.else} is part of the @command{@value{AS}} support for conditional
assembly; @pxref{If,,@code{.if}}. It marks the beginning of a section assembly; see @ref{If,,@code{.if}}. It marks the beginning of a section
of code to be assembled if the condition for the preceding @code{.if} of code to be assembled if the condition for the preceding @code{.if}
was false. was false.
@ -4279,7 +4286,7 @@ was false.
@cindex @code{elseif} directive @cindex @code{elseif} directive
@code{.elseif} is part of the @command{@value{AS}} support for conditional @code{.elseif} is part of the @command{@value{AS}} support for conditional
assembly; @pxref{If,,@code{.if}}. It is shorthand for beginning a new assembly; see @ref{If,,@code{.if}}. It is shorthand for beginning a new
@code{.if} block that would otherwise fill the entire @code{.else} section. @code{.if} block that would otherwise fill the entire @code{.else} section.
@node End @node End
@ -4324,7 +4331,7 @@ conditionally. @xref{If,,@code{.if}}.
@cindex assigning values to symbols @cindex assigning values to symbols
@cindex symbols, assigning values to @cindex symbols, assigning values to
This directive sets the value of @var{symbol} to @var{expression}. This directive sets the value of @var{symbol} to @var{expression}.
It is synonymous with @samp{.set}; @pxref{Set,,@code{.set}}. It is synonymous with @samp{.set}; see @ref{Set,,@code{.set}}.
@ifset HPPA @ifset HPPA
The syntax for @code{equ} on the HPPA is The syntax for @code{equ} on the HPPA is
@ -4335,8 +4342,8 @@ The syntax for @code{equ} on the HPPA is
The syntax for @code{equ} on the Z80 is The syntax for @code{equ} on the Z80 is
@samp{@var{symbol} equ @var{expression}}. @samp{@var{symbol} equ @var{expression}}.
On the Z80 it is an eror if @var{symbol} is already defined, On the Z80 it is an eror if @var{symbol} is already defined,
but the symbol is not protected from later redefinition, but the symbol is not protected from later redefinition.
compare @xref{Equiv}. Compare @ref{Equiv}.
@end ifset @end ifset
@node Equiv @node Equiv
@ -4492,7 +4499,7 @@ compatibility with other assemblers.
@ifset HPPA @ifset HPPA
On the HPPA, @code{.global} is not always enough to make it accessible to other On the HPPA, @code{.global} is not always enough to make it accessible to other
partial programs. You may need the HPPA-only @code{.EXPORT} directive as well. partial programs. You may need the HPPA-only @code{.EXPORT} directive as well.
@xref{HPPA Directives,, HPPA Assembler Directives}. @xref{HPPA Directives, ,HPPA Assembler Directives}.
@end ifset @end ifset
@ifset ELF @ifset ELF
@ -4729,8 +4736,7 @@ is equivalent to assembling
move d3,sp@@- move d3,sp@@-
@end example @end example
For some caveats with the spelling of @var{symbol}, see also the discussion For some caveats with the spelling of @var{symbol}, see also @ref{Macro}.
at @xref{Macro}.
@node Irpc @node Irpc
@section @code{.irpc @var{symbol},@var{values}}@dots{} @section @code{.irpc @var{symbol},@var{values}}@dots{}
@ -4915,7 +4921,7 @@ the initial value of the listing counter is one.
@section @code{.long @var{expressions}} @section @code{.long @var{expressions}}
@cindex @code{long} directive @cindex @code{long} directive
@code{.long} is the same as @samp{.int}, @pxref{Int,,@code{.int}}. @code{.long} is the same as @samp{.int}. @xref{Int,,@code{.int}}.
@ignore @ignore
@c no one seems to know what this is for or whether this description is @c no one seems to know what this is for or whether this description is
@ -4979,7 +4985,7 @@ indicate whether all invocations must specify a non-blank value (through
(through @samp{:@code{vararg}}). You can supply a default value for any (through @samp{:@code{vararg}}). You can supply a default value for any
macro argument by following the name with @samp{=@var{deflt}}. You macro argument by following the name with @samp{=@var{deflt}}. You
cannot define two macros with the same @var{macname} unless it has been cannot define two macros with the same @var{macname} unless it has been
subject to the @code{.purgem} directive (@xref{Purgem}.) between the two subject to the @code{.purgem} directive (@pxref{Purgem}) between the two
definitions. For example, these are all valid @code{.macro} statements: definitions. For example, these are all valid @code{.macro} statements:
@table @code @table @code
@ -5087,9 +5093,9 @@ l&:
@end example @end example
@end table @end table
Note - this problem of correctly identifying string parameters to pseudo ops Note: this problem of correctly identifying string parameters to pseudo ops
also applies to the identifiers used in @code{.irp} (@xref{Irp}.) also applies to the identifiers used in @code{.irp} (@pxref{Irp})
and @code{.irpc} (@xref{Irpc}.) as well. and @code{.irpc} (@pxref{Irpc}) as well.
@item .endm @item .endm
@cindex @code{endm} directive @cindex @code{endm} directive
@ -5150,7 +5156,7 @@ and use the result as a string.
@node Noaltmacro @node Noaltmacro
@section @code{.noaltmacro} @section @code{.noaltmacro}
Disable alternate macro mode. @ref{Altmacro} Disable alternate macro mode. @xref{Altmacro}.
@node Nolist @node Nolist
@section @code{.nolist} @section @code{.nolist}
@ -5547,7 +5553,7 @@ ARM) then another character is used instead. For example the ARM port uses the
@code{%} character. @code{%} character.
If @var{flags} contains the @code{M} symbol then the @var{type} argument must If @var{flags} contains the @code{M} symbol then the @var{type} argument must
be specified as well as an extra argument - @var{entsize} - like this: be specified as well as an extra argument---@var{entsize}---like this:
@smallexample @smallexample
.section @var{name} , "@var{flags}"M, @@@var{type}, @var{entsize} .section @var{name} , "@var{flags}"M, @@@var{type}, @var{entsize}
@ -5576,7 +5582,7 @@ indicates that only one copy of this section should be retained
an alias for comdat an alias for comdat
@end table @end table
Note - if both the @var{M} and @var{G} flags are present then the fields for Note: if both the @var{M} and @var{G} flags are present then the fields for
the Merge flag should come first, like this: the Merge flag should come first, like this:
@smallexample @smallexample
@ -5649,7 +5655,7 @@ On Z80 @code{set} is a real instruction, use
@xref{Word,,@code{.word}}. @xref{Word,,@code{.word}}.
In some configurations, however, @code{.short} and @code{.word} generate In some configurations, however, @code{.short} and @code{.word} generate
numbers of different lengths; @pxref{Machine Dependencies}. numbers of different lengths. @xref{Machine Dependencies}.
@end ifset @end ifset
@ifclear GENERIC @ifclear GENERIC
@ifset W16 @ifset W16
@ -5732,7 +5738,7 @@ symbols.
@cindex @code{sleb128} directive @cindex @code{sleb128} directive
@var{sleb128} stands for ``signed little endian base 128.'' This is a @var{sleb128} stands for ``signed little endian base 128.'' This is a
compact, variable length representation of numbers used by the DWARF compact, variable length representation of numbers used by the DWARF
symbolic debugging format. @xref{Uleb128,@code{.uleb128}}. symbolic debugging format. @xref{Uleb128, ,@code{.uleb128}}.
@ifclear no-space-dir @ifclear no-space-dir
@node Skip @node Skip
@ -6060,7 +6066,7 @@ The syntaxes supported are:
@cindex @code{uleb128} directive @cindex @code{uleb128} directive
@var{uleb128} stands for ``unsigned little endian base 128.'' This is a @var{uleb128} stands for ``unsigned little endian base 128.'' This is a
compact, variable length representation of numbers used by the DWARF compact, variable length representation of numbers used by the DWARF
symbolic debugging format. @xref{Sleb128,@code{.sleb128}}. symbolic debugging format. @xref{Sleb128, ,@code{.sleb128}}.
@ifset COFF @ifset COFF
@node Val @node Val
@ -6103,7 +6109,7 @@ This directive finds or creates a symbol @code{table} and creates a
This directive finds the symbol @code{child} and finds or creates the symbol This directive finds the symbol @code{child} and finds or creates the symbol
@code{parent} and then creates a @code{VTABLE_INHERIT} relocation for the @code{parent} and then creates a @code{VTABLE_INHERIT} relocation for the
parent whose addend is the value of the child symbol. As a special case the parent whose addend is the value of the child symbol. As a special case the
parent name of @code{0} is treated as referring the @code{*ABS*} section. parent name of @code{0} is treated as referring to the @code{*ABS*} section.
@end ifset @end ifset
@node Warning @node Warning