This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
[PATCH, binutils] Fix use of "command line X" in binutils doc
- From: Thomas Preudhomme <thomas dot preudhomme at foss dot arm dot com>
- To: "nickc at redhat dot com" <nickc at redhat dot com>, Alan Modra <amodra at gmail dot com>, "binutils at sourceware dot org" <binutils at sourceware dot org>
- Cc: "Richard Earnshaw (lists)" <Richard dot Earnshaw at arm dot com>
- Date: Fri, 29 Jun 2018 09:14:50 +0100
- Subject: [PATCH, binutils] Fix use of "command line X" in binutils doc
- References: <ffd2e5dd-0782-35ce-a06b-e92910a2760a@foss.arm.com> <18d51732-32e0-a2cc-88a9-d57c7c9f497b@arm.com>
Hi,
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
words 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
ChangeLog entries are as follows:
*** bfd/ChangeLog ***
2018-02-27 Thomas Preud'homme <thomas.preudhomme@arm.com>
* doc/bfdint.texi: Use command-line consistently when used in a
compount word.
* doc/bfdsumm.texi: Likewise.
*** binutils/ChangeLog ***
2018-02-27 Thomas Preud'homme <thomas.preudhomme@arm.com>
* NEWS: Use command-line consistently when used in a compount word.
* doc/binutils.texi: Likewise.
*** gas/ChangeLog ***
2018-02-27 Thomas Preud'homme <thomas.preudhomme@arm.com>
* NEWS: Use command-line consistently when used in a compount word.
* doc/as.texinfo: 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/ChangeLog ***
2018-02-27 Thomas Preud'homme <thomas.preudhomme@arm.com>
* gprof.texi: Use command-line consistently when used in a compount
word.
*** ld/ChangeLog ***
2018-02-27 Thomas Preud'homme <thomas.preudhomme@arm.com>
* NEWS: Use command-line consistently when used in a compount word.
* ld.texinfo: Likewise.
* ldint.texinfo: Likewise.
Testing: make html work except for unchanged readline. Tested that the
change to the "Command Line Options" section in ld.texinfo does not
break links to it.
Is this ok for master branch?
Best regards,
Thomas
On 20/02/18 10:25, Richard Earnshaw (lists) wrote:
On 20/02/18 09:48, Thomas Preudhomme wrote:
Hi,
c-aarch64.texi and c-arm.texi contain several occurrences of commandline
instead of "command line" which the rest of gas documentation seems to
have settled on. This patch changes these occurences for better
consistency.
ChangeLog entry is as follows:
*** gas/ChangeLog ***
2018-02-19 Thomas Preud'homme <thomas.preudhomme@arm.com>
* doc/c-aarch64.texi: Replace uses of "commandline" by "command
line".
* doc/c-arm.texi: Likewise.
Committed as obvious.
If I remember my English grammar correctly, since the cases you change
here all use "command line" to qualify a noun ("option") I think they
should be hyphenated, so "command-line option".
R.
Best regards,
Thomas
fix_commandline_typo.patch
diff --git a/gas/doc/c-aarch64.texi b/gas/doc/c-aarch64.texi
index 56aa7e1636c5fbab0d69d9e4c335c8d1ba238252..d4aa7291d7496d4d3051faac2058da1d21dd2a28 100644
--- a/gas/doc/c-aarch64.texi
+++ b/gas/doc/c-aarch64.texi
@@ -284,7 +284,7 @@ The AArch64 architecture uses @sc{ieee} floating-point numbers.
@cindex @code{.arch} directive, AArch64
@item .arch @var{name}
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
extensions.
@@ -293,7 +293,7 @@ extensions.
@item .arch_extension @var{name}
Add or remove an architecture extension to the target architecture. Valid
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
incrementally to the architecture being compiled for.
diff --git a/gas/doc/c-arm.texi b/gas/doc/c-arm.texi
index f67696f00fbbbf76627d41cf45b682432e272ba8..a53956ea505d168038d987325afe6190cc271c51 100644
--- a/gas/doc/c-arm.texi
+++ b/gas/doc/c-arm.texi
@@ -622,7 +622,7 @@ boundary). This is for compatibility with ARM's own assembler.
@cindex @code{.arch} directive, ARM
@item .arch @var{name}
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
extensions.
@@ -631,7 +631,7 @@ extensions.
@item .arch_extension @var{name}
Add or remove an architecture extension to the target architecture. Valid
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
incrementally to the architecture being compiled for.
@@ -661,7 +661,7 @@ selects Thumb, with the value 32 selecting ARM.
@cindex @code{.cpu} directive, ARM
@item .cpu @var{name}
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
extensions.
@@ -769,7 +769,7 @@ target processor does not support those instructions
@cindex @code{.fpu} directive, ARM
@item .fpu @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 HHHHHHHHHHHHHHHHHHHHHHHHHH
diff --git a/bfd/doc/bfdint.texi b/bfd/doc/bfdint.texi
index fa838c489a6e267386d49f05e46e76a812ab18da..7edb61262eb8e7bef97e7a5e1d0d68d9dbfb76b9 100644
--- a/bfd/doc/bfdint.texi
+++ b/bfd/doc/bfdint.texi
@@ -318,7 +318,7 @@ The target vector starts with a set of constants.
@table @samp
@item name
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.
@item flavour
diff --git a/bfd/doc/bfdsumm.texi b/bfd/doc/bfdsumm.texi
index c02c27aaeb8a0dabd5383be7ae46098fea7ee08a..1efe1df930886e8fea9d13005814c2280359befc 100644
--- a/bfd/doc/bfdsumm.texi
+++ b/bfd/doc/bfdsumm.texi
@@ -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
information is not worth retaining; in @code{a.out}, type information is
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.
There is one word of type information within the symbol, so if the
diff --git a/binutils/NEWS b/binutils/NEWS
index c0fa05f25e2c7ce10b922e0b66fbf5964f7fcd57..a2ba20c3db4965ed94e344f7c844133f43796c88 100644
--- a/binutils/NEWS
+++ b/binutils/NEWS
@@ -52,11 +52,11 @@ Changes in 2.28:
require an ABI update, affecting other assemblers and linkers that
create and process the relocations correctly. It is recommended that
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
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
symbol's name.
@@ -116,7 +116,7 @@ Changes in 2.25:
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.
* Add support for Altera Nios II.
@@ -159,10 +159,10 @@ changes in 2.21:
* Add to dlltool .def file feature of aliasing PE internal symbol name by
'== <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.
-* 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.
* The hppa/som targets can now be compiled on any host.
@@ -175,14 +175,14 @@ Changes in 2.20:
from the static delayimp library, which will import LoadLibraryA and
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
instructions.
* 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
file.
@@ -193,7 +193,7 @@ Changes in 2.20:
for objcopy.
* 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.
* Option --dwarf/-W of objdump is now as flexible as readelf --debug-dump/-w.
@@ -256,7 +256,7 @@ Changes in 2.18:
re-compiled by windres without lossing resources or compilation errors.
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
for its symbol table. Files containing just symbols can be useful
to some OSes.
@@ -308,7 +308,7 @@ Changes in 2.16:
* readelf can now display address ranges from .debug_range sections. This
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.
* nm and objdump now have a switch "--special-syms" to enable the displaying of
@@ -390,17 +390,17 @@ Changes in version 2.12:
* readelf: Support added for DWARF 2.1 extensions. Support added for
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.
by Honda Hiroki.
* 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
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
makes sense, if the input target is binary. Otherwise it is ignored.
By Stefan Geuken.
@@ -412,7 +412,7 @@ Changes in binutils 2.11:
* Add support for ARM v5t and v5te architectures and Intel's XScale ARM
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.
* Support for the MIPS32, by Anders Norlander.
@@ -425,11 +425,11 @@ Changes in binutils 2.10:
* 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
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
disassembler. Used by ARM targets to select register name sets, ISA, APCS or
raw verions.
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index caf7f9d37d78b241bbe8f589ac8b9cf44d7fd4d1..01ef8441f51b51f0e3e42aa3b351cb6ba0fcbdc0 100644
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -519,13 +519,13 @@ when the modifier @samp{v} is appended.
This modifier shows the version number of @command{ar}.
@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
in specific ways:
@table @samp
@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.
@item --version
@@ -540,7 +540,7 @@ of the other @samp{-X} options; in particular, it does not support
@item --plugin @var{name}
@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
for more file formats, including object files with link-time
optimization information.
@@ -563,7 +563,7 @@ is always backwards compatible with earlier versions, so it is
sufficient to just copy the newest one.
@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
different from your system's default format. See
@xref{Target Selection}, for more information.
@@ -2846,7 +2846,7 @@ If none are specified, the file @code{a.out} will be used.
@c man begin OPTIONS size
-The command line options have the following meanings:
+The command-line options have the following meanings:
@table @env
@item -A
@@ -2974,7 +2974,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
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
the presence of any @option{-d} option.
@@ -3424,7 +3424,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
the standard output. The difference between reading names from the
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
for example:
@@ -3903,7 +3903,7 @@ current directory.
@item -H
@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}
@itemx --maxlength @var{characters}
@@ -4265,7 +4265,7 @@ which in turn will import LoadLibraryA and GetProcAddress from kernel32.
@command{dlltool} builds the library file by hand, but it builds the
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,
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
@@ -4293,7 +4293,7 @@ description of the @option{-I} or @option{--identify} option.
@c man begin OPTIONS dlltool
-The command line options have the following meanings:
+The command-line options have the following meanings:
@table @env
@@ -4359,7 +4359,7 @@ to create the exports file.
@item -f @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
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
@@ -4486,7 +4486,7 @@ Make dlltool describe what it is doing.
@item -h
@itemx --help
-Displays a list of command line options and then exits.
+Displays a list of command-line options and then exits.
@item -V
@itemx --version
@@ -4794,7 +4794,7 @@ single line, which is far more readable on terminals wider than 80 columns.
@item -H
@itemx --help
-Display the command line options understood by @command{readelf}.
+Display the command-line options understood by @command{readelf}.
@end table
@@ -4888,7 +4888,7 @@ Display the version number of @command{elfedit}.
@item -h
@itemx --help
-Display the command line options understood by @command{elfedit}.
+Display the command-line options understood by @command{elfedit}.
@end table
@@ -4981,7 +4981,7 @@ Ways to specify:
@enumerate
@item
-command line option: @option{-b} or @option{--target}
+command-line option: @option{-b} or @option{--target}
@item
environment variable @code{GNUTARGET}
@@ -4996,7 +4996,7 @@ Ways to specify:
@enumerate
@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
environment variable @code{GNUTARGET}
@@ -5011,7 +5011,7 @@ Ways to specify:
@enumerate
@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
the input target (see ``@command{objcopy} and @command{strip} Input Target'' above)
@@ -5029,7 +5029,7 @@ Ways to specify:
@enumerate
@item
-command line option: @option{--target}
+command-line option: @option{--target}
@item
environment variable @code{GNUTARGET}
@@ -5056,7 +5056,7 @@ Ways to specify:
@enumerate
@item
-command line option: @option{-m} or @option{--architecture}
+command-line option: @option{-m} or @option{--architecture}
@item
deduced from the input file
diff --git a/gas/NEWS b/gas/NEWS
index 27ee306f2f62543617e88a46bcded86f96e2cc87..ceb531e66c473f99d8c68e7e084ad79bc152e74c 100644
--- a/gas/NEWS
+++ b/gas/NEWS
@@ -47,7 +47,7 @@ Changes in 2.27:
assembler should generate common symbols with the STT_COMMON type by
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.
* Add ability to set section flags and types via numeric values for ELF
@@ -57,10 +57,10 @@ Changes in 2.27:
x86 assembler should generate relax relocations by default. Default to
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.
-* 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)".
* Add assembly-time relaxation option for ARC cpus.
@@ -104,7 +104,7 @@ Changes in 2.25:
* Replace support for openrisc and or32 with support for or1k.
* 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.
@@ -112,7 +112,7 @@ Changes in 2.24:
* 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.
* Add support for Altera Nios II.
@@ -159,7 +159,7 @@ Changes in 2.21:
* 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
file. Compressed debug sections are supported by readelf, objdump, and
gold, but not currently by Gnu ld.
@@ -196,23 +196,23 @@ Changes in 2.19:
* New pseudo op .cfi_val_encoded_addr, to record constant addresses in unwind
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.
-* New command line option, -msse-check=[none|error|warning], for x86
+* New command-line option, -msse-check=[none|error|warning], for x86
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
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.
* 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,
-mnaked-reg and -mold-gcc, for x86 targets.
@@ -245,7 +245,7 @@ Changes in 2.17:
* Add support for the "@<file>" syntax to the command line, so that extra
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 $
character. This allows register names to be distinguished from label names.
@@ -266,15 +266,15 @@ Changes in 2.17:
for the VAX target in order to be more compatible with the VAX MACRO
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:
* 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.
* The IA64 port now uses automatic dependency violation removal as its default
@@ -284,7 +284,7 @@ Changes in 2.16:
* 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.
* Support for the crx-elf target added.
@@ -299,9 +299,9 @@ Changes in 2.16:
* Support for ColdFire EMAC instructions added and Motorola syntax for MAC/EMAC
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.
Changes in 2.15:
@@ -395,7 +395,7 @@ Changes in 2.12:
but still works for compatability.
* 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.
Changes in 2.11:
@@ -418,7 +418,7 @@ Changes in 2.11:
* 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
translating various deprecated floating point instructions.
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index 3084bcb871caeb06fe1cc6ba51f1a4bbaa05d802..e6153ca3beadd96644037c829ca88eb490c51bb5 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -757,7 +757,7 @@ by a configure option @option{--enable-elf-stt-common}.
@end ifset
@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
Print a summary of all target specific options and exit.
@@ -1613,12 +1613,12 @@ an MCore processor.
@item -jsri2bsr
@itemx -nojsri2bsr
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
@itemx -nosifilter
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
Alter jump instructions for long displacements.
@@ -2021,7 +2021,7 @@ significant.
explicitly, as one of the files for @command{@value{AS}} to assemble.
@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
@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
@@ -2060,7 +2060,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
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.
If you give @command{@value{AS}} no file names it attempts to read one input file
@@ -2307,7 +2307,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.,
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
directives. This is because the listing code buffers input source lines from
stdin only after they have been preprocessed by the assembler. This reduces
@@ -2402,7 +2402,7 @@ in the object file. Usually if you do this you also tell the linker
@node 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
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
@@ -2836,7 +2836,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. Some targets use a sequence of two characters to introduce a line
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.
If the line comment character is the hash sign (@samp{#}) then it still has the
@@ -5773,7 +5773,7 @@ counter, and @code{.nolist} decrements it. Assembly listings are
generated whenever the counter is greater than zero.
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.
@node Ln
diff --git a/gas/doc/c-aarch64.texi b/gas/doc/c-aarch64.texi
index 56aa7e1636c5fbab0d69d9e4c335c8d1ba238252..330071415c4f848ebfae5af4a1ef0d1db6492d00 100644
--- a/gas/doc/c-aarch64.texi
+++ b/gas/doc/c-aarch64.texi
@@ -34,23 +34,23 @@
@c man begin OPTIONS
@table @gcctabopt
-@cindex @option{-EB} command line option, AArch64
+@cindex @option{-EB} command-line option, AArch64
@item -EB
This option specifies that the output generated by the assembler should
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
This option specifies that the output generated by the assembler should
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}
Specify which ABI the source code uses. The recognized arguments
are: @code{ilp32} and @code{lp64}, which decides the generated object
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{}]
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
@@ -84,7 +84,7 @@ extension, then then those extensions are automatically enabled.
Consequently, you will not normally have to specify any additional
extensions.
-@cindex @option{-march=} command line option, AArch64
+@cindex @option{-march=} command-line option, AArch64
@item -march=@var{architecture}[+@var{extension}@dots{}]
This option specifies the target architecture. The assembler will
issue an error message if an attempt is made to assemble an
@@ -101,12 +101,12 @@ extension options as the @option{-mcpu} option. Unlike
@option{-mcpu}, extensions are not always enabled by default,
@xref{AArch64 Extensions}.
-@cindex @code{-mverbose-error} command line option, AArch64
+@cindex @code{-mverbose-error} command-line option, AArch64
@item -mverbose-error
This option enables verbose error messages for AArch64 gas. This option
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
This option disables verbose error messages in AArch64 gas.
@@ -284,7 +284,7 @@ The AArch64 architecture uses @sc{ieee} floating-point numbers.
@cindex @code{.arch} directive, AArch64
@item .arch @var{name}
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
extensions.
@@ -293,7 +293,7 @@ extensions.
@item .arch_extension @var{name}
Add or remove an architecture extension to the target architecture. Valid
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
incrementally to the architecture being compiled for.
@@ -309,7 +309,7 @@ This directive switches to the @code{.bss} section.
@cindex @code{.cpu} directive, AArch64
@item .cpu @var{name}
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
diff --git a/gas/doc/c-alpha.texi b/gas/doc/c-alpha.texi
index 8365e39995dead893443498b8a5fb5f9595baef4..7b228ac9a76672f3e29735ad1f6d21236647e645 100644
--- a/gas/doc/c-alpha.texi
+++ b/gas/doc/c-alpha.texi
@@ -40,7 +40,7 @@ features specific to these formats are not yet documented.
@c man begin OPTIONS
@table @gcctabopt
-@cindex @code{-m@var{cpu}} command line option, Alpha
+@cindex @code{-m@var{cpu}} command-line option, Alpha
@item -m@var{cpu}
This option specifies the target processor. If an attempt is made to
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
instructions, while the ``electro-vlasic'' names (e.g.@: @code{ev4}) do not.
-@cindex @code{-mdebug} command line option, Alpha
-@cindex @code{-no-mdebug} command line option, Alpha
+@cindex @code{-mdebug} command-line option, Alpha
+@cindex @code{-no-mdebug} command-line option, Alpha
@item -mdebug
@itemx -no-mdebug
Enables or disables the generation of @code{.mdebug} encapsulation for
stabs directives and procedure descriptors. The default is to automatically
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
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
@@ -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
can still be useful in specific applications.
-@cindex @code{-replace} command line option, Alpha
-@cindex @code{-noreplace} command line option, Alpha
+@cindex @code{-replace} command-line option, Alpha
+@cindex @code{-noreplace} command-line option, Alpha
@item -replace
@itemx -noreplace
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
Utility Manual.
-@cindex @code{-g} command line option, Alpha
+@cindex @code{-g} command-line option, Alpha
@item -g
This option is used when the compiler generates debug information. When
@command{gcc} is using @command{mips-tfile} to generate debug
information for ECOFF, local labels must be passed through to the object
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}
A local common symbol larger than @var{size} is placed in @code{.bss},
while smaller symbols are placed in @code{.sbss}.
-@cindex @code{-F} command line option, Alpha
-@cindex @code{-32addr} command line option, Alpha
+@cindex @code{-F} command-line option, Alpha
+@cindex @code{-32addr} command-line option, Alpha
@item -F
@itemx -32addr
These options are ignored for backward compatibility.
diff --git a/gas/doc/c-arc.texi b/gas/doc/c-arc.texi
index 76eae3f1da7f30c7742de4d5f57b8ff1384afa28..bce51d15a48d099e1de1f512dc02b66a872854cf 100644
--- a/gas/doc/c-arc.texi
+++ b/gas/doc/c-arc.texi
@@ -36,14 +36,14 @@ assembled, and generic constraints on the code generated:
@table @code
@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
also shortcut alias options available for backward compatibility and
convenience. Supported values for @var{cpu} are
@table @code
-@cindex @code{mA6} command line option, ARC
-@cindex @code{marc600} command line option, ARC
+@cindex @code{mA6} command-line option, ARC
+@cindex @code{marc600} command-line option, ARC
@item arc600
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.
@item arc601
-@cindex @code{mARC601} command line option, ARC
+@cindex @code{mARC601} command-line option, ARC
Assemble for ARC 601. Alias: @code{-mARC601}.
@item arc601_norm
@@ -70,12 +70,12 @@ Assemble for ARC 601 with mul64 instructions.
Assemble for ARC 601 with mul32x16 instructions.
@item arc700
-@cindex @code{mA7} command line option, ARC
-@cindex @code{mARC700} command line option, ARC
+@cindex @code{mA7} command-line option, ARC
+@cindex @code{mARC700} command-line option, ARC
Assemble for ARC 700. Aliases: @code{-mA7}, @code{-mARC700}.
@item arcem
-@cindex @code{mEM} command line option, ARC
+@cindex @code{mEM} command-line option, ARC
Assemble for ARC EM. Aliases: @code{-mEM}
@item em
@@ -98,7 +98,7 @@ instructions.
Assemble for QuarkSE-EM cpu.
@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}.
@item hs
@@ -114,7 +114,7 @@ Assemble for ARC HS38.
Assemble for ARC HS38 with floating point support on.
@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.
@end table
@@ -122,41 +122,41 @@ Assemble for ARC 700 with NPS-400 extended instructions.
Note: the @code{.cpu} directive (@pxref{ARC Directives}) can
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
This option specifies that the output generated by the assembler should
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
This option specifies that the output generated by the assembler should
be marked as being encoded for a little-endian processor - this is the
default.
-@cindex @code{-mcode-density} command line option, ARC
+@cindex @code{-mcode-density} command-line option, ARC
@item -mcode-density
This option turns on Code Density instructions. Only valid for ARC EM
processors.
-@cindex @code{-mrelax} command line option, ARC
+@cindex @code{-mrelax} command-line option, ARC
@item -mrelax
Enable support for assembly-time relaxation. The assembler will
replace a longer version of an instruction with a shorter one,
whenever it is possible.
-@cindex @code{-mnps400} command line option, ARC
+@cindex @code{-mnps400} command-line option, ARC
@item -mnps400
Enable support for NPS-400 extended instructions.
-@cindex @code{-mspfp} command line option, ARC
+@cindex @code{-mspfp} command-line option, ARC
@item -mspfp
Enable support for single-precision floating point instructions.
-@cindex @code{-mdpfp} command line option, ARC
+@cindex @code{-mdpfp} command-line option, ARC
@item -mdpfp
Enable support for double-precision floating point instructions.
-@cindex @code{-mfpuda} command line option, ARC
+@cindex @code{-mfpuda} command-line option, ARC
@item -mfpuda
Enable support for double-precision assist floating point instructions.
Only valid for ARC EM processors.
@@ -486,7 +486,7 @@ Assemble for ARC HS38 with floating point support on.
@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
consistent between the two.
diff --git a/gas/doc/c-arm.texi b/gas/doc/c-arm.texi
index f67696f00fbbbf76627d41cf45b682432e272ba8..f7cea1ebe0db10d57dac29ab78cd95e2233ef0e7 100644
--- a/gas/doc/c-arm.texi
+++ b/gas/doc/c-arm.texi
@@ -32,7 +32,7 @@
@table @code
-@cindex @code{-mcpu=} command line option, ARM
+@cindex @code{-mcpu=} command-line option, ARM
@item -mcpu=@var{processor}[+@var{extension}@dots{}]
This option specifies the target processor. The assembler will issue an
error message if an attempt is made to assemble an instruction which
@@ -200,7 +200,7 @@ for v8-A architecture),
and
@code{xscale}.
-@cindex @code{-march=} command line option, ARM
+@cindex @code{-march=} command-line option, ARM
@item -march=@var{architecture}[+@var{extension}@dots{}]
This option specifies the target architecture. The assembler will issue
an error message if an attempt is made to assemble an instruction which
@@ -251,7 +251,7 @@ the setting for @code{-mcpu}.
The architecture option can be extended with the same instruction set
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}
This option specifies the floating point format to assemble for. The
@@ -308,18 +308,18 @@ The default is dependent on the processor selected. For Architecture 5 or
later, the default is to assemble for VFP instructions; for earlier
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
This option specifies that the assembler should start assembling Thumb
instructions; that is, it should behave as though the file starts with a
@code{.code 16} directive.
-@cindex @code{-mthumb-interwork} command line option, ARM
+@cindex @code{-mthumb-interwork} command-line option, ARM
@item -mthumb-interwork
This option specifies that the output generated by the assembler should
be marked as supporting interworking.
-@cindex @code{-mimplicit-it} command line option, ARM
+@cindex @code{-mimplicit-it} command-line option, ARM
@item -mimplicit-it=never
@itemx -mimplicit-it=always
@itemx -mimplicit-it=arm
@@ -337,15 +337,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
behavior is equivalent to @code{-mimplicit-it=arm}.
-@cindex @code{-mapcs-26} command line option, ARM
-@cindex @code{-mapcs-32} command line option, ARM
+@cindex @code{-mapcs-26} command-line option, ARM
+@cindex @code{-mapcs-32} command-line option, ARM
@item -mapcs-26
@itemx -mapcs-32
These options specify that the output generated by the assembler should
be marked as supporting the indicated version of the Arm Procedure.
Calling Standard.
-@cindex @code{-matpcs} command line option, ARM
+@cindex @code{-matpcs} command-line option, ARM
@item -matpcs
This option specifies that the output generated by the assembler should
be marked as supporting the Arm/Thumb Procedure Calling Standard. If
@@ -353,18 +353,18 @@ enabled this option will cause the assembler to create an empty
debugging section in the object file called .arm.atpcs. Debuggers can
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
This indicates the floating point variant of the APCS should be
used. In this variant floating point arguments are passed in FP
registers rather than integer registers.
-@cindex @code{-mapcs-reentrant} command line option, ARM
+@cindex @code{-mapcs-reentrant} command-line option, ARM
@item -mapcs-reentrant
This indicates that the reentrant variant of the APCS should be used.
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}
This option specifies that the output generated by the assembler should be
marked as using specified floating point ABI.
@@ -374,7 +374,7 @@ The following values are recognized:
and
@code{hard}.
-@cindex @code{-eabi=} command line option, ARM
+@cindex @code{-eabi=} command-line option, ARM
@item -meabi=@var{ver}
This option specifies which EABI version the produced object files should
conform to.
@@ -384,7 +384,7 @@ The following values are recognized:
and
@code{5}.
-@cindex @code{-EB} command line option, ARM
+@cindex @code{-EB} command-line option, ARM
@item -EB
This option specifies that the output generated by the assembler should
be marked as being encoded for a big-endian processor.
@@ -395,33 +395,33 @@ and little-endian instructions then it should be assembled with the
the @option{--be8} option. This will reverse the endianness of the
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
This option specifies that the output generated by the assembler should
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
@item -k
This option specifies that the output of the assembler should be marked
as position-independent code (PIC).
-@cindex @code{--fix-v4bx} command line option, ARM
+@cindex @code{--fix-v4bx} command-line option, ARM
@item --fix-v4bx
Allow @code{BX} instructions in ARMv4 code. This is intended for use with
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
@itemx -mno-warn-deprecated
Enable or disable warnings about using deprecated options or
features. The default is to warn.
-@cindex @code{-mccs} command line option, ARM
+@cindex @code{-mccs} command-line option, ARM
@item -mccs
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
@itemx -mno-warn-syms
Enable or disable warnings about symbols that match the names of ARM
@@ -622,7 +622,7 @@ boundary). This is for compatibility with ARM's own assembler.
@cindex @code{.arch} directive, ARM
@item .arch @var{name}
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
extensions.
@@ -631,7 +631,7 @@ extensions.
@item .arch_extension @var{name}
Add or remove an architecture extension to the target architecture. Valid
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
incrementally to the architecture being compiled for.
@@ -661,7 +661,7 @@ selects Thumb, with the value 32 selecting ARM.
@cindex @code{.cpu} directive, ARM
@item .cpu @var{name}
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
extensions.
@@ -769,7 +769,7 @@ target processor does not support those instructions
@cindex @code{.fpu} directive, ARM
@item .fpu @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 HHHHHHHHHHHHHHHHHHHHHHHHHH
diff --git a/gas/doc/c-avr.texi b/gas/doc/c-avr.texi
index c827426aee809178eadcc9cc1c210b01d82ed0b1..6fc669e949a66b2bb41c4a50025ff33110ed27a1 100644
--- a/gas/doc/c-avr.texi
+++ b/gas/doc/c-avr.texi
@@ -28,7 +28,7 @@
@table @code
-@cindex @code{-mmcu=} command line option, AVR
+@cindex @code{-mmcu=} command-line option, AVR
@item -mmcu=@var{mcu}
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
microcontrollers.
-@cindex @code{-mall-opcodes} command line option, AVR
+@cindex @code{-mall-opcodes} command-line option, AVR
@item -mall-opcodes
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
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
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
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
Enable support for link-time relaxation. This is now on by default
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
Disable support for link-time relaxation. The assembler will resolve
relocations when it can, and may be able to better compress some debug
information.
-@cindex @code{-mgcc-isr} command line option, AVR
+@cindex @code{-mgcc-isr} command-line option, AVR
@item -mgcc-isr
Enable the @code{__gcc_isr} pseudo instruction.
diff --git a/gas/doc/c-bfin.texi b/gas/doc/c-bfin.texi
index 1df0a9fcbb8b9cbb71c5649ae9d9ab7d0e41e75e..51cdda1d6d92c6d6de5c91c3fce2f998c3c3a38b 100644
--- a/gas/doc/c-bfin.texi
+++ b/gas/doc/c-bfin.texi
@@ -29,7 +29,7 @@
@c man begin OPTIONS
@table @gcctabopt
-@cindex @code{-mcpu=} command line option, Blackfin
+@cindex @code{-mcpu=} command-line option, Blackfin
@item -mcpu=@var{processor}@r{[}-@var{sirevision}@r{]}
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
@@ -72,12 +72,12 @@ recognized:
and
@code{bf592}.
-@cindex @code{-mfdpic} command line option, Blackfin
+@cindex @code{-mfdpic} command-line option, Blackfin
@item -mfdpic
Assemble for the FDPIC ABI.
-@cindex @code{-mno-fdpic} command line option, Blackfin
-@cindex @code{-mnopic} command line option, Blackfin
+@cindex @code{-mno-fdpic} command-line option, Blackfin
+@cindex @code{-mnopic} command-line option, Blackfin
@item -mno-fdpic
@itemx -mnopic
Disable -mfdpic.
diff --git a/gas/doc/c-cris.texi b/gas/doc/c-cris.texi
index 6fc25f11cbca8fad3849cb9253d9089583899b3c..e77e33f5cc9bcc21e7fe0e42a889cb3297b5f9d9 100644
--- a/gas/doc/c-cris.texi
+++ b/gas/doc/c-cris.texi
@@ -28,10 +28,10 @@
The CRIS version of @code{@value{AS}} has these
machine-dependent command-line options.
-@cindex @option{--emulation=criself} command line option, CRIS
-@cindex @option{--emulation=crisaout} command line option, CRIS
-@cindex CRIS @option{--emulation=criself} command line option
-@cindex CRIS @option{--emulation=crisaout} command line option
+@cindex @option{--emulation=criself} command-line option, CRIS
+@cindex @option{--emulation=crisaout} command-line option, CRIS
+@cindex CRIS @option{--emulation=criself} command-line option
+@cindex CRIS @option{--emulation=crisaout} command-line option
The format of the generated object files can be either ELF or
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
name @code{cris-axis-aout}.
-@cindex @option{--underscore} command line option, CRIS
-@cindex @option{--no-underscore} command line option, CRIS
-@cindex CRIS @option{--underscore} command line option
-@cindex CRIS @option{--no-underscore} command line option
+@cindex @option{--underscore} command-line option, CRIS
+@cindex @option{--no-underscore} command-line option, CRIS
+@cindex CRIS @option{--underscore} command-line option
+@cindex CRIS @option{--no-underscore} command-line option
There are two different link-incompatible ELF object file
variants for CRIS, for use in environments where symbols are
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}
option makes a @samp{$} register prefix mandatory.
-@cindex @option{--pic} command line option, CRIS
-@cindex CRIS @option{--pic} command line option
+@cindex @option{--pic} command-line option, CRIS
+@cindex CRIS @option{--pic} command-line option
@cindex Position-independent code, CRIS
@cindex CRIS position-independent code
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
valid when generating ELF format object files.
-@cindex @option{--march=@var{architecture}} command line option, CRIS
-@cindex CRIS @option{--march=@var{architecture}} command line option
+@cindex @option{--march=@var{architecture}} command-line option, CRIS
+@cindex CRIS @option{--march=@var{architecture}} command-line option
@cindex Architecture variant option, CRIS
@cindex CRIS architecture variant option
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.
@end table
-@cindex @option{-N} command line option, CRIS
-@cindex CRIS @option{-N} command line option
+@cindex @option{-N} command-line option, CRIS
+@cindex CRIS @option{-N} command-line option
When @option{-N} is specified, @code{@value{AS}} will emit a
warning when a 16-bit branch instruction is expanded into a
32-bit multiple-instruction construct (@pxref{CRIS-Expand}).
-@cindex @option{--no-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{--mul-bug-abort} command line option
+@cindex @option{--no-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{--mul-bug-abort} command-line option
Some versions of the CRIS v10, for example in the Etrax 100 LX,
contain a bug that causes destabilizing memory accesses when a
multiply instruction is executed with certain values in 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
containing a multiply instruction at a dangerous offset, one
that could be the last on a cache-line, or is in a section with
insufficient alignment. This placement checking does not catch
any case where the multiply instruction is dangerously placed
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.
@node CRIS-Expand
diff --git a/gas/doc/c-epiphany.texi b/gas/doc/c-epiphany.texi
index b5b0cc6f8ddd62764ea82798cc0540d7b0416619..8f533f0b9d175f77726cfb7cfa41b4b02e065b64 100644
--- a/gas/doc/c-epiphany.texi
+++ b/gas/doc/c-epiphany.texi
@@ -30,12 +30,12 @@ architecture.
@c man begin OPTIONS
@table @gcctabopt
-@cindex @code{-mepiphany} command line option, Epiphany
+@cindex @code{-mepiphany} command-line option, Epiphany
@item -mepiphany
Specifies that the both 32 and 16 bit instructions are allowed. This is the
default behavior.
-@cindex @code{-mepiphany16} command line option, Epiphany
+@cindex @code{-mepiphany16} command-line option, Epiphany
@item -mepiphany16
Restricts the permitted instructions to just the 16 bit set.
@end table
diff --git a/gas/doc/c-i386.texi b/gas/doc/c-i386.texi
index e669c5f34f5e38c03f7252d65da4d2ee9b799aee..8a8a46e83ebaa65d34fa1a3e759e7344074c5c42 100644
--- a/gas/doc/c-i386.texi
+++ b/gas/doc/c-i386.texi
@@ -569,7 +569,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
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
introduces a line comment.
diff --git a/gas/doc/c-ia64.texi b/gas/doc/c-ia64.texi
index b571ec5a971107741d7ec9bde0b965bd5eec8853..fc739b431b2809bfd1a223b11f7d5960794de96e 100644
--- a/gas/doc/c-ia64.texi
+++ b/gas/doc/c-ia64.texi
@@ -29,7 +29,7 @@
@cindex options for IA-64
@table @option
-@cindex @code{-mconstant-gp} command line option, IA-64
+@cindex @code{-mconstant-gp} command-line option, IA-64
@item -mconstant-gp
This option instructs the assembler to mark the resulting object file
diff --git a/gas/doc/c-lm32.texi b/gas/doc/c-lm32.texi
index 0d66e3cb692890efba5f347658ab64934040b110..058ca37822394011b6caca965131ea34d4ad5754 100644
--- a/gas/doc/c-lm32.texi
+++ b/gas/doc/c-lm32.texi
@@ -27,39 +27,39 @@
@table @code
-@cindex @code{-mmultiply-enabled} command line option, LM32
+@cindex @code{-mmultiply-enabled} command-line option, LM32
@item -mmultiply-enabled
Enable multiply instructions.
-@cindex @code{-mdivide-enabled} command line option, LM32
+@cindex @code{-mdivide-enabled} command-line option, LM32
@item -mdivide-enabled
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
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
Enable sign extend instructions.
-@cindex @code{-muser-enabled} command line option, LM32
+@cindex @code{-muser-enabled} command-line option, LM32
@item -muser-enabled
Enable user defined instructions.
-@cindex @code{-micache-enabled} command line option, LM32
+@cindex @code{-micache-enabled} command-line option, LM32
@item -micache-enabled
Enable instruction cache related CSRs.
-@cindex @code{-mdcache-enabled} command line option, LM32
+@cindex @code{-mdcache-enabled} command-line option, LM32
@item -mdcache-enabled
Enable data cache related CSRs.
-@cindex @code{-mbreak-enabled} command line option, LM32
+@cindex @code{-mbreak-enabled} command-line option, LM32
@item -mbreak-enabled
Enable break instructions.
-@cindex @code{-mall-enabled} command line option, LM32
+@cindex @code{-mall-enabled} command-line option, LM32
@item -mall-enabled
Enable all instructions and CSRs.
diff --git a/gas/doc/c-m32r.texi b/gas/doc/c-m32r.texi
index 754164ad0539a668e18929f79ecc80ef7d47ea1d..53950ca7882d41fc825ce6e8e4c6a98f0c3f1c5c 100644
--- a/gas/doc/c-m32r.texi
+++ b/gas/doc/c-m32r.texi
@@ -53,7 +53,7 @@ microprocessor.
@cindex M32R architecture options
This option can be used to restore the assembler's default behaviour of
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
@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
This message is produced when the assembler encounters an instruction
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.
@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
This message is produced when the assembler encounters a parallel
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.
@item instruction @samp{...} cannot be executed in parallel.
diff --git a/gas/doc/c-m68k.texi b/gas/doc/c-m68k.texi
index 2ef5e2191ba7badbcbb6e0b6d2c1eff7c2690002..76c111f5158943d4d95166670de5e1b9c6e95dae 100644
--- a/gas/doc/c-m68k.texi
+++ b/gas/doc/c-m68k.texi
@@ -31,7 +31,7 @@ dependent options:
@table @samp
-@cindex @samp{-march=} command line option, M680x0
+@cindex @samp{-march=} command-line option, M680x0
@item -march=@var{architecture}
This option specifies a target architecture. The following
architectures are recognized:
@@ -49,20 +49,20 @@ architectures are recognized:
@code{cfv4e}.
-@cindex @samp{-mcpu=} command line option, M680x0
+@cindex @samp{-mcpu=} command-line option, M680x0
@item -mcpu=@var{cpu}
This option specifies a target cpu. When used in conjunction with the
@option{-march} option, the cpu must be within the specified
architecture. Also, the generic features of the architecture are used
for instruction generation, rather than those of the specific chip.
-@cindex @samp{-m[no-]68851} 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-]usp} 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-]emac} 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-]div} 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-]mac} command-line option, M680x0
+@cindex @samp{-m[no-]emac} command-line option, M680x0
@item -m[no-]68851
@itemx -m[no-]68881
@itemx -m[no-]div
@@ -446,7 +446,7 @@ This directive is identical to a @code{.space} directive.
@cindex @code{arch} directive, M680x0
@item .arch @var{name}
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
any instructions have been assembled. If it is given multiple times,
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
@item .cpu @var{name}
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
any instructions have been assembled. If it is given multiple times,
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 comments, M680x0
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.
An asterisk (@samp{*}) as the first character on a line marks the
diff --git a/gas/doc/c-mips.texi b/gas/doc/c-mips.texi
index 650d8868d9bbd582f2a59a55606f14d53c126f39..91f4ca74ce37719c85e4faee3dfc2a0d66f8f804 100644
--- a/gas/doc/c-mips.texi
+++ b/gas/doc/c-mips.texi
@@ -510,7 +510,7 @@ for branches.
By default @samp{-mno-ignore-branch-isa} is selected, causing any invalid
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}
This option indicates whether the source code uses the IEEE 2008
NaN encoding (@option{-mnan=2008}) or the original MIPS encoding
@@ -736,7 +736,7 @@ for the corresponding ISA level, from that point on in the
assembly. @code{.set mips@var{n}} affects not only which instructions
are permitted, but also how certain macros are expanded. @code{.set
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
instructions while assembling in 32 bit mode. Use this directive with
care!
@@ -746,7 +746,7 @@ care!
The @code{.set arch=@var{cpu}} directive provides even finer control.
It changes the effective CPU target and allows the assembler to use
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 directive @code{.set mips16} puts the assembler into MIPS 16 mode,
@@ -764,13 +764,13 @@ Traditional MIPS assemblers do not support this directive.
@node MIPS assembly options
@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}
-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}
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
-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
define the defaults.
@@ -861,7 +861,7 @@ other and must be tracked carefully.
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.
-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.
@node MIPS FP ABI Variants
@@ -921,7 +921,7 @@ of MIPS32r2.
@cindex @code{.module fp=@var{nn}} directive, MIPS
In order to simplify and add safety to the process of selecting 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
@code{.gnu_attribute 4, @var{n}} directive has been seen then a warning
will be raised if it does not match an inferred setting.
diff --git a/gas/doc/c-mmix.texi b/gas/doc/c-mmix.texi
index 3ed682206414375f15719ddd73bff8bed8481c79..d10d750d4cefc6ae00bc98584447ab290761c827 100644
--- a/gas/doc/c-mmix.texi
+++ b/gas/doc/c-mmix.texi
@@ -27,25 +27,25 @@
@cindex MMIX 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
names specified in @ref{MMIX-Regs} are recognized in the instructions
@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.
This option is useful when splitting up a @code{mmixal} program into
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
@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 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
rather get an error, for example when using @code{@value{AS}} with a
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,
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
or an external symbol (@pxref{MMIX-Expand}). By passing
@samp{--no-expand}, no such expansion will be done, instead causing errors
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
registers allocated with the @samp{GREG} directive (@pxref{MMIX-greg}) and
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
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
operand unless the option @samp{-x} is specified. It is believed that
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
@samp{--linker-allocated-gregs}.
-@cindex @samp{--no-pushj-stubs} command line option, MMIX
-@cindex @samp{--no-stubs} command line option, MMIX
+@cindex @samp{--no-pushj-stubs} command-line option, MMIX
+@cindex @samp{--no-stubs} command-line option, MMIX
If instruction expansion is enabled, @code{@value{AS}} can expand a
@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
@@ -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
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
@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
diff --git a/gas/doc/c-msp430.texi b/gas/doc/c-msp430.texi
index bb491b7551d04edb7f56952cd96db636eafaa6d3..8338e6d957151845891909b45741c1bac6189074 100644
--- a/gas/doc/c-msp430.texi
+++ b/gas/doc/c-msp430.texi
@@ -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
followed by a NOP instruction in order to ensure the correct
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.
@item -mN
@@ -302,12 +302,12 @@ MSP 430 assemblers.
@cindex @code{arch} directive, MSP 430
@item .arch
Sets the target microcontroller in the same way as the @option{-mmcu}
-command line option.
+command-line option.
@cindex @code{cpu} directive, MSP 430
@item .cpu
Sets the target architecture in the same way as the @option{-mcpu}
-command line option.
+command-line option.
@cindex @code{profiler} directive, MSP 430
@item .profiler
diff --git a/gas/doc/c-mt.texi b/gas/doc/c-mt.texi
index b25f50abfbf56f04526e62ca350a0cad584460cf..dd759fb901ef63fe289827cd90d40a8d7b12a1a2 100644
--- a/gas/doc/c-mt.texi
+++ b/gas/doc/c-mt.texi
@@ -26,7 +26,7 @@
@table @code
-@cindex @code{-march=} command line option, MT
+@cindex @code{-march=} command-line option, MT
@item -march=@var{processor}
This option specifies the target processor. The assembler will issue an
error message if an attempt is made to assemble an instruction which
@@ -37,7 +37,7 @@ recognized:
@code{ms1-16-003},
and @code{ms2}.
-@cindex @code{-nosched} command line option, MT
+@cindex @code{-nosched} command-line option, MT
@item -nosched
This option disables scheduling restriction checking.
diff --git a/gas/doc/c-nios2.texi b/gas/doc/c-nios2.texi
index 1895b4038f95a2da5afa44311b9ba2b06b29c59a..a0f22f4c26e219a7232e9f0a14b802dfa735197c 100644
--- a/gas/doc/c-nios2.texi
+++ b/gas/doc/c-nios2.texi
@@ -31,7 +31,7 @@
@c man begin OPTIONS
@table @gcctabopt
-@cindex @code{relax-section} command line option, Nios II
+@cindex @code{relax-section} command-line option, Nios II
@item -relax-section
Replace identified out-of-range branches with PC-relative @code{jmp}
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.
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
Replace branch instructions not determinable to be in range
and all call instructions with @code{jmp} and @code{callr} sequences
(respectively). This option generates absolute relocations against the
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
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
Generate big-endian output.
-@cindex @code{EL} command line option, Nios II
+@cindex @code{EL} command-line option, Nios II
@item -EL
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}
This option specifies the target architecture. The assembler issues
an error message if an attempt is made to assemble an instruction which
diff --git a/gas/doc/c-ppc.texi b/gas/doc/c-ppc.texi
index 807b0879ba020bb6f7185c990cb398ab9e482c14..6f7b0f9a91e9ff439a525f9e95eb8a87baa5ba42 100644
--- a/gas/doc/c-ppc.texi
+++ b/gas/doc/c-ppc.texi
@@ -229,7 +229,7 @@ control command (@pxref{Preprocessing}).
If the assembler has been configured for the ppc-*-solaris* target
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.
@cindex line separator, PowerPC
diff --git a/gas/doc/c-pru.texi b/gas/doc/c-pru.texi
index 208e199eec0c3d165ec5f674ebcc81a779f02e04..0910b39ac17383e904be39cbc63c945aa177db3c 100644
--- a/gas/doc/c-pru.texi
+++ b/gas/doc/c-pru.texi
@@ -25,19 +25,19 @@
@c man begin OPTIONS
@table @gcctabopt
-@cindex @code{mlink-relax} command line option, PRU
+@cindex @code{mlink-relax} command-line option, PRU
@item -mlink-relax
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
shorten the LDI32 instruction to a single LDI. In such case @code{@value{AS}}
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
Assume that LD would not optimize LDI32 instructions. As a consequence,
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
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
@@ -129,7 +129,7 @@ Create an unaligned constant 16 bytes in size.
@cindex @code{set no_warn_regname_label} directive, PRU
@item .set no_warn_regname_label
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
diff --git a/gas/doc/c-rl78.texi b/gas/doc/c-rl78.texi
index 62be228f98ea0dc6403f98d8686a6c3387e6ea15..1d645875bbed7d49093bea58c4168a6a0a765d01 100644
--- a/gas/doc/c-rl78.texi
+++ b/gas/doc/c-rl78.texi
@@ -13,7 +13,7 @@
@cindex RL78 support
@menu
-* RL78-Opts:: RL78 Assembler Command Line Options
+* RL78-Opts:: RL78 Assembler Command-line Options
* RL78-Modifiers:: Symbolic Operand Modifiers
* RL78-Directives:: Assembler Directives
* RL78-Syntax:: Syntax
@@ -107,7 +107,7 @@ In addition to the common directives, the RL78 adds these:
@item .double
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
-@option{-m32bit-doubles}|@option{-m64bit-doubles} command line
+@option{-m32bit-doubles}|@option{-m64bit-doubles} command-line
option.
@item .bss
diff --git a/gas/doc/c-rx.texi b/gas/doc/c-rx.texi
index ea523f11bd89416ec1b7bd14cd86655edbfdbb49..b20fd09496b0d0b0c68e7dde225eae4a840e700d 100644
--- a/gas/doc/c-rx.texi
+++ b/gas/doc/c-rx.texi
@@ -13,7 +13,7 @@
@cindex RX support
@menu
-* RX-Opts:: RX Assembler Command Line Options
+* RX-Opts:: RX Assembler Command-line Options
* RX-Modifiers:: Symbolic Operand Modifiers
* RX-Directives:: Assembler Directives
* RX-Float:: Floating Point
@@ -26,7 +26,7 @@
@cindex RX options
The Renesas RX port of @code{@value{AS}} has a few target specific
-command line options:
+command-line options:
@table @code
@@ -218,7 +218,7 @@ The floating point formats generated by directives are these.
@cindex @code{double} directive, RX
@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
(64-bit) floating point constants, otherwise it generates
@code{single} precision (32-bit) floating point constants. To force
diff --git a/gas/doc/c-tic6x.texi b/gas/doc/c-tic6x.texi
index 4622e187235d0c848663e6859331fece7589c944..87441003f48b8262a214683ddff825e4ffc41695 100644
--- a/gas/doc/c-tic6x.texi
+++ b/gas/doc/c-tic6x.texi
@@ -28,7 +28,7 @@
@c man begin OPTIONS
@table @gcctabopt
-@cindex @code{-march=} command line option, TIC6X
+@cindex @code{-march=} command-line option, TIC6X
@item -march=@var{arch}
Enable (only) instructions from architecture @var{arch}. By default,
all instructions are permitted.
@@ -36,8 +36,8 @@ all instructions are permitted.
The following values of @var{arch} are accepted: @code{c62x},
@code{c64x}, @code{c64x+}, @code{c67x}, @code{c67x+}, @code{c674x}.
-@cindex @code{-mdsbt} command line option, TIC6X
-@cindex @code{-mno-dsbt} command line option, TIC6X
+@cindex @code{-mdsbt} command-line option, TIC6X
+@cindex @code{-mno-dsbt} command-line option, TIC6X
@item -mdsbt
@itemx -mno-dsbt
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
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
@itemx -mpid=near
@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
are linked together.
-@cindex @code{-mpic} command line option, TIC6X
-@cindex @code{-mno-pic} command line option, TIC6X
+@cindex @code{-mpic} command-line option, TIC6X
+@cindex @code{-mno-pic} command-line option, TIC6X
@item -mpic
@itemx -mno-pic
The @option{-mpic} option causes the assembler to generate the
diff --git a/gas/doc/c-v850.texi b/gas/doc/c-v850.texi
index bc30159ccb19eac87a6e8b91146e5c1f7ef83759..a29fa545df6a049468acc5bf8c5b35aa568f5fd3 100644
--- a/gas/doc/c-v850.texi
+++ b/gas/doc/c-v850.texi
@@ -21,43 +21,43 @@
@code{@value{AS}} supports the following additional command-line options
for the V850 processor family:
-@cindex command line options, V850
-@cindex V850 command line options
+@cindex command-line options, V850
+@cindex V850 command-line options
@table @code
-@cindex @code{-wsigned_overflow} command line option, V850
+@cindex @code{-wsigned_overflow} command-line option, V850
@item -wsigned_overflow
Causes warnings to be produced when signed immediate values overflow the
space available for then within their opcodes. By default this option
is disabled as it is possible to receive spurious warnings due to using
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
Causes warnings to be produced when unsigned immediate values overflow
the space available for then within their opcodes. By default this
option is disabled as it is possible to receive spurious warnings due to
using exact bit patterns as immediate constants.
-@cindex @code{-mv850} command line option, V850
+@cindex @code{-mv850} command-line option, V850
@item -mv850
Specifies that the assembled code should be marked as being targeted at
the V850 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors.
-@cindex @code{-mv850e} command line option, V850
+@cindex @code{-mv850e} command-line option, V850
@item -mv850e
Specifies that the assembled code should be marked as being targeted at
the V850E processor. This allows the linker to detect attempts to link
such code with code assembled for other processors.
-@cindex @code{-mv850e1} command line option, V850
+@cindex @code{-mv850e1} command-line option, V850
@item -mv850e1
Specifies that the assembled code should be marked as being targeted at
the V850E1 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors.
-@cindex @code{-mv850any} command line option, V850
+@cindex @code{-mv850any} command-line option, V850
@item -mv850any
Specifies that the assembled code should be marked as being targeted at
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.
-@cindex @code{-mv850e2} command line option, V850
+@cindex @code{-mv850e2} command-line option, V850
@item -mv850e2
Specifies that the assembled code should be marked as being targeted at
the V850E2 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors.
-@cindex @code{-mv850e2v3} command line option, V850
+@cindex @code{-mv850e2v3} command-line option, V850
@item -mv850e2v3
Specifies that the assembled code should be marked as being targeted at
the V850E2V3 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors.
-@cindex @code{-mv850e2v4} command line option, V850
+@cindex @code{-mv850e2v4} command-line option, V850
@item -mv850e2v4
This is an alias for @option{-mv850e3v5}.
-@cindex @code{-mv850e3v5} command line option, V850
+@cindex @code{-mv850e3v5} command-line option, V850
@item -mv850e3v5
Specifies that the assembled code should be marked as being targeted at
the V850E3V5 processor. This allows the linker to detect attempts to link
such code with code assembled for other processors.
-@cindex @code{-mrelax} command line option, V850
+@cindex @code{-mrelax} command-line option, V850
@item -mrelax
Enables relaxation. This allows the .longcall and .longjump pseudo
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
attempt to relax them.
-@cindex @code{-mgcc-abi} command line option, V850
+@cindex @code{-mgcc-abi} command-line option, V850
@item -mgcc-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
Marks the generated object file as supporting the RH850 ABI. This is
the default.
-@cindex @code{-m8byte-align} command line option, V850
+@cindex @code{-m8byte-align} command-line option, V850
@item -m8byte-align
Marks the generated object file as supporting a maximum 64-bits of
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
Marks the generated object file as supporting a maximum 32-bits of
alignment for variables defined in the source code. This is the
default.
-@cindex @code{-msoft-float} command line option, V850
+@cindex @code{-msoft-float} command-line option, V850
@item -msoft-float
Marks the generated object file as not using any floating point
instructions - and hence can be linked with other V850 binaries
that do or do not use floating point. This is the default for
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
Marks the generated object file as one that uses floating point
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
label called '__gp'. This can either be set up automatically by the
linker, or specifically set by using the @samp{--defsym __gp=<value>}
-command line option].
+command-line option].
@cindex @code{tdaoff} pseudo-op, V850
@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
label called '__ep'. This can either be set up automatically by the
linker, or specifically set by using the @samp{--defsym __ep=<value>}
-command line option].
+command-line option].
@cindex @code{zdaoff} pseudo-op, V850
@item zdaoff()
@@ -473,14 +473,14 @@ at the location labeled 'table_func1'.
Indicates that the following sequence of instructions is a long 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
-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
@item .longjump @code{name}
Indicates that the following sequence of instructions is a long jump
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
-valid if the @code{-mrelax} command line switch has been enabled.
+valid if the @code{-mrelax} command-line switch has been enabled.
@end table
diff --git a/gas/doc/c-vax.texi b/gas/doc/c-vax.texi
index 0d72d4fb1755c44d17686465238aea30c2df3f00..0dddbcd0d5814a78575336d5ccd1c32a952d4a17 100644
--- a/gas/doc/c-vax.texi
+++ b/gas/doc/c-vax.texi
@@ -50,7 +50,7 @@ These are obsolete options used to debug old assemblers.
@item @code{-d} (Displacement size for JUMPs)
This option expects a number following the @samp{-d}. Like options
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).
@cindex @code{-V}, redundant on VAX
diff --git a/gas/doc/c-visium.texi b/gas/doc/c-visium.texi
index e35f1742851b76d70447be97a9d4d77ca2f6ccc4..d6b8e4cee593f243692ebd55d2b9283c9e24054a 100644
--- a/gas/doc/c-visium.texi
+++ b/gas/doc/c-visium.texi
@@ -30,7 +30,7 @@ The Visium assembler implements one machine-specific option:
@c man begin OPTIONS
@table @gcctabopt
-@cindex @code{-mtune=@var{arch}} command line option, Visium
+@cindex @code{-mtune=@var{arch}} command-line option, Visium
@item -mtune=@var{arch}
This option specifies the target architecture. If an attempt is made to
assemble an instruction that will not execute on the target architecture,
diff --git a/gas/doc/c-xstormy16.texi b/gas/doc/c-xstormy16.texi
index e60264ac5030602742d0b138885d719f7c5d9233..48b74e5edb3340a81d783ea91fa20d92c52f3cd7 100644
--- a/gas/doc/c-xstormy16.texi
+++ b/gas/doc/c-xstormy16.texi
@@ -52,17 +52,17 @@ line.
@cindex @code{16bit_pointers} directive, XStormy16
@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.
@cindex @code{32bit_pointers} directive, XStormy16
@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.
@cindex @code{.no_pointers} directive, XStormy16
@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.
@end table
diff --git a/gas/doc/c-xtensa.texi b/gas/doc/c-xtensa.texi
index 488e11a64114ea3b8f52a8d0a383e1199821a06b..cf93c143507c46887029925b9792e6d72a9891da 100644
--- a/gas/doc/c-xtensa.texi
+++ b/gas/doc/c-xtensa.texi
@@ -28,7 +28,7 @@ Reference Manual}.
@end menu
@node Xtensa Options
-@section Command Line Options
+@section Command-line Options
@c man begin OPTIONS
@table @gcctabopt
@@ -296,7 +296,7 @@ call. This alignment has the potential to reduce branch penalties at
some expense in code size.
This optimization is enabled by default. You can disable it with the
@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
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
underscore prefixes (@pxref{Xtensa Opcodes, ,Opcode Names}), the
@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}).
@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
or performance while the code itself is small. This relaxation may be
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
@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
can be disabled by using underscore prefixes (@pxref{Xtensa Opcodes,
,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}).
@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;
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
are placed in the current section.@footnote{Literals for the
@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
directive has no effect when using the
@samp{--text-@-section-@-literals} option (@pxref{Xtensa Options,
-,Command Line Options}).
+,Command-line Options}).
@node Absolute Literals Directive
@subsection absolute-literals
diff --git a/gas/doc/c-z80.texi b/gas/doc/c-z80.texi
index 3bc89e123a7d0211e1bac07ea0dea3d3f8ea5f2d..3287c687ce1035a0bd6ddf6692c5c00719f9ff08 100644
--- a/gas/doc/c-z80.texi
+++ b/gas/doc/c-z80.texi
@@ -30,7 +30,7 @@
The Zilog Z80 and Ascii R800 version of @code{@value{AS}} have a few machine
dependent options.
@table @option
-@cindex @code{-z80} command line option, Z80
+@cindex @code{-z80} command-line option, Z80
@item -z80
Produce code for the Z80 processor. There are additional options to
request warnings and error messages for undocumented instructions.
@@ -56,7 +56,7 @@ Treat all undocumented z80-instructions as errors.
@itemx -Fup
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
Produce code for the R800 processor. The assembler does not support
undocumented instructions for the R800.
diff --git a/gas/doc/c-z8k.texi b/gas/doc/c-z8k.texi
index d80a828e0828891de01ade87406d87074612329d..a6c08ae7c9e92760a136ff7e13fec613bbdb7016 100644
--- a/gas/doc/c-z8k.texi
+++ b/gas/doc/c-z8k.texi
@@ -36,11 +36,11 @@ for a list of other Z8000 specific assembler directives.
@cindex Z8000 options
@cindex options, Z8000
@table @option
-@cindex @code{-z8001} command line option, Z8000
+@cindex @code{-z8001} command-line option, Z8000
@item -z8001
Generate segmented code by default.
-@cindex @code{-z8002} command line option, Z8000
+@cindex @code{-z8002} command-line option, Z8000
@item -z8002
Generate unsegmented code by default.
@end table
diff --git a/gas/doc/internals.texi b/gas/doc/internals.texi
index 418c7003696413f0c910c373fd43a35b2803c30a..7a4cfdde9899fc0f057c3e6dc8d4820984b82152 100644
--- a/gas/doc/internals.texi
+++ b/gas/doc/internals.texi
@@ -1229,7 +1229,7 @@ the relax table.
@item LINKER_RELAXING_SHRINKS_ONLY
@cindex LINKER_RELAXING_SHRINKS_ONLY
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
then discard this space when relaxing the section.
@@ -1593,7 +1593,7 @@ if it is necessary to add object file format specific code to the CPU file.
@item obj_begin
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.
@item obj_app_file
diff --git a/gprof/gprof.texi b/gprof/gprof.texi
index bdcda00c4e016618cce14d62bbaf74135117fb07..456805b687d61847c8252d5af2dbf259a55b971f 100644
--- a/gprof/gprof.texi
+++ b/gprof/gprof.texi
@@ -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
against a static version of the library containing the profiling
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
@@ -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}.
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
and exit of every function in their program. This can be used to
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
to generate debugging symbols for tracking source code lines.
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
in line-by-line mode.
diff --git a/ld/NEWS b/ld/NEWS
index eafcaf33cb7b50b5bacbe1e21a92b1d27584f537..3cd51cf4646486784373c5263a24e3808eb71948 100644
--- a/ld/NEWS
+++ b/ld/NEWS
@@ -4,9 +4,9 @@ Changes in 2.30:
* 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
supports this functionality.
@@ -63,7 +63,7 @@ Changes in 2.28:
* 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.
* Add --in-implib=<infile> to the ARM linker to enable specifying a set of
@@ -111,10 +111,10 @@ Changes in 2.26:
* Experimental support for linker garbage collection (--gc-sections)
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].
-* 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
the current behaviour, 'warn' and 'error' issue a warning or error
respectively when orphan sections are found, and 'discard' will discard all
@@ -131,11 +131,11 @@ Changes in 2.25:
* 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
- command line option.
+ command-line option.
* 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.
@@ -261,7 +261,7 @@ Changes in 2.20:
latter case the library is not linked if it is found in a DT_NEEDED
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.
* Add support for Sunplus score architecture.
@@ -296,11 +296,11 @@ Changes in 2.19:
direction of sorting.
* 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
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:
@@ -315,7 +315,7 @@ Changes in 2.18:
* -l:foo now searches the library path for a filename called foo,
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
script.
@@ -389,7 +389,7 @@ Changes in 2.16:
language to permit sorting sections by section name or section
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.
* ELF: --add-needed/--no-add-needed options to control if a DT_NEEDED tag
@@ -399,7 +399,7 @@ Changes in 2.16:
* 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
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
@@ -499,7 +499,7 @@ Changes in version 2.11:
* 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.
* Added ability to emit full relocation information in linked executables,
diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index 226e2deb32df0cdd587c6b9d4fb7034ed1b90ef8..84272d0759af2c529d2ece2570efde20d22761e4 100644
--- a/ld/ld.texinfo
+++ b/ld/ld.texinfo
@@ -251,12 +251,12 @@ you have many choices to control its behavior.
@ifset UsesEnvVars
@menu
-* Options:: Command Line Options
+* Options:: Command-line Options
* Environment:: Environment Variables
@end menu
@node Options
-@section Command Line Options
+@section Command-line Options
@end ifset
@cindex command line
@@ -336,7 +336,7 @@ Unique abbreviations of the names of multiple-letter options are
accepted.
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
compiler driver) like this:
@@ -356,7 +356,7 @@ the joined forms of both single- and multiple-letter options, such as:
gcc foo.o bar.o -Wl,-eENTRY -Wl,-Map=a.map
@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:
@table @gcctabopt
@@ -1174,7 +1174,7 @@ This option is only meaningful when building a dynamic executable.
This option marks the executable as requiring global auditing by
setting the @code{DF_1_GLOBAUDIT} bit in the @code{DT_FLAGS_1} dynamic
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.
@item ibtplt
@@ -1457,7 +1457,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
suitable error messages. The linker does know about, and does make
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
force checking in that case by using the @option{--check-sections}
option.
@@ -2516,7 +2516,7 @@ symbols from, to ensure that they get linked in, just like a normal
object file).
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
values by either a space or an equals sign.
@@ -3184,8 +3184,8 @@ described below.
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
-linker executable. You can use the @samp{--verbose} command line option
-to display the default linker script. Certain command line options,
+linker executable. You can use the @samp{--verbose} command-line option
+to display the default linker script. Certain command-line options,
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
@@ -3441,10 +3441,10 @@ linker will search through the archive library search path.
The @dfn{sysroot prefix} can also be forced by specifying @code{=}
as the first character in the filename path, or prefixing the filename
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
-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}.
When you use the @code{INPUT} command in an implicit linker script, the
@@ -3458,7 +3458,7 @@ script file is included. This can affect archive searching.
The @code{GROUP} command is like @code{INPUT}, except that the named
files should all be archives, and they are searched repeatedly until no
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{})
@itemx AS_NEEDED(@var{file} @var{file} @dots{})
@@ -3478,7 +3478,7 @@ setting afterwards.
The @code{OUTPUT} command names the output file. Using
@code{OUTPUT(@var{filename})} in the linker script is exactly like using
@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.
You can use the @code{OUTPUT} command to define a default name for the
@@ -3492,9 +3492,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
@command{ld} looks for archive libraries. Using
@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
-the command line option are searched first.
+the command-line option are searched first.
@item STARTUP(@var{filename})
@kindex STARTUP(@var{filename})
@@ -3519,11 +3519,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
output file (@pxref{BFD}). Using @code{OUTPUT_FORMAT(@var{bfdname})} is
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.
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
desired endianness.
@@ -3538,7 +3538,7 @@ command:
OUTPUT_FORMAT(elf32-bigmips, elf32-bigmips, elf32-littlemips)
@end smallexample
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}
format.
@@ -3548,7 +3548,7 @@ format.
The @code{TARGET} command names the BFD format to use when reading input
files. It affects subsequent @code{INPUT} and @code{GROUP} commands.
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}
command is also used to set the format for the output file. @xref{BFD}.
@end table
@@ -4568,12 +4568,12 @@ is treated the same as @code{SORT_BY_ALIGNMENT} (wildcard section pattern).
All other nested section sorting commands are invalid.
@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
-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
-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.
@enumerate
@@ -4588,10 +4588,10 @@ treated as nested sorting command.
@end enumerate
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
-@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.
If you ever get confused about where input sections are going, use the
@@ -5887,8 +5887,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
support, the orphan section is placed at the end of the file.
-The command line options @samp{--orphan-handling} and @samp{--unique}
-(@pxref{Options,,Command Line Options}) can be used to control which
+The command-line options @samp{--orphan-handling} and @samp{--unique}
+(@pxref{Options,,Command-line Options}) can be used to control which
output sections an orphan is placed in.
@node Location Counter
@@ -6697,7 +6697,7 @@ options are required for these chips.
@cindex i960 support
-You can use the @samp{-A@var{architecture}} command line option to
+You can use the @samp{-A@var{architecture}} command-line option to
specify one of the two-letter names identifying members of the 960
family; the option specifies the desired output target, and warns of any
incompatible instructions in the input files. It also modifies the
@@ -6810,7 +6810,7 @@ between ARM and Thumb code. These stubs only work with code that has
been compiled and assembled with the @samp{-mthumb-interwork} command
line option. If it is necessary to link with old ARM object files or
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
which will work with non-interworking aware ARM code. Note, however,
the linker does not support generating stubs for function calls to
@@ -7016,7 +7016,7 @@ The linker will automatically generate and insert small sequences of
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
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
duplicate stubs, increasing the code size. The linker will try to
group stubs together in order to reduce interruptions to the flow of
@@ -7073,7 +7073,7 @@ link-time values for dynamic relocations.
@cindex Placement of SG veneers
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
veneers in memory.
@@ -7810,8 +7810,8 @@ header format depends on the default specified by the specific target.
@section @command{ld} and WIN32 (cygwin/mingw)
This section describes some of the win32 specific @command{ld} issues.
-See @ref{Options,,Command Line Options} for detailed description of the
-command line options mentioned here.
+See @ref{Options,,Command-line Options} for detailed description of the
+command-line options mentioned here.
@table @emph
@cindex import libraries
@@ -7821,7 +7821,7 @@ libraries, which contains information for linking to dll's. They are
regular static archives and are handled as any other static
archive. The cygwin and mingw ports of @command{ld} have specific
support for creating such libraries provided with the
-@samp{--out-implib} command line option.
+@samp{--out-implib} command-line option.
@item exporting DLL symbols
@cindex exporting DLL symbols
@@ -7831,7 +7831,7 @@ The cygwin/mingw @command{ld} has several ways to export symbols for dll's.
@item using auto-export functionality
@cindex using 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
@item --export-all-symbols [This is the default]
@@ -7965,7 +7965,7 @@ other DEF file statements
@cindex creating 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
@cindex Using decorations
@@ -8225,7 +8225,7 @@ The line @samp{_foo = foo} maps the exported symbol @samp{foo} to
@end table
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
@emph{all} desired exports in the DEF file, including the symbols
that are not being renamed, and do @emph{not} use the
diff --git a/ld/ldint.texinfo b/ld/ldint.texinfo
index 6df7c88562579f5b2866272dd5d54e44ce9ae8b4..d15b9fac8b43a14ee5ff41ae28e91756c11a9e62 100644
--- a/ld/ldint.texinfo
+++ b/ld/ldint.texinfo
@@ -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
will be invoked 5 (or, in some cases, 6) times, with different
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
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.
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
@code{ldemul_default_target}, it picks your @code{target_name} by
default.