Improve --help output to generate references to option aliases.
authorMartin Sebor <msebor@redhat.com>
Wed, 21 Oct 2015 22:24:41 +0000 (22:24 +0000)
committerMartin Sebor <msebor@gcc.gnu.org>
Wed, 21 Oct 2015 22:24:41 +0000 (16:24 -0600)
commita7b2e1845f0c20da4ed6462161f58f706a587d44
tree0e86ee5c584e34b06f641c070503e72ef5231aaf
parent22d663823adbd7b1a17e0c7b89ab8c489ae6c8f4
Improve --help output to generate references to option aliases.

gcc/
PR driver/68043
* opts.c (undocumented_msg, use_diagnosed_msg): New globals.
(print_filtered_help): Reference aliased option's name and encourage
readers to use it in preference to the alias if the former is not
documented.  Mention when using an option is diagnosed.
* gcc.c (display_help): End each sentence with a period.

* ada/gcc-interface/lang.opt: End each sentence that describes
an option with a period.
* c-family/c.opt: Same.
* common.opt: Same.
* config/aarch64/aarch64.opt: Same.
* config/alpha/alpha.opt: Same.
* config/arc/arc.opt: Same.
* config/arm/arm.opt: Same.
* config/avr/avr.opt: Same.
* config/bfin/bfin.opt: Same.
* config/c6x/c6x.opt: Same.
* config/cr16/cr16.opt: Same.
* config/cris/cris.opt: Same.
* config/cris/linux.opt: Same.
* config/darwin.opt: Same.
* config/epiphany/epiphany.opt: Same.
* config/fr30/fr30.opt: Same.
* config/frv/frv.opt: Same.
* config/ft32/ft32.opt: Same.
* config/g.opt: Same.
* config/h8300/h8300.opt: Same.
* config/i386/cygming.opt: Same.
* config/i386/djgpp.opt: Same.
* config/i386/i386.opt: Same.
* config/i386/interix.opt: Same.
* config/i386/mingw-w64.opt: Same.
* config/i386/mingw.opt: Same.
* config/ia64/ia64.opt: Same.
* config/ia64/ilp32.opt: Same.
* config/iq2000/iq2000.opt: Same.
* config/linux.opt: Same.
* config/lm32/lm32.opt: Same.
* config/lynx.opt: Same.
* config/m32c/m32c.opt: Same.
* config/m32r/m32r.opt: Same.
* config/m68k/ieee.opt: Same.
* config/m68k/m68k.opt: Same.
* config/mcore/mcore.opt: Same.
* config/mep/mep.opt: Same.
* config/microblaze/microblaze.opt: Same.
* config/mips/mips.opt: Same.
* config/mmix/mmix.opt: Same.
* config/mn10300/mn10300.opt: Same.
* config/moxie/moxie.opt: Same.
* config/msp430/msp430.opt: Same.
* config/nios2/elf.opt: Same.
* config/nios2/nios2.opt: Same.
* config/nvptx/nvptx.opt: Same.
* config/pa/pa-hpux.opt: Same.
* config/pa/pa-hpux1010.opt: Same.
* config/pa/pa-hpux1111.opt: Same.
* config/pa/pa-hpux1131.opt: Same.
* config/pa/pa.opt: Same.
* config/pa/pa64-hpux.opt: Same.
* config/pdp11/pdp11.opt: Same.
* config/rl78/rl78.opt: Same.
* config/rs6000/476.opt: Same.
* config/rs6000/aix64.opt: Same.
* config/rs6000/darwin.opt: Same.
* config/rs6000/linux64.opt: Same.
* config/rs6000/rs6000.opt: Same.
* config/rs6000/sysv4.opt: Same.
* config/s390/s390.opt: Same.
* config/s390/tpf.opt: Same.
* config/sh/sh.opt: Same.
* config/sol2.opt: Same.
* config/sparc/long-double-switch.opt: Same.
* config/sparc/sparc.opt: Same.
* config/spu/spu.opt: Same.
* config/stormy16/stormy16.opt: Same.
* config/tilegx/tilegx.opt: Same.
* config/tilepro/tilepro.opt: Same.
* config/v850/v850.opt: Same.
* config/vax/vax.opt: Same.
* config/visium/visium.opt: Same.
* config/vms/vms.opt: Same.
* config/vxworks.opt: Same.
* config/xtensa/xtensa.opt: Same.
* fortran/lang.opt: Same.

testsuite/
PR driver/68043
* gcc.misc-tests/help.exp: Adjust.
* lib/options.exp (check_for_options): Add detail to output.

From-SVN: r229155
88 files changed:
gcc/ChangeLog
gcc/ada/gcc-interface/lang.opt
gcc/c-family/c.opt
gcc/common.opt
gcc/config/aarch64/aarch64.opt
gcc/config/alpha/alpha.opt
gcc/config/arc/arc.opt
gcc/config/arm/arm.opt
gcc/config/avr/avr.opt
gcc/config/bfin/bfin.opt
gcc/config/c6x/c6x.opt
gcc/config/cr16/cr16.opt
gcc/config/cris/cris.opt
gcc/config/cris/linux.opt
gcc/config/darwin.opt
gcc/config/epiphany/epiphany.opt
gcc/config/fr30/fr30.opt
gcc/config/frv/frv.opt
gcc/config/ft32/ft32.opt
gcc/config/g.opt
gcc/config/h8300/h8300.opt
gcc/config/i386/cygming.opt
gcc/config/i386/djgpp.opt
gcc/config/i386/i386.opt
gcc/config/i386/interix.opt
gcc/config/i386/mingw-w64.opt
gcc/config/i386/mingw.opt
gcc/config/ia64/ia64.opt
gcc/config/ia64/ilp32.opt
gcc/config/iq2000/iq2000.opt
gcc/config/linux.opt
gcc/config/lm32/lm32.opt
gcc/config/lynx.opt
gcc/config/m32c/m32c.opt
gcc/config/m32r/m32r.opt
gcc/config/m68k/ieee.opt
gcc/config/m68k/m68k.opt
gcc/config/mcore/mcore.opt
gcc/config/mep/mep.opt
gcc/config/microblaze/microblaze.opt
gcc/config/mips/mips.opt
gcc/config/mmix/mmix.opt
gcc/config/mn10300/mn10300.opt
gcc/config/moxie/moxie.opt
gcc/config/msp430/msp430.opt
gcc/config/nios2/elf.opt
gcc/config/nios2/nios2.opt
gcc/config/nvptx/nvptx.opt
gcc/config/pa/pa-hpux.opt
gcc/config/pa/pa-hpux1010.opt
gcc/config/pa/pa-hpux1111.opt
gcc/config/pa/pa-hpux1131.opt
gcc/config/pa/pa.opt
gcc/config/pa/pa64-hpux.opt
gcc/config/pdp11/pdp11.opt
gcc/config/rl78/rl78.opt
gcc/config/rs6000/476.opt
gcc/config/rs6000/aix64.opt
gcc/config/rs6000/darwin.opt
gcc/config/rs6000/linux64.opt
gcc/config/rs6000/rs6000.opt
gcc/config/rs6000/sysv4.opt
gcc/config/s390/s390.opt
gcc/config/s390/tpf.opt
gcc/config/sh/sh.opt
gcc/config/sol2.opt
gcc/config/sparc/long-double-switch.opt
gcc/config/sparc/sparc.opt
gcc/config/spu/spu.opt
gcc/config/stormy16/stormy16.opt
gcc/config/tilegx/tilegx.opt
gcc/config/tilepro/tilepro.opt
gcc/config/v850/v850.opt
gcc/config/vax/vax.opt
gcc/config/visium/visium.opt
gcc/config/vms/vms.opt
gcc/config/vxworks.opt
gcc/config/xtensa/xtensa.opt
gcc/fortran/lang.opt
gcc/gcc.c
gcc/go/lang.opt
gcc/java/lang.opt
gcc/lto/lang.opt
gcc/opts.c
gcc/params.def
gcc/testsuite/ChangeLog
gcc/testsuite/gcc.misc-tests/help.exp
gcc/testsuite/lib/options.exp