From: Thomas Preud'homme Date: Mon, 2 Jul 2018 10:18:24 +0000 (+0100) Subject: Fix use of "command line X" in binutils doc X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=a05a5b64cf33d36d93a92fd03ae900e18dbe5572;p=binutils-gdb.git Fix use of "command line X" in binutils doc Binutils documentation uses a mix of spelling for the compound word "command-line X". According to [1]: "Sometimes compound words are written separately (nail polish), sometimes with a hyphen (short-sighted) and sometimes as one word (eyelashes). Often new compounds are written as two separate words and, as they become more familiar, they are either connected with a hyphen (-) or made into one word." I think command-line X is common enough in our industry that the two workds command and line should be connected. Since command-line is more common than commandline, I propose to update binutils documentation to consistently use "command-line" when this is used as an adjective to a noun (eg. command-line argument, command-line switch, command-line option and command-line flag). I've left occurences of "the command line" as is. I've also left gdb, sim and readline alone and have only touched public documentation (texi and NEWS files). [1] http://dictionary.cambridge.org/grammar/british-grammar/word-formation/compounds 2018-07-02 Thomas Preud'homme bfd/ * doc/bfdint.texi: Use command-line consistently when used in a compount word. * doc/bfdsumm.texi: Likewise. binutils/ * NEWS: Use command-line consistently when used in a compount word. * doc/binutils.texi: Likewise and fix trailing whitespace on same line. gas/ * NEWS: Use command-line consistently when used in a compount word. * doc/as.texi: Likewise. * doc/c-aarch64.texi: Likewise. * doc/c-alpha.texi: Likewise. * doc/c-arc.texi: Likewise. * doc/c-arm.texi: Likewise. * doc/c-avr.texi: Likewise. * doc/c-bfin.texi: Likewise. * doc/c-cris.texi: Likewise. * doc/c-epiphany.texi: Likewise. * doc/c-i386.texi: Likewise. * doc/c-ia64.texi: Likewise. * doc/c-lm32.texi: Likewise. * doc/c-m32r.texi: Likewise. * doc/c-m68k.texi: Likewise. * doc/c-mips.texi: Likewise. * doc/c-mmix.texi: Likewise. * doc/c-msp430.texi: Likewise. * doc/c-mt.texi: Likewise. * doc/c-nios2.texi: Likewise. * doc/c-ppc.texi: Likewise. * doc/c-pru.texi: Likewise. * doc/c-rl78.texi: Likewise. * doc/c-rx.texi: Likewise. * doc/c-tic6x.texi: Likewise. * doc/c-v850.texi: Likewise. * doc/c-vax.texi: Likewise. * doc/c-visium.texi: Likewise. * doc/c-xstormy16.texi: Likewise. * doc/c-xtensa.texi: Likewise. * doc/c-z80.texi: Likewise. * doc/c-z8k.texi: Likewise. * doc/internals.texi: Likewise. gprof/ * gprof.texi: Use command-line consistently when used in a compount word. ld/ * NEWS: Use command-line consistently when used in a compount word. * ld.texinfo: Likewise. * ldint.texinfo: Likewise. --- diff --git a/bfd/ChangeLog b/bfd/ChangeLog index 9cfd1c9068b..a4ee93365de 100644 --- a/bfd/ChangeLog +++ b/bfd/ChangeLog @@ -1,3 +1,9 @@ +2018-07-02 Thomas Preud'homme + + * doc/bfdint.texi: Use command-line consistently when used in a + compount word. + * doc/bfdsumm.texi: Likewise. + 2018-06-29 Maciej W. Rozycki * elfxx-mips.c (allocate_dynrelocs): Remove extraneous symbol diff --git a/bfd/doc/bfdint.texi b/bfd/doc/bfdint.texi index 4d36381ceac..91479f92fa7 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 848c06ea632..51ffbb795a3 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/ChangeLog b/binutils/ChangeLog index 20c6bd7a73d..4f3284ae7db 100644 --- a/binutils/ChangeLog +++ b/binutils/ChangeLog @@ -1,3 +1,9 @@ +2018-07-02 Thomas Preud'homme + + * NEWS: Use command-line consistently when used in a compount word. + * doc/binutils.texi: Likewise and fix trailing whitespace on same + line. + 2018-06-26 Nick Clifton * po/sv.po: Updated Swedish translation. diff --git a/binutils/NEWS b/binutils/NEWS index 6b29a8ad552..a3890ed94c6 100644 --- a/binutils/NEWS +++ b/binutils/NEWS @@ -66,11 +66,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. @@ -130,7 +130,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. @@ -173,10 +173,10 @@ changes in 2.21: * Add to dlltool .def file feature of aliasing PE internal symbol name by '== ' 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. @@ -189,14 +189,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= command line option. + of bytes via the --relocated-dump= 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= which reads in symbols from a specified file. @@ -207,7 +207,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. @@ -270,7 +270,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. @@ -322,7 +322,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 @@ -404,17 +404,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. @@ -426,7 +426,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. @@ -439,11 +439,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 599c79eb93e..e40ccb073d5 100644 --- a/binutils/doc/binutils.texi +++ b/binutils/doc/binutils.texi @@ -520,13 +520,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 @@ -541,7 +541,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. @@ -564,7 +564,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. @@ -2852,7 +2852,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 @@ -2980,7 +2980,7 @@ data sections. If the file type in unrecognizable, or if strings is reading from stdin then it will always display all of the printable 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. @@ -3430,7 +3430,7 @@ If no @var{symbol} arguments are given, @command{c++filt} reads symbol names from the standard input instead. All the results are printed on 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: @@ -3804,7 +3804,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} @@ -4166,7 +4166,7 @@ which in turn will import LoadLibraryA and GetProcAddress from kernel32. @command{dlltool} builds the library file by hand, but it builds the 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 @@ -4194,7 +4194,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 @@ -4260,7 +4260,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 @@ -4387,7 +4387,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 @@ -4695,7 +4695,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 @@ -4789,7 +4789,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 @@ -4882,7 +4882,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} @@ -4897,7 +4897,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} @@ -4912,7 +4912,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) @@ -4930,7 +4930,7 @@ Ways to specify: @enumerate @item -command line option: @option{--target} +command-line option: @option{--target} @item environment variable @code{GNUTARGET} @@ -4957,7 +4957,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/ChangeLog b/gas/ChangeLog index 70a922961b4..9a286480cb5 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,3 +1,39 @@ +2018-07-02 Thomas Preud'homme + + * NEWS: Use command-line consistently when used in a compount word. + * doc/as.texi: Likewise. + * doc/c-aarch64.texi: Likewise. + * doc/c-alpha.texi: Likewise. + * doc/c-arc.texi: Likewise. + * doc/c-arm.texi: Likewise. + * doc/c-avr.texi: Likewise. + * doc/c-bfin.texi: Likewise. + * doc/c-cris.texi: Likewise. + * doc/c-epiphany.texi: Likewise. + * doc/c-i386.texi: Likewise. + * doc/c-ia64.texi: Likewise. + * doc/c-lm32.texi: Likewise. + * doc/c-m32r.texi: Likewise. + * doc/c-m68k.texi: Likewise. + * doc/c-mips.texi: Likewise. + * doc/c-mmix.texi: Likewise. + * doc/c-msp430.texi: Likewise. + * doc/c-mt.texi: Likewise. + * doc/c-nios2.texi: Likewise. + * doc/c-ppc.texi: Likewise. + * doc/c-pru.texi: Likewise. + * doc/c-rl78.texi: Likewise. + * doc/c-rx.texi: Likewise. + * doc/c-tic6x.texi: Likewise. + * doc/c-v850.texi: Likewise. + * doc/c-vax.texi: Likewise. + * doc/c-visium.texi: Likewise. + * doc/c-xstormy16.texi: Likewise. + * doc/c-xtensa.texi: Likewise. + * doc/c-z80.texi: Likewise. + * doc/c-z8k.texi: Likewise. + * doc/internals.texi: Likewise. + 2018-06-29 Jim Wilson * config/tc-riscv.c (md_begin): Call hash_reg_name for "fp". diff --git a/gas/NEWS b/gas/NEWS index 09faaf1c618..5fd844cdc4c 100644 --- a/gas/NEWS +++ b/gas/NEWS @@ -70,7 +70,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 @@ -80,10 +80,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. @@ -127,7 +127,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. @@ -135,7 +135,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. @@ -182,7 +182,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. @@ -219,23 +219,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. @@ -268,7 +268,7 @@ Changes in 2.17: * Add support for the "@" syntax to the command line, so that extra switches can be read from . -* 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. @@ -289,15 +289,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 @@ -307,7 +307,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. @@ -322,9 +322,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: @@ -418,7 +418,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: @@ -441,7 +441,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.texi b/gas/doc/as.texi index 493049cf9fb..49b1ef1b8b8 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -757,7 +757,7 @@ configure option. @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. @@ -1607,12 +1607,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. @@ -2011,7 +2011,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 @@ -2050,7 +2050,7 @@ program. The source program is made up of one or more files. You give @command{@value{AS}} a command line that has zero or more input file 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 @@ -2288,7 +2288,7 @@ The letters after @samp{-a} may be combined into one option, Note if the assembler source is coming from the standard input (e.g., 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 @@ -2383,7 +2383,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 @@ -2777,7 +2777,7 @@ specific, and some targets multiple comment characters. Some targets also have line comment characters that only work if they are the first character on a line. 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 @@ -5700,7 +5700,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 0423995af1b..b659b8ba597 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 @@ -85,7 +85,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 @@ -102,12 +102,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. @@ -285,7 +285,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. @@ -294,7 +294,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. @@ -310,7 +310,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 8365e39995d..7b228ac9a76 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 76eae3f1da7..bce51d15a48 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 4683b8a4bb7..d2f6fe18090 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 @@ -201,7 +201,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 @@ -252,7 +252,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 @@ -309,19 +309,19 @@ The default is dependent on the processor selected. For Architecture 5 or later, the default is to assemble for VFP instructions; for earlier 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. It also affects the behaviour of the @code{ADR} and @code{ADRL} pseudo opcodes. -@cindex @code{-mimplicit-it} command line option, ARM +@cindex @code{-mimplicit-it} command-line option, ARM @item -mimplicit-it=never @itemx -mimplicit-it=always @itemx -mimplicit-it=arm @@ -339,15 +339,15 @@ If @code{thumb} is specified, such constructs cause a warning in ARM code and are accepted in Thumb-2 code. If you omit this option, the 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 @@ -355,18 +355,18 @@ enabled this option will cause the assembler to create an empty debugging section in the object file called .arm.atpcs. Debuggers can 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. @@ -376,7 +376,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. @@ -386,7 +386,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. @@ -397,33 +397,33 @@ and little-endian instructions then it should be assembled with the the @option{--be8} option. This will reverse the endianness of the 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 @@ -624,7 +624,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. @@ -633,7 +633,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. @@ -663,7 +663,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. @@ -771,7 +771,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 c827426aee8..6fc669e949a 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 1df0a9fcbb8..51cdda1d6d9 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 6fc25f11cbc..e77e33f5cc9 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 b5b0cc6f8dd..8f533f0b9d1 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 2390fa9cbb1..c3fce9eac63 100644 --- a/gas/doc/c-i386.texi +++ b/gas/doc/c-i386.texi @@ -596,7 +596,7 @@ line is treated as a comment, but in this case the line can also be a logical line number directive (@pxref{Comments}) or a preprocessor 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 b571ec5a971..fc739b431b2 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 0d66e3cb692..058ca378223 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 754164ad053..53950ca7882 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 2ef5e2191ba..76c111f5158 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 9cbfaf2dd05..24f68433d21 100644 --- a/gas/doc/c-mips.texi +++ b/gas/doc/c-mips.texi @@ -522,7 +522,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 @@ -748,7 +748,7 @@ for the corresponding ISA level, from that point on in the assembly. @code{.set mips@var{n}} affects not only which instructions 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! @@ -758,7 +758,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, @@ -776,13 +776,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. @@ -873,7 +873,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 @@ -933,7 +933,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 3ed68220641..d10d750d4ce 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 bb491b7551d..8338e6d9571 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 b25f50abfbf..dd759fb901e 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 1895b4038f9..a0f22f4c26e 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 807b0879ba0..6f7b0f9a91e 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 208e199eec0..0910b39ac17 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 62be228f98e..1d645875bbe 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 ea523f11bd8..b20fd09496b 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 4622e187235..87441003f48 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 bc30159ccb1..a29fa545df6 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=} -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=} -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 0d72d4fb175..0dddbcd0d58 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 e35f1742851..d6b8e4cee59 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 e60264ac503..48b74e5edb3 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 488e11a6411..cf93c143507 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 3bc89e123a7..3287c687ce1 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 d80a828e082..a6c08ae7c9e 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 93352ecf7f1..f58ae8bf12d 100644 --- a/gas/doc/internals.texi +++ b/gas/doc/internals.texi @@ -1224,7 +1224,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. @@ -1588,7 +1588,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/ChangeLog b/gprof/ChangeLog index f57729deb3e..ce748f60f02 100644 --- a/gprof/ChangeLog +++ b/gprof/ChangeLog @@ -1,3 +1,8 @@ +2018-07-02 Thomas Preud'homme + + * gprof.texi: Use command-line consistently when used in a compount + word. + 2018-06-24 Nick Clifton * configure: Regenerate. diff --git a/gprof/gprof.texi b/gprof/gprof.texi index bdcda00c4e0..456805b687d 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/ChangeLog b/ld/ChangeLog index 5f4d250ae6f..399ea0af6b1 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,3 +1,9 @@ +2018-07-02 Thomas Preud'homme + + * NEWS: Use command-line consistently when used in a compount word. + * ld.texinfo: Likewise. + * ldint.texinfo: Likewise. + 2018-06-26 Nick Clifton * po/uk.po: Updated Ukranian translation. diff --git a/ld/NEWS b/ld/NEWS index bf199058266..47d06c981c7 100644 --- a/ld/NEWS +++ b/ld/NEWS @@ -13,9 +13,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. @@ -72,7 +72,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= to the ARM linker to enable specifying a set of @@ -120,10 +120,10 @@ Changes in 2.26: * Experimental support for linker garbage collection (--gc-sections) 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 @@ -140,11 +140,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. @@ -270,7 +270,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. @@ -305,11 +305,11 @@ Changes in 2.19: direction of sorting. * The M68K linker now supports multiple GOT generation schemes controlled via - the --got= command line option. + the --got= 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: @@ -324,7 +324,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. @@ -398,7 +398,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 @@ -408,7 +408,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=. Also if the switch --reduce-memory-overheads is used, and --hash-size has not been used, then the default value will be set @@ -508,7 +508,7 @@ Changes in version 2.11: * TI C54x support, by Timothy Wall. -* 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.texi b/ld/ld.texi index 40d79ddf624..b9fe2324da1 100644 --- a/ld/ld.texi +++ b/ld/ld.texi @@ -247,12 +247,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 @@ -332,7 +332,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: @@ -352,7 +352,7 @@ the joined forms of both single- and multiple-letter options, such as: gcc foo.o bar.o -Wl,-eENTRY -Wl,-Map=a.map @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 @@ -1153,7 +1153,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 @@ -1436,7 +1436,7 @@ been assigned to see if there are any overlaps. Normally the linker will perform this check, and if it finds any overlaps it will produce 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. @@ -2497,7 +2497,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. @@ -3168,8 +3168,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 @@ -3425,10 +3425,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 @@ -3442,7 +3442,7 @@ script file is included. This can affect archive searching. The @code{GROUP} command is like @code{INPUT}, except that the named 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{}) @@ -3462,7 +3462,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 @@ -3476,9 +3476,9 @@ output file other than the usual default of @file{a.out}. The @code{SEARCH_DIR} command adds @var{path} to the list of paths where @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}) @@ -3503,11 +3503,11 @@ A couple of linker script commands deal with object file formats. The @code{OUTPUT_FORMAT} command names the BFD format to use for the 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. @@ -3522,7 +3522,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. @@ -3532,7 +3532,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 @@ -4552,12 +4552,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 @@ -4572,10 +4572,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 @@ -5871,8 +5871,8 @@ attribute, such as code vs data, loadable vs non-loadable, etc. If no sections with matching attributes are found, or your target lacks this 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 @@ -6734,7 +6734,7 @@ between ARM and Thumb code. These stubs only work with code that has been compiled and assembled with the @samp{-mthumb-interwork} command 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 @@ -6940,7 +6940,7 @@ The linker will automatically generate and insert small sequences of code into a linked ARM ELF executable whenever an attempt is made to 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 @@ -6997,7 +6997,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. @@ -7734,8 +7734,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 @@ -7745,7 +7745,7 @@ libraries, which contains information for linking to dll's. They are regular static archives and are handled as any other static 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 @@ -7755,7 +7755,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] @@ -7889,7 +7889,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 } command line option. +with the @samp{--output-def } command-line option. @item Using decorations @cindex Using decorations @@ -8150,7 +8150,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.texi b/ld/ldint.texi index 6df7c885625..d15b9fac8b4 100644 --- a/ld/ldint.texi +++ b/ld/ldint.texi @@ -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.