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.



git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@229155 138bc75d-0d04-0410-961f-82ee72b054a4

6 files changed, 29 insertions, 29 deletions

diff --git a/gcc/config/pa/pa-hpux.opt b/gcc/config/pa/pa-hpux.opt
index 528c921c099..1ce6998a82c 100644
--- a/gcc/config/pa/pa-hpux.opt
+++ b/gcc/config/pa/pa-hpux.opt
@@ -24,15 +24,15 @@ int flag_pa_unix = TARGET_HPUX_11_31 ? 2003 : TARGET_HPUX_11_11 ? 1998 : TARGET_
 
 msio
 Target RejectNegative Mask(SIO)
-Generate cpp defines for server IO
+Generate cpp defines for server IO.
 
 munix=93
 Target RejectNegative Var(flag_pa_unix, 1993)
-Specify UNIX standard for predefines and linking
+Specify UNIX standard for predefines and linking.
 
 mwsio
 Target RejectNegative InverseMask(SIO)
-Generate cpp defines for workstation IO
+Generate cpp defines for workstation IO.
 
 nolibdld
 Driver
diff --git a/gcc/config/pa/pa-hpux1010.opt b/gcc/config/pa/pa-hpux1010.opt
index 82192cd299c..0ae6224d688 100644
--- a/gcc/config/pa/pa-hpux1010.opt
+++ b/gcc/config/pa/pa-hpux1010.opt
@@ -20,4 +20,4 @@
 
 munix=95
 Target RejectNegative Var(flag_pa_unix, 1995)
-Specify UNIX standard for predefines and linking
+Specify UNIX standard for predefines and linking.
diff --git a/gcc/config/pa/pa-hpux1111.opt b/gcc/config/pa/pa-hpux1111.opt
index 7f5c7b9f3f4..6623182a23e 100644
--- a/gcc/config/pa/pa-hpux1111.opt
+++ b/gcc/config/pa/pa-hpux1111.opt
@@ -20,4 +20,4 @@
 
 munix=98
 Target RejectNegative Var(flag_pa_unix, 1998)
-Specify UNIX standard for predefines and linking
+Specify UNIX standard for predefines and linking.
diff --git a/gcc/config/pa/pa-hpux1131.opt b/gcc/config/pa/pa-hpux1131.opt
index 717c5531121..fefd441d033 100644
--- a/gcc/config/pa/pa-hpux1131.opt
+++ b/gcc/config/pa/pa-hpux1131.opt
@@ -20,4 +20,4 @@
 
 munix=2003
 Target RejectNegative Var(flag_pa_unix, 2003)
-Specify UNIX standard for predefines and linking
+Specify UNIX standard for predefines and linking.
diff --git a/gcc/config/pa/pa.opt b/gcc/config/pa/pa.opt
index 57c9c5e67ac..055c5697e55 100644
--- a/gcc/config/pa/pa.opt
+++ b/gcc/config/pa/pa.opt
@@ -27,15 +27,15 @@ enum processor_type pa_cpu = TARGET_SCHED_DEFAULT
 
 march=1.0
 Target RejectNegative
-Generate PA1.0 code
+Generate PA1.0 code.
 
 march=1.1
 Target RejectNegative
-Generate PA1.1 code
+Generate PA1.1 code.
 
 march=2.0
 Target RejectNegative
-Generate PA2.0 code (requires binutils 2.10 or later)
+Generate PA2.0 code (requires binutils 2.10 or later).
 
 mbig-switch
 Target Ignore
@@ -43,23 +43,23 @@ Does nothing.  Preserved for backward compatibility.
 
 mdisable-fpregs
 Target Report Mask(DISABLE_FPREGS)
-Disable FP regs
+Disable FP regs.
 
 mdisable-indexing
 Target Report Mask(DISABLE_INDEXING)
-Disable indexed addressing
+Disable indexed addressing.
 
 mfast-indirect-calls
 Target Report Mask(FAST_INDIRECT_CALLS)
-Generate fast indirect calls
+Generate fast indirect calls.
 
 mfixed-range=
 Target RejectNegative Joined Var(pa_deferred_options) Defer
-Specify range of registers to make fixed
+Specify range of registers to make fixed.
 
 mgas
 Target Report Mask(GAS)
-Assume code will be assembled by GAS
+Assume code will be assembled by GAS.
 
 mjump-in-delay
 Target Ignore
@@ -68,43 +68,43 @@ Does nothing.  Preserved for backward compatibility.
 ;; Not used by gcc
 mlinker-opt
 Target RejectNegative
-Enable linker optimizations
+Enable linker optimizations.
 
 mlong-calls
 Target Report Mask(LONG_CALLS)
-Always generate long calls
+Always generate long calls.
 
 mlong-load-store
 Target Report Mask(LONG_LOAD_STORE)
-Emit long load/store sequences
+Emit long load/store sequences.
 
 mnosnake
 Target RejectNegative
-Generate PA1.0 code
+Generate PA1.0 code.
 
 mno-space-regs
 Target RejectNegative Report Mask(NO_SPACE_REGS)
-Disable space regs
+Disable space regs.
 
 mpa-risc-1-0
 Target RejectNegative
-Generate PA1.0 code
+Generate PA1.0 code.
 
 mpa-risc-1-1
 Target RejectNegative Mask(PA_11)
-Generate PA1.1 code
+Generate PA1.1 code.
 
 mpa-risc-2-0
 Target RejectNegative Mask(PA_20)
-Generate PA2.0 code (requires binutils 2.10 or later)
+Generate PA2.0 code (requires binutils 2.10 or later).
 
 mportable-runtime
 Target Report Mask(PORTABLE_RUNTIME)
-Use portable calling conventions
+Use portable calling conventions.
 
 mschedule=
 Target RejectNegative Joined Enum(pa_schedule) Var(pa_cpu)
-Specify CPU for scheduling purposes.  Valid arguments are 700, 7100, 7100LC, 7200, 7300, and 8000
+Specify CPU for scheduling purposes.  Valid arguments are 700, 7100, 7100LC, 7200, 7300, and 8000.
 
 Enum
 Name(pa_schedule) Type(enum processor_type)
@@ -129,12 +129,12 @@ Enum(pa_schedule) String(7300) Value(PROCESSOR_7300)
 
 msoft-float
 Target Report Mask(SOFT_FLOAT)
-Use software floating point
+Use software floating point.
 
 msnake
 Target RejectNegative
-Generate PA1.1 code
+Generate PA1.1 code.
 
 mspace-regs
 Target RejectNegative Report InverseMask(NO_SPACE_REGS)
-Do not disable space regs
+Do not disable space regs.
diff --git a/gcc/config/pa/pa64-hpux.opt b/gcc/config/pa/pa64-hpux.opt
index d4e39465e6b..8e65a41b971 100644
--- a/gcc/config/pa/pa64-hpux.opt
+++ b/gcc/config/pa/pa64-hpux.opt
@@ -20,8 +20,8 @@
 
 mgnu-ld
 Target RejectNegative Mask(GNU_LD)
-Assume code will be linked by GNU ld
+Assume code will be linked by GNU ld.
 
 mhp-ld
 Target RejectNegative InverseMask(GNU_LD)
-Assume code will be linked by HP ld
+Assume code will be linked by HP ld.