invoke.texi (C Dialect Options): Document -aux-info.

* doc/invoke.texi (C Dialect Options): Document -aux-info.
(Debugging Options): Document -print-multi-directory and
-print-multi-lib.
* doc/gcc.1: Rebuilt.

From-SVN: r43124

gcc/ChangeLog

 2001-06-09  Alexandre Oliva  <aoliva@redhat.com>
 
+	* doc/invoke.texi (C Dialect Options): Document -aux-info.
+	(Debugging Options): Document -print-multi-directory and
+	-print-multi-lib.
+	* doc/gcc.1: Rebuilt.
+
+2001-06-09  Alexandre Oliva  <aoliva@redhat.com>
+
 	* toplev.c (independent_decode_option): Require `=' between
 	`-aux-info' and filename in the same argument.
 	* gcc.c: Don't pass -aux-info=filename twice.

gcc/doc/invoke.texi

@@ -157,7 +157,8 @@ in the following sections.
 @item C Language Options
 @xref{C Dialect Options,,Options Controlling C Dialect}.
 @gccoptlist{
--ansi  -std=@var{standard}  -fno-asm  -fno-builtin @gol
+-ansi  -std=@var{standard}  -aux-info @var{filename} @gol
+-fno-asm  -fno-builtin @gol
 -fhosted  -ffreestanding @gol
 -trigraphs  -traditional  -traditional-cpp @gol
 -fallow-single-precision  -fcond-mismatch @gol
@@ -243,6 +244,7 @@ in the following sections.
 -g  -g@var{level}  -gcoff  -gdwarf  -gdwarf-1  -gdwarf-1+  -gdwarf-2 @gol
 -ggdb  -gstabs  -gstabs+  -gxcoff  -gxcoff+ @gol
 -p  -pg  -print-file-name=@var{library}  -print-libgcc-file-name @gol
+-print-multi-directory  -print-multi-lib @gol
 -print-prog-name=@var{program}  -print-search-dirs  -Q @gol
 -save-temps  -time}
 
@@ -959,6 +961,22 @@ the @code{inline} keyword in ISO C99) are not disabled.
 @xref{Standards,,Language Standards Supported by GCC}, for details of
 these standard versions.
 
+@item -aux-info @var{filename}
+@opindex aux-info
+Output to the given filename prototyped declarations for all functions
+declared and/or defined in a translation unit, including those in header
+files.  This option is silently ignored in any language other than C.
+
+Besides declarations, the file indicates, in comments, the origin of
+each declaration (source file and line), whether the declaration was
+implicit, prototyped or unprototyped (@samp{I}, @samp{N} for new or
+@samp{O} for old, respectively, in the first character after the line
+number and the colon), and whether it came from a declaration or a
+definition (@samp{C} or @samp{F}, respectively, in the following
+character).  In the case of function definitions, a K&R-style list of
+arguments followed by their declarations is also provided, inside
+comments, after the declaration.
+
 @item -fno-asm
 @opindex fno-asm
 Do not recognize @code{asm}, @code{inline} or @code{typeof} as a
@@ -3051,6 +3069,20 @@ would be used when linking---and don't do anything else.  With this
 option, GCC does not compile or link anything; it just prints the
 file name.
 
+@item -print-multi-directory
+@opindex print-multi-directory
+Print the directory name corresponding to the multilib selected by any
+other switches present in the command line.  This directory is supposed
+to exist in @env{GCC_EXEC_PREFIX}.
+
+@item -print-multi-lib
+@opindex print-multi-lib
+Print the mapping from multilib directory names to compiler switches
+that enable them.  The directory name is separated from the switches by
+@samp{;}, and each switch starts with an @samp{@@} instead of the
+@samp{-}, without spaces between multiple switches.  This is supposed to
+ease shell-processing.
+
 @item -print-prog-name=@var{program}
 @opindex print-prog-name
 Like @samp{-print-file-name}, but searches for a program such as @samp{cpp}.
@@ -9560,7 +9592,7 @@ the existing @samp{.X} file because it is newer than the source file.
 For example:
 
 @example
-gcc -Dfoo=bar file1.c -aux-info
+gcc -Dfoo=bar file1.c -aux-info file1.X
 protoize *.c
 @end example