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

diff --git a/gcc/config/arm/arm.opt b/gcc/config/arm/arm.opt
index c9095b9..666ff73 100644
--- a/gcc/config/arm/arm.opt
+++ b/gcc/config/arm/arm.opt
@@ -33,7 +33,7 @@ Enum(tls_type) String(gnu2) Value(TLS_GNU2)
 
 mabi=
 Target RejectNegative Joined Enum(arm_abi_type) Var(arm_abi) Init(ARM_DEFAULT_ABI)
-Specify an ABI
+Specify an ABI.
 
 Enum
 Name(arm_abi_type) Type(enum arm_abi_type)
@@ -56,29 +56,29 @@ Enum(arm_abi_type) String(aapcs-linux) Value(ARM_ABI_AAPCS_LINUX)
 
 mabort-on-noreturn
 Target Report Mask(ABORT_NORETURN)
-Generate a call to abort if a noreturn function returns
+Generate a call to abort if a noreturn function returns.
 
 mapcs
 Target RejectNegative Mask(APCS_FRAME) Undocumented
 
 mapcs-float
 Target Report Mask(APCS_FLOAT)
-Pass FP arguments in FP registers
+Pass FP arguments in FP registers.
 
 mapcs-frame
 Target Report Mask(APCS_FRAME)
-Generate APCS conformant stack frames
+Generate APCS conformant stack frames.
 
 mapcs-reentrant
 Target Report Mask(APCS_REENT)
-Generate re-entrant, PIC code
+Generate re-entrant, PIC code.
 
 mapcs-stack-check
 Target Report Mask(APCS_STACK) Undocumented
 
 march=
 Target RejectNegative ToLower Joined Enum(arm_arch) Var(arm_arch_option)
-Specify the name of the target architecture
+Specify the name of the target architecture.
 
 ; Other arm_arch values are loaded from arm-tables.opt
 ; but that is a generated file and this is an odd-one-out.
@@ -91,23 +91,23 @@ Generate code in 32 bit ARM state.
 
 mbig-endian
 Target Report RejectNegative Mask(BIG_END)
-Assume target CPU is configured as big endian
+Assume target CPU is configured as big endian.
 
 mcallee-super-interworking
 Target Report Mask(CALLEE_INTERWORKING)
-Thumb: Assume non-static functions may be called from ARM code
+Thumb: Assume non-static functions may be called from ARM code.
 
 mcaller-super-interworking
 Target Report Mask(CALLER_INTERWORKING)
-Thumb: Assume function pointers may go to non-Thumb aware code
+Thumb: Assume function pointers may go to non-Thumb aware code.
 
 mcpu=
 Target RejectNegative ToLower Joined Enum(processor_type) Var(arm_cpu_option) Init(arm_none)
-Specify the name of the target CPU
+Specify the name of the target CPU.
 
 mfloat-abi=
 Target RejectNegative Joined Enum(float_abi_type) Var(arm_float_abi) Init(TARGET_DEFAULT_FLOAT_ABI)
-Specify if floating point hardware should be used
+Specify if floating point hardware should be used.
 
 Enum
 Name(float_abi_type) Type(enum float_abi_type)
@@ -124,11 +124,11 @@ Enum(float_abi_type) String(hard) Value(ARM_FLOAT_ABI_HARD)
 
 mflip-thumb
 Target Report Var(TARGET_FLIP_THUMB) Undocumented
-Switch ARM/Thumb modes on alternating functions for compiler testing
+Switch ARM/Thumb modes on alternating functions for compiler testing.
 
 mfp16-format=
 Target RejectNegative Joined Enum(arm_fp16_format_type) Var(arm_fp16_format) Init(ARM_FP16_FORMAT_NONE)
-Specify the __fp16 floating-point format
+Specify the __fp16 floating-point format.
 
 Enum
 Name(arm_fp16_format_type) Type(enum arm_fp16_format_type)
@@ -145,18 +145,18 @@ Enum(arm_fp16_format_type) String(alternative) Value(ARM_FP16_FORMAT_ALTERNATIVE
 
 mfpu=
 Target RejectNegative Joined Enum(arm_fpu) Var(arm_fpu_index)
-Specify the name of the target floating point hardware/format
+Specify the name of the target floating point hardware/format.
 
 mhard-float
 Target RejectNegative Alias(mfloat-abi=, hard) Undocumented
 
 mlittle-endian
 Target Report RejectNegative InverseMask(BIG_END)
-Assume target CPU is configured as little endian
+Assume target CPU is configured as little endian.
 
 mlong-calls
 Target Report Mask(LONG_CALLS)
-Generate call insns as indirect calls, if necessary
+Generate call insns as indirect calls, if necessary.
 
 mpic-data-is-text-relative
 Target Report Var(arm_pic_data_is_text_relative) Init(TARGET_DEFAULT_PIC_DATA_IS_TEXT_RELATIVE)
@@ -164,42 +164,42 @@ Assume data segments are relative to text segment.
 
 mpic-register=
 Target RejectNegative Joined Var(arm_pic_register_string)
-Specify the register to be used for PIC addressing
+Specify the register to be used for PIC addressing.
 
 mpoke-function-name
 Target Report Mask(POKE_FUNCTION_NAME)
-Store function names in object code
+Store function names in object code.
 
 msched-prolog
 Target Report Mask(SCHED_PROLOG)
-Permit scheduling of a function's prologue sequence
+Permit scheduling of a function's prologue sequence.
 
 msingle-pic-base
 Target Report Mask(SINGLE_PIC_BASE)
-Do not load the PIC register in function prologues
+Do not load the PIC register in function prologues.
 
 msoft-float
 Target RejectNegative Alias(mfloat-abi=, soft) Undocumented
 
 mstructure-size-boundary=
 Target RejectNegative Joined UInteger Var(arm_structure_size_boundary) Init(DEFAULT_STRUCTURE_SIZE_BOUNDARY)
-Specify the minimum bit alignment of structures
+Specify the minimum bit alignment of structures.
 
 mthumb
 Target Report RejectNegative Mask(THUMB) Save
-Generate code for Thumb state
+Generate code for Thumb state.
 
 mthumb-interwork
 Target Report Mask(INTERWORK)
-Support calls between Thumb and ARM instruction sets
+Support calls between Thumb and ARM instruction sets.
 
 mtls-dialect=
 Target RejectNegative Joined Enum(tls_type) Var(target_tls_dialect) Init(TLS_GNU)
-Specify thread local storage scheme
+Specify thread local storage scheme.
 
 mtp=
 Target RejectNegative Joined Enum(arm_tp_type) Var(target_thread_pointer) Init(TP_AUTO)
-Specify how to access the thread pointer
+Specify how to access the thread pointer.
 
 Enum
 Name(arm_tp_type) Type(enum arm_tp_type)
@@ -216,15 +216,15 @@ Enum(arm_tp_type) String(cp15) Value(TP_CP15)
 
 mtpcs-frame
 Target Report Mask(TPCS_FRAME)
-Thumb: Generate (non-leaf) stack frames even if not needed
+Thumb: Generate (non-leaf) stack frames even if not needed.
 
 mtpcs-leaf-frame
 Target Report Mask(TPCS_LEAF_FRAME)
-Thumb: Generate (leaf) stack frames even if not needed
+Thumb: Generate (leaf) stack frames even if not needed.
 
 mtune=
 Target RejectNegative ToLower Joined Enum(processor_type) Var(arm_tune_option) Init(arm_none)
-Tune code for the given processor
+Tune code for the given processor.
 
 mprint-tune-info
 Target Report RejectNegative Var(print_tune_info) Init(0)
@@ -239,11 +239,11 @@ Enum(processor_type) String(native) Value(-1) DriverOnly
 
 mvectorize-with-neon-quad
 Target Report RejectNegative InverseMask(NEON_VECTORIZE_DOUBLE)
-Use Neon quad-word (rather than double-word) registers for vectorization
+Use Neon quad-word (rather than double-word) registers for vectorization.
 
 mvectorize-with-neon-double
 Target Report RejectNegative Mask(NEON_VECTORIZE_DOUBLE)
-Use Neon double-word (rather than quad-word) registers for vectorization
+Use Neon double-word (rather than quad-word) registers for vectorization.
 
 mword-relocations
 Target Report Var(target_word_relocations) Init(TARGET_DEFAULT_WORD_RELOCATIONS)