[Bug driver/68043] many undocumented options, missing punctuation

["msebor at gcc dot gnu.org" <gcc-bugzilla at gcc dot gnu dot org>]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=68043

--- Comment #1 from Martin Sebor <msebor at gcc dot gnu.org> ---
Author: msebor
Date: Wed Oct 21 22:24:41 2015
New Revision: 229155

URL: https://gcc.gnu.org/viewcvs?rev=229155&root=gcc&view=rev
Log:
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.


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