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

2 files changed, 30 insertions, 30 deletions

diff --git a/gcc/config/sparc/long-double-switch.opt b/gcc/config/sparc/long-double-switch.opt
index fede08b..ca7cb7a4 100644
--- a/gcc/config/sparc/long-double-switch.opt
+++ b/gcc/config/sparc/long-double-switch.opt
@@ -20,8 +20,8 @@
 
 mlong-double-128
 Target Report RejectNegative Mask(LONG_DOUBLE_128)
-Use 128-bit long double
+Use 128-bit long double.
 
 mlong-double-64
 Target Report RejectNegative InverseMask(LONG_DOUBLE_128)
-Use 64-bit long double
+Use 64-bit long double.
diff --git a/gcc/config/sparc/sparc.opt b/gcc/config/sparc/sparc.opt
index 85bf0bd..249d33b 100644
--- a/gcc/config/sparc/sparc.opt
+++ b/gcc/config/sparc/sparc.opt
@@ -27,103 +27,103 @@ unsigned int sparc_debug
 
 mfpu
 Target Report Mask(FPU)
-Use hardware FP
+Use hardware FP.
 
 mhard-float
 Target RejectNegative Mask(FPU)
-Use hardware FP
+Use hardware FP.
 
 msoft-float
 Target RejectNegative InverseMask(FPU)
-Do not use hardware FP
+Do not use hardware FP.
 
 mflat
 Target Report Mask(FLAT)
-Use flat register window model
+Use flat register window model.
 
 munaligned-doubles
 Target Report Mask(UNALIGNED_DOUBLES)
-Assume possible double misalignment
+Assume possible double misalignment.
 
 mapp-regs
 Target Report Mask(APP_REGS)
-Use ABI reserved registers
+Use ABI reserved registers.
 
 mhard-quad-float
 Target Report RejectNegative Mask(HARD_QUAD)
-Use hardware quad FP instructions
+Use hardware quad FP instructions.
 
 msoft-quad-float
 Target Report RejectNegative InverseMask(HARD_QUAD)
-Do not use hardware quad fp instructions
+Do not use hardware quad fp instructions.
 
 mv8plus
 Target Report Mask(V8PLUS)
-Compile for V8+ ABI
+Compile for V8+ ABI.
 
 mvis
 Target Report Mask(VIS)
-Use UltraSPARC Visual Instruction Set version 1.0 extensions
+Use UltraSPARC Visual Instruction Set version 1.0 extensions.
 
 mvis2
 Target Report Mask(VIS2)
-Use UltraSPARC Visual Instruction Set version 2.0 extensions
+Use UltraSPARC Visual Instruction Set version 2.0 extensions.
 
 mvis3
 Target Report Mask(VIS3)
-Use UltraSPARC Visual Instruction Set version 3.0 extensions
+Use UltraSPARC Visual Instruction Set version 3.0 extensions.
 
 mcbcond
 Target Report Mask(CBCOND)
-Use UltraSPARC Compare-and-Branch extensions
+Use UltraSPARC Compare-and-Branch extensions.
 
 mfmaf
 Target Report Mask(FMAF)
-Use UltraSPARC Fused Multiply-Add extensions
+Use UltraSPARC Fused Multiply-Add extensions.
 
 mpopc
 Target Report Mask(POPC)
-Use UltraSPARC Population-Count instruction
+Use UltraSPARC Population-Count instruction.
 
 mptr64
 Target Report RejectNegative Mask(PTR64)
-Pointers are 64-bit
+Pointers are 64-bit.
 
 mptr32
 Target Report RejectNegative InverseMask(PTR64)
-Pointers are 32-bit
+Pointers are 32-bit.
 
 m64
 Target Report RejectNegative Mask(64BIT)
-Use 64-bit ABI
+Use 64-bit ABI.
 
 m32
 Target Report RejectNegative InverseMask(64BIT)
-Use 32-bit ABI
+Use 32-bit ABI.
 
 mstack-bias
 Target Report Mask(STACK_BIAS)
-Use stack bias
+Use stack bias.
 
 mfaster-structs
 Target Report Mask(FASTER_STRUCTS)
-Use structs on stronger alignment for double-word copies
+Use structs on stronger alignment for double-word copies.
 
 mrelax
 Target
-Optimize tail call instructions in assembler and linker
+Optimize tail call instructions in assembler and linker.
 
 muser-mode
 Target Report InverseMask(SV_MODE)
-Do not generate code that can only run in supervisor mode (default)
+Do not generate code that can only run in supervisor mode (default).
 
 mcpu=
 Target RejectNegative Joined Var(sparc_cpu_and_features) Enum(sparc_processor_type) Init(PROCESSOR_V7)
-Use features of and schedule code for given CPU
+Use features of and schedule code for given CPU.
 
 mtune=
 Target RejectNegative Joined Var(sparc_cpu) Enum(sparc_processor_type) Init(PROCESSOR_V7)
-Schedule code for given CPU
+Schedule code for given CPU.
 
 Enum
 Name(sparc_processor_type) Type(enum processor_type)
@@ -196,11 +196,11 @@ Enum(sparc_processor_type) String(niagara4) Value(PROCESSOR_NIAGARA4)
 
 mcmodel=
 Target RejectNegative Joined Var(sparc_cmodel_string)
-Use given SPARC-V9 code model
+Use given SPARC-V9 code model.
 
 mdebug=
 Target RejectNegative Joined Var(sparc_debug_string)
-Enable debug output
+Enable debug output.
 
 mstd-struct-return
 Target Report RejectNegative Var(sparc_std_struct_return)
@@ -213,7 +213,7 @@ Enable workaround for single erratum of AT697F processor
 
 mfix-ut699
 Target Report RejectNegative Var(sparc_fix_ut699)
-Enable workarounds for the errata of the UT699 processor
+Enable workarounds for the errata of the UT699 processor.
 
 Mask(LONG_DOUBLE_128)
 ;; Use 128-bit long double