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

diff --git a/gcc/config/cris/cris.opt b/gcc/config/cris/cris.opt
index 5acda39..63f8a77 100644
--- a/gcc/config/cris/cris.opt
+++ b/gcc/config/cris/cris.opt
@@ -42,18 +42,18 @@
 ; on the same page, including the TLB registers).
 mmul-bug-workaround
 Target Report Mask(MUL_BUG)
-Work around bug in multiplication instruction
+Work around bug in multiplication instruction.
 
 ; TARGET_ETRAX4_ADD: Instruction-set additions from Etrax 4 and up.
 ; (Just "lz".)
 metrax4
 Target Report Mask(ETRAX4_ADD)
-Compile for ETRAX 4 (CRIS v3)
+Compile for ETRAX 4 (CRIS v3).
 
 ; See cris_handle_option.
 metrax100
 Target Report RejectNegative
-Compile for ETRAX 100 (CRIS v8)
+Compile for ETRAX 100 (CRIS v8).
 
 ; See cris_handle_option.
 mno-etrax100
@@ -61,14 +61,14 @@ Target Report RejectNegative Undocumented
 
 mpdebug
 Target Report Mask(PDEBUG)
-Emit verbose debug information in assembly code
+Emit verbose debug information in assembly code.
 
 ; TARGET_CCINIT: Whether to use condition-codes generated by
 ; insns other than the immediately preceding compare/test insn.
 ; Used to check for errors in notice_update_cc.
 mcc-init
 Target Report Mask(CCINIT)
-Do not use condition codes from normal instructions
+Do not use condition codes from normal instructions.
 
 ; TARGET_SIDE_EFFECT_PREFIXES: Whether to use side-effect
 ; patterns.  Used to debug the [rx=ry+i] type patterns.
@@ -77,7 +77,7 @@ Target Report RejectNegative Mask(SIDE_EFFECT_PREFIXES) Undocumented
 
 mno-side-effects
 Target Report RejectNegative InverseMask(SIDE_EFFECT_PREFIXES)
-Do not emit addressing modes with side-effect assignment
+Do not emit addressing modes with side-effect assignment.
 
 ; TARGET_STACK_ALIGN: Whether to *keep* (not force) alignment of
 ; stack at 16 (or 32, depending on TARGET_ALIGN_BY_32) bits.
@@ -86,7 +86,7 @@ Target Report RejectNegative Mask(STACK_ALIGN) Undocumented
 
 mno-stack-align
 Target Report RejectNegative InverseMask(STACK_ALIGN)
-Do not tune stack alignment
+Do not tune stack alignment.
 
 ; TARGET_DATA_ALIGN: Whether to do alignment on individual
 ; modifiable objects.
@@ -95,7 +95,7 @@ Target Report RejectNegative Mask(DATA_ALIGN) Undocumented
 
 mno-data-align
 Target Report RejectNegative InverseMask(DATA_ALIGN)
-Do not tune writable data alignment
+Do not tune writable data alignment.
 
 ; TARGET_CONST_ALIGN: Whether to do alignment on individual
 ; non-modifiable objects.
@@ -104,7 +104,7 @@ Target Report RejectNegative Mask(CONST_ALIGN) Undocumented
 
 mno-const-align
 Target Report RejectNegative InverseMask(CONST_ALIGN)
-Do not tune code and read-only data alignment
+Do not tune code and read-only data alignment.
 
 ; See cris_handle_option.
 m32-bit
@@ -113,7 +113,7 @@ Target Report RejectNegative Undocumented
 ; See cris_handle_option.
 m32bit
 Target Report RejectNegative
-Align code and data to 32 bits
+Align code and data to 32 bits.
 
 ; See cris_handle_option.
 m16-bit
@@ -130,7 +130,7 @@ Target Report RejectNegative Undocumented
 ; See cris_handle_option.
 m8bit
 Target Report RejectNegative
-Don't align items in code or data
+Don't align items in code or data.
 
 ; TARGET_PROLOGUE_EPILOGUE: Whether or not to omit function
 ; prologue and epilogue.
@@ -139,14 +139,14 @@ Target Report RejectNegative Mask(PROLOGUE_EPILOGUE) Undocumented
 
 mno-prologue-epilogue
 Target Report RejectNegative InverseMask(PROLOGUE_EPILOGUE)
-Do not emit function prologue or epilogue
+Do not emit function prologue or epilogue.
 
 ; We have to handle this m-option here since we can't wash it
 ; off in both CC1_SPEC and CC1PLUS_SPEC.
 
 mbest-lib-options
 Target Report RejectNegative
-Use the most feature-enabling options allowed by other options
+Use the most feature-enabling options allowed by other options.
 
 ; FIXME: The following comment relates to gcc before cris.opt.
 ; Check if it's still valid:
@@ -155,22 +155,22 @@ Use the most feature-enabling options allowed by other options
 ; Kludgy, but needed for some multilibbed files.
 moverride-best-lib-options
 Target Report RejectNegative
-Override -mbest-lib-options
+Override -mbest-lib-options.
 
 mcpu=
 Target Report RejectNegative Joined Undocumented Var(cris_cpu_str)
 
 march=
 Target Report RejectNegative Joined Var(cris_cpu_str)
--march=ARCH	Generate code for the specified chip or CPU version
+-march=ARCH	Generate code for the specified chip or CPU version.
 
 mtune=
 Target Report RejectNegative Joined Var(cris_tune_str)
--mtune=ARCH	Tune alignment for the specified chip or CPU version
+-mtune=ARCH	Tune alignment for the specified chip or CPU version.
 
 mmax-stackframe=
 Target Report RejectNegative Joined Var(cris_max_stackframe_str)
--mmax-stackframe=SIZE	Warn when a stackframe is larger than the specified size
+-mmax-stackframe=SIZE	Warn when a stackframe is larger than the specified size.
 
 max-stackframe=
 Target Report RejectNegative Joined Undocumented Var(cris_max_stackframe_str)
@@ -181,7 +181,7 @@ Emit traps as \"break 8\", default for CRIS v3 and up.  If disabled, calls to ab
 
 mtrap-unaligned-atomic
 Target Report Var(cris_trap_unaligned_atomic) Init(2)
-Emit checks causing \"break 8\" instructions to execute when applying atomic builtins on misaligned memory
+Emit checks causing \"break 8\" instructions to execute when applying atomic builtins on misaligned memory.
 
 munaligned-atomic-may-use-library
 Target Report Var(cris_atomics_calling_libfunc) Init(2)
diff --git a/gcc/config/cris/linux.opt b/gcc/config/cris/linux.opt
index 5283ea6..84ee074 100644
--- a/gcc/config/cris/linux.opt
+++ b/gcc/config/cris/linux.opt
@@ -24,7 +24,7 @@ Target Report RejectNegative Undocumented
 
 mno-gotplt
 Target Report RejectNegative Mask(AVOID_GOTPLT)
-Together with -fpic and -fPIC, do not use GOTPLT references
+Together with -fpic and -fPIC, do not use GOTPLT references.
 
 ; There's a small added setup cost with using GOTPLT references
 ; for the first (resolving) call, but should in total be a win