FreeChainXenon/binutils-gdb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Fix use of "command line X" in binutils doc

Browse source 
Binutils documentation uses a mix of spelling for the compound word
"command-line X". According to [1]:

"Sometimes compound words are written separately (nail polish),
sometimes with a hyphen (short-sighted) and sometimes as one word
(eyelashes). Often new compounds are written as two separate words and,
as they become more familiar, they are either connected with a hyphen
(-) or made into one word."

I think command-line X is common enough in our industry that the two
workds command and line should be connected. Since command-line is more
common than commandline, I propose to update binutils documentation to
consistently use "command-line" when this is used as an adjective to a
noun (eg. command-line argument, command-line switch, command-line
option and command-line flag). I've left occurences of "the command
line" as is. I've also left gdb, sim and readline alone and have only
touched public documentation (texi and NEWS files).

[1]
http://dictionary.cambridge.org/grammar/british-grammar/word-formation/compounds

2018-07-02  Thomas Preud'homme  <thomas.preudhomme@arm.com>

bfd/
	* doc/bfdint.texi: Use command-line consistently when used in a
	compount word.
	* doc/bfdsumm.texi: Likewise.

binutils/
	* NEWS: Use command-line consistently when used in a compount word.
	* doc/binutils.texi: Likewise and fix trailing whitespace on same
	line.

gas/
	* NEWS: Use command-line consistently when used in a compount word.
	* doc/as.texi: Likewise.
	* doc/c-aarch64.texi: Likewise.
	* doc/c-alpha.texi: Likewise.
	* doc/c-arc.texi: Likewise.
	* doc/c-arm.texi: Likewise.
	* doc/c-avr.texi: Likewise.
	* doc/c-bfin.texi: Likewise.
	* doc/c-cris.texi: Likewise.
	* doc/c-epiphany.texi: Likewise.
	* doc/c-i386.texi: Likewise.
	* doc/c-ia64.texi: Likewise.
	* doc/c-lm32.texi: Likewise.
	* doc/c-m32r.texi: Likewise.
	* doc/c-m68k.texi: Likewise.
	* doc/c-mips.texi: Likewise.
	* doc/c-mmix.texi: Likewise.
	* doc/c-msp430.texi: Likewise.
	* doc/c-mt.texi: Likewise.
	* doc/c-nios2.texi: Likewise.
	* doc/c-ppc.texi: Likewise.
	* doc/c-pru.texi: Likewise.
	* doc/c-rl78.texi: Likewise.
	* doc/c-rx.texi: Likewise.
	* doc/c-tic6x.texi: Likewise.
	* doc/c-v850.texi: Likewise.
	* doc/c-vax.texi: Likewise.
	* doc/c-visium.texi: Likewise.
	* doc/c-xstormy16.texi: Likewise.
	* doc/c-xtensa.texi: Likewise.
	* doc/c-z80.texi: Likewise.
	* doc/c-z8k.texi: Likewise.
	* doc/internals.texi: Likewise.

gprof/
	* gprof.texi: Use command-line consistently when used in a compount
	word.

ld/
	* NEWS: Use command-line consistently when used in a compount word.
	* ld.texinfo: Likewise.
	* ldint.texinfo: Likewise.
This commit is contained in:
Thomas Preud'homme 2018-07-02 11:18:24 +01:00
parent f2075844e2
commit a05a5b64cf
46 changed files with 390 additions and 331 deletions
Download patch file Download diff file Expand all files Collapse all files

6
bfd/ChangeLog
View file

@ -1,3 +1,9 @@
2018-07-02 Thomas Preud'homme <thomas.preudhomme@arm.com>
* doc/bfdint.texi: Use command-line consistently when used in a
compount word.
* doc/bfdsumm.texi: Likewise.
2018-06-29 Maciej W. Rozycki <macro@mips.com> 2018-06-29 Maciej W. Rozycki <macro@mips.com>
* elfxx-mips.c (allocate_dynrelocs): Remove extraneous symbol * elfxx-mips.c (allocate_dynrelocs): Remove extraneous symbol

2
bfd/doc/bfdint.texi
View file

@ -318,7 +318,7 @@ The target vector starts with a set of constants.
@table @samp @table @samp
@item name @item name
The name of the target vector. This is an arbitrary string. This is The name of the target vector. This is an arbitrary string. This is
how the target vector is named in command line options for tools which how the target vector is named in command-line options for tools which
use BFD, such as the @samp{--oformat} linker option. use BFD, such as the @samp{--oformat} linker option.
@item flavour @item flavour

2
bfd/doc/bfdsumm.texi
View file

@ -115,7 +115,7 @@ output file (no matter its format) will retain symbols pointing to
functions and to global, static, and common variables. Some symbol functions and to global, static, and common variables. Some symbol
information is not worth retaining; in @code{a.out}, type information is information is not worth retaining; in @code{a.out}, type information is
stored in the symbol table as long symbol names. This information would stored in the symbol table as long symbol names. This information would
be useless to most COFF debuggers; the linker has command line switches be useless to most COFF debuggers; the linker has command-line switches
to allow users to throw it away. to allow users to throw it away.
There is one word of type information within the symbol, so if the There is one word of type information within the symbol, so if the

6
binutils/ChangeLog
View file

@ -1,3 +1,9 @@
2018-07-02 Thomas Preud'homme <thomas.preudhomme@arm.com>
* NEWS: Use command-line consistently when used in a compount word.
* doc/binutils.texi: Likewise and fix trailing whitespace on same
line.
2018-06-26 Nick Clifton <nickc@redhat.com> 2018-06-26 Nick Clifton <nickc@redhat.com>
* po/sv.po: Updated Swedish translation. * po/sv.po: Updated Swedish translation.

34
binutils/NEWS
View file

@ -66,11 +66,11 @@ Changes in 2.28:
require an ABI update, affecting other assemblers and linkers that require an ABI update, affecting other assemblers and linkers that
create and process the relocations correctly. It is recommended that create and process the relocations correctly. It is recommended that
all VLE object files be recompiled, but ld can modify the relocations all VLE object files be recompiled, but ld can modify the relocations
if --vle-reloc-fixup is passed to ld. If the new ld command line if --vle-reloc-fixup is passed to ld. If the new ld command-line
option is not used, ld will ld warn on finding relocations inconsistent option is not used, ld will ld warn on finding relocations inconsistent
with the instructions being relocated. with the instructions being relocated.
* The nm program has a new command line option (--with-version-strings) * The nm program has a new command-line option (--with-version-strings)
which will display a symbol's version information, if any, after the which will display a symbol's version information, if any, after the
symbol's name. symbol's name.
@ -130,7 +130,7 @@ Changes in 2.25:
Changes in 2.24: Changes in 2.24:
* Objcopy now supports wildcard characters in command line options that take * Objcopy now supports wildcard characters in command-line options that take
section names. section names.
* Add support for Altera Nios II. * Add support for Altera Nios II.
@ -173,10 +173,10 @@ changes in 2.21:
* Add to dlltool .def file feature of aliasing PE internal symbol name by * Add to dlltool .def file feature of aliasing PE internal symbol name by
'== <ID>' option. '== <ID>' option.
* Add a new command line option -a / --addresses to addr2line to display the * Add a new command-line option -a / --addresses to addr2line to display the
address before function name or source filename. address before function name or source filename.
* Add a new command line option -p / --pretty-print to addr2line to have * Add a new command-line option -p / --pretty-print to addr2line to have
a more human readable output. a more human readable output.
* The hppa/som targets can now be compiled on any host. * The hppa/som targets can now be compiled on any host.
@ -189,14 +189,14 @@ Changes in 2.20:
from the static delayimp library, which will import LoadLibraryA and from the static delayimp library, which will import LoadLibraryA and
GetProcAddress from kernel32. GetProcAddress from kernel32.
* Add a new command line option, --insn-width=WIDTH, to objdump to specify * Add a new command-line option, --insn-width=WIDTH, to objdump to specify
number of bytes to be displayed on a single line when disassembling number of bytes to be displayed on a single line when disassembling
instructions. instructions.
* Readelf can now display the relocated contents of a section as a sequence * Readelf can now display the relocated contents of a section as a sequence
of bytes via the --relocated-dump=<name|number> command line option. of bytes via the --relocated-dump=<name|number> command-line option.
* The gprof program has been given a new command line option: * The gprof program has been given a new command-line option:
--external-symbols-table=<filename> which reads in symbols from a specified --external-symbols-table=<filename> which reads in symbols from a specified
file. file.
@ -207,7 +207,7 @@ Changes in 2.20:
for objcopy. for objcopy.
* Add --file-alignment, --heap, --image-base, --section-alignment, * Add --file-alignment, --heap, --image-base, --section-alignment,
--stack and --subsystem command line options to objcopy, which will --stack and --subsystem command-line options to objcopy, which will
set PE optional header. set PE optional header.
* Option --dwarf/-W of objdump is now as flexible as readelf --debug-dump/-w. * Option --dwarf/-W of objdump is now as flexible as readelf --debug-dump/-w.
@ -270,7 +270,7 @@ Changes in 2.18:
re-compiled by windres without lossing resources or compilation errors. re-compiled by windres without lossing resources or compilation errors.
Some problems on dialog resource translations are corrected. Some problems on dialog resource translations are corrected.
* Add --extract-symbol command line option to objcopy, which will * Add --extract-symbol command-line option to objcopy, which will
strip everything out of an ordinary object file or executable except strip everything out of an ordinary object file or executable except
for its symbol table. Files containing just symbols can be useful for its symbol table. Files containing just symbols can be useful
to some OSes. to some OSes.
@ -322,7 +322,7 @@ Changes in 2.16:
* readelf can now display address ranges from .debug_range sections. This * readelf can now display address ranges from .debug_range sections. This
happens automatically when a DW_AT_range attribute is encountered. The happens automatically when a DW_AT_range attribute is encountered. The
command line switch --debug-dump=Ranges (or -wR) can also be used to display command-line switch --debug-dump=Ranges (or -wR) can also be used to display
the contents of the .debug_range section. the contents of the .debug_range section.
* nm and objdump now have a switch "--special-syms" to enable the displaying of * nm and objdump now have a switch "--special-syms" to enable the displaying of
@ -404,17 +404,17 @@ Changes in version 2.12:
* readelf: Support added for DWARF 2.1 extensions. Support added for * readelf: Support added for DWARF 2.1 extensions. Support added for
displaying the contents of .debug.macinfo sections. displaying the contents of .debug.macinfo sections.
* New command line switches added to objcopy to allow symbols to be kept as * New command-line switches added to objcopy to allow symbols to be kept as
global symbols, and also to specify files containing lists of such symbols. global symbols, and also to specify files containing lists of such symbols.
by Honda Hiroki. by Honda Hiroki.
* Support for OpenRISC by Johan Rydberg. * Support for OpenRISC by Johan Rydberg.
* New command line switch to objcopy --alt-machine-code which creates a binary * New command-line switch to objcopy --alt-machine-code which creates a binary
with an alternate machine code if one is defined in the architecture with an alternate machine code if one is defined in the architecture
description. Only supported for ELF targets. By Alexandre Oliva. description. Only supported for ELF targets. By Alexandre Oliva.
* New command line switch to objcopy -B (or --binary-architecture) which sets * New command-line switch to objcopy -B (or --binary-architecture) which sets
the architecture of the output file to the given argument. This option only the architecture of the output file to the given argument. This option only
makes sense, if the input target is binary. Otherwise it is ignored. makes sense, if the input target is binary. Otherwise it is ignored.
By Stefan Geuken. By Stefan Geuken.
@ -426,7 +426,7 @@ Changes in binutils 2.11:
* Add support for ARM v5t and v5te architectures and Intel's XScale ARM * Add support for ARM v5t and v5te architectures and Intel's XScale ARM
extenstions. extenstions.
* Add --srec-len and --srec-forceS3 command line switch to objcopy. * Add --srec-len and --srec-forceS3 command-line switch to objcopy.
By Luciano Gemme. By Luciano Gemme.
* Support for the MIPS32, by Anders Norlander. * Support for the MIPS32, by Anders Norlander.
@ -439,11 +439,11 @@ Changes in binutils 2.10:
* Support for 64-bit ELF on HPPA. * Support for 64-bit ELF on HPPA.
* New command line switch to objdump --file-start-context which shows the * New command-line switch to objdump --file-start-context which shows the
entire file contents up to the source line first encountered for a given entire file contents up to the source line first encountered for a given
file. file.
* New command line switch to objdump -M (or --disassembler-options) which takes * New command-line switch to objdump -M (or --disassembler-options) which takes
a parameter which can then be interpreted on a per-target basis by the a parameter which can then be interpreted on a per-target basis by the
disassembler. Used by ARM targets to select register name sets, ISA, APCS or disassembler. Used by ARM targets to select register name sets, ISA, APCS or
raw verions. raw verions.

38
binutils/doc/binutils.texi
View file

@ -520,13 +520,13 @@ when the modifier @samp{v} is appended.
This modifier shows the version number of @command{ar}. This modifier shows the version number of @command{ar}.
@end table @end table
The @command{ar} program also supports some command line options which The @command{ar} program also supports some command-line options which
are neither modifiers nor actions, but which do change its behaviour are neither modifiers nor actions, but which do change its behaviour
in specific ways: in specific ways:
@table @samp @table @samp
@item --help @item --help
Displays the list of command line options supported by @command{ar} Displays the list of command-line options supported by @command{ar}
and then exits. and then exits.
@item --version @item --version
@ -541,7 +541,7 @@ of the other @samp{-X} options; in particular, it does not support
@item --plugin @var{name} @item --plugin @var{name}
@cindex plugins @cindex plugins
The optional command line switch @option{--plugin @var{name}} causes The optional command-line switch @option{--plugin @var{name}} causes
@command{ar} to load the plugin called @var{name} which adds support @command{ar} to load the plugin called @var{name} which adds support
for more file formats, including object files with link-time for more file formats, including object files with link-time
optimization information. optimization information.
@ -564,7 +564,7 @@ is always backwards compatible with earlier versions, so it is
sufficient to just copy the newest one. sufficient to just copy the newest one.
@item --target @var{target} @item --target @var{target}
The optional command line switch @option{--target @var{bfdname}} The optional command-line switch @option{--target @var{bfdname}}
specifies that the archive members are in an object code format specifies that the archive members are in an object code format
different from your system's default format. See different from your system's default format. See
@xref{Target Selection}, for more information. @xref{Target Selection}, for more information.
@ -2852,7 +2852,7 @@ If none are specified, the file @code{a.out} will be used.
@c man begin OPTIONS size @c man begin OPTIONS size
The command line options have the following meanings: The command-line options have the following meanings:
@table @env @table @env
@item -A @item -A
@ -2980,7 +2980,7 @@ data sections. If the file type in unrecognizable, or if strings is
reading from stdin then it will always display all of the printable reading from stdin then it will always display all of the printable
sequences that it can find. sequences that it can find.
For backwards compatibility any file that occurs after a command line For backwards compatibility any file that occurs after a command-line
option of just @option{-} will also be scanned in full, regardless of option of just @option{-} will also be scanned in full, regardless of
the presence of any @option{-d} option. the presence of any @option{-d} option.
@ -3430,7 +3430,7 @@ If no @var{symbol} arguments are given, @command{c++filt} reads symbol
names from the standard input instead. All the results are printed on names from the standard input instead. All the results are printed on
the standard output. The difference between reading names from the the standard output. The difference between reading names from the
command line versus reading names from the standard input is that command line versus reading names from the standard input is that
command line arguments are expected to be just mangled names and no command-line arguments are expected to be just mangled names and no
checking is performed to separate them from surrounding text. Thus checking is performed to separate them from surrounding text. Thus
for example: for example:
@ -3804,7 +3804,7 @@ current directory.
@item -H @item -H
@itemx --help @itemx --help
Displays a list of command line options and then exits. Displays a list of command-line options and then exits.
@item -m @var{characters} @item -m @var{characters}
@itemx --maxlength @var{characters} @itemx --maxlength @var{characters}
@ -4166,7 +4166,7 @@ which in turn will import LoadLibraryA and GetProcAddress from kernel32.
@command{dlltool} builds the library file by hand, but it builds the @command{dlltool} builds the library file by hand, but it builds the
exports file by creating temporary files containing assembler statements exports file by creating temporary files containing assembler statements
and then assembling these. The @option{-S} command line option can be and then assembling these. The @option{-S} command-line option can be
used to specify the path to the assembler that dlltool will use, used to specify the path to the assembler that dlltool will use,
and the @option{-f} option can be used to pass specific flags to that and the @option{-f} option can be used to pass specific flags to that
assembler. The @option{-n} can be used to prevent dlltool from deleting assembler. The @option{-n} can be used to prevent dlltool from deleting
@ -4194,7 +4194,7 @@ description of the @option{-I} or @option{--identify} option.
@c man begin OPTIONS dlltool @c man begin OPTIONS dlltool
The command line options have the following meanings: The command-line options have the following meanings:
@table @env @table @env
@ -4260,7 +4260,7 @@ to create the exports file.
@item -f @var{options} @item -f @var{options}
@itemx --as-flags @var{options} @itemx --as-flags @var{options}
Specifies any specific command line options to be passed to the Specifies any specific command-line options to be passed to the
assembler when building the exports file. This option will work even if assembler when building the exports file. This option will work even if
the @option{-S} option is not used. This option only takes one argument, the @option{-S} option is not used. This option only takes one argument,
and if it occurs more than once on the command line, then later and if it occurs more than once on the command line, then later
@ -4387,7 +4387,7 @@ Make dlltool describe what it is doing.
@item -h @item -h
@itemx --help @itemx --help
Displays a list of command line options and then exits. Displays a list of command-line options and then exits.
@item -V @item -V
@itemx --version @itemx --version
@ -4695,7 +4695,7 @@ single line, which is far more readable on terminals wider than 80 columns.
@item -H @item -H
@itemx --help @itemx --help
Display the command line options understood by @command{readelf}. Display the command-line options understood by @command{readelf}.
@end table @end table
@ -4789,7 +4789,7 @@ Display the version number of @command{elfedit}.
@item -h @item -h
@itemx --help @itemx --help
Display the command line options understood by @command{elfedit}. Display the command-line options understood by @command{elfedit}.
@end table @end table
@ -4882,7 +4882,7 @@ Ways to specify:
@enumerate @enumerate
@item @item
command line option: @option{-b} or @option{--target} command-line option: @option{-b} or @option{--target}
@item @item
environment variable @code{GNUTARGET} environment variable @code{GNUTARGET}
@ -4897,7 +4897,7 @@ Ways to specify:
@enumerate @enumerate
@item @item
command line options: @option{-I} or @option{--input-target}, or @option{-F} or @option{--target} command-line options: @option{-I} or @option{--input-target}, or @option{-F} or @option{--target}
@item @item
environment variable @code{GNUTARGET} environment variable @code{GNUTARGET}
@ -4912,7 +4912,7 @@ Ways to specify:
@enumerate @enumerate
@item @item
command line options: @option{-O} or @option{--output-target}, or @option{-F} or @option{--target} command-line options: @option{-O} or @option{--output-target}, or @option{-F} or @option{--target}
@item @item
the input target (see ``@command{objcopy} and @command{strip} Input Target'' above) the input target (see ``@command{objcopy} and @command{strip} Input Target'' above)
@ -4930,7 +4930,7 @@ Ways to specify:
@enumerate @enumerate
@item @item
command line option: @option{--target} command-line option: @option{--target}
@item @item
environment variable @code{GNUTARGET} environment variable @code{GNUTARGET}
@ -4957,7 +4957,7 @@ Ways to specify:
@enumerate @enumerate
@item @item
command line option: @option{-m} or @option{--architecture} command-line option: @option{-m} or @option{--architecture}
@item @item
deduced from the input file deduced from the input file

36
gas/ChangeLog
View file

@ -1,3 +1,39 @@
2018-07-02 Thomas Preud'homme <thomas.preudhomme@arm.com>
* NEWS: Use command-line consistently when used in a compount word.
* doc/as.texi: Likewise.
* doc/c-aarch64.texi: Likewise.
* doc/c-alpha.texi: Likewise.
* doc/c-arc.texi: Likewise.
* doc/c-arm.texi: Likewise.
* doc/c-avr.texi: Likewise.
* doc/c-bfin.texi: Likewise.
* doc/c-cris.texi: Likewise.
* doc/c-epiphany.texi: Likewise.
* doc/c-i386.texi: Likewise.
* doc/c-ia64.texi: Likewise.
* doc/c-lm32.texi: Likewise.
* doc/c-m32r.texi: Likewise.
* doc/c-m68k.texi: Likewise.
* doc/c-mips.texi: Likewise.
* doc/c-mmix.texi: Likewise.
* doc/c-msp430.texi: Likewise.
* doc/c-mt.texi: Likewise.
* doc/c-nios2.texi: Likewise.
* doc/c-ppc.texi: Likewise.
* doc/c-pru.texi: Likewise.
* doc/c-rl78.texi: Likewise.
* doc/c-rx.texi: Likewise.
* doc/c-tic6x.texi: Likewise.
* doc/c-v850.texi: Likewise.
* doc/c-vax.texi: Likewise.
* doc/c-visium.texi: Likewise.
* doc/c-xstormy16.texi: Likewise.
* doc/c-xtensa.texi: Likewise.
* doc/c-z80.texi: Likewise.
* doc/c-z8k.texi: Likewise.
* doc/internals.texi: Likewise.
2018-06-29 Jim Wilson <jimw@sifive.com> 2018-06-29 Jim Wilson <jimw@sifive.com>
* config/tc-riscv.c (md_begin): Call hash_reg_name for "fp". * config/tc-riscv.c (md_begin): Call hash_reg_name for "fp".

42
gas/NEWS
View file

@ -70,7 +70,7 @@ Changes in 2.27:
assembler should generate common symbols with the STT_COMMON type by assembler should generate common symbols with the STT_COMMON type by
default. Default to no. default. Default to no.
* New command line option --elf-stt-common= for ELF targets to control * New command-line option --elf-stt-common= for ELF targets to control
whether to generate common symbols with the STT_COMMON type. whether to generate common symbols with the STT_COMMON type.
* Add ability to set section flags and types via numeric values for ELF * Add ability to set section flags and types via numeric values for ELF
@ -80,10 +80,10 @@ Changes in 2.27:
x86 assembler should generate relax relocations by default. Default to x86 assembler should generate relax relocations by default. Default to
yes, except for x86 Solaris targets older than Solaris 12. yes, except for x86 Solaris targets older than Solaris 12.
* New command line option -mrelax-relocations= for x86 target to control * New command-line option -mrelax-relocations= for x86 target to control
whether to generate relax relocations. whether to generate relax relocations.
* New command line option -mfence-as-lock-add=yes for x86 target to encode * New command-line option -mfence-as-lock-add=yes for x86 target to encode
lfence, mfence and sfence as "lock addl $0x0, (%[re]sp)". lfence, mfence and sfence as "lock addl $0x0, (%[re]sp)".
* Add assembly-time relaxation option for ARC cpus. * Add assembly-time relaxation option for ARC cpus.
@ -127,7 +127,7 @@ Changes in 2.25:
* Replace support for openrisc and or32 with support for or1k. * Replace support for openrisc and or32 with support for or1k.
* Enhanced the ARM port to accept the assembler output from the CodeComposer * Enhanced the ARM port to accept the assembler output from the CodeComposer
Studio tool. Support is enabled via the new command line option -mccs. Studio tool. Support is enabled via the new command-line option -mccs.
* Add support for the Andes NDS32. * Add support for the Andes NDS32.
@ -135,7 +135,7 @@ Changes in 2.24:
* Add support for the Texas Instruments MSP430X processor. * Add support for the Texas Instruments MSP430X processor.
* Add -gdwarf-sections command line option to enable per-code-section * Add -gdwarf-sections command-line option to enable per-code-section
generation of DWARF .debug_line sections. generation of DWARF .debug_line sections.
* Add support for Altera Nios II. * Add support for Altera Nios II.
@ -182,7 +182,7 @@ Changes in 2.21:
* Add support for the Renesas RX processor. * Add support for the Renesas RX processor.
* New command line option, --compress-debug-sections, which requests * New command-line option, --compress-debug-sections, which requests
compression of DWARF debug information sections in the relocatable output compression of DWARF debug information sections in the relocatable output
file. Compressed debug sections are supported by readelf, objdump, and file. Compressed debug sections are supported by readelf, objdump, and
gold, but not currently by Gnu ld. gold, but not currently by Gnu ld.
@ -219,23 +219,23 @@ Changes in 2.19:
* New pseudo op .cfi_val_encoded_addr, to record constant addresses in unwind * New pseudo op .cfi_val_encoded_addr, to record constant addresses in unwind
tables without runtime relocation. tables without runtime relocation.
* New command line option, -h-tick-hex, for sh, m32c, and h8/300 targets, which * New command-line option, -h-tick-hex, for sh, m32c, and h8/300 targets, which
adds compatibility with H'00 style hex constants. adds compatibility with H'00 style hex constants.
* New command line option, -msse-check=[none|error|warning], for x86 * New command-line option, -msse-check=[none|error|warning], for x86
targets. targets.
* New sub-option added to the assembler's -a command line switch to * New sub-option added to the assembler's -a command-line switch to
generate a listing output. The 'g' sub-option will insert into the listing generate a listing output. The 'g' sub-option will insert into the listing
various information about the assembly, such as assembler version, the various information about the assembly, such as assembler version, the
command line options used, and a time stamp. command-line options used, and a time stamp.
* New command line option -msse2avx for x86 target to encode SSE * New command-line option -msse2avx for x86 target to encode SSE
instructions with VEX prefix. instructions with VEX prefix.
* Add Intel XSAVE, EPT, MOVBE, AES, PCLMUL, AVX/FMA support for x86 target. * Add Intel XSAVE, EPT, MOVBE, AES, PCLMUL, AVX/FMA support for x86 target.
* New command line options, -march=CPU[,+EXTENSION...], -mtune=CPU, * New command-line options, -march=CPU[,+EXTENSION...], -mtune=CPU,
-mmnemonic=[att|intel], -msyntax=[att|intel], -mindex-reg, -mmnemonic=[att|intel], -msyntax=[att|intel], -mindex-reg,
-mnaked-reg and -mold-gcc, for x86 targets. -mnaked-reg and -mold-gcc, for x86 targets.
@ -268,7 +268,7 @@ Changes in 2.17:
* Add support for the "@<file>" syntax to the command line, so that extra * Add support for the "@<file>" syntax to the command line, so that extra
switches can be read from <file>. switches can be read from <file>.
* The SH target supports a new command line switch --enable-reg-prefix which, * The SH target supports a new command-line switch --enable-reg-prefix which,
if enabled, will allow register names to be optionally prefixed with a $ if enabled, will allow register names to be optionally prefixed with a $
character. This allows register names to be distinguished from label names. character. This allows register names to be distinguished from label names.
@ -289,15 +289,15 @@ Changes in 2.17:
for the VAX target in order to be more compatible with the VAX MACRO for the VAX target in order to be more compatible with the VAX MACRO
assembler. assembler.
* New command line option -mtune=[itanium1|itanium2] for IA64 targets. * New command-line option -mtune=[itanium1|itanium2] for IA64 targets.
Changes in 2.16: Changes in 2.16:
* Redefinition of macros now results in an error. * Redefinition of macros now results in an error.
* New command line option -mhint.b=[ok|warning|error] for IA64 targets. * New command-line option -mhint.b=[ok|warning|error] for IA64 targets.
* New command line option -munwind-check=[warning|error] for IA64 * New command-line option -munwind-check=[warning|error] for IA64
targets. targets.
* The IA64 port now uses automatic dependency violation removal as its default * The IA64 port now uses automatic dependency violation removal as its default
@ -307,7 +307,7 @@ Changes in 2.16:
* Added support for generating unwind tables for ARM ELF targets. * Added support for generating unwind tables for ARM ELF targets.
* Add a -g command line option to generate debug information in the target's * Add a -g command-line option to generate debug information in the target's
preferred debug format. preferred debug format.
* Support for the crx-elf target added. * Support for the crx-elf target added.
@ -322,9 +322,9 @@ Changes in 2.16:
* Support for ColdFire EMAC instructions added and Motorola syntax for MAC/EMAC * Support for ColdFire EMAC instructions added and Motorola syntax for MAC/EMAC
instrucitons. instrucitons.
* New command line option -mno-shared for MIPS ELF targets. * New command-line option -mno-shared for MIPS ELF targets.
* New command line option --alternate and pseudo-ops .altmacro and .noaltmacro * New command-line option --alternate and pseudo-ops .altmacro and .noaltmacro
added to enter (and leave) alternate macro syntax mode. added to enter (and leave) alternate macro syntax mode.
Changes in 2.15: Changes in 2.15:
@ -418,7 +418,7 @@ Changes in 2.12:
but still works for compatability. but still works for compatability.
* The MIPS assembler no longer issues a warning by default when it * The MIPS assembler no longer issues a warning by default when it
generates a nop instruction from a macro. The new command line option generates a nop instruction from a macro. The new command-line option
-n will turn on the warning. -n will turn on the warning.
Changes in 2.11: Changes in 2.11:
@ -441,7 +441,7 @@ Changes in 2.11:
* x86 gas has a new .arch pseudo op to specify the target CPU architecture. * x86 gas has a new .arch pseudo op to specify the target CPU architecture.
* x86 gas -q command line option quietens warnings about register size changes * x86 gas -q command-line option quietens warnings about register size changes
due to suffix, indirect jmp/call without `*', stand-alone prefixes, and due to suffix, indirect jmp/call without `*', stand-alone prefixes, and
translating various deprecated floating point instructions. translating various deprecated floating point instructions.

18
gas/doc/as.texi
View file

@ -757,7 +757,7 @@ configure option.
@end ifset @end ifset
@item --help @item --help
Print a summary of the command line options and exit. Print a summary of the command-line options and exit.
@item --target-help @item --target-help
Print a summary of all target specific options and exit. Print a summary of all target specific options and exit.
@ -1607,12 +1607,12 @@ an MCore processor.
@item -jsri2bsr @item -jsri2bsr
@itemx -nojsri2bsr @itemx -nojsri2bsr
Enable or disable the JSRI to BSR transformation. By default this is enabled. Enable or disable the JSRI to BSR transformation. By default this is enabled.
The command line option @samp{-nojsri2bsr} can be used to disable it. The command-line option @samp{-nojsri2bsr} can be used to disable it.
@item -sifilter @item -sifilter
@itemx -nosifilter @itemx -nosifilter
Enable or disable the silicon filter behaviour. By default this is disabled. Enable or disable the silicon filter behaviour. By default this is disabled.
The default can be overridden by the @samp{-sifilter} command line option. The default can be overridden by the @samp{-sifilter} command-line option.
@item -relax @item -relax
Alter jump instructions for long displacements. Alter jump instructions for long displacements.
@ -2011,7 +2011,7 @@ significant.
explicitly, as one of the files for @command{@value{AS}} to assemble. explicitly, as one of the files for @command{@value{AS}} to assemble.
@cindex options, command line @cindex options, command line
Except for @samp{--} any command line argument that begins with a Except for @samp{--} any command-line argument that begins with a
hyphen (@samp{-}) is an option. Each option changes the behavior of hyphen (@samp{-}) is an option. Each option changes the behavior of
@command{@value{AS}}. No option changes the way another option works. An @command{@value{AS}}. No option changes the way another option works. An
option is a @samp{-} followed by one or more letters; the case of option is a @samp{-} followed by one or more letters; the case of
@ -2050,7 +2050,7 @@ program. The source program is made up of one or more files.
You give @command{@value{AS}} a command line that has zero or more input file You give @command{@value{AS}} a command line that has zero or more input file
names. The input files are read (from left file name to right). A names. The input files are read (from left file name to right). A
command line argument (in any position) that has no special meaning command-line argument (in any position) that has no special meaning
is taken to be an input file name. is taken to be an input file name.
If you give @command{@value{AS}} no file names it attempts to read one input file If you give @command{@value{AS}} no file names it attempts to read one input file
@ -2288,7 +2288,7 @@ The letters after @samp{-a} may be combined into one option,
Note if the assembler source is coming from the standard input (e.g., Note if the assembler source is coming from the standard input (e.g.,
because it 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
stdin only after they have been preprocessed by the assembler. This reduces stdin only after they have been preprocessed by the assembler. This reduces
@ -2383,7 +2383,7 @@ in the object file. Usually if you do this you also tell the linker
@node listing @node listing
@section Configuring listing output: @option{--listing} @section Configuring listing output: @option{--listing}
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 them as a listing file. The format of this listing can be controlled by
@ -2777,7 +2777,7 @@ specific, and some targets multiple comment characters. Some targets also have
line comment characters that only work if they are the first character on a line comment characters that only work if they are the first character on a
line. Some targets use a sequence of two characters to introduce a line line. Some targets use a sequence of two characters to introduce a line
comment. Some targets can also change their line comment characters depending comment. Some targets can also change their line comment characters depending
upon command line options that have been used. For more details see the upon command-line options that have been used. For more details see the
@emph{Syntax} section in the documentation for individual targets. @emph{Syntax} section in the documentation for individual targets.
If the line comment character is the hash sign (@samp{#}) then it still has the If the line comment character is the hash sign (@samp{#}) then it still has the
@ -5700,7 +5700,7 @@ counter, and @code{.nolist} decrements it. Assembly listings are
generated whenever the counter is greater than zero. generated whenever the counter is greater than zero.
By default, listings are disabled. When you enable them (with the By default, listings are disabled. When you enable them (with the
@samp{-a} command line option; @pxref{Invoking,,Command-Line Options}), @samp{-a} command-line option; @pxref{Invoking,,Command-Line Options}),
the initial value of the listing counter is one. the initial value of the listing counter is one.
@node Ln @node Ln

20
gas/doc/c-aarch64.texi
View file

@ -34,23 +34,23 @@
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @option{-EB} command line option, AArch64 @cindex @option{-EB} command-line option, AArch64
@item -EB @item -EB
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as being encoded for a big-endian processor. be marked as being encoded for a big-endian processor.
@cindex @option{-EL} command line option, AArch64 @cindex @option{-EL} command-line option, AArch64
@item -EL @item -EL
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as being encoded for a little-endian processor. be marked as being encoded for a little-endian processor.
@cindex @option{-mabi=} command line option, AArch64 @cindex @option{-mabi=} command-line option, AArch64
@item -mabi=@var{abi} @item -mabi=@var{abi}
Specify which ABI the source code uses. The recognized arguments Specify which ABI the source code uses. The recognized arguments
are: @code{ilp32} and @code{lp64}, which decides the generated object are: @code{ilp32} and @code{lp64}, which decides the generated object
file in ELF32 and ELF64 format respectively. The default is @code{lp64}. file in ELF32 and ELF64 format respectively. The default is @code{lp64}.
@cindex @option{-mcpu=} command line option, AArch64 @cindex @option{-mcpu=} command-line option, AArch64
@item -mcpu=@var{processor}[+@var{extension}@dots{}] @item -mcpu=@var{processor}[+@var{extension}@dots{}]
This option specifies the target processor. The assembler will issue an error This option specifies the target processor. The assembler will issue an error
message if an attempt is made to assemble an instruction which will not execute message if an attempt is made to assemble an instruction which will not execute
@ -85,7 +85,7 @@ extension, then then those extensions are automatically enabled.
Consequently, you will not normally have to specify any additional Consequently, you will not normally have to specify any additional
extensions. extensions.
@cindex @option{-march=} command line option, AArch64 @cindex @option{-march=} command-line option, AArch64
@item -march=@var{architecture}[+@var{extension}@dots{}] @item -march=@var{architecture}[+@var{extension}@dots{}]
This option specifies the target architecture. The assembler will This option specifies the target architecture. The assembler will
issue an error message if an attempt is made to assemble an issue an error message if an attempt is made to assemble an
@ -102,12 +102,12 @@ extension options as the @option{-mcpu} option. Unlike
@option{-mcpu}, extensions are not always enabled by default, @option{-mcpu}, extensions are not always enabled by default,
@xref{AArch64 Extensions}. @xref{AArch64 Extensions}.
@cindex @code{-mverbose-error} command line option, AArch64 @cindex @code{-mverbose-error} command-line option, AArch64
@item -mverbose-error @item -mverbose-error
This option enables verbose error messages for AArch64 gas. This option This option enables verbose error messages for AArch64 gas. This option
is enabled by default. is enabled by default.
@cindex @code{-mno-verbose-error} command line option, AArch64 @cindex @code{-mno-verbose-error} command-line option, AArch64
@item -mno-verbose-error @item -mno-verbose-error
This option disables verbose error messages in AArch64 gas. This option disables verbose error messages in AArch64 gas.
@ -285,7 +285,7 @@ The AArch64 architecture uses @sc{ieee} floating-point numbers.
@cindex @code{.arch} directive, AArch64 @cindex @code{.arch} directive, AArch64
@item .arch @var{name} @item .arch @var{name}
Select the target architecture. Valid values for @var{name} are the same as Select the target architecture. Valid values for @var{name} are the same as
for the @option{-march} commandline option. for the @option{-march} command-line option.
Specifying @code{.arch} clears any previously selected architecture Specifying @code{.arch} clears any previously selected architecture
extensions. extensions.
@ -294,7 +294,7 @@ extensions.
@item .arch_extension @var{name} @item .arch_extension @var{name}
Add or remove an architecture extension to the target architecture. Valid Add or remove an architecture extension to the target architecture. Valid
values for @var{name} are the same as those accepted as architectural values for @var{name} are the same as those accepted as architectural
extensions by the @option{-mcpu} commandline option. extensions by the @option{-mcpu} command-line option.
@code{.arch_extension} may be used multiple times to add or remove extensions @code{.arch_extension} may be used multiple times to add or remove extensions
incrementally to the architecture being compiled for. incrementally to the architecture being compiled for.
@ -310,7 +310,7 @@ This directive switches to the @code{.bss} section.
@cindex @code{.cpu} directive, AArch64 @cindex @code{.cpu} directive, AArch64
@item .cpu @var{name} @item .cpu @var{name}
Set the target processor. Valid values for @var{name} are the same as Set the target processor. Valid values for @var{name} are the same as
those accepted by the @option{-mcpu=} command line option. those accepted by the @option{-mcpu=} command-line option.
@c DDDDDDDDDDDDDDDDDDDDDDDDDD @c DDDDDDDDDDDDDDDDDDDDDDDDDD

20
gas/doc/c-alpha.texi
View file

@ -40,7 +40,7 @@ features specific to these formats are not yet documented.
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @code{-m@var{cpu}} command line option, Alpha @cindex @code{-m@var{cpu}} command-line option, Alpha
@item -m@var{cpu} @item -m@var{cpu}
This option specifies the target processor. If an attempt is made to This option specifies the target processor. If an attempt is made to
assemble an instruction which will not execute on the target processor, assemble an instruction which will not execute on the target processor,
@ -75,15 +75,15 @@ and existing practice within @command{MILO} (the Linux ARC bootloader), the
numbered processor names (e.g.@: 21064) enable the processor-specific PALcode numbered processor names (e.g.@: 21064) enable the processor-specific PALcode
instructions, while the ``electro-vlasic'' names (e.g.@: @code{ev4}) do not. instructions, while the ``electro-vlasic'' names (e.g.@: @code{ev4}) do not.
@cindex @code{-mdebug} command line option, Alpha @cindex @code{-mdebug} command-line option, Alpha
@cindex @code{-no-mdebug} command line option, Alpha @cindex @code{-no-mdebug} command-line option, Alpha
@item -mdebug @item -mdebug
@itemx -no-mdebug @itemx -no-mdebug
Enables or disables the generation of @code{.mdebug} encapsulation for Enables or disables the generation of @code{.mdebug} encapsulation for
stabs directives and procedure descriptors. The default is to automatically stabs directives and procedure descriptors. The default is to automatically
enable @code{.mdebug} when the first stabs directive is seen. enable @code{.mdebug} when the first stabs directive is seen.
@cindex @code{-relax} command line option, Alpha @cindex @code{-relax} command-line option, Alpha
@item -relax @item -relax
This option forces all relocations to be put into the object file, instead This option forces all relocations to be put into the object file, instead
of saving space and resolving some relocations at assembly time. Note that of saving space and resolving some relocations at assembly time. Note that
@ -91,8 +91,8 @@ this option does not propagate all symbol arithmetic into the object file,
because not all symbol arithmetic can be represented. However, the option because not all symbol arithmetic can be represented. However, the option
can still be useful in specific applications. can still be useful in specific applications.
@cindex @code{-replace} command line option, Alpha @cindex @code{-replace} command-line option, Alpha
@cindex @code{-noreplace} command line option, Alpha @cindex @code{-noreplace} command-line option, Alpha
@item -replace @item -replace
@itemx -noreplace @itemx -noreplace
Enables or disables the optimization of procedure calls, both at assemblage Enables or disables the optimization of procedure calls, both at assemblage
@ -100,20 +100,20 @@ and at link time. These options are only available for VMS targets and
@code{-replace} is the default. See section 1.4.1 of the OpenVMS Linker @code{-replace} is the default. See section 1.4.1 of the OpenVMS Linker
Utility Manual. Utility Manual.
@cindex @code{-g} command line option, Alpha @cindex @code{-g} command-line option, Alpha
@item -g @item -g
This option is used when the compiler generates debug information. When This option is used when the compiler generates debug information. When
@command{gcc} is using @command{mips-tfile} to generate debug @command{gcc} is using @command{mips-tfile} to generate debug
information for ECOFF, local labels must be passed through to the object information for ECOFF, local labels must be passed through to the object
file. Otherwise this option has no effect. file. Otherwise this option has no effect.
@cindex @code{-G} command line option, Alpha @cindex @code{-G} command-line option, Alpha
@item -G@var{size} @item -G@var{size}
A local common symbol larger than @var{size} is placed in @code{.bss}, A local common symbol larger than @var{size} is placed in @code{.bss},
while smaller symbols are placed in @code{.sbss}. while smaller symbols are placed in @code{.sbss}.
@cindex @code{-F} command line option, Alpha @cindex @code{-F} command-line option, Alpha
@cindex @code{-32addr} command line option, Alpha @cindex @code{-32addr} command-line option, Alpha
@item -F @item -F
@itemx -32addr @itemx -32addr
These options are ignored for backward compatibility. These options are ignored for backward compatibility.

36
gas/doc/c-arc.texi
View file

@ -36,14 +36,14 @@ assembled, and generic constraints on the code generated:
@table @code @table @code
@item -mcpu=@var{cpu} @item -mcpu=@var{cpu}
@cindex @code{-mcpu=@var{cpu}} command line option, ARC @cindex @code{-mcpu=@var{cpu}} command-line option, ARC
Set architecture type and register usage for @var{cpu}. There are Set architecture type and register usage for @var{cpu}. There are
also shortcut alias options available for backward compatibility and also shortcut alias options available for backward compatibility and
convenience. Supported values for @var{cpu} are convenience. Supported values for @var{cpu} are
@table @code @table @code
@cindex @code{mA6} command line option, ARC @cindex @code{mA6} command-line option, ARC
@cindex @code{marc600} command line option, ARC @cindex @code{marc600} command-line option, ARC
@item arc600 @item arc600
Assemble for ARC 600. Aliases: @code{-mA6}, @code{-mARC600}. Assemble for ARC 600. Aliases: @code{-mA6}, @code{-mARC600}.
@ -57,7 +57,7 @@ Assemble for ARC 600 with mul64 instructions.
Assemble for ARC 600 with mul32x16 instructions. Assemble for ARC 600 with mul32x16 instructions.
@item arc601 @item arc601
@cindex @code{mARC601} command line option, ARC @cindex @code{mARC601} command-line option, ARC
Assemble for ARC 601. Alias: @code{-mARC601}. Assemble for ARC 601. Alias: @code{-mARC601}.
@item arc601_norm @item arc601_norm
@ -70,12 +70,12 @@ Assemble for ARC 601 with mul64 instructions.
Assemble for ARC 601 with mul32x16 instructions. Assemble for ARC 601 with mul32x16 instructions.
@item arc700 @item arc700
@cindex @code{mA7} command line option, ARC @cindex @code{mA7} command-line option, ARC
@cindex @code{mARC700} command line option, ARC @cindex @code{mARC700} command-line option, ARC
Assemble for ARC 700. Aliases: @code{-mA7}, @code{-mARC700}. Assemble for ARC 700. Aliases: @code{-mA7}, @code{-mARC700}.
@item arcem @item arcem
@cindex @code{mEM} command line option, ARC @cindex @code{mEM} command-line option, ARC
Assemble for ARC EM. Aliases: @code{-mEM} Assemble for ARC EM. Aliases: @code{-mEM}
@item em @item em
@ -98,7 +98,7 @@ instructions.
Assemble for QuarkSE-EM cpu. Assemble for QuarkSE-EM cpu.
@item archs @item archs
@cindex @code{mHS} command line option, ARC @cindex @code{mHS} command-line option, ARC
Assemble for ARC HS. Aliases: @code{-mHS}, @code{-mav2hs}. Assemble for ARC HS. Aliases: @code{-mHS}, @code{-mav2hs}.
@item hs @item hs
@ -114,7 +114,7 @@ Assemble for ARC HS38.
Assemble for ARC HS38 with floating point support on. Assemble for ARC HS38 with floating point support on.
@item nps400 @item nps400
@cindex @code{mnps400} command line option, ARC @cindex @code{mnps400} command-line option, ARC
Assemble for ARC 700 with NPS-400 extended instructions. Assemble for ARC 700 with NPS-400 extended instructions.
@end table @end table
@ -122,41 +122,41 @@ Assemble for ARC 700 with NPS-400 extended instructions.
Note: the @code{.cpu} directive (@pxref{ARC Directives}) can Note: the @code{.cpu} directive (@pxref{ARC Directives}) can
to be used to select a core variant from within assembly code. to be used to select a core variant from within assembly code.
@cindex @code{-EB} command line option, ARC @cindex @code{-EB} command-line option, ARC
@item -EB @item -EB
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as being encoded for a big-endian processor. be marked as being encoded for a big-endian processor.
@cindex @code{-EL} command line option, ARC @cindex @code{-EL} command-line option, ARC
@item -EL @item -EL
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as being encoded for a little-endian processor - this is the be marked as being encoded for a little-endian processor - this is the
default. default.
@cindex @code{-mcode-density} command line option, ARC @cindex @code{-mcode-density} command-line option, ARC
@item -mcode-density @item -mcode-density
This option turns on Code Density instructions. Only valid for ARC EM This option turns on Code Density instructions. Only valid for ARC EM
processors. processors.
@cindex @code{-mrelax} command line option, ARC @cindex @code{-mrelax} command-line option, ARC
@item -mrelax @item -mrelax
Enable support for assembly-time relaxation. The assembler will Enable support for assembly-time relaxation. The assembler will
replace a longer version of an instruction with a shorter one, replace a longer version of an instruction with a shorter one,
whenever it is possible. whenever it is possible.
@cindex @code{-mnps400} command line option, ARC @cindex @code{-mnps400} command-line option, ARC
@item -mnps400 @item -mnps400
Enable support for NPS-400 extended instructions. Enable support for NPS-400 extended instructions.
@cindex @code{-mspfp} command line option, ARC @cindex @code{-mspfp} command-line option, ARC
@item -mspfp @item -mspfp
Enable support for single-precision floating point instructions. Enable support for single-precision floating point instructions.
@cindex @code{-mdpfp} command line option, ARC @cindex @code{-mdpfp} command-line option, ARC
@item -mdpfp @item -mdpfp
Enable support for double-precision floating point instructions. Enable support for double-precision floating point instructions.
@cindex @code{-mfpuda} command line option, ARC @cindex @code{-mfpuda} command-line option, ARC
@item -mfpuda @item -mfpuda
Enable support for double-precision assist floating point instructions. Enable support for double-precision assist floating point instructions.
Only valid for ARC EM processors. Only valid for ARC EM processors.
@ -486,7 +486,7 @@ Assemble for ARC HS38 with floating point support on.
@end table @end table
Note: the @code{.cpu} directive overrides the command line option Note: the @code{.cpu} directive overrides the command-line option
@code{-mcpu=@var{cpu}}; a warning is emitted when the version is not @code{-mcpu=@var{cpu}}; a warning is emitted when the version is not
consistent between the two. consistent between the two.

48
gas/doc/c-arm.texi
View file

@ -32,7 +32,7 @@
@table @code @table @code
@cindex @code{-mcpu=} command line option, ARM @cindex @code{-mcpu=} command-line option, ARM
@item -mcpu=@var{processor}[+@var{extension}@dots{}] @item -mcpu=@var{processor}[+@var{extension}@dots{}]
This option specifies the target processor. The assembler will issue an This option specifies the target processor. The assembler will issue an
error message if an attempt is made to assemble an instruction which error message if an attempt is made to assemble an instruction which
@ -201,7 +201,7 @@ for v8-A architecture),
and and
@code{xscale}. @code{xscale}.
@cindex @code{-march=} command line option, ARM @cindex @code{-march=} command-line option, ARM
@item -march=@var{architecture}[+@var{extension}@dots{}] @item -march=@var{architecture}[+@var{extension}@dots{}]
This option specifies the target architecture. The assembler will issue This option specifies the target architecture. The assembler will issue
an error message if an attempt is made to assemble an instruction which an error message if an attempt is made to assemble an instruction which
@ -252,7 +252,7 @@ the setting for @code{-mcpu}.
The architecture option can be extended with the same instruction set The architecture option can be extended with the same instruction set
extension options as the @code{-mcpu} option. extension options as the @code{-mcpu} option.
@cindex @code{-mfpu=} command line option, ARM @cindex @code{-mfpu=} command-line option, ARM
@item -mfpu=@var{floating-point-format} @item -mfpu=@var{floating-point-format}
This option specifies the floating point format to assemble for. The This option specifies the floating point format to assemble for. The
@ -309,19 +309,19 @@ The default is dependent on the processor selected. For Architecture 5 or
later, the default is to assemble for VFP instructions; for earlier later, the default is to assemble for VFP instructions; for earlier
architectures the default is to assemble for FPA instructions. architectures the default is to assemble for FPA instructions.
@cindex @code{-mthumb} command line option, ARM @cindex @code{-mthumb} command-line option, ARM
@item -mthumb @item -mthumb
This option specifies that the assembler should start assembling Thumb This option specifies that the assembler should start assembling Thumb
instructions; that is, it should behave as though the file starts with a instructions; that is, it should behave as though the file starts with a
@code{.code 16} directive. @code{.code 16} directive.
@cindex @code{-mthumb-interwork} command line option, ARM @cindex @code{-mthumb-interwork} command-line option, ARM
@item -mthumb-interwork @item -mthumb-interwork
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as supporting interworking. It also affects the behaviour be marked as supporting interworking. It also affects the behaviour
of the @code{ADR} and @code{ADRL} pseudo opcodes. of the @code{ADR} and @code{ADRL} pseudo opcodes.
@cindex @code{-mimplicit-it} command line option, ARM @cindex @code{-mimplicit-it} command-line option, ARM
@item -mimplicit-it=never @item -mimplicit-it=never
@itemx -mimplicit-it=always @itemx -mimplicit-it=always
@itemx -mimplicit-it=arm @itemx -mimplicit-it=arm
@ -339,15 +339,15 @@ If @code{thumb} is specified, such constructs cause a warning in ARM
code and are accepted in Thumb-2 code. If you omit this option, the code and are accepted in Thumb-2 code. If you omit this option, the
behavior is equivalent to @code{-mimplicit-it=arm}. behavior is equivalent to @code{-mimplicit-it=arm}.
@cindex @code{-mapcs-26} command line option, ARM @cindex @code{-mapcs-26} command-line option, ARM
@cindex @code{-mapcs-32} command line option, ARM @cindex @code{-mapcs-32} command-line option, ARM
@item -mapcs-26 @item -mapcs-26
@itemx -mapcs-32 @itemx -mapcs-32
These options specify that the output generated by the assembler should These options specify that the output generated by the assembler should
be marked as supporting the indicated version of the Arm Procedure. be marked as supporting the indicated version of the Arm Procedure.
Calling Standard. Calling Standard.
@cindex @code{-matpcs} command line option, ARM @cindex @code{-matpcs} command-line option, ARM
@item -matpcs @item -matpcs
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as supporting the Arm/Thumb Procedure Calling Standard. If be marked as supporting the Arm/Thumb Procedure Calling Standard. If
@ -355,18 +355,18 @@ enabled this option will cause the assembler to create an empty
debugging section in the object file called .arm.atpcs. Debuggers can debugging section in the object file called .arm.atpcs. Debuggers can
use this to determine the ABI being used by. use this to determine the ABI being used by.
@cindex @code{-mapcs-float} command line option, ARM @cindex @code{-mapcs-float} command-line option, ARM
@item -mapcs-float @item -mapcs-float
This indicates the floating point variant of the APCS should be This indicates the floating point variant of the APCS should be
used. In this variant floating point arguments are passed in FP used. In this variant floating point arguments are passed in FP
registers rather than integer registers. registers rather than integer registers.
@cindex @code{-mapcs-reentrant} command line option, ARM @cindex @code{-mapcs-reentrant} command-line option, ARM
@item -mapcs-reentrant @item -mapcs-reentrant
This indicates that the reentrant variant of the APCS should be used. This indicates that the reentrant variant of the APCS should be used.
This variant supports position independent code. This variant supports position independent code.
@cindex @code{-mfloat-abi=} command line option, ARM @cindex @code{-mfloat-abi=} command-line option, ARM
@item -mfloat-abi=@var{abi} @item -mfloat-abi=@var{abi}
This option specifies that the output generated by the assembler should be This option specifies that the output generated by the assembler should be
marked as using specified floating point ABI. marked as using specified floating point ABI.
@ -376,7 +376,7 @@ The following values are recognized:
and and
@code{hard}. @code{hard}.
@cindex @code{-eabi=} command line option, ARM @cindex @code{-eabi=} command-line option, ARM
@item -meabi=@var{ver} @item -meabi=@var{ver}
This option specifies which EABI version the produced object files should This option specifies which EABI version the produced object files should
conform to. conform to.
@ -386,7 +386,7 @@ The following values are recognized:
and and
@code{5}. @code{5}.
@cindex @code{-EB} command line option, ARM @cindex @code{-EB} command-line option, ARM
@item -EB @item -EB
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as being encoded for a big-endian processor. be marked as being encoded for a big-endian processor.
@ -397,33 +397,33 @@ and little-endian instructions then it should be assembled with the
the @option{--be8} option. This will reverse the endianness of the the @option{--be8} option. This will reverse the endianness of the
instructions back to little-endian, but leave the data as big-endian. instructions back to little-endian, but leave the data as big-endian.
@cindex @code{-EL} command line option, ARM @cindex @code{-EL} command-line option, ARM
@item -EL @item -EL
This option specifies that the output generated by the assembler should This option specifies that the output generated by the assembler should
be marked as being encoded for a little-endian processor. be marked as being encoded for a little-endian processor.
@cindex @code{-k} command line option, ARM @cindex @code{-k} command-line option, ARM
@cindex PIC code generation for ARM @cindex PIC code generation for ARM
@item -k @item -k
This option specifies that the output of the assembler should be marked This option specifies that the output of the assembler should be marked
as position-independent code (PIC). as position-independent code (PIC).
@cindex @code{--fix-v4bx} command line option, ARM @cindex @code{--fix-v4bx} command-line option, ARM
@item --fix-v4bx @item --fix-v4bx
Allow @code{BX} instructions in ARMv4 code. This is intended for use with Allow @code{BX} instructions in ARMv4 code. This is intended for use with
the linker option of the same name. the linker option of the same name.
@cindex @code{-mwarn-deprecated} command line option, ARM @cindex @code{-mwarn-deprecated} command-line option, ARM
@item -mwarn-deprecated @item -mwarn-deprecated
@itemx -mno-warn-deprecated @itemx -mno-warn-deprecated
Enable or disable warnings about using deprecated options or Enable or disable warnings about using deprecated options or
features. The default is to warn. features. The default is to warn.
@cindex @code{-mccs} command line option, ARM @cindex @code{-mccs} command-line option, ARM
@item -mccs @item -mccs
Turns on CodeComposer Studio assembly syntax compatibility mode. Turns on CodeComposer Studio assembly syntax compatibility mode.
@cindex @code{-mwarn-syms} command line option, ARM @cindex @code{-mwarn-syms} command-line option, ARM
@item -mwarn-syms @item -mwarn-syms
@itemx -mno-warn-syms @itemx -mno-warn-syms
Enable or disable warnings about symbols that match the names of ARM Enable or disable warnings about symbols that match the names of ARM
@ -624,7 +624,7 @@ boundary). This is for compatibility with ARM's own assembler.
@cindex @code{.arch} directive, ARM @cindex @code{.arch} directive, ARM
@item .arch @var{name} @item .arch @var{name}
Select the target architecture. Valid values for @var{name} are the same as Select the target architecture. Valid values for @var{name} are the same as
for the @option{-march} commandline option. for the @option{-march} command-line option.
Specifying @code{.arch} clears any previously selected architecture Specifying @code{.arch} clears any previously selected architecture
extensions. extensions.
@ -633,7 +633,7 @@ extensions.
@item .arch_extension @var{name} @item .arch_extension @var{name}
Add or remove an architecture extension to the target architecture. Valid Add or remove an architecture extension to the target architecture. Valid
values for @var{name} are the same as those accepted as architectural values for @var{name} are the same as those accepted as architectural
extensions by the @option{-mcpu} and @option{-march} commandline options. extensions by the @option{-mcpu} and @option{-march} command-line options.
@code{.arch_extension} may be used multiple times to add or remove extensions @code{.arch_extension} may be used multiple times to add or remove extensions
incrementally to the architecture being compiled for. incrementally to the architecture being compiled for.
@ -663,7 +663,7 @@ selects Thumb, with the value 32 selecting ARM.
@cindex @code{.cpu} directive, ARM @cindex @code{.cpu} directive, ARM
@item .cpu @var{name} @item .cpu @var{name}
Select the target processor. Valid values for @var{name} are the same as Select the target processor. Valid values for @var{name} are the same as
for the @option{-mcpu} commandline option. for the @option{-mcpu} command-line option.
Specifying @code{.cpu} clears any previously selected architecture Specifying @code{.cpu} clears any previously selected architecture
extensions. extensions.
@ -771,7 +771,7 @@ target processor does not support those instructions
@cindex @code{.fpu} directive, ARM @cindex @code{.fpu} directive, ARM
@item .fpu @var{name} @item .fpu @var{name}
Select the floating-point unit to assemble for. Valid values for @var{name} Select the floating-point unit to assemble for. Valid values for @var{name}
are the same as for the @option{-mfpu} commandline option. are the same as for the @option{-mfpu} command-line option.
@c GGGGGGGGGGGGGGGGGGGGGGGGGG @c GGGGGGGGGGGGGGGGGGGGGGGGGG
@c HHHHHHHHHHHHHHHHHHHHHHHHHH @c HHHHHHHHHHHHHHHHHHHHHHHHHH

16
gas/doc/c-avr.texi
View file

@ -28,7 +28,7 @@
@table @code @table @code
@cindex @code{-mmcu=} command line option, AVR @cindex @code{-mmcu=} command-line option, AVR
@item -mmcu=@var{mcu} @item -mmcu=@var{mcu}
Specify ATMEL AVR instruction set or MCU type. Specify ATMEL AVR instruction set or MCU type.
@ -128,34 +128,34 @@ atxmega128a1, atxmega128a1u, atxmega128a4u).
Instruction set avrtiny is for the ATtiny4/5/9/10/20/40 Instruction set avrtiny is for the ATtiny4/5/9/10/20/40
microcontrollers. microcontrollers.
@cindex @code{-mall-opcodes} command line option, AVR @cindex @code{-mall-opcodes} command-line option, AVR
@item -mall-opcodes @item -mall-opcodes
Accept all AVR opcodes, even if not supported by @code{-mmcu}. Accept all AVR opcodes, even if not supported by @code{-mmcu}.
@cindex @code{-mno-skip-bug} command line option, AVR @cindex @code{-mno-skip-bug} command-line option, AVR
@item -mno-skip-bug @item -mno-skip-bug
This option disable warnings for skipping two-word instructions. This option disable warnings for skipping two-word instructions.
@cindex @code{-mno-wrap} command line option, AVR @cindex @code{-mno-wrap} command-line option, AVR
@item -mno-wrap @item -mno-wrap
This option reject @code{rjmp/rcall} instructions with 8K wrap-around. This option reject @code{rjmp/rcall} instructions with 8K wrap-around.
@cindex @code{-mrmw} command line option, AVR @cindex @code{-mrmw} command-line option, AVR
@item -mrmw @item -mrmw
Accept Read-Modify-Write (@code{XCH,LAC,LAS,LAT}) instructions. Accept Read-Modify-Write (@code{XCH,LAC,LAS,LAT}) instructions.
@cindex @code{-mlink-relax} command line option, AVR @cindex @code{-mlink-relax} command-line option, AVR
@item -mlink-relax @item -mlink-relax
Enable support for link-time relaxation. This is now on by default Enable support for link-time relaxation. This is now on by default
and this flag no longer has any effect. and this flag no longer has any effect.
@cindex @code{-mno-link-relax} command line option, AVR @cindex @code{-mno-link-relax} command-line option, AVR
@item -mno-link-relax @item -mno-link-relax
Disable support for link-time relaxation. The assembler will resolve Disable support for link-time relaxation. The assembler will resolve
relocations when it can, and may be able to better compress some debug relocations when it can, and may be able to better compress some debug
information. information.
@cindex @code{-mgcc-isr} command line option, AVR @cindex @code{-mgcc-isr} command-line option, AVR
@item -mgcc-isr @item -mgcc-isr
Enable the @code{__gcc_isr} pseudo instruction. Enable the @code{__gcc_isr} pseudo instruction.

8
gas/doc/c-bfin.texi
View file

@ -29,7 +29,7 @@
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @code{-mcpu=} command line option, Blackfin @cindex @code{-mcpu=} command-line option, Blackfin
@item -mcpu=@var{processor}@r{[}-@var{sirevision}@r{]} @item -mcpu=@var{processor}@r{[}-@var{sirevision}@r{]}
This option specifies the target processor. The optional @var{sirevision} This option specifies the target processor. The optional @var{sirevision}
is not used in assembler. It's here such that GCC can easily pass down its is not used in assembler. It's here such that GCC can easily pass down its
@ -72,12 +72,12 @@ recognized:
and and
@code{bf592}. @code{bf592}.
@cindex @code{-mfdpic} command line option, Blackfin @cindex @code{-mfdpic} command-line option, Blackfin
@item -mfdpic @item -mfdpic
Assemble for the FDPIC ABI. Assemble for the FDPIC ABI.
@cindex @code{-mno-fdpic} command line option, Blackfin @cindex @code{-mno-fdpic} command-line option, Blackfin
@cindex @code{-mnopic} command line option, Blackfin @cindex @code{-mnopic} command-line option, Blackfin
@item -mno-fdpic @item -mno-fdpic
@itemx -mnopic @itemx -mnopic
Disable -mfdpic. Disable -mfdpic.

40
gas/doc/c-cris.texi
View file

@ -28,10 +28,10 @@
The CRIS version of @code{@value{AS}} has these The CRIS version of @code{@value{AS}} has these
machine-dependent command-line options. machine-dependent command-line options.
@cindex @option{--emulation=criself} command line option, CRIS @cindex @option{--emulation=criself} command-line option, CRIS
@cindex @option{--emulation=crisaout} command line option, CRIS @cindex @option{--emulation=crisaout} command-line option, CRIS
@cindex CRIS @option{--emulation=criself} command line option @cindex CRIS @option{--emulation=criself} command-line option
@cindex CRIS @option{--emulation=crisaout} command line option @cindex CRIS @option{--emulation=crisaout} command-line option
The format of the generated object files can be either ELF or The format of the generated object files can be either ELF or
a.out, specified by the command-line options a.out, specified by the command-line options
@ -40,10 +40,10 @@ The default is ELF (criself), unless @code{@value{AS}} has been
configured specifically for a.out by using the configuration configured specifically for a.out by using the configuration
name @code{cris-axis-aout}. name @code{cris-axis-aout}.
@cindex @option{--underscore} command line option, CRIS @cindex @option{--underscore} command-line option, CRIS
@cindex @option{--no-underscore} command line option, CRIS @cindex @option{--no-underscore} command-line option, CRIS
@cindex CRIS @option{--underscore} command line option @cindex CRIS @option{--underscore} command-line option
@cindex CRIS @option{--no-underscore} command line option @cindex CRIS @option{--no-underscore} command-line option
There are two different link-incompatible ELF object file There are two different link-incompatible ELF object file
variants for CRIS, for use in environments where symbols are variants for CRIS, for use in environments where symbols are
expected to be prefixed by a leading @samp{_} character and for expected to be prefixed by a leading @samp{_} character and for
@ -58,8 +58,8 @@ difference, the effect of this option is to parse register names
differently (@pxref{crisnous}). The @option{--no-underscore} differently (@pxref{crisnous}). The @option{--no-underscore}
option makes a @samp{$} register prefix mandatory. option makes a @samp{$} register prefix mandatory.
@cindex @option{--pic} command line option, CRIS @cindex @option{--pic} command-line option, CRIS
@cindex CRIS @option{--pic} command line option @cindex CRIS @option{--pic} command-line option
@cindex Position-independent code, CRIS @cindex Position-independent code, CRIS
@cindex CRIS position-independent code @cindex CRIS position-independent code
The option @option{--pic} must be passed to @code{@value{AS}} in The option @option{--pic} must be passed to @code{@value{AS}} in
@ -70,8 +70,8 @@ affect expansion of instructions. The expansion with
faster) absolute addresses in those expansions. This option is only faster) absolute addresses in those expansions. This option is only
valid when generating ELF format object files. valid when generating ELF format object files.
@cindex @option{--march=@var{architecture}} command line option, CRIS @cindex @option{--march=@var{architecture}} command-line option, CRIS
@cindex CRIS @option{--march=@var{architecture}} command line option @cindex CRIS @option{--march=@var{architecture}} command-line option
@cindex Architecture variant option, CRIS @cindex Architecture variant option, CRIS
@cindex CRIS architecture variant option @cindex CRIS architecture variant option
The option @option{--march=@var{architecture}} The option @option{--march=@var{architecture}}
@ -103,29 +103,29 @@ Only instructions with register names and addressing modes with
opcodes common to the v10 and v32 are recognized. opcodes common to the v10 and v32 are recognized.
@end table @end table
@cindex @option{-N} command line option, CRIS @cindex @option{-N} command-line option, CRIS
@cindex CRIS @option{-N} command line option @cindex CRIS @option{-N} command-line option
When @option{-N} is specified, @code{@value{AS}} will emit a When @option{-N} is specified, @code{@value{AS}} will emit a
warning when a 16-bit branch instruction is expanded into a warning when a 16-bit branch instruction is expanded into a
32-bit multiple-instruction construct (@pxref{CRIS-Expand}). 32-bit multiple-instruction construct (@pxref{CRIS-Expand}).
@cindex @option{--no-mul-bug-abort} command line option, CRIS @cindex @option{--no-mul-bug-abort} command-line option, CRIS
@cindex @option{--mul-bug-abort} command line option, CRIS @cindex @option{--mul-bug-abort} command-line option, CRIS
@cindex CRIS @option{--no-mul-bug-abort} command line option @cindex CRIS @option{--no-mul-bug-abort} command-line option
@cindex CRIS @option{--mul-bug-abort} command line option @cindex CRIS @option{--mul-bug-abort} command-line option
Some versions of the CRIS v10, for example in the Etrax 100 LX, Some versions of the CRIS v10, for example in the Etrax 100 LX,
contain a bug that causes destabilizing memory accesses when a contain a bug that causes destabilizing memory accesses when a
multiply instruction is executed with certain values in the multiply instruction is executed with certain values in the
first operand just before a cache-miss. When the first operand just before a cache-miss. When the
@option{--mul-bug-abort} command line option is active (the @option{--mul-bug-abort} command-line option is active (the
default value), @code{@value{AS}} will refuse to assemble a file default value), @code{@value{AS}} will refuse to assemble a file
containing a multiply instruction at a dangerous offset, one containing a multiply instruction at a dangerous offset, one
that could be the last on a cache-line, or is in a section with that could be the last on a cache-line, or is in a section with
insufficient alignment. This placement checking does not catch insufficient alignment. This placement checking does not catch
any case where the multiply instruction is dangerously placed any case where the multiply instruction is dangerously placed
because it is located in a delay-slot. The because it is located in a delay-slot. The
@option{--mul-bug-abort} command line option turns off the @option{--mul-bug-abort} command-line option turns off the
checking. checking.
@node CRIS-Expand @node CRIS-Expand

4
gas/doc/c-epiphany.texi
View file

@ -30,12 +30,12 @@ architecture.
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @code{-mepiphany} command line option, Epiphany @cindex @code{-mepiphany} command-line option, Epiphany
@item -mepiphany @item -mepiphany
Specifies that the both 32 and 16 bit instructions are allowed. This is the Specifies that the both 32 and 16 bit instructions are allowed. This is the
default behavior. default behavior.
@cindex @code{-mepiphany16} command line option, Epiphany @cindex @code{-mepiphany16} command-line option, Epiphany
@item -mepiphany16 @item -mepiphany16
Restricts the permitted instructions to just the 16 bit set. Restricts the permitted instructions to just the 16 bit set.
@end table @end table

2
gas/doc/c-i386.texi
View file

@ -596,7 +596,7 @@ line is treated as a comment, but in this case the line can also be a
logical line number directive (@pxref{Comments}) or a preprocessor logical line number directive (@pxref{Comments}) or a preprocessor
control command (@pxref{Preprocessing}). control command (@pxref{Preprocessing}).
If the @option{--divide} command line option has not been specified If the @option{--divide} command-line option has not been specified
then the @samp{/} character appearing anywhere on a line also then the @samp{/} character appearing anywhere on a line also
introduces a line comment. introduces a line comment.

2
gas/doc/c-ia64.texi
View file

@ -29,7 +29,7 @@
@cindex options for IA-64 @cindex options for IA-64
@table @option @table @option
@cindex @code{-mconstant-gp} command line option, IA-64 @cindex @code{-mconstant-gp} command-line option, IA-64
@item -mconstant-gp @item -mconstant-gp
This option instructs the assembler to mark the resulting object file This option instructs the assembler to mark the resulting object file

18
gas/doc/c-lm32.texi
View file

@ -27,39 +27,39 @@
@table @code @table @code
@cindex @code{-mmultiply-enabled} command line option, LM32 @cindex @code{-mmultiply-enabled} command-line option, LM32
@item -mmultiply-enabled @item -mmultiply-enabled
Enable multiply instructions. Enable multiply instructions.
@cindex @code{-mdivide-enabled} command line option, LM32 @cindex @code{-mdivide-enabled} command-line option, LM32
@item -mdivide-enabled @item -mdivide-enabled
Enable divide instructions. Enable divide instructions.
@cindex @code{-mbarrel-shift-enabled} command line option, LM32 @cindex @code{-mbarrel-shift-enabled} command-line option, LM32
@item -mbarrel-shift-enabled @item -mbarrel-shift-enabled
Enable barrel-shift instructions. Enable barrel-shift instructions.
@cindex @code{-msign-extend-enabled} command line option, LM32 @cindex @code{-msign-extend-enabled} command-line option, LM32
@item -msign-extend-enabled @item -msign-extend-enabled
Enable sign extend instructions. Enable sign extend instructions.
@cindex @code{-muser-enabled} command line option, LM32 @cindex @code{-muser-enabled} command-line option, LM32
@item -muser-enabled @item -muser-enabled
Enable user defined instructions. Enable user defined instructions.
@cindex @code{-micache-enabled} command line option, LM32 @cindex @code{-micache-enabled} command-line option, LM32
@item -micache-enabled @item -micache-enabled
Enable instruction cache related CSRs. Enable instruction cache related CSRs.
@cindex @code{-mdcache-enabled} command line option, LM32 @cindex @code{-mdcache-enabled} command-line option, LM32
@item -mdcache-enabled @item -mdcache-enabled
Enable data cache related CSRs. Enable data cache related CSRs.
@cindex @code{-mbreak-enabled} command line option, LM32 @cindex @code{-mbreak-enabled} command-line option, LM32
@item -mbreak-enabled @item -mbreak-enabled
Enable break instructions. Enable break instructions.
@cindex @code{-mall-enabled} command line option, LM32 @cindex @code{-mall-enabled} command-line option, LM32
@item -mall-enabled @item -mall-enabled
Enable all instructions and CSRs. Enable all instructions and CSRs.

6
gas/doc/c-m32r.texi
View file

@ -53,7 +53,7 @@ microprocessor.
@cindex M32R architecture options @cindex M32R architecture options
This option can be used to restore the assembler's default behaviour of This option can be used to restore the assembler's default behaviour of
assembling for the M32R microprocessor. This can be useful if the assembling for the M32R microprocessor. This can be useful if the
default has been changed by a previous command line option. default has been changed by a previous command-line option.
@item -little @item -little
@cindex @code{-little} option, M32R @cindex @code{-little} option, M32R
@ -321,7 +321,7 @@ neg instruction and the input to the move instruction.
@item instruction @samp{...} is for the M32RX only @item instruction @samp{...} is for the M32RX only
This message is produced when the assembler encounters an instruction This message is produced when the assembler encounters an instruction
which is only supported by the M32Rx processor, and the @samp{-m32rx} which is only supported by the M32Rx processor, and the @samp{-m32rx}
command line flag has not been specified to allow assembly of such command-line flag has not been specified to allow assembly of such
instructions. instructions.
@item unknown instruction @samp{...} @item unknown instruction @samp{...}
@ -331,7 +331,7 @@ which it does not recognize.
@item only the NOP instruction can be issued in parallel on the m32r @item only the NOP instruction can be issued in parallel on the m32r
This message is produced when the assembler encounters a parallel This message is produced when the assembler encounters a parallel
instruction which does not involve a NOP instruction and the instruction which does not involve a NOP instruction and the
@samp{-m32rx} command line flag has not been specified. Only the M32Rx @samp{-m32rx} command-line flag has not been specified. Only the M32Rx
processor is able to execute two instructions in parallel. processor is able to execute two instructions in parallel.
@item instruction @samp{...} cannot be executed in parallel. @item instruction @samp{...} cannot be executed in parallel.

24
gas/doc/c-m68k.texi
View file

@ -31,7 +31,7 @@ dependent options:
@table @samp @table @samp
@cindex @samp{-march=} command line option, M680x0 @cindex @samp{-march=} command-line option, M680x0
@item -march=@var{architecture} @item -march=@var{architecture}
This option specifies a target architecture. The following This option specifies a target architecture. The following
architectures are recognized: architectures are recognized:
@ -49,20 +49,20 @@ architectures are recognized:
@code{cfv4e}. @code{cfv4e}.
@cindex @samp{-mcpu=} command line option, M680x0 @cindex @samp{-mcpu=} command-line option, M680x0
@item -mcpu=@var{cpu} @item -mcpu=@var{cpu}
This option specifies a target cpu. When used in conjunction with the This option specifies a target cpu. When used in conjunction with the
@option{-march} option, the cpu must be within the specified @option{-march} option, the cpu must be within the specified
architecture. Also, the generic features of the architecture are used architecture. Also, the generic features of the architecture are used
for instruction generation, rather than those of the specific chip. for instruction generation, rather than those of the specific chip.
@cindex @samp{-m[no-]68851} command line option, M680x0 @cindex @samp{-m[no-]68851} command-line option, M680x0
@cindex @samp{-m[no-]68881} command line option, M680x0 @cindex @samp{-m[no-]68881} command-line option, M680x0
@cindex @samp{-m[no-]div} command line option, M680x0 @cindex @samp{-m[no-]div} command-line option, M680x0
@cindex @samp{-m[no-]usp} command line option, M680x0 @cindex @samp{-m[no-]usp} command-line option, M680x0
@cindex @samp{-m[no-]float} command line option, M680x0 @cindex @samp{-m[no-]float} command-line option, M680x0
@cindex @samp{-m[no-]mac} command line option, M680x0 @cindex @samp{-m[no-]mac} command-line option, M680x0
@cindex @samp{-m[no-]emac} command line option, M680x0 @cindex @samp{-m[no-]emac} command-line option, M680x0
@item -m[no-]68851 @item -m[no-]68851
@itemx -m[no-]68881 @itemx -m[no-]68881
@itemx -m[no-]div @itemx -m[no-]div
@ -446,7 +446,7 @@ This directive is identical to a @code{.space} directive.
@cindex @code{arch} directive, M680x0 @cindex @code{arch} directive, M680x0
@item .arch @var{name} @item .arch @var{name}
Select the target architecture and extension features. Valid values Select the target architecture and extension features. Valid values
for @var{name} are the same as for the @option{-march} command line for @var{name} are the same as for the @option{-march} command-line
option. This directive cannot be specified after option. This directive cannot be specified after
any instructions have been assembled. If it is given multiple times, any instructions have been assembled. If it is given multiple times,
or in conjunction with the @option{-march} option, all uses must be for or in conjunction with the @option{-march} option, all uses must be for
@ -455,7 +455,7 @@ the same architecture and extension set.
@cindex @code{cpu} directive, M680x0 @cindex @code{cpu} directive, M680x0
@item .cpu @var{name} @item .cpu @var{name}
Select the target cpu. Valid values Select the target cpu. Valid values
for @var{name} are the same as for the @option{-mcpu} command line for @var{name} are the same as for the @option{-mcpu} command-line
option. This directive cannot be specified after option. This directive cannot be specified after
any instructions have been assembled. If it is given multiple times, any instructions have been assembled. If it is given multiple times,
or in conjunction with the @option{-mopt} option, all uses must be for or in conjunction with the @option{-mopt} option, all uses must be for
@ -613,7 +613,7 @@ branch instructions allow both word and long displacements.
@cindex line comment character, M680x0 @cindex line comment character, M680x0
@cindex comments, M680x0 @cindex comments, M680x0
Line comments are introduced by the @samp{|} character appearing Line comments are introduced by the @samp{|} character appearing
anywhere on a line, unless the @option{--bitwise-or} command line option anywhere on a line, unless the @option{--bitwise-or} command-line option
has been specified. has been specified.
An asterisk (@samp{*}) as the first character on a line marks the An asterisk (@samp{*}) as the first character on a line marks the

16
gas/doc/c-mips.texi
View file

@ -522,7 +522,7 @@ for branches.
By default @samp{-mno-ignore-branch-isa} is selected, causing any invalid By default @samp{-mno-ignore-branch-isa} is selected, causing any invalid
branch requiring a transition between ISA modes to produce an error. branch requiring a transition between ISA modes to produce an error.
@cindex @option{-mnan=} command line option, MIPS @cindex @option{-mnan=} command-line option, MIPS
@item -mnan=@var{encoding} @item -mnan=@var{encoding}
This option indicates whether the source code uses the IEEE 2008 This option indicates whether the source code uses the IEEE 2008
NaN encoding (@option{-mnan=2008}) or the original MIPS encoding NaN encoding (@option{-mnan=2008}) or the original MIPS encoding
@ -748,7 +748,7 @@ for the corresponding ISA level, from that point on in the
assembly. @code{.set mips@var{n}} affects not only which instructions assembly. @code{.set mips@var{n}} affects not only which instructions
are permitted, but also how certain macros are expanded. @code{.set are permitted, but also how certain macros are expanded. @code{.set
mips0} restores the ISA level to its original level: either the mips0} restores the ISA level to its original level: either the
level you selected with command line options, or the default for your level you selected with command-line options, or the default for your
configuration. You can use this feature to permit specific MIPS III configuration. You can use this feature to permit specific MIPS III
instructions while assembling in 32 bit mode. Use this directive with instructions while assembling in 32 bit mode. Use this directive with
care! care!
@ -758,7 +758,7 @@ care!
The @code{.set arch=@var{cpu}} directive provides even finer control. The @code{.set arch=@var{cpu}} directive provides even finer control.
It changes the effective CPU target and allows the assembler to use It changes the effective CPU target and allows the assembler to use
instructions specific to a particular CPU. All CPUs supported by the instructions specific to a particular CPU. All CPUs supported by the
@samp{-march} command line option are also selectable by this directive. @samp{-march} command-line option are also selectable by this directive.
The original value is restored by @code{.set arch=default}. The original value is restored by @code{.set arch=default}.
The directive @code{.set mips16} puts the assembler into MIPS 16 mode, The directive @code{.set mips16} puts the assembler into MIPS 16 mode,
@ -776,13 +776,13 @@ Traditional MIPS assemblers do not support this directive.
@node MIPS assembly options @node MIPS assembly options
@section Directives to control code generation @section Directives to control code generation
@cindex MIPS directives to override command line options @cindex MIPS directives to override command-line options
@kindex @code{.module} @kindex @code{.module}
The @code{.module} directive allows command line options to be set directly The @code{.module} directive allows command-line options to be set directly
from assembly. The format of the directive matches the @code{.set} from assembly. The format of the directive matches the @code{.set}
directive but only those options which are relevant to a whole module are directive but only those options which are relevant to a whole module are
supported. The effect of a @code{.module} directive is the same as the supported. The effect of a @code{.module} directive is the same as the
corresponding command line option. Where @code{.set} directives support corresponding command-line option. Where @code{.set} directives support
returning to a default then the @code{.module} directives do not as they returning to a default then the @code{.module} directives do not as they
define the defaults. define the defaults.
@ -873,7 +873,7 @@ other and must be tracked carefully.
Traditionally the use of an explicit @code{.gnu_attribute 4, @var{n}} Traditionally the use of an explicit @code{.gnu_attribute 4, @var{n}}
directive is used to indicate which ABI is in use by a specific module. directive is used to indicate which ABI is in use by a specific module.
It was then left to the user to ensure that command line options and the It was then left to the user to ensure that command-line options and the
selected ABI were compatible with some potential for inconsistencies. selected ABI were compatible with some potential for inconsistencies.
@node MIPS FP ABI Variants @node MIPS FP ABI Variants
@ -933,7 +933,7 @@ of MIPS32r2.
@cindex @code{.module fp=@var{nn}} directive, MIPS @cindex @code{.module fp=@var{nn}} directive, MIPS
In order to simplify and add safety to the process of selecting the In order to simplify and add safety to the process of selecting the
correct floating-point ABI, the assembler will automatically infer the correct floating-point ABI, the assembler will automatically infer the
correct @code{.gnu_attribute 4, @var{n}} directive based on command line correct @code{.gnu_attribute 4, @var{n}} directive based on command-line
options and @code{.module} overrides. Where an explicit options and @code{.module} overrides. Where an explicit
@code{.gnu_attribute 4, @var{n}} directive has been seen then a warning @code{.gnu_attribute 4, @var{n}} directive has been seen then a warning
will be raised if it does not match an inferred setting. will be raised if it does not match an inferred setting.

22
gas/doc/c-mmix.texi
View file

@ -27,25 +27,25 @@
@cindex MMIX options @cindex MMIX options
The MMIX version of @code{@value{AS}} has some machine-dependent options. The MMIX version of @code{@value{AS}} has some machine-dependent options.
@cindex @samp{--fixed-special-register-names} command line option, MMIX @cindex @samp{--fixed-special-register-names} command-line option, MMIX
When @samp{--fixed-special-register-names} is specified, only the register When @samp{--fixed-special-register-names} is specified, only the register
names specified in @ref{MMIX-Regs} are recognized in the instructions names specified in @ref{MMIX-Regs} are recognized in the instructions
@code{PUT} and @code{GET}. @code{PUT} and @code{GET}.
@cindex @samp{--globalize-symbols} command line option, MMIX @cindex @samp{--globalize-symbols} command-line option, MMIX
You can use the @samp{--globalize-symbols} to make all symbols global. You can use the @samp{--globalize-symbols} to make all symbols global.
This option is useful when splitting up a @code{mmixal} program into This option is useful when splitting up a @code{mmixal} program into
several files. several files.
@cindex @samp{--gnu-syntax} command line option, MMIX @cindex @samp{--gnu-syntax} command-line option, MMIX
The @samp{--gnu-syntax} turns off most syntax compatibility with The @samp{--gnu-syntax} turns off most syntax compatibility with
@code{mmixal}. Its usability is currently doubtful. @code{mmixal}. Its usability is currently doubtful.
@cindex @samp{--relax} command line option, MMIX @cindex @samp{--relax} command-line option, MMIX
The @samp{--relax} option is not fully supported, but will eventually make The @samp{--relax} option is not fully supported, but will eventually make
the object file prepared for linker relaxation. the object file prepared for linker relaxation.
@cindex @samp{--no-predefined-syms} command line option, MMIX @cindex @samp{--no-predefined-syms} command-line option, MMIX
If you want to avoid inadvertently calling a predefined symbol and would If you want to avoid inadvertently calling a predefined symbol and would
rather get an error, for example when using @code{@value{AS}} with a rather get an error, for example when using @code{@value{AS}} with a
compiler or other machine-generated code, specify compiler or other machine-generated code, specify
@ -55,13 +55,13 @@ symbols, @samp{BIT} symbols, and @code{TRAP} symbols used in @code{mmix}
``system calls''. It also turns off predefined special-register names, ``system calls''. It also turns off predefined special-register names,
except when used in @code{PUT} and @code{GET} instructions. except when used in @code{PUT} and @code{GET} instructions.
@cindex @samp{--no-expand} command line option, MMIX @cindex @samp{--no-expand} command-line option, MMIX
By default, some instructions are expanded to fit the size of the operand By default, some instructions are expanded to fit the size of the operand
or an external symbol (@pxref{MMIX-Expand}). By passing or an external symbol (@pxref{MMIX-Expand}). By passing
@samp{--no-expand}, no such expansion will be done, instead causing errors @samp{--no-expand}, no such expansion will be done, instead causing errors
at link time if the operand does not fit. at link time if the operand does not fit.
@cindex @samp{--no-merge-gregs} command line option, MMIX @cindex @samp{--no-merge-gregs} command-line option, MMIX
The @code{mmixal} documentation (@pxref{mmixsite}) specifies that global The @code{mmixal} documentation (@pxref{mmixsite}) specifies that global
registers allocated with the @samp{GREG} directive (@pxref{MMIX-greg}) and registers allocated with the @samp{GREG} directive (@pxref{MMIX-greg}) and
initialized to the same non-zero value, will refer to the same global initialized to the same non-zero value, will refer to the same global
@ -70,7 +70,7 @@ final addresses aren't known until link-time, but it will do an effort
unless the @samp{--no-merge-gregs} option is specified. (Register merging unless the @samp{--no-merge-gregs} option is specified. (Register merging
isn't yet implemented in @code{@value{LD}}.) isn't yet implemented in @code{@value{LD}}.)
@cindex @samp{-x} command line option, MMIX @cindex @samp{-x} command-line option, MMIX
@code{@value{AS}} will warn every time it expands an instruction to fit an @code{@value{AS}} will warn every time it expands an instruction to fit an
operand unless the option @samp{-x} is specified. It is believed that operand unless the option @samp{-x} is specified. It is believed that
this behaviour is more useful than just mimicking @code{mmixal}'s this behaviour is more useful than just mimicking @code{mmixal}'s
@ -82,8 +82,8 @@ that at link stage can be contracted. (Though linker relaxation isn't yet
implemented in @code{@value{LD}}.) The option @samp{-x} also implies implemented in @code{@value{LD}}.) The option @samp{-x} also implies
@samp{--linker-allocated-gregs}. @samp{--linker-allocated-gregs}.
@cindex @samp{--no-pushj-stubs} command line option, MMIX @cindex @samp{--no-pushj-stubs} command-line option, MMIX
@cindex @samp{--no-stubs} command line option, MMIX @cindex @samp{--no-stubs} command-line option, MMIX
If instruction expansion is enabled, @code{@value{AS}} can expand a If instruction expansion is enabled, @code{@value{AS}} can expand a
@samp{PUSHJ} instruction into a series of instructions. The shortest @samp{PUSHJ} instruction into a series of instructions. The shortest
expansion is to not expand it, but just mark the call as redirectable to a expansion is to not expand it, but just mark the call as redirectable to a
@ -97,7 +97,7 @@ then created at assembly-time. The option @samp{--no-stubs} is a synonym,
intended for compatibility with future releases, where generation of stubs intended for compatibility with future releases, where generation of stubs
for other instructions may be implemented. for other instructions may be implemented.
@cindex @samp{--linker-allocated-gregs} command line option, MMIX @cindex @samp{--linker-allocated-gregs} command-line option, MMIX
Usually a two-operand-expression (@pxref{GREG-base}) without a matching Usually a two-operand-expression (@pxref{GREG-base}) without a matching
@samp{GREG} directive is treated as an error by @code{@value{AS}}. When @samp{GREG} directive is treated as an error by @code{@value{AS}}. When
the option @samp{--linker-allocated-gregs} is in effect, they are instead the option @samp{--linker-allocated-gregs} is in effect, they are instead

6
gas/doc/c-msp430.texi
View file

@ -83,7 +83,7 @@ changes the interrupt state (@code{EINT}, @code{DINT}, @code{BIC #8,
SR}, @code{BIS #8, SR} or @code{MOV.W <>, SR}) must be SR}, @code{BIS #8, SR} or @code{MOV.W <>, SR}) must be
followed by a NOP instruction in order to ensure the correct followed by a NOP instruction in order to ensure the correct
processing of interrupts. By default it is up to the programmer to processing of interrupts. By default it is up to the programmer to
supply these NOP instructions, but this command line option enables supply these NOP instructions, but this command-line option enables
the automatic insertion by the assembler, if they are missing. the automatic insertion by the assembler, if they are missing.
@item -mN @item -mN
@ -302,12 +302,12 @@ MSP 430 assemblers.
@cindex @code{arch} directive, MSP 430 @cindex @code{arch} directive, MSP 430
@item .arch @item .arch
Sets the target microcontroller in the same way as the @option{-mmcu} Sets the target microcontroller in the same way as the @option{-mmcu}
command line option. command-line option.
@cindex @code{cpu} directive, MSP 430 @cindex @code{cpu} directive, MSP 430
@item .cpu @item .cpu
Sets the target architecture in the same way as the @option{-mcpu} Sets the target architecture in the same way as the @option{-mcpu}
command line option. command-line option.
@cindex @code{profiler} directive, MSP 430 @cindex @code{profiler} directive, MSP 430
@item .profiler @item .profiler

4
gas/doc/c-mt.texi
View file

@ -26,7 +26,7 @@
@table @code @table @code
@cindex @code{-march=} command line option, MT @cindex @code{-march=} command-line option, MT
@item -march=@var{processor} @item -march=@var{processor}
This option specifies the target processor. The assembler will issue an This option specifies the target processor. The assembler will issue an
error message if an attempt is made to assemble an instruction which error message if an attempt is made to assemble an instruction which
@ -37,7 +37,7 @@ recognized:
@code{ms1-16-003}, @code{ms1-16-003},
and @code{ms2}. and @code{ms2}.
@cindex @code{-nosched} command line option, MT @cindex @code{-nosched} command-line option, MT
@item -nosched @item -nosched
This option disables scheduling restriction checking. This option disables scheduling restriction checking.

12
gas/doc/c-nios2.texi
View file

@ -31,7 +31,7 @@
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @code{relax-section} command line option, Nios II @cindex @code{relax-section} command-line option, Nios II
@item -relax-section @item -relax-section
Replace identified out-of-range branches with PC-relative @code{jmp} Replace identified out-of-range branches with PC-relative @code{jmp}
sequences when possible. The generated code sequences are suitable sequences when possible. The generated code sequences are suitable
@ -39,26 +39,26 @@ for use in position-independent code, but there is a practical limit
on the extended branch range because of the length of the sequences. on the extended branch range because of the length of the sequences.
This option is the default. This option is the default.
@cindex @code{relax-all} command line option, Nios II @cindex @code{relax-all} command-line option, Nios II
@item -relax-all @item -relax-all
Replace branch instructions not determinable to be in range Replace branch instructions not determinable to be in range
and all call instructions with @code{jmp} and @code{callr} sequences and all call instructions with @code{jmp} and @code{callr} sequences
(respectively). This option generates absolute relocations against the (respectively). This option generates absolute relocations against the
target symbols and is not appropriate for position-independent code. target symbols and is not appropriate for position-independent code.
@cindex @code{no-relax} command line option, Nios II @cindex @code{no-relax} command-line option, Nios II
@item -no-relax @item -no-relax
Do not replace any branches or calls. Do not replace any branches or calls.
@cindex @code{EB} command line option, Nios II @cindex @code{EB} command-line option, Nios II
@item -EB @item -EB
Generate big-endian output. Generate big-endian output.
@cindex @code{EL} command line option, Nios II @cindex @code{EL} command-line option, Nios II
@item -EL @item -EL
Generate little-endian output. This is the default. Generate little-endian output. This is the default.
@cindex @code{march} command line option, Nios II @cindex @code{march} command-line option, Nios II
@item -march=@var{architecture} @item -march=@var{architecture}
This option specifies the target architecture. The assembler issues This option specifies the target architecture. The assembler issues
an error message if an attempt is made to assemble an instruction which an error message if an attempt is made to assemble an instruction which

2
gas/doc/c-ppc.texi
View file

@ -229,7 +229,7 @@ control command (@pxref{Preprocessing}).
If the assembler has been configured for the ppc-*-solaris* target If the assembler has been configured for the ppc-*-solaris* target
then the @samp{!} character also acts as a line comment character. then the @samp{!} character also acts as a line comment character.
This can be disabled via the @option{-mno-solaris} command line This can be disabled via the @option{-mno-solaris} command-line
option. option.
@cindex line separator, PowerPC @cindex line separator, PowerPC

8
gas/doc/c-pru.texi
View file

@ -25,19 +25,19 @@
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @code{mlink-relax} command line option, PRU @cindex @code{mlink-relax} command-line option, PRU
@item -mlink-relax @item -mlink-relax
Assume that LD would optimize LDI32 instructions by checking the upper Assume that LD would optimize LDI32 instructions by checking the upper
16 bits of the @var{expression}. If they are all zeros, then LD would 16 bits of the @var{expression}. If they are all zeros, then LD would
shorten the LDI32 instruction to a single LDI. In such case @code{@value{AS}} shorten the LDI32 instruction to a single LDI. In such case @code{@value{AS}}
will output DIFF relocations for diff expressions. will output DIFF relocations for diff expressions.
@cindex @code{mno-link-relax} command line option, PRU @cindex @code{mno-link-relax} command-line option, PRU
@item -mno-link-relax @item -mno-link-relax
Assume that LD would not optimize LDI32 instructions. As a consequence, Assume that LD would not optimize LDI32 instructions. As a consequence,
DIFF relocations will not be emitted. DIFF relocations will not be emitted.
@cindex @code{mno-warn-regname-label} command line option, PRU @cindex @code{mno-warn-regname-label} command-line option, PRU
@item -mno-warn-regname-label @item -mno-warn-regname-label
Do not warn if a label name matches a register name. Usually assembler Do not warn if a label name matches a register name. Usually assembler
programmers will want this warning to be emitted. C compilers may want programmers will want this warning to be emitted. C compilers may want
@ -129,7 +129,7 @@ Create an unaligned constant 16 bytes in size.
@cindex @code{set no_warn_regname_label} directive, PRU @cindex @code{set no_warn_regname_label} directive, PRU
@item .set no_warn_regname_label @item .set no_warn_regname_label
Do not output warnings when a label name matches a register name. Equivalent Do not output warnings when a label name matches a register name. Equivalent
to passing the @code{-mno-warn-regname-label} command line option. to passing the @code{-mno-warn-regname-label} command-line option.
@end table @end table

4
gas/doc/c-rl78.texi
View file

@ -13,7 +13,7 @@
@cindex RL78 support @cindex RL78 support
@menu @menu
* RL78-Opts:: RL78 Assembler Command Line Options * RL78-Opts:: RL78 Assembler Command-line Options
* RL78-Modifiers:: Symbolic Operand Modifiers * RL78-Modifiers:: Symbolic Operand Modifiers
* RL78-Directives:: Assembler Directives * RL78-Directives:: Assembler Directives
* RL78-Syntax:: Syntax * RL78-Syntax:: Syntax
@ -107,7 +107,7 @@ In addition to the common directives, the RL78 adds these:
@item .double @item .double
Output a constant in ``double'' format, which is either a 32-bit Output a constant in ``double'' format, which is either a 32-bit
or a 64-bit floating point value, depending upon the setting of the or a 64-bit floating point value, depending upon the setting of the
@option{-m32bit-doubles}|@option{-m64bit-doubles} command line @option{-m32bit-doubles}|@option{-m64bit-doubles} command-line
option. option.
@item .bss @item .bss

6
gas/doc/c-rx.texi
View file

@ -13,7 +13,7 @@
@cindex RX support @cindex RX support
@menu @menu
* RX-Opts:: RX Assembler Command Line Options * RX-Opts:: RX Assembler Command-line Options
* RX-Modifiers:: Symbolic Operand Modifiers * RX-Modifiers:: Symbolic Operand Modifiers
* RX-Directives:: Assembler Directives * RX-Directives:: Assembler Directives
* RX-Float:: Floating Point * RX-Float:: Floating Point
@ -26,7 +26,7 @@
@cindex RX options @cindex RX options
The Renesas RX port of @code{@value{AS}} has a few target specific The Renesas RX port of @code{@value{AS}} has a few target specific
command line options: command-line options:
@table @code @table @code
@ -218,7 +218,7 @@ The floating point formats generated by directives are these.
@cindex @code{double} directive, RX @cindex @code{double} directive, RX
@item .double @item .double
If the @option{-m64bit-doubles} command line option has been specified If the @option{-m64bit-doubles} command-line option has been specified
then then @code{double} directive generates @code{double} precision then then @code{double} directive generates @code{double} precision
(64-bit) floating point constants, otherwise it generates (64-bit) floating point constants, otherwise it generates
@code{single} precision (32-bit) floating point constants. To force @code{single} precision (32-bit) floating point constants. To force

12
gas/doc/c-tic6x.texi
View file

@ -28,7 +28,7 @@
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @code{-march=} command line option, TIC6X @cindex @code{-march=} command-line option, TIC6X
@item -march=@var{arch} @item -march=@var{arch}
Enable (only) instructions from architecture @var{arch}. By default, Enable (only) instructions from architecture @var{arch}. By default,
all instructions are permitted. all instructions are permitted.
@ -36,8 +36,8 @@ all instructions are permitted.
The following values of @var{arch} are accepted: @code{c62x}, The following values of @var{arch} are accepted: @code{c62x},
@code{c64x}, @code{c64x+}, @code{c67x}, @code{c67x+}, @code{c674x}. @code{c64x}, @code{c64x+}, @code{c67x}, @code{c67x+}, @code{c674x}.
@cindex @code{-mdsbt} command line option, TIC6X @cindex @code{-mdsbt} command-line option, TIC6X
@cindex @code{-mno-dsbt} command line option, TIC6X @cindex @code{-mno-dsbt} command-line option, TIC6X
@item -mdsbt @item -mdsbt
@itemx -mno-dsbt @itemx -mno-dsbt
The @option{-mdsbt} option causes the assembler to generate the The @option{-mdsbt} option causes the assembler to generate the
@ -47,7 +47,7 @@ default, causes the tag to have a value of 0, indicating that the code
does not use DSBT addressing. The linker will emit a warning if does not use DSBT addressing. The linker will emit a warning if
objects of different type (DSBT and non-DSBT) are linked together. objects of different type (DSBT and non-DSBT) are linked together.
@cindex @code{-mpid=} command line option, TIC6X @cindex @code{-mpid=} command-line option, TIC6X
@item -mpid=no @item -mpid=no
@itemx -mpid=near @itemx -mpid=near
@itemx -mpid=far @itemx -mpid=far
@ -61,8 +61,8 @@ addressing with GOT accesses using far DP addressing. The linker will
emit a warning if objects built with different settings of this option emit a warning if objects built with different settings of this option
are linked together. are linked together.
@cindex @code{-mpic} command line option, TIC6X @cindex @code{-mpic} command-line option, TIC6X
@cindex @code{-mno-pic} command line option, TIC6X @cindex @code{-mno-pic} command-line option, TIC6X
@item -mpic @item -mpic
@itemx -mno-pic @itemx -mno-pic
The @option{-mpic} option causes the assembler to generate the The @option{-mpic} option causes the assembler to generate the

46
gas/doc/c-v850.texi
View file

@ -21,43 +21,43 @@
@code{@value{AS}} supports the following additional command-line options @code{@value{AS}} supports the following additional command-line options
for the V850 processor family: for the V850 processor family:
@cindex command line options, V850 @cindex command-line options, V850
@cindex V850 command line options @cindex V850 command-line options
@table @code @table @code
@cindex @code{-wsigned_overflow} command line option, V850 @cindex @code{-wsigned_overflow} command-line option, V850
@item -wsigned_overflow @item -wsigned_overflow
Causes warnings to be produced when signed immediate values overflow the Causes warnings to be produced when signed immediate values overflow the
space available for then within their opcodes. By default this option space available for then within their opcodes. By default this option
is disabled as it is possible to receive spurious warnings due to using is disabled as it is possible to receive spurious warnings due to using
exact bit patterns as immediate constants. exact bit patterns as immediate constants.
@cindex @code{-wunsigned_overflow} command line option, V850 @cindex @code{-wunsigned_overflow} command-line option, V850
@item -wunsigned_overflow @item -wunsigned_overflow
Causes warnings to be produced when unsigned immediate values overflow Causes warnings to be produced when unsigned immediate values overflow
the space available for then within their opcodes. By default this the space available for then within their opcodes. By default this
option is disabled as it is possible to receive spurious warnings due to option is disabled as it is possible to receive spurious warnings due to
using exact bit patterns as immediate constants. using exact bit patterns as immediate constants.
@cindex @code{-mv850} command line option, V850 @cindex @code{-mv850} command-line option, V850
@item -mv850 @item -mv850
Specifies that the assembled code should be marked as being targeted at Specifies that the assembled code should be marked as being targeted at
the V850 processor. This allows the linker to detect attempts to link the V850 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors. such code with code assembled for other processors.
@cindex @code{-mv850e} command line option, V850 @cindex @code{-mv850e} command-line option, V850
@item -mv850e @item -mv850e
Specifies that the assembled code should be marked as being targeted at Specifies that the assembled code should be marked as being targeted at
the V850E processor. This allows the linker to detect attempts to link the V850E processor. This allows the linker to detect attempts to link
such code with code assembled for other processors. such code with code assembled for other processors.
@cindex @code{-mv850e1} command line option, V850 @cindex @code{-mv850e1} command-line option, V850
@item -mv850e1 @item -mv850e1
Specifies that the assembled code should be marked as being targeted at Specifies that the assembled code should be marked as being targeted at
the V850E1 processor. This allows the linker to detect attempts to link the V850E1 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors. such code with code assembled for other processors.
@cindex @code{-mv850any} command line option, V850 @cindex @code{-mv850any} command-line option, V850
@item -mv850any @item -mv850any
Specifies that the assembled code should be marked as being targeted at Specifies that the assembled code should be marked as being targeted at
the V850 processor but support instructions that are specific to the the V850 processor but support instructions that are specific to the
@ -68,29 +68,29 @@ routines used by the code produced by GCC for all versions of the v850
architecture, together with support routines only used by the V850E architecture, together with support routines only used by the V850E
architecture. architecture.
@cindex @code{-mv850e2} command line option, V850 @cindex @code{-mv850e2} command-line option, V850
@item -mv850e2 @item -mv850e2
Specifies that the assembled code should be marked as being targeted at Specifies that the assembled code should be marked as being targeted at
the V850E2 processor. This allows the linker to detect attempts to link the V850E2 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors. such code with code assembled for other processors.
@cindex @code{-mv850e2v3} command line option, V850 @cindex @code{-mv850e2v3} command-line option, V850
@item -mv850e2v3 @item -mv850e2v3
Specifies that the assembled code should be marked as being targeted at Specifies that the assembled code should be marked as being targeted at
the V850E2V3 processor. This allows the linker to detect attempts to link the V850E2V3 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors. such code with code assembled for other processors.
@cindex @code{-mv850e2v4} command line option, V850 @cindex @code{-mv850e2v4} command-line option, V850
@item -mv850e2v4 @item -mv850e2v4
This is an alias for @option{-mv850e3v5}. This is an alias for @option{-mv850e3v5}.
@cindex @code{-mv850e3v5} command line option, V850 @cindex @code{-mv850e3v5} command-line option, V850
@item -mv850e3v5 @item -mv850e3v5
Specifies that the assembled code should be marked as being targeted at Specifies that the assembled code should be marked as being targeted at
the V850E3V5 processor. This allows the linker to detect attempts to link the V850E3V5 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors. such code with code assembled for other processors.
@cindex @code{-mrelax} command line option, V850 @cindex @code{-mrelax} command-line option, V850
@item -mrelax @item -mrelax
Enables relaxation. This allows the .longcall and .longjump pseudo Enables relaxation. This allows the .longcall and .longjump pseudo
ops to be used in the assembler source code. These ops label sections ops to be used in the assembler source code. These ops label sections
@ -98,34 +98,34 @@ of code which are either a long function call or a long branch. The
assembler will then flag these sections of code and the linker will assembler will then flag these sections of code and the linker will
attempt to relax them. attempt to relax them.
@cindex @code{-mgcc-abi} command line option, V850 @cindex @code{-mgcc-abi} command-line option, V850
@item -mgcc-abi @item -mgcc-abi
Marks the generated object file as supporting the old GCC ABI. Marks the generated object file as supporting the old GCC ABI.
@cindex @code{-mrh850-abi} command line option, V850 @cindex @code{-mrh850-abi} command-line option, V850
@item -mrh850-abi @item -mrh850-abi
Marks the generated object file as supporting the RH850 ABI. This is Marks the generated object file as supporting the RH850 ABI. This is
the default. the default.
@cindex @code{-m8byte-align} command line option, V850 @cindex @code{-m8byte-align} command-line option, V850
@item -m8byte-align @item -m8byte-align
Marks the generated object file as supporting a maximum 64-bits of Marks the generated object file as supporting a maximum 64-bits of
alignment for variables defined in the source code. alignment for variables defined in the source code.
@cindex @code{-m4byte-align} command line option, V850 @cindex @code{-m4byte-align} command-line option, V850
@item -m4byte-align @item -m4byte-align
Marks the generated object file as supporting a maximum 32-bits of Marks the generated object file as supporting a maximum 32-bits of
alignment for variables defined in the source code. This is the alignment for variables defined in the source code. This is the
default. default.
@cindex @code{-msoft-float} command line option, V850 @cindex @code{-msoft-float} command-line option, V850
@item -msoft-float @item -msoft-float
Marks the generated object file as not using any floating point Marks the generated object file as not using any floating point
instructions - and hence can be linked with other V850 binaries instructions - and hence can be linked with other V850 binaries
that do or do not use floating point. This is the default for that do or do not use floating point. This is the default for
binaries for architectures earlier than the @code{e2v3}. binaries for architectures earlier than the @code{e2v3}.
@cindex @code{-mhard-float} command line option, V850 @cindex @code{-mhard-float} command-line option, V850
@item -mhard-float @item -mhard-float
Marks the generated object file as one that uses floating point Marks the generated object file as one that uses floating point
instructions - and hence can only be linked with other V850 binaries instructions - and hence can only be linked with other V850 binaries
@ -423,7 +423,7 @@ into register 6, provided that the label is located somewhere within +/-
that the GP register contains a fixed address set to the address of the that the GP register contains a fixed address set to the address of the
label called '__gp'. This can either be set up automatically by the label called '__gp'. This can either be set up automatically by the
linker, or specifically set by using the @samp{--defsym __gp=<value>} linker, or specifically set by using the @samp{--defsym __gp=<value>}
command line option]. command-line option].
@cindex @code{tdaoff} pseudo-op, V850 @cindex @code{tdaoff} pseudo-op, V850
@item tdaoff() @item tdaoff()
@ -440,7 +440,7 @@ bytes of the address held in the EP register. [Note the linker assumes
that the EP register contains a fixed address set to the address of the that the EP register contains a fixed address set to the address of the
label called '__ep'. This can either be set up automatically by the label called '__ep'. This can either be set up automatically by the
linker, or specifically set by using the @samp{--defsym __ep=<value>} linker, or specifically set by using the @samp{--defsym __ep=<value>}
command line option]. command-line option].
@cindex @code{zdaoff} pseudo-op, V850 @cindex @code{zdaoff} pseudo-op, V850
@item zdaoff() @item zdaoff()
@ -473,14 +473,14 @@ at the location labeled 'table_func1'.
Indicates that the following sequence of instructions is a long call Indicates that the following sequence of instructions is a long call
to function @code{name}. The linker will attempt to shorten this call to function @code{name}. The linker will attempt to shorten this call
sequence if @code{name} is within a 22bit offset of the call. Only sequence if @code{name} is within a 22bit offset of the call. Only
valid if the @code{-mrelax} command line switch has been enabled. valid if the @code{-mrelax} command-line switch has been enabled.
@cindex @code{longjump} pseudo-op, V850 @cindex @code{longjump} pseudo-op, V850
@item .longjump @code{name} @item .longjump @code{name}
Indicates that the following sequence of instructions is a long jump Indicates that the following sequence of instructions is a long jump
to label @code{name}. The linker will attempt to shorten this code to label @code{name}. The linker will attempt to shorten this code
sequence if @code{name} is within a 22bit offset of the jump. Only sequence if @code{name} is within a 22bit offset of the jump. Only
valid if the @code{-mrelax} command line switch has been enabled. valid if the @code{-mrelax} command-line switch has been enabled.
@end table @end table

2
gas/doc/c-vax.texi
View file

@ -50,7 +50,7 @@ These are obsolete options used to debug old assemblers.
@item @code{-d} (Displacement size for JUMPs) @item @code{-d} (Displacement size for JUMPs)
This option expects a number following the @samp{-d}. Like options This option expects a number following the @samp{-d}. Like options
that expect filenames, the number may immediately follow the that expect filenames, the number may immediately follow the
@samp{-d} (old standard) or constitute the whole of the command line @samp{-d} (old standard) or constitute the whole of the command-line
argument that follows @samp{-d} (@sc{gnu} standard). argument that follows @samp{-d} (@sc{gnu} standard).
@cindex @code{-V}, redundant on VAX @cindex @code{-V}, redundant on VAX

2
gas/doc/c-visium.texi
View file

@ -30,7 +30,7 @@ The Visium assembler implements one machine-specific option:
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@cindex @code{-mtune=@var{arch}} command line option, Visium @cindex @code{-mtune=@var{arch}} command-line option, Visium
@item -mtune=@var{arch} @item -mtune=@var{arch}
This option specifies the target architecture. If an attempt is made to This option specifies the target architecture. If an attempt is made to
assemble an instruction that will not execute on the target architecture, assemble an instruction that will not execute on the target architecture,

6
gas/doc/c-xstormy16.texi
View file

@ -52,17 +52,17 @@ line.
@cindex @code{16bit_pointers} directive, XStormy16 @cindex @code{16bit_pointers} directive, XStormy16
@item .16bit_pointers @item .16bit_pointers
Like the @option{--16bit-pointers} command line option this directive Like the @option{--16bit-pointers} command-line option this directive
indicates that the assembly code makes use of 16-bit pointers. indicates that the assembly code makes use of 16-bit pointers.
@cindex @code{32bit_pointers} directive, XStormy16 @cindex @code{32bit_pointers} directive, XStormy16
@item .32bit_pointers @item .32bit_pointers
Like the @option{--32bit-pointers} command line option this directive Like the @option{--32bit-pointers} command-line option this directive
indicates that the assembly code makes use of 32-bit pointers. indicates that the assembly code makes use of 32-bit pointers.
@cindex @code{.no_pointers} directive, XStormy16 @cindex @code{.no_pointers} directive, XStormy16
@item .no_pointers @item .no_pointers
Like the @option{--no-pointers} command line option this directive Like the @option{--no-pointers} command-line option this directive
indicates that the assembly code does not makes use pointers. indicates that the assembly code does not makes use pointers.
@end table @end table

14
gas/doc/c-xtensa.texi
View file

@ -28,7 +28,7 @@ Reference Manual}.
@end menu @end menu
@node Xtensa Options @node Xtensa Options
@section Command Line Options @section Command-line Options
@c man begin OPTIONS @c man begin OPTIONS
@table @gcctabopt @table @gcctabopt
@ -296,7 +296,7 @@ call. This alignment has the potential to reduce branch penalties at
some expense in code size. some expense in code size.
This optimization is enabled by default. You can disable it with the This optimization is enabled by default. You can disable it with the
@samp{--no-target-@-align} command-line option (@pxref{Xtensa Options, @samp{--no-target-@-align} command-line option (@pxref{Xtensa Options,
,Command Line Options}). ,Command-line Options}).
The target alignment optimization is done without adding instructions The target alignment optimization is done without adding instructions
that could increase the execution time of the program. If there are that could increase the execution time of the program. If there are
@ -383,7 +383,7 @@ unconditional jump to a target that is out of range.
Branch relaxation is enabled by default. It can be disabled by using Branch relaxation is enabled by default. It can be disabled by using
underscore prefixes (@pxref{Xtensa Opcodes, ,Opcode Names}), the underscore prefixes (@pxref{Xtensa Opcodes, ,Opcode Names}), the
@samp{--no-transform} command-line option (@pxref{Xtensa Options, @samp{--no-transform} command-line option (@pxref{Xtensa Options,
,Command Line Options}), or the @code{no-transform} directive ,Command-line Options}), or the @code{no-transform} directive
(@pxref{Transform Directive, ,transform}). (@pxref{Transform Directive, ,transform}).
@node Xtensa Call Relaxation @node Xtensa Call Relaxation
@ -509,7 +509,7 @@ will reach their targets once resolved.
Jump relaxation is enabled by default because it does not affect code size Jump relaxation is enabled by default because it does not affect code size
or performance while the code itself is small. This relaxation may be or performance while the code itself is small. This relaxation may be
disabled completely with @samp{--no-trampolines} or @samp{--no-transform} disabled completely with @samp{--no-trampolines} or @samp{--no-transform}
command-line options (@pxref{Xtensa Options, ,Command Line Options}). command-line options (@pxref{Xtensa Options, ,Command-line Options}).
@node Xtensa Immediate Relaxation @node Xtensa Immediate Relaxation
@subsection Other Immediate Field Relaxation @subsection Other Immediate Field Relaxation
@ -519,7 +519,7 @@ command-line options (@pxref{Xtensa Options, ,Command Line Options}).
The assembler normally performs the following other relaxations. They The assembler normally performs the following other relaxations. They
can be disabled by using underscore prefixes (@pxref{Xtensa Opcodes, can be disabled by using underscore prefixes (@pxref{Xtensa Opcodes,
,Opcode Names}), the @samp{--no-transform} command-line option ,Opcode Names}), the @samp{--no-transform} command-line option
(@pxref{Xtensa Options, ,Command Line Options}), or the (@pxref{Xtensa Options, ,Command-line Options}), or the
@code{no-transform} directive (@pxref{Transform Directive, ,transform}). @code{no-transform} directive (@pxref{Transform Directive, ,transform}).
@cindex @code{MOVI} instructions, relaxation @cindex @code{MOVI} instructions, relaxation
@ -770,7 +770,7 @@ the data in a literal pool.
Literal pools are placed by default in separate literal sections; Literal pools are placed by default in separate literal sections;
however, when using the @samp{--text-@-section-@-literals} however, when using the @samp{--text-@-section-@-literals}
option (@pxref{Xtensa Options, ,Command Line Options}), the literal option (@pxref{Xtensa Options, ,Command-line Options}), the literal
pools for PC-relative mode @code{L32R} instructions pools for PC-relative mode @code{L32R} instructions
are placed in the current section.@footnote{Literals for the are placed in the current section.@footnote{Literals for the
@code{.init} and @code{.fini} sections are always placed in separate @code{.init} and @code{.fini} sections are always placed in separate
@ -893,7 +893,7 @@ do not change. @xref{Literal Directive, ,literal}. If the @var{name}
argument is omitted, the literal sections revert to the defaults. This argument is omitted, the literal sections revert to the defaults. This
directive has no effect when using the directive has no effect when using the
@samp{--text-@-section-@-literals} option (@pxref{Xtensa Options, @samp{--text-@-section-@-literals} option (@pxref{Xtensa Options,
,Command Line Options}). ,Command-line Options}).
@node Absolute Literals Directive @node Absolute Literals Directive
@subsection absolute-literals @subsection absolute-literals

4
gas/doc/c-z80.texi
View file

@ -30,7 +30,7 @@
The Zilog Z80 and Ascii R800 version of @code{@value{AS}} have a few machine The Zilog Z80 and Ascii R800 version of @code{@value{AS}} have a few machine
dependent options. dependent options.
@table @option @table @option
@cindex @code{-z80} command line option, Z80 @cindex @code{-z80} command-line option, Z80
@item -z80 @item -z80
Produce code for the Z80 processor. There are additional options to Produce code for the Z80 processor. There are additional options to
request warnings and error messages for undocumented instructions. request warnings and error messages for undocumented instructions.
@ -56,7 +56,7 @@ Treat all undocumented z80-instructions as errors.
@itemx -Fup @itemx -Fup
Treat undocumented z80-instructions that do not work on R800 as errors. Treat undocumented z80-instructions that do not work on R800 as errors.
@cindex @code{-r800} command line option, Z80 @cindex @code{-r800} command-line option, Z80
@item -r800 @item -r800
Produce code for the R800 processor. The assembler does not support Produce code for the R800 processor. The assembler does not support
undocumented instructions for the R800. undocumented instructions for the R800.

4
gas/doc/c-z8k.texi
View file

@ -36,11 +36,11 @@ for a list of other Z8000 specific assembler directives.
@cindex Z8000 options @cindex Z8000 options
@cindex options, Z8000 @cindex options, Z8000
@table @option @table @option
@cindex @code{-z8001} command line option, Z8000 @cindex @code{-z8001} command-line option, Z8000
@item -z8001 @item -z8001
Generate segmented code by default. Generate segmented code by default.
@cindex @code{-z8002} command line option, Z8000 @cindex @code{-z8002} command-line option, Z8000
@item -z8002 @item -z8002
Generate unsegmented code by default. Generate unsegmented code by default.
@end table @end table

4
gas/doc/internals.texi
View file

@ -1224,7 +1224,7 @@ the relax table.
@item LINKER_RELAXING_SHRINKS_ONLY @item LINKER_RELAXING_SHRINKS_ONLY
@cindex LINKER_RELAXING_SHRINKS_ONLY @cindex LINKER_RELAXING_SHRINKS_ONLY
If you define this macro, and the global variable @samp{linkrelax} is set If you define this macro, and the global variable @samp{linkrelax} is set
(because of a command line option, or unconditionally in @code{md_begin}), a (because of a command-line option, or unconditionally in @code{md_begin}), a
@samp{.align} directive will cause extra space to be allocated. The linker can @samp{.align} directive will cause extra space to be allocated. The linker can
then discard this space when relaxing the section. then discard this space when relaxing the section.
@ -1588,7 +1588,7 @@ if it is necessary to add object file format specific code to the CPU file.
@item obj_begin @item obj_begin
If you define this macro, GAS will call it at the start of the assembly, after If you define this macro, GAS will call it at the start of the assembly, after
the command line arguments have been parsed and all the machine independent the command-line arguments have been parsed and all the machine independent
initializations have been completed. initializations have been completed.
@item obj_app_file @item obj_app_file

5
gprof/ChangeLog
View file

@ -1,3 +1,8 @@
2018-07-02 Thomas Preud'homme <thomas.preudhomme@arm.com>
* gprof.texi: Use command-line consistently when used in a compount
word.
2018-06-24 Nick Clifton <nickc@redhat.com> 2018-06-24 Nick Clifton <nickc@redhat.com>
* configure: Regenerate. * configure: Regenerate.

6
gprof/gprof.texi
View file

@ -331,7 +331,7 @@ initialised. This is usually detected by the program encountering a
segmentation fault as soon as it is run. The solution is to link segmentation fault as soon as it is run. The solution is to link
against a static version of the library containing the profiling against a static version of the library containing the profiling
support code, which for @code{gcc} users can be done via the support code, which for @code{gcc} users can be done via the
@samp{-static} or @samp{-static-libgcc} command line option. For @samp{-static} or @samp{-static-libgcc} command-line option. For
example: example:
@example @example
@ -357,7 +357,7 @@ there is still support for displaying this kind of information in
@code{gprof}. @xref{Line-by-line, ,Line-by-line Profiling}. @code{gprof}. @xref{Line-by-line, ,Line-by-line Profiling}.
It also worth noting that @code{gcc} implements a It also worth noting that @code{gcc} implements a
@samp{-finstrument-functions} command line option which will insert @samp{-finstrument-functions} command-line option which will insert
calls to special user supplied instrumentation routines at the entry calls to special user supplied instrumentation routines at the entry
and exit of every function in their program. This can be used to and exit of every function in their program. This can be used to
implement an alternative profiling scheme. implement an alternative profiling scheme.
@ -1431,7 +1431,7 @@ With the older versions of @code{gcc} the program usually has to be
compiled with a @samp{-g} option, in addition to @samp{-pg}, in order compiled with a @samp{-g} option, in addition to @samp{-pg}, in order
to generate debugging symbols for tracking source code lines. to generate debugging symbols for tracking source code lines.
Note, in much older versions of @code{gcc} the program had to be Note, in much older versions of @code{gcc} the program had to be
compiled with the @samp{-a} command line option as well. compiled with the @samp{-a} command-line option as well.
The flat profile is the most useful output table The flat profile is the most useful output table
in line-by-line mode. in line-by-line mode.

6
ld/ChangeLog
View file

@ -1,3 +1,9 @@
2018-07-02 Thomas Preud'homme <thomas.preudhomme@arm.com>
* NEWS: Use command-line consistently when used in a compount word.
* ld.texinfo: Likewise.
* ldint.texinfo: Likewise.
2018-06-26 Nick Clifton <nickc@redhat.com> 2018-06-26 Nick Clifton <nickc@redhat.com>
* po/uk.po: Updated Ukranian translation. * po/uk.po: Updated Ukranian translation.

28
ld/NEWS
View file

@ -13,9 +13,9 @@ Changes in 2.30:
* Add -z separate-code to generate separate code PT_LOAD segment. * Add -z separate-code to generate separate code PT_LOAD segment.
* Add "-z undefs" command line option as the inverse of the "-z defs" option. * Add "-z undefs" command-line option as the inverse of the "-z defs" option.
* Add -z globalaudit command line option to force audit libraries to be run * Add -z globalaudit command-line option to force audit libraries to be run
for every dynamic object loaded by an executable - provided that the loader for every dynamic object loaded by an executable - provided that the loader
supports this functionality. supports this functionality.
@ -72,7 +72,7 @@ Changes in 2.28:
* Add support for the RISC-V architecture. * Add support for the RISC-V architecture.
* The command line option --no-eh-frame-hdr can now be used in ELF based * The command-line option --no-eh-frame-hdr can now be used in ELF based
linkers to disable the automatic generation of .eh_frame_hdr sections. linkers to disable the automatic generation of .eh_frame_hdr sections.
* Add --in-implib=<infile> to the ARM linker to enable specifying a set of * Add --in-implib=<infile> to the ARM linker to enable specifying a set of
@ -120,10 +120,10 @@ Changes in 2.26:
* Experimental support for linker garbage collection (--gc-sections) * Experimental support for linker garbage collection (--gc-sections)
has been enabled for COFF and PE based targets. has been enabled for COFF and PE based targets.
* New command line option for ELF targets to compress DWARF debug * New command-line option for ELF targets to compress DWARF debug
sections, --compress-debug-sections=[none|zlib|zlib-gnu|zlib-gabi]. sections, --compress-debug-sections=[none|zlib|zlib-gnu|zlib-gabi].
* New command line option, --orphan-handling=[place|warn|error|discard], to * New command-line option, --orphan-handling=[place|warn|error|discard], to
adjust how orphan sections are handled. The default is 'place' which gives adjust how orphan sections are handled. The default is 'place' which gives
the current behaviour, 'warn' and 'error' issue a warning or error the current behaviour, 'warn' and 'error' issue a warning or error
respectively when orphan sections are found, and 'discard' will discard all respectively when orphan sections are found, and 'discard' will discard all
@ -140,11 +140,11 @@ Changes in 2.25:
* PE binaries now once again contain real timestamps by default. To disable * PE binaries now once again contain real timestamps by default. To disable
the inclusion of a timestamp in a PE binary, use the --no-insert-timestamp the inclusion of a timestamp in a PE binary, use the --no-insert-timestamp
command line option. command-line option.
* Replace support for openrisc and or32 with support for or1k. * Replace support for openrisc and or32 with support for or1k.
* Add support for the --build-id command line option to COFF based targets. * Add support for the --build-id command-line option to COFF based targets.
* x86/x86_64 pe-coff now supports the --build-id option. * x86/x86_64 pe-coff now supports the --build-id option.
@ -270,7 +270,7 @@ Changes in 2.20:
latter case the library is not linked if it is found in a DT_NEEDED latter case the library is not linked if it is found in a DT_NEEDED
entry of one of the libraries already linked. entry of one of the libraries already linked.
* Add a new command line option, -Ttext-segment ADDR, for ELF targets * Add a new command-line option, -Ttext-segment ADDR, for ELF targets
to set the address of the first byte of the text segment. to set the address of the first byte of the text segment.
* Add support for Sunplus score architecture. * Add support for Sunplus score architecture.
@ -305,11 +305,11 @@ Changes in 2.19:
direction of sorting. direction of sorting.
* The M68K linker now supports multiple GOT generation schemes controlled via * The M68K linker now supports multiple GOT generation schemes controlled via
the --got=<type> command line option. the --got=<type> command-line option.
* The ARM EABI linker will now generate stubs for function calls to symbols * The ARM EABI linker will now generate stubs for function calls to symbols
that are too far away. The placement of the stubs is controlled by a new that are too far away. The placement of the stubs is controlled by a new
linker command line option: --stub-group-size=N. linker command-line option: --stub-group-size=N.
Changes in 2.18: Changes in 2.18:
@ -324,7 +324,7 @@ Changes in 2.18:
* -l:foo now searches the library path for a filename called foo, * -l:foo now searches the library path for a filename called foo,
without converting it to libfoo.a or libfoo.so. without converting it to libfoo.a or libfoo.so.
* Add a new command line option '--default-script=FILE' or '-dT FILE' * Add a new command-line option '--default-script=FILE' or '-dT FILE'
which specifies a replacement for the built in, default linker which specifies a replacement for the built in, default linker
script. script.
@ -398,7 +398,7 @@ Changes in 2.16:
language to permit sorting sections by section name or section language to permit sorting sections by section name or section
maximum alignment. maximum alignment.
* Added a new linker command line switch, --sort-section name|alignment, * Added a new linker command-line switch, --sort-section name|alignment,
to sort sections by section name or maximum alignment. to sort sections by section name or maximum alignment.
* ELF: --add-needed/--no-add-needed options to control if a DT_NEEDED tag * ELF: --add-needed/--no-add-needed options to control if a DT_NEEDED tag
@ -408,7 +408,7 @@ Changes in 2.16:
* Support for the sh-symbianelf target added. * Support for the sh-symbianelf target added.
* A new linker command line switch has been added which allows the hash table * A new linker command-line switch has been added which allows the hash table
size to be set to a suitable prime value near to its argument. This switch size to be set to a suitable prime value near to its argument. This switch
is --hash-size=<NUMBER>. Also if the switch --reduce-memory-overheads is is --hash-size=<NUMBER>. Also if the switch --reduce-memory-overheads is
used, and --hash-size has not been used, then the default value will be set used, and --hash-size has not been used, then the default value will be set
@ -508,7 +508,7 @@ Changes in version 2.11:
* TI C54x support, by Timothy Wall. * TI C54x support, by Timothy Wall.
* Added command line switch --section-start to set the start address of any * Added command-line switch --section-start to set the start address of any
specified section. specified section.
* Added ability to emit full relocation information in linked executables, * Added ability to emit full relocation information in linked executables,

70
ld/ld.texi
View file

@ -247,12 +247,12 @@ you have many choices to control its behavior.
@ifset UsesEnvVars @ifset UsesEnvVars
@menu @menu
* Options:: Command Line Options * Options:: Command-line Options
* Environment:: Environment Variables * Environment:: Environment Variables
@end menu @end menu
@node Options @node Options
@section Command Line Options @section Command-line Options
@end ifset @end ifset
@cindex command line @cindex command line
@ -332,7 +332,7 @@ Unique abbreviations of the names of multiple-letter options are
accepted. accepted.
Note---if the linker is being invoked indirectly, via a compiler driver Note---if the linker is being invoked indirectly, via a compiler driver
(e.g. @samp{gcc}) then all the linker command line options should be (e.g. @samp{gcc}) then all the linker command-line options should be
prefixed by @samp{-Wl,} (or whatever is appropriate for the particular prefixed by @samp{-Wl,} (or whatever is appropriate for the particular
compiler driver) like this: compiler driver) like this:
@ -352,7 +352,7 @@ the joined forms of both single- and multiple-letter options, such as:
gcc foo.o bar.o -Wl,-eENTRY -Wl,-Map=a.map gcc foo.o bar.o -Wl,-eENTRY -Wl,-Map=a.map
@end smallexample @end smallexample
Here is a table of the generic command line switches accepted by the GNU Here is a table of the generic command-line switches accepted by the GNU
linker: linker:
@table @gcctabopt @table @gcctabopt
@ -1153,7 +1153,7 @@ This option is only meaningful when building a dynamic executable.
This option marks the executable as requiring global auditing by This option marks the executable as requiring global auditing by
setting the @code{DF_1_GLOBAUDIT} bit in the @code{DT_FLAGS_1} dynamic setting the @code{DF_1_GLOBAUDIT} bit in the @code{DT_FLAGS_1} dynamic
tag. Global auditing requires that any auditing library defined via tag. Global auditing requires that any auditing library defined via
the @option{--depaudit} or @option{-P} command line options be run for the @option{--depaudit} or @option{-P} command-line options be run for
all dynamic objects loaded by the application. all dynamic objects loaded by the application.
@item ibtplt @item ibtplt
@ -1436,7 +1436,7 @@ been assigned to see if there are any overlaps. Normally the linker will
perform this check, and if it finds any overlaps it will produce perform this check, and if it finds any overlaps it will produce
suitable error messages. The linker does know about, and does make suitable error messages. The linker does know about, and does make
allowances for sections in overlays. The default behaviour can be allowances for sections in overlays. The default behaviour can be
restored by using the command line switch @option{--check-sections}. restored by using the command-line switch @option{--check-sections}.
Section overlap is not usually checked for relocatable links. You can Section overlap is not usually checked for relocatable links. You can
force checking in that case by using the @option{--check-sections} force checking in that case by using the @option{--check-sections}
option. option.
@ -2497,7 +2497,7 @@ symbols from, to ensure that they get linked in, just like a normal
object file). object file).
In addition to the options common to all targets, the i386 PE linker In addition to the options common to all targets, the i386 PE linker
support additional command line options that are specific to the i386 support additional command-line options that are specific to the i386
PE target. Options that take values may be separated from their PE target. Options that take values may be separated from their
values by either a space or an equals sign. values by either a space or an equals sign.
@ -3168,8 +3168,8 @@ described below.
The linker always uses a linker script. If you do not supply one The linker always uses a linker script. If you do not supply one
yourself, the linker will use a default script that is compiled into the yourself, the linker will use a default script that is compiled into the
linker executable. You can use the @samp{--verbose} command line option linker executable. You can use the @samp{--verbose} command-line option
to display the default linker script. Certain command line options, to display the default linker script. Certain command-line options,
such as @samp{-r} or @samp{-N}, will affect the default linker script. such as @samp{-r} or @samp{-N}, will affect the default linker script.
You may supply your own linker script by using the @samp{-T} command You may supply your own linker script by using the @samp{-T} command
@ -3425,10 +3425,10 @@ linker will search through the archive library search path.
The @dfn{sysroot prefix} can also be forced by specifying @code{=} The @dfn{sysroot prefix} can also be forced by specifying @code{=}
as the first character in the filename path, or prefixing the filename as the first character in the filename path, or prefixing the filename
path with @code{$SYSROOT}. See also the description of @samp{-L} in path with @code{$SYSROOT}. See also the description of @samp{-L} in
@ref{Options,,Command Line Options}. @ref{Options,,Command-line Options}.
If you use @samp{INPUT (-l@var{file})}, @command{ld} will transform the If you use @samp{INPUT (-l@var{file})}, @command{ld} will transform the
name to @code{lib@var{file}.a}, as with the command line argument name to @code{lib@var{file}.a}, as with the command-line argument
@samp{-l}. @samp{-l}.
When you use the @code{INPUT} command in an implicit linker script, the When you use the @code{INPUT} command in an implicit linker script, the
@ -3442,7 +3442,7 @@ script file is included. This can affect archive searching.
The @code{GROUP} command is like @code{INPUT}, except that the named The @code{GROUP} command is like @code{INPUT}, except that the named
files should all be archives, and they are searched repeatedly until no files should all be archives, and they are searched repeatedly until no
new undefined references are created. See the description of @samp{-(} new undefined references are created. See the description of @samp{-(}
in @ref{Options,,Command Line Options}. in @ref{Options,,Command-line Options}.
@item AS_NEEDED(@var{file}, @var{file}, @dots{}) @item AS_NEEDED(@var{file}, @var{file}, @dots{})
@itemx AS_NEEDED(@var{file} @var{file} @dots{}) @itemx AS_NEEDED(@var{file} @var{file} @dots{})
@ -3462,7 +3462,7 @@ setting afterwards.
The @code{OUTPUT} command names the output file. Using The @code{OUTPUT} command names the output file. Using
@code{OUTPUT(@var{filename})} in the linker script is exactly like using @code{OUTPUT(@var{filename})} in the linker script is exactly like using
@samp{-o @var{filename}} on the command line (@pxref{Options,,Command @samp{-o @var{filename}} on the command line (@pxref{Options,,Command
Line Options}). If both are used, the command line option takes Line Options}). If both are used, the command-line option takes
precedence. precedence.
You can use the @code{OUTPUT} command to define a default name for the You can use the @code{OUTPUT} command to define a default name for the
@ -3476,9 +3476,9 @@ output file other than the usual default of @file{a.out}.
The @code{SEARCH_DIR} command adds @var{path} to the list of paths where The @code{SEARCH_DIR} command adds @var{path} to the list of paths where
@command{ld} looks for archive libraries. Using @command{ld} looks for archive libraries. Using
@code{SEARCH_DIR(@var{path})} is exactly like using @samp{-L @var{path}} @code{SEARCH_DIR(@var{path})} is exactly like using @samp{-L @var{path}}
on the command line (@pxref{Options,,Command Line Options}). If both on the command line (@pxref{Options,,Command-line Options}). If both
are used, then the linker will search both paths. Paths specified using are used, then the linker will search both paths. Paths specified using
the command line option are searched first. the command-line option are searched first.
@item STARTUP(@var{filename}) @item STARTUP(@var{filename})
@kindex STARTUP(@var{filename}) @kindex STARTUP(@var{filename})
@ -3503,11 +3503,11 @@ A couple of linker script commands deal with object file formats.
The @code{OUTPUT_FORMAT} command names the BFD format to use for the The @code{OUTPUT_FORMAT} command names the BFD format to use for the
output file (@pxref{BFD}). Using @code{OUTPUT_FORMAT(@var{bfdname})} is output file (@pxref{BFD}). Using @code{OUTPUT_FORMAT(@var{bfdname})} is
exactly like using @samp{--oformat @var{bfdname}} on the command line exactly like using @samp{--oformat @var{bfdname}} on the command line
(@pxref{Options,,Command Line Options}). If both are used, the command (@pxref{Options,,Command-line Options}). If both are used, the command
line option takes precedence. line option takes precedence.
You can use @code{OUTPUT_FORMAT} with three arguments to use different You can use @code{OUTPUT_FORMAT} with three arguments to use different
formats based on the @samp{-EB} and @samp{-EL} command line options. formats based on the @samp{-EB} and @samp{-EL} command-line options.
This permits the linker script to set the output format based on the This permits the linker script to set the output format based on the
desired endianness. desired endianness.
@ -3522,7 +3522,7 @@ command:
OUTPUT_FORMAT(elf32-bigmips, elf32-bigmips, elf32-littlemips) OUTPUT_FORMAT(elf32-bigmips, elf32-bigmips, elf32-littlemips)
@end smallexample @end smallexample
This says that the default format for the output file is This says that the default format for the output file is
@samp{elf32-bigmips}, but if the user uses the @samp{-EL} command line @samp{elf32-bigmips}, but if the user uses the @samp{-EL} command-line
option, the output file will be created in the @samp{elf32-littlemips} option, the output file will be created in the @samp{elf32-littlemips}
format. format.
@ -3532,7 +3532,7 @@ format.
The @code{TARGET} command names the BFD format to use when reading input The @code{TARGET} command names the BFD format to use when reading input
files. It affects subsequent @code{INPUT} and @code{GROUP} commands. files. It affects subsequent @code{INPUT} and @code{GROUP} commands.
This command is like using @samp{-b @var{bfdname}} on the command line This command is like using @samp{-b @var{bfdname}} on the command line
(@pxref{Options,,Command Line Options}). If the @code{TARGET} command (@pxref{Options,,Command-line Options}). If the @code{TARGET} command
is used but @code{OUTPUT_FORMAT} is not, then the last @code{TARGET} is used but @code{OUTPUT_FORMAT} is not, then the last @code{TARGET}
command is also used to set the format for the output file. @xref{BFD}. command is also used to set the format for the output file. @xref{BFD}.
@end table @end table
@ -4552,12 +4552,12 @@ is treated the same as @code{SORT_BY_ALIGNMENT} (wildcard section pattern).
All other nested section sorting commands are invalid. All other nested section sorting commands are invalid.
@end enumerate @end enumerate
When both command line section sorting option and linker script When both command-line section sorting option and linker script
section sorting command are used, section sorting command always section sorting command are used, section sorting command always
takes precedence over the command line option. takes precedence over the command-line option.
If the section sorting command in linker script isn't nested, the If the section sorting command in linker script isn't nested, the
command line option will make the section sorting command to be command-line option will make the section sorting command to be
treated as nested sorting command. treated as nested sorting command.
@enumerate @enumerate
@ -4572,10 +4572,10 @@ treated as nested sorting command.
@end enumerate @end enumerate
If the section sorting command in linker script is nested, the If the section sorting command in linker script is nested, the
command line option will be ignored. command-line option will be ignored.
@cindex SORT_NONE @cindex SORT_NONE
@code{SORT_NONE} disables section sorting by ignoring the command line @code{SORT_NONE} disables section sorting by ignoring the command-line
section sorting option. section sorting option.
If you ever get confused about where input sections are going, use the If you ever get confused about where input sections are going, use the
@ -5871,8 +5871,8 @@ attribute, such as code vs data, loadable vs non-loadable, etc. If no
sections with matching attributes are found, or your target lacks this sections with matching attributes are found, or your target lacks this
support, the orphan section is placed at the end of the file. support, the orphan section is placed at the end of the file.
The command line options @samp{--orphan-handling} and @samp{--unique} The command-line options @samp{--orphan-handling} and @samp{--unique}
(@pxref{Options,,Command Line Options}) can be used to control which (@pxref{Options,,Command-line Options}) can be used to control which
output sections an orphan is placed in. output sections an orphan is placed in.
@node Location Counter @node Location Counter
@ -6734,7 +6734,7 @@ between ARM and Thumb code. These stubs only work with code that has
been compiled and assembled with the @samp{-mthumb-interwork} command been compiled and assembled with the @samp{-mthumb-interwork} command
line option. If it is necessary to link with old ARM object files or line option. If it is necessary to link with old ARM object files or
libraries, which have not been compiled with the -mthumb-interwork libraries, which have not been compiled with the -mthumb-interwork
option then the @samp{--support-old-code} command line switch should be option then the @samp{--support-old-code} command-line switch should be
given to the linker. This will make it generate larger stub functions given to the linker. This will make it generate larger stub functions
which will work with non-interworking aware ARM code. Note, however, which will work with non-interworking aware ARM code. Note, however,
the linker does not support generating stubs for function calls to the linker does not support generating stubs for function calls to
@ -6940,7 +6940,7 @@ The linker will automatically generate and insert small sequences of
code into a linked ARM ELF executable whenever an attempt is made to code into a linked ARM ELF executable whenever an attempt is made to
perform a function call to a symbol that is too far away. The perform a function call to a symbol that is too far away. The
placement of these sequences of instructions - called stubs - is placement of these sequences of instructions - called stubs - is
controlled by the command line option @option{--stub-group-size=N}. controlled by the command-line option @option{--stub-group-size=N}.
The placement is important because a poor choice can create a need for The placement is important because a poor choice can create a need for
duplicate stubs, increasing the code size. The linker will try to duplicate stubs, increasing the code size. The linker will try to
group stubs together in order to reduce interruptions to the flow of group stubs together in order to reduce interruptions to the flow of
@ -6997,7 +6997,7 @@ link-time values for dynamic relocations.
@cindex Placement of SG veneers @cindex Placement of SG veneers
All SG veneers are placed in the special output section @code{.gnu.sgstubs}. All SG veneers are placed in the special output section @code{.gnu.sgstubs}.
Its start address must be set, either with the command line option Its start address must be set, either with the command-line option
@samp{--section-start} or in a linker script, to indicate where to place these @samp{--section-start} or in a linker script, to indicate where to place these
veneers in memory. veneers in memory.
@ -7734,8 +7734,8 @@ header format depends on the default specified by the specific target.
@section @command{ld} and WIN32 (cygwin/mingw) @section @command{ld} and WIN32 (cygwin/mingw)
This section describes some of the win32 specific @command{ld} issues. This section describes some of the win32 specific @command{ld} issues.
See @ref{Options,,Command Line Options} for detailed description of the See @ref{Options,,Command-line Options} for detailed description of the
command line options mentioned here. command-line options mentioned here.
@table @emph @table @emph
@cindex import libraries @cindex import libraries
@ -7745,7 +7745,7 @@ libraries, which contains information for linking to dll's. They are
regular static archives and are handled as any other static regular static archives and are handled as any other static
archive. The cygwin and mingw ports of @command{ld} have specific archive. The cygwin and mingw ports of @command{ld} have specific
support for creating such libraries provided with the support for creating such libraries provided with the
@samp{--out-implib} command line option. @samp{--out-implib} command-line option.
@item exporting DLL symbols @item exporting DLL symbols
@cindex exporting DLL symbols @cindex exporting DLL symbols
@ -7755,7 +7755,7 @@ The cygwin/mingw @command{ld} has several ways to export symbols for dll's.
@item using auto-export functionality @item using auto-export functionality
@cindex using auto-export functionality @cindex using auto-export functionality
By default @command{ld} exports symbols with the auto-export functionality, By default @command{ld} exports symbols with the auto-export functionality,
which is controlled by the following command line options: which is controlled by the following command-line options:
@itemize @itemize
@item --export-all-symbols [This is the default] @item --export-all-symbols [This is the default]
@ -7889,7 +7889,7 @@ other DEF file statements
@cindex creating a DEF file @cindex creating a DEF file
While linking a shared dll, @command{ld} is able to create a DEF file While linking a shared dll, @command{ld} is able to create a DEF file
with the @samp{--output-def <file>} command line option. with the @samp{--output-def <file>} command-line option.
@item Using decorations @item Using decorations
@cindex Using decorations @cindex Using decorations
@ -8150,7 +8150,7 @@ The line @samp{_foo = foo} maps the exported symbol @samp{foo} to
@end table @end table
Note: using a DEF file disables the default auto-export behavior, Note: using a DEF file disables the default auto-export behavior,
unless the @samp{--export-all-symbols} command line option is used. unless the @samp{--export-all-symbols} command-line option is used.
If, however, you are trying to rename symbols, then you should list If, however, you are trying to rename symbols, then you should list
@emph{all} desired exports in the DEF file, including the symbols @emph{all} desired exports in the DEF file, including the symbols
that are not being renamed, and do @emph{not} use the that are not being renamed, and do @emph{not} use the

4
ld/ldint.texi
View file

@ -113,7 +113,7 @@ The @file{genscripts.sh} script will invoke a shell script in the
written in the linker command language. The @file{scripttempl} script written in the linker command language. The @file{scripttempl} script
will be invoked 5 (or, in some cases, 6) times, with different will be invoked 5 (or, in some cases, 6) times, with different
assignments to shell variables, to create different default scripts. assignments to shell variables, to create different default scripts.
The choice of script is made based on the command line options. The choice of script is made based on the command-line options.
After creating the scripts, @file{genscripts.sh} will invoke yet another After creating the scripts, @file{genscripts.sh} will invoke yet another
shell script, this time in the @file{emultempl} directory. That shell shell script, this time in the @file{emultempl} directory. That shell
@ -480,7 +480,7 @@ We will also skip or gloss over parts of the link process that don't
relate to emulations, like setting up internationalization. relate to emulations, like setting up internationalization.
After initialization, @code{main} selects an emulation by pre-scanning After initialization, @code{main} selects an emulation by pre-scanning
the command line arguments. It calls @code{ldemul_choose_target} to the command-line arguments. It calls @code{ldemul_choose_target} to
choose a target. If you set @code{choose_target} to choose a target. If you set @code{choose_target} to
@code{ldemul_default_target}, it picks your @code{target_name} by @code{ldemul_default_target}, it picks your @code{target_name} by
default. default.