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

1 files changed, 22 insertions, 22 deletions

diff --git a/gcc/config/spu/spu.opt b/gcc/config/spu/spu.opt
index f57ae38..8f0abb7 100644
--- a/gcc/config/spu/spu.opt
+++ b/gcc/config/spu/spu.opt
@@ -17,89 +17,89 @@
 
 mwarn-reloc
 Target Report Mask(WARN_RELOC)
-Emit warnings when run-time relocations are generated
+Emit warnings when run-time relocations are generated.
 
 merror-reloc
 Target Report Mask(ERROR_RELOC)
-Emit errors when run-time relocations are generated
+Emit errors when run-time relocations are generated.
 
 mbranch-cost=
 Target RejectNegative Joined UInteger Var(spu_branch_cost) Init(20)
-Specify cost of branches (Default 20)
+Specify cost of branches (Default 20).
 
 msafe-dma
 Target Report RejectNegative Mask(SAFE_DMA)
-Make sure loads and stores are not moved past DMA instructions
+Make sure loads and stores are not moved past DMA instructions.
 
 munsafe-dma
 Target Report RejectNegative InverseMask(SAFE_DMA)
-volatile must be specified on any memory that is effected by DMA
+volatile must be specified on any memory that is effected by DMA.
 
 mdual-nops
 Target Report Var(spu_dual_nops,10) Init(10)
-Insert nops when it might improve performance by allowing dual issue (default)
+Insert nops when it might improve performance by allowing dual issue (default).
 
 mdual-nops=
 Target RejectNegative Joined UInteger Var(spu_dual_nops)
-Insert nops when it might improve performance by allowing dual issue (default)
+Insert nops when it might improve performance by allowing dual issue (default).
 
 mstdmain
 Target Report Mask(STD_MAIN)
-Use standard main function as entry for startup
+Use standard main function as entry for startup.
 
 mbranch-hints
 Target Report Mask(BRANCH_HINTS)
-Generate branch hints for branches
+Generate branch hints for branches.
 
 mhint-max-nops=
 Target RejectNegative Joined UInteger Var(spu_max_nops) Init(2)
-Maximum number of nops to insert for a hint (Default 2)
+Maximum number of nops to insert for a hint (Default 2).
 
 mhint-max-distance=
 Target RejectNegative Joined Var(spu_max_distance_str)
-Approximate maximum number of instructions to allow between a hint and its branch [125]
+Approximate maximum number of instructions to allow between a hint and its branch [125].
 
 msmall-mem
 Target Report RejectNegative InverseMask(LARGE_MEM)
-Generate code for 18 bit addressing
+Generate code for 18 bit addressing.
 
 mlarge-mem
 Target Report RejectNegative Mask(LARGE_MEM)
-Generate code for 32 bit addressing
+Generate code for 32 bit addressing.
 
 mfixed-range=
 Target RejectNegative Joined Var(spu_fixed_range_string)
-Specify range of registers to make fixed
+Specify range of registers to make fixed.
 
 msafe-hints
 Target Report Mask(SAFE_HINTS)
-Insert hbrp instructions after hinted branch targets to avoid the SPU hang issue
+Insert hbrp instructions after hinted branch targets to avoid the SPU hang issue.
 
 march=
 Target RejectNegative Joined Var(spu_arch_string)
-Generate code for given CPU
+Generate code for given CPU.
 
 mtune=
 Target RejectNegative Joined Var(spu_tune_string)
-Schedule code for given CPU
+Schedule code for given CPU.
 
 mea32
 Target Report RejectNegative Var(spu_ea_model,32) Init(32)
-Access variables in 32-bit PPU objects (default)
+Access variables in 32-bit PPU objects (default).
 
 mea64
 Target Report RejectNegative Var(spu_ea_model,64)
-Access variables in 64-bit PPU objects
+Access variables in 64-bit PPU objects.
 
 maddress-space-conversion
 Target Report Mask(ADDRESS_SPACE_CONVERSION)
-Allow conversions between __ea and generic pointers (default)
+Allow conversions between __ea and generic pointers (default).
 
 mcache-size=
 Target Report RejectNegative Joined UInteger
-Size (in KB) of software data cache
+Size (in KB) of software data cache.
 
 matomic-updates
 Target Report
-Atomically write back software data cache lines (default)
+Atomically write back software data cache lines (default).