diff options
author | Thomas Preud'homme <thomas.preudhomme@arm.com> | 2018-07-02 11:18:24 +0100 |
---|---|---|
committer | Thomas Preud'homme <thomas.preudhomme@arm.com> | 2018-07-02 11:18:24 +0100 |
commit | a05a5b64cf33d36d93a92fd03ae900e18dbe5572 (patch) | |
tree | 15b75a1cf3c0fc782160e6e592c63d822e312e6e /ld/NEWS | |
parent | f2075844e2d4dc0f3f0d15b1acf20651f19cbb33 (diff) | |
download | gdb-a05a5b64cf33d36d93a92fd03ae900e18dbe5572.zip gdb-a05a5b64cf33d36d93a92fd03ae900e18dbe5572.tar.gz gdb-a05a5b64cf33d36d93a92fd03ae900e18dbe5572.tar.bz2 |
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 <thomas.preudhomme@arm.com>
bfd/
* doc/bfdint.texi: Use command-line consistently when used in a
compount word.
* doc/bfdsumm.texi: Likewise.
binutils/
* NEWS: Use command-line consistently when used in a compount word.
* doc/binutils.texi: Likewise and fix trailing whitespace on same
line.
gas/
* NEWS: Use command-line consistently when used in a compount word.
* doc/as.texi: Likewise.
* doc/c-aarch64.texi: Likewise.
* doc/c-alpha.texi: Likewise.
* doc/c-arc.texi: Likewise.
* doc/c-arm.texi: Likewise.
* doc/c-avr.texi: Likewise.
* doc/c-bfin.texi: Likewise.
* doc/c-cris.texi: Likewise.
* doc/c-epiphany.texi: Likewise.
* doc/c-i386.texi: Likewise.
* doc/c-ia64.texi: Likewise.
* doc/c-lm32.texi: Likewise.
* doc/c-m32r.texi: Likewise.
* doc/c-m68k.texi: Likewise.
* doc/c-mips.texi: Likewise.
* doc/c-mmix.texi: Likewise.
* doc/c-msp430.texi: Likewise.
* doc/c-mt.texi: Likewise.
* doc/c-nios2.texi: Likewise.
* doc/c-ppc.texi: Likewise.
* doc/c-pru.texi: Likewise.
* doc/c-rl78.texi: Likewise.
* doc/c-rx.texi: Likewise.
* doc/c-tic6x.texi: Likewise.
* doc/c-v850.texi: Likewise.
* doc/c-vax.texi: Likewise.
* doc/c-visium.texi: Likewise.
* doc/c-xstormy16.texi: Likewise.
* doc/c-xtensa.texi: Likewise.
* doc/c-z80.texi: Likewise.
* doc/c-z8k.texi: Likewise.
* doc/internals.texi: Likewise.
gprof/
* gprof.texi: Use command-line consistently when used in a compount
word.
ld/
* NEWS: Use command-line consistently when used in a compount word.
* ld.texinfo: Likewise.
* ldint.texinfo: Likewise.
Diffstat (limited to 'ld/NEWS')
-rw-r--r-- | ld/NEWS | 28 |
1 files changed, 14 insertions, 14 deletions
@@ -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=<infile> to the ARM linker to enable specifying a set of @@ -120,10 +120,10 @@ Changes in 2.26: * Experimental support for linker garbage collection (--gc-sections) 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=<type> command line option. + the --got=<type> command-line option. * The ARM EABI linker will now generate stubs for function calls to symbols that are too far away. The placement of the stubs is controlled by a new - linker command line option: --stub-group-size=N. + linker command-line option: --stub-group-size=N. Changes in 2.18: @@ -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=<NUMBER>. 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, |