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

diff --git a/gcc/config/m32r/m32r.opt b/gcc/config/m32r/m32r.opt
index 85a197b..c87b687 100644
--- a/gcc/config/m32r/m32r.opt
+++ b/gcc/config/m32r/m32r.opt
@@ -31,51 +31,51 @@ enum m32r_sdata m32r_sdata_selected = M32R_SDATA_DEFAULT
 
 m32rx
 Target Report RejectNegative Mask(M32RX)
-Compile for the m32rx
+Compile for the m32rx.
 
 m32r2
 Target Report RejectNegative Mask(M32R2)
-Compile for the m32r2
+Compile for the m32r2.
 
 m32r
 Target RejectNegative
-Compile for the m32r
+Compile for the m32r.
 
 malign-loops
 Target Report Mask(ALIGN_LOOPS)
-Align all loops to 32 byte boundary
+Align all loops to 32 byte boundary.
 
 mbranch-cost=1
 Target Report RejectNegative Mask(BRANCH_COST)
-Prefer branches over conditional execution
+Prefer branches over conditional execution.
 
 mbranch-cost=2
 Target Report RejectNegative InverseMask(BRANCH_COST)
-Give branches their default cost
+Give branches their default cost.
 
 mdebug
 Target Mask(DEBUG)
-Display compile time statistics
+Display compile time statistics.
 
 mflush-func=
 Target RejectNegative Joined Var(m32r_cache_flush_func) Init(CACHE_FLUSH_FUNC)
-Specify cache flush function
+Specify cache flush function.
 
 mflush-trap=
 Target RejectNegative Joined UInteger Var(m32r_cache_flush_trap) Init(CACHE_FLUSH_TRAP)
-Specify cache flush trap number
+Specify cache flush trap number.
 
 missue-rate=1
 Target Report RejectNegative Mask(LOW_ISSUE_RATE)
-Only issue one instruction per cycle
+Only issue one instruction per cycle.
 
 missue-rate=2
 Target Report RejectNegative InverseMask(LOW_ISSUE_RATE)
-Allow two instructions to be issued per cycle
+Allow two instructions to be issued per cycle.
 
 mmodel=
 Target RejectNegative Joined Enum(m32r_model) Var(m32r_model_selected)
-Code size: small, medium or large
+Code size: small, medium or large.
 
 Enum
 Name(m32r_model) Type(enum m32r_model)
@@ -91,18 +91,18 @@ Enum(m32r_model) String(large) Value(M32R_MODEL_LARGE)
 
 mno-flush-func
 Target RejectNegative
-Don't call any cache flush functions
+Don't call any cache flush functions.
 
 mno-flush-trap
 Target RejectNegative Var(m32r_cache_flush_trap, -1)
-Don't call any cache flush trap
+Don't call any cache flush trap.
 
 ; mrelax
 ; Target Mask(RELAX)
 
 msdata=
 Target RejectNegative Joined Enum(m32r_sdata) Var(m32r_sdata_selected)
-Small data area: none, sdata, use
+Small data area: none, sdata, use.
 
 Enum
 Name(m32r_sdata) Type(enum m32r_sdata)