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

diff --git a/gcc/config/bfin/bfin.opt b/gcc/config/bfin/bfin.opt
index cbc5c9e8c7b..bf7ad5b0886 100644
--- a/gcc/config/bfin/bfin.opt
+++ b/gcc/config/bfin/bfin.opt
@@ -37,19 +37,19 @@ unsigned int bfin_workarounds = 0
 
 msim
 Target RejectNegative
-Use simulator runtime
+Use simulator runtime.
 
 mcpu=
 Target RejectNegative Joined
-Specify the name of the target CPU
+Specify the name of the target CPU.
 
 momit-leaf-frame-pointer
 Target Report Mask(OMIT_LEAF_FRAME_POINTER)
-Omit frame pointer for leaf functions
+Omit frame pointer for leaf functions.
 
 mlow64k
 Target Report Mask(LOW_64K)
-Program is entirely located in low 64k of memory
+Program is entirely located in low 64k of memory.
 
 mcsync-anomaly
 Target Report Var(bfin_csync_anomaly) Init(-1)
@@ -62,7 +62,7 @@ Avoid speculative loads to work around a hardware anomaly.
 
 mid-shared-library
 Target Report Mask(ID_SHARED_LIBRARY)
-Enabled ID based shared library
+Enabled ID based shared library.
 
 mleaf-id-shared-library
 Target Report Mask(LEAF_ID_SHARED_LIBRARY)
@@ -71,47 +71,47 @@ but may be used as a shared library.
 
 mshared-library-id=
 Target RejectNegative Joined UInteger Var(bfin_library_id)
-ID of shared library to build
+ID of shared library to build.
 
 msep-data
 Target Report Mask(SEP_DATA)
-Enable separate data segment
+Enable separate data segment.
 
 mlong-calls
 Target Report Mask(LONG_CALLS)
-Avoid generating pc-relative calls; use indirection
+Avoid generating pc-relative calls; use indirection.
 
 mfast-fp
 Target Report Mask(FAST_FP)
-Link with the fast floating-point library
+Link with the fast floating-point library.
 
 mfdpic
 Target Report Mask(FDPIC)
-Enable Function Descriptor PIC mode
+Enable Function Descriptor PIC mode.
 
 minline-plt
 Target Report Mask(INLINE_PLT)
-Enable inlining of PLT in function calls
+Enable inlining of PLT in function calls.
 
 mstack-check-l1
 Target Report Mask(STACK_CHECK_L1)
-Do stack checking using bounds in L1 scratch memory
+Do stack checking using bounds in L1 scratch memory.
 
 mmulticore
 Target Report Mask(MULTICORE)
-Enable multicore support
+Enable multicore support.
 
 mcorea
 Target Report Mask(COREA)
-Build for Core A
+Build for Core A.
 
 mcoreb
 Target Report Mask(COREB)
-Build for Core B
+Build for Core B.
 
 msdram
 Target Report Mask(SDRAM)
-Build for SDRAM
+Build for SDRAM.
 
 micplb
 Target Report Mask(ICPLB)