mirror of
https://github.com/espressif/binutils-gdb.git
synced 2025-06-21 02:24:17 +08:00
correct typo in as cmdline synopsis (-w for -W);
describe --statistics (nee -noquiet); describe -Z
This commit is contained in:
@ -178,9 +178,9 @@ 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 We don't use deffn and friends for the following because they seem
|
||||||
@c to be limited to one line for the header.
|
@c to be limited to one line for the header.
|
||||||
@smallexample
|
@smallexample
|
||||||
@value{AS} [ -a[dhlns] ] [ -D ] [ -f ]
|
@value{AS} [ -a[dhlns] ] [ -D ] [ -f ] [ -I @var{path} ]
|
||||||
[ -I @var{path} ] [ -K ] [ -L ]
|
[ -K ] [ -L ] [ -o @var{objfile} ] [ -R ]
|
||||||
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
|
[ --statistics] [ -v ] [ -W ] [ -Z ]
|
||||||
@ifset A29K
|
@ifset A29K
|
||||||
@c am29k has no machine-dependent assembler options
|
@c am29k has no machine-dependent assembler options
|
||||||
@end ifset
|
@end ifset
|
||||||
@ -263,12 +263,19 @@ Name the object-file output from @code{@value{AS}}
|
|||||||
@item -R
|
@item -R
|
||||||
Fold data section into text section
|
Fold data section into text section
|
||||||
|
|
||||||
|
@item --statistics
|
||||||
|
Display maximum space (in bytes), and total time (in seconds), taken by
|
||||||
|
assembly.
|
||||||
|
|
||||||
@item -v
|
@item -v
|
||||||
Announce @code{as} version
|
Announce @code{as} version
|
||||||
|
|
||||||
@item -W
|
@item -W
|
||||||
Suppress warning messages
|
Suppress warning messages
|
||||||
|
|
||||||
|
@item -Z
|
||||||
|
Generate object file even after errors
|
||||||
|
|
||||||
@item -- | @var{files} @dots{}
|
@item -- | @var{files} @dots{}
|
||||||
Standard input, or source files to assemble.
|
Standard input, or source files to assemble.
|
||||||
|
|
||||||
@ -726,8 +733,10 @@ passes to each compilation pass, including the assembler.)
|
|||||||
* L:: -L to retain local labels
|
* L:: -L to retain local labels
|
||||||
* o:: -o to name the object file
|
* o:: -o to name the object file
|
||||||
* R:: -R to join data and text sections
|
* R:: -R to join data and text sections
|
||||||
|
* statistics:: --statistics to see statistics about assembly
|
||||||
* v:: -v to announce version
|
* v:: -v to announce version
|
||||||
* W:: -W to suppress warnings
|
* W:: -W to suppress warnings
|
||||||
|
* Z:: -Z to make object file even after errors
|
||||||
@end menu
|
@end menu
|
||||||
|
|
||||||
@node a
|
@node a
|
||||||
@ -912,6 +921,18 @@ this option is only useful if you use sections named @samp{.text} and
|
|||||||
@code{-R} generates a warning from @code{@value{AS}}.
|
@code{-R} generates a warning from @code{@value{AS}}.
|
||||||
@end ifset
|
@end ifset
|
||||||
|
|
||||||
|
@node statistics
|
||||||
|
@section Display Statistics about Assembly: @code{--statistics}
|
||||||
|
|
||||||
|
@kindex --statistics
|
||||||
|
@cindex statistics, about assembly
|
||||||
|
@cindex time, total for assembly
|
||||||
|
@cindex space used, maximum for assembly
|
||||||
|
Use @samp{--statistics} to display two statistics about the resources used by
|
||||||
|
@code{@value{AS}}: the maximum amount of space allocated during the assembly
|
||||||
|
(in bytes), and the total execution time taken for the assembly (in @sc{cpu}
|
||||||
|
seconds).
|
||||||
|
|
||||||
@node v
|
@node v
|
||||||
@section Announce Version: @code{-v}
|
@section Announce Version: @code{-v}
|
||||||
|
|
||||||
@ -938,6 +959,17 @@ affects the warning messages: it does not change any particular of how
|
|||||||
@code{@value{AS}} assembles your file. Errors, which stop the assembly, are
|
@code{@value{AS}} assembles your file. Errors, which stop the assembly, are
|
||||||
still reported.
|
still reported.
|
||||||
|
|
||||||
|
@node Z
|
||||||
|
@section Generate Object File in Spite of Errors: @code{-Z}
|
||||||
|
@cindex object file, after errors
|
||||||
|
@cindex errors, continuing after
|
||||||
|
After an error message, @code{@value{AS}} normally produces no output. If for
|
||||||
|
some reason you are interested in object file output even after
|
||||||
|
@code{@value{AS}} gives an error message on your program, use the @samp{-Z}
|
||||||
|
option. If there are any errors, @code{@value{AS}} continues anyways, and
|
||||||
|
writes an object file after a final warning message of the form @samp{@var{n}
|
||||||
|
errors, @var{m} warnings, generating bad object file.}
|
||||||
|
|
||||||
@node Syntax
|
@node Syntax
|
||||||
@chapter Syntax
|
@chapter Syntax
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user