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

1 files changed, 27 insertions, 27 deletions

diff --git a/gcc/java/lang.opt b/gcc/java/lang.opt
index 11fef6b2690..7399d57734a 100644
--- a/gcc/java/lang.opt
+++ b/gcc/java/lang.opt
@@ -119,15 +119,15 @@ Java Var(warn_deprecated)
 
 Wextraneous-semicolon
 Java Var(flag_extraneous_semicolon)
-Warn if deprecated empty statements are found
+Warn if deprecated empty statements are found.
 
 Wout-of-date
 Java Var(flag_newer) Init(1)
-Warn if .class files are out of date
+Warn if .class files are out of date.
 
 Wredundant-modifiers
 Java Var(flag_redundant)
-Warn if modifiers are specified when not necessary
+Warn if modifiers are specified when not necessary.
 
 bootclasspath
 Java Separate Alias(fbootclasspath=)
@@ -147,14 +147,14 @@ Driver Separate
 
 fCLASSPATH=
 Java JoinedOrMissing RejectNegative Alias(fclasspath=)
---CLASSPATH	Deprecated; use --classpath instead
+--CLASSPATH	Deprecated; use --classpath instead.
 
 faux-classpath
 Java Separate RejectNegative Undocumented
 
 fassert
 Java Var(flag_assert) Init(1)
-Permit the use of the assert keyword
+Permit the use of the assert keyword.
 
 fassume-compiled
 Java
@@ -176,34 +176,34 @@ Java JoinedOrMissing
 
 fbootclasspath=
 Java JoinedOrMissing RejectNegative
---bootclasspath=<path>	Replace system path
+--bootclasspath=<path>	Replace system path.
 
 fcheck-references
 Java Var(flag_check_references)
-Generate checks for references to NULL
+Generate checks for references to NULL.
 
 fclasspath=
 Java JoinedOrMissing RejectNegative
---classpath=<path>	Set class path
+--classpath=<path>	Set class path.
 
 fcompile-resource=
 Java Joined RejectNegative
 
 femit-class-file
 Java Var(flag_emit_class_files)
-Output a class file
+Output a class file.
 
 femit-class-files
 Java Var(flag_emit_class_files)
-Alias for -femit-class-file
+Alias for -femit-class-file.
 
 fencoding=
 Java Joined RejectNegative
---encoding=<encoding>	Choose input encoding (defaults from your locale)
+--encoding=<encoding>	Choose input encoding (defaults from your locale).
 
 fextdirs=
 Java Joined RejectNegative
---extdirs=<path>	Set the extension directory path
+--extdirs=<path>	Set the extension directory path.
 
 fmain=
 Driver JoinedOrMissing RejectNegative
@@ -213,72 +213,72 @@ Java Joined Undocumented
 
 ffilelist-file
 Java Var(flag_filelist_file)
-Input file is a file with a list of filenames to compile
+Input file is a file with a list of filenames to compile.
 
 fsaw-java-file
 Java Undocumented RejectNegative
 
 fforce-classes-archive-check
 Java Var(flag_force_classes_archive_check)
-Always check for non gcj generated classes archives
+Always check for non gcj generated classes archives.
 
 fhash-synchronization
 Java Var(flag_hash_synchronization)
-Assume the runtime uses a hash table to map an object to its synchronization structure
+Assume the runtime uses a hash table to map an object to its synchronization structure.
 
 findirect-classes
 Java Var(flag_indirect_classes) Init(1)
-Generate instances of Class at runtime
+Generate instances of Class at runtime.
 
 findirect-dispatch
 Java Var(flag_indirect_dispatch)
-Use offset tables for virtual method calls
+Use offset tables for virtual method calls.
 
 finline-functions
 Java
 
 fjni
 Java Var(flag_jni)
-Assume native functions are implemented using JNI
+Assume native functions are implemented using JNI.
 
 foptimize-static-class-initialization
 Java Var(flag_optimize_sci)
-Enable optimization of static class initialization code
+Enable optimization of static class initialization code.
 
 foutput-class-dir=
 Java Joined RejectNegative
 
 freduced-reflection
 Java Var(flag_reduced_reflection)
-Reduce the amount of reflection meta-data generated
+Reduce the amount of reflection meta-data generated.
 
 fstore-check
 Java Var(flag_store_check) Init(1)
-Enable assignability checks for stores into object arrays
+Enable assignability checks for stores into object arrays.
 
 fuse-boehm-gc
 Java Var(flag_use_boehm_gc)
-Generate code for the Boehm GC
+Generate code for the Boehm GC.
 
 fuse-divide-subroutine
 Java Var(flag_use_divide_subroutine) Init(1)
-Call a library routine to do integer divisions
+Call a library routine to do integer divisions.
 
 fuse-atomic-builtins
 Java Var(flag_use_atomic_builtins) Init(0)
-Generate code for built-in atomic operations
+Generate code for built-in atomic operations.
 
 fbootstrap-classes
 Java Var(flag_bootstrap_classes)
-Generated should be loaded by bootstrap loader
+Generated should be loaded by bootstrap loader.
 
 fsource=
 Java Joined
-Set the source language version
+Set the source language version.
 
 ftarget=
 Java Joined
-Set the target VM version
+Set the target VM version.
 
 s-bc-abi
 Driver