c/761: Undocumented options, part 1

[Joseph Myers]

>Number:         761
>Category:       c
>Synopsis:       Undocumented options, part 1
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    unassigned
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Nov 09 14:26:00 PST 2000
>Closed-Date:
>Last-Modified:
>Originator:     Joseph S. Myers
>Release:        2.97 20001108 (experimental)
>Organization:
none
>Environment:
System: Linux decomino 2.2.17 #1 Mon Sep 4 20:22:16 UTC 2000 i686 unknown
Architecture: i686

	
host: i686-pc-linux-gnu
build: i686-pc-linux-gnu
target: i686-pc-linux-gnu
>Description:

There are many command line options that have managed to get into GCC
without documentation in the Texinfo manual.  These include the
following; this list covers only the driver, back-end
architecture-independent options, and the C compiler.  Even if some
are only intended for internal or debugging use (or placeholders for
future use) they should still be documented: many such options already
are.

-dumpspecs
-dumpversion
-dumpmachine
-print-multi-lib
-print-multi-directory
-aux-info
-fsched-verbose
-feliminate-dwarf2-dups
-fsched-interblock
-fsched-spec
-fsched-spec-load
-fsched-spec-load-dangerous
-fbranch-count-reg
-fnew-exceptions
-fsjlj-exceptions
-fasynchronous-exceptions
-freorder-blocks
-fpeephole2
-fbounded-pointers
-fbounds-check
-ftime-report
-fmem-report
-fpreprocessed
-Wmissing-braces

>How-To-Repeat:

Observe such an option in the source or a Makefile or --help output;
try and fail to find any explanation in the manual of exactly what it
does.

>Fix:

Add documentation for all the above options to the manual.  Don't add
new options without being sure to add documentation at the same time.
>Release-Note:
>Audit-Trail:
>Unformatted: