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, 29 insertions, 29 deletions

diff --git a/gcc/config/v850/v850.opt b/gcc/config/v850/v850.opt
index c1ded1f..d33b87b 100644
--- a/gcc/config/v850/v850.opt
+++ b/gcc/config/v850/v850.opt
@@ -26,134 +26,134 @@ int small_memory_max[(int)SMALL_MEMORY_max] = { 0, 0, 0 }
 
 mapp-regs
 Target Report Mask(APP_REGS)
-Use registers r2 and r5
+Use registers r2 and r5.
 
 mbig-switch
 Target Report Mask(BIG_SWITCH)
-Use 4 byte entries in switch tables
+Use 4 byte entries in switch tables.
 
 mdebug
 Target Report Mask(DEBUG)
-Enable backend debugging
+Enable backend debugging.
 
 mdisable-callt
 Target Report Mask(DISABLE_CALLT)
-Do not use the callt instruction (default)
+Do not use the callt instruction (default).
 
 mep
 Target Report Mask(EP)
-Reuse r30 on a per function basis
+Reuse r30 on a per function basis.
 
 mghs
 Target RejectNegative InverseMask(GCC_ABI) MaskExists
 
 mlong-calls
 Target Report Mask(LONG_CALLS)
-Prohibit PC relative function calls
+Prohibit PC relative function calls.
 
 mprolog-function
 Target Report Mask(PROLOG_FUNCTION)
-Use stubs for function prologues
+Use stubs for function prologues.
 
 msda=
 Target RejectNegative Joined UInteger
-Set the max size of data eligible for the SDA area
+Set the max size of data eligible for the SDA area.
 
 msda-
 Target RejectNegative Joined Undocumented Alias(msda=)
 
 msmall-sld
 Target Report Mask(SMALL_SLD)
-Enable the use of the short load instructions
+Enable the use of the short load instructions.
 
 mspace
 Target RejectNegative
-Same as: -mep -mprolog-function
+Same as: -mep -mprolog-function.
 
 mtda=
 Target RejectNegative Joined UInteger
-Set the max size of data eligible for the TDA area
+Set the max size of data eligible for the TDA area.
 
 mtda-
 Target RejectNegative Joined Undocumented Alias(mtda=)
 
 mno-strict-align
 Target Report Mask(NO_STRICT_ALIGN)
-Do not enforce strict alignment
+Do not enforce strict alignment.
 
 mjump-tables-in-data-section
 Target Report Mask(JUMP_TABLES_IN_DATA_SECTION)
-Put jump tables for switch statements into the .data section rather than the .code section
+Put jump tables for switch statements into the .data section rather than the .code section.
 
 mUS-bit-set
 Target Report Mask(US_BIT_SET)
 
 mv850
 Target Report RejectNegative Mask(V850)
-Compile for the v850 processor
+Compile for the v850 processor.
 
 mv850e
 Target Report RejectNegative Mask(V850E)
-Compile for the v850e processor
+Compile for the v850e processor.
 
 mv850e1
 Target RejectNegative Mask(V850E1)
-Compile for the v850e1 processor
+Compile for the v850e1 processor.
 
 mv850es
 Target RejectNegative Mask(V850E1)
-Compile for the v850es variant of the v850e1
+Compile for the v850es variant of the v850e1.
 
 mv850e2
 Target Report RejectNegative Mask(V850E2)
-Compile for the v850e2 processor
+Compile for the v850e2 processor.
 
 mv850e2v3
 Target Report RejectNegative Mask(V850E2V3)
-Compile for the v850e2v3 processor
+Compile for the v850e2v3 processor.
 
 mv850e3v5
 Target Report RejectNegative Mask(V850E3V5)
-Compile for the v850e3v5 processor
+Compile for the v850e3v5 processor.
 
 mv850e2v4
 Target RejectNegative Mask(V850E3V5) MaskExists
 
 mloop
 Target Report Mask(LOOP)
-Enable v850e3v5 loop instructions
+Enable v850e3v5 loop instructions.
 
 mzda=
 Target RejectNegative Joined UInteger
-Set the max size of data eligible for the ZDA area
+Set the max size of data eligible for the ZDA area.
 
 mzda-
 Target RejectNegative Joined Undocumented Alias(mzda=)
 
 mrelax
 Target Report Mask(RELAX)
-Enable relaxing in the assembler
+Enable relaxing in the assembler.
 
 mlong-jumps
 Target Report Mask(BIG_SWITCH) MaskExists
-Prohibit PC relative jumps
+Prohibit PC relative jumps.
 
 msoft-float
 Target Report RejectNegative Mask(SOFT_FLOAT)
-Inhibit the use of hardware floating point instructions
+Inhibit the use of hardware floating point instructions.
 
 mhard-float
 Target Report RejectNegative InverseMask(SOFT_FLOAT) MaskExists
-Allow the use of hardware floating point instructions for V850E2V3 and up
+Allow the use of hardware floating point instructions for V850E2V3 and up.
 
 mrh850-abi
 Target RejectNegative Report InverseMask(GCC_ABI) MaskExists
-Enable support for the RH850 ABI.  This is the default
+Enable support for the RH850 ABI.  This is the default.
 
 mgcc-abi
 Target RejectNegative Report Mask(GCC_ABI)
-Enable support for the old GCC ABI
+Enable support for the old GCC ABI.
 
 m8byte-align
 Target Report Mask(8BYTE_ALIGN)
-Support alignments of up to 64-bits
+Support alignments of up to 64-bits.