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

3 files changed, 333 insertions, 276 deletions

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index a0142e3..ca22a31 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,5 +1,12 @@
 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.
diff --git a/gcc/doc/gcc.1 b/gcc/doc/gcc.1
index 98fbab9..6f4442a 100644
--- a/gcc/doc/gcc.1
+++ b/gcc/doc/gcc.1
@@ -1,5 +1,5 @@
 .\" Automatically generated by Pod::Man version 1.15
-.\" Sun May 20 12:45:49 2001
+.\" Sat Jun  9 21:33:22 2001
 .\"
 .\" Standard preamble:
 .\" ======================================================================
@@ -138,7 +138,7 @@
 .\" ======================================================================
 .\"
 .IX Title "GCC 1"
-.TH GCC 1 "gcc-3.1" "2001-05-20" "GNU"
+.TH GCC 1 "gcc-3.1" "2001-06-09" "GNU"
 .UC
 .SH "NAME"
 gcc \- \s-1GNU\s0 project C and \*(C+ compiler
@@ -200,7 +200,8 @@ in the following sections.
 \&\fB\-v  \-\-target-help  \-\-help\fR
 .Ip "\fIC Language Options\fR" 4
 .IX Item "C Language Options"
-\&\fB\-ansi  \-std=\fR\fIstandard\fR  \fB\-fno-asm  \-fno-builtin 
+\&\fB\-ansi  \-std=\fR\fIstandard\fR  \fB\-aux-info\fR \fIfilename\fR 
+\&\fB\-fno-asm  \-fno-builtin 
 \&\-fhosted  \-ffreestanding 
 \&\-trigraphs  \-traditional  \-traditional-cpp 
 \&\-fallow-single-precision  \-fcond-mismatch 
@@ -210,17 +211,18 @@ in the following sections.
 .Ip "\fI\*(C+ Language Options\fR" 4
 .IX Item " Language Options"
 \&\fB\-fno-access-control  \-fcheck-new  \-fconserve-space 
-\&\-fdollars-in-identifiers  \-fno-elide-constructors 
+\&\-fno-const-strings  \-fdollars-in-identifiers 
+\&\-fno-elide-constructors 
 \&\-fno-enforce-eh-specs  \-fexternal-templates 
 \&\-falt-external-templates 
 \&\-ffor-scope  \-fno-for-scope  \-fno-gnu-keywords  \-fhonor-std 
-\&\-fhuge-objects  \-fno-implicit-templates 
+\&\-fno-implicit-templates 
 \&\-fno-implicit-inline-templates 
 \&\-fno-implement-inlines  \-fms-extensions 
-\&\-fno-operator-names 
+\&\-fno-nonansi-builtins  \-fno-operator-names 
 \&\-fno-optional-diags  \-fpermissive 
-\&\-frepo  \-fno-rtti \-ftemplate-depth-\fR\fIn\fR 
-\&\fB\-fuse-cxa-atexit  \-fvtable-thunks  \-nostdinc++ 
+\&\-frepo  \-fno-rtti  \-fstats  \-ftemplate-depth-\fR\fIn\fR 
+\&\fB\-fuse-cxa-atexit  \-fvtable-gc  \-fno-weak  \-nostdinc++ 
 \&\-fno-default-inline  \-Wctor-dtor-privacy 
 \&\-Wnon-virtual-dtor  \-Wreorder 
 \&\-Weffc++  \-Wno-deprecated 
@@ -230,7 +232,7 @@ in the following sections.
 .Ip "\fIObjective-C Language Options\fR" 4
 .IX Item "Objective-C Language Options"
 \&\fB\-fconstant-string-class=\fR\fIclass name\fR 
-\&\fB\-fgnu-runtime  \-fnext-runtime  \-gen-decls
+\&\fB\-fgnu-runtime  \-fnext-runtime  \-gen-decls 
 \&\-Wno-protocol  \-Wselector\fR
 .Ip "\fILanguage Independent Options\fR" 4
 .IX Item "Language Independent Options"
@@ -241,19 +243,19 @@ in the following sections.
 \&\fB\-fsyntax-only  \-pedantic  \-pedantic-errors 
 \&\-w  \-W  \-Wall  \-Waggregate-return 
 \&\-Wcast-align  \-Wcast-qual  \-Wchar-subscripts  \-Wcomment 
-\&\-Wconversion  \-Wdisabled-optimization \-Werror 
+\&\-Wconversion  \-Wdisabled-optimization  \-Werror 
 \&\-Wfloat-equal  \-Wformat  \-Wformat=2 
-\&\-Wformat-nonliteral \-Wformat-security 
-\&\-Wid-clash-\fR\fIlen\fR  \fB\-Wimplicit \-Wimplicit-int  
+\&\-Wformat-nonliteral  \-Wformat-security 
+\&\-Wimplicit  \-Wimplicit-int  
 \&\-Wimplicit-function-declaration 
 \&\-Werror-implicit-function-declaration 
 \&\-Wimport  \-Winline 
 \&\-Wlarger-than-\fR\fIlen\fR  \fB\-Wlong-long 
 \&\-Wmain  \-Wmissing-braces  \-Wmissing-declarations 
 \&\-Wmissing-format-attribute  \-Wmissing-noreturn 
-\&\-Wmultichar  \-Wno-format-extra-args \-Wno-format-y2k 
+\&\-Wmultichar  \-Wno-format-extra-args  \-Wno-format-y2k 
 \&\-Wno-import  \-Wpacked  \-Wpadded 
-\&\-Wparentheses \-Wpointer-arith  \-Wredundant-decls 
+\&\-Wparentheses  \-Wpointer-arith  \-Wredundant-decls 
 \&\-Wreturn-type  \-Wsequence-point  \-Wshadow 
 \&\-Wsign-compare  \-Wswitch  \-Wsystem-headers 
 \&\-Wtrigraphs  \-Wundef  \-Wuninitialized 
@@ -262,17 +264,19 @@ in the following sections.
 \&\-Wunused-value  \-Wunused-variable  \-Wwrite-strings\fR
 .Ip "\fIC-only Warning Options\fR" 4
 .IX Item "C-only Warning Options"
-\&\fB\-Wbad-function-cast \-Wmissing-prototypes \-Wnested-externs 
-\&\-Wstrict-prototypes \-Wtraditional\fR
+\&\fB\-Wbad-function-cast  \-Wmissing-prototypes  \-Wnested-externs 
+\&\-Wstrict-prototypes  \-Wtraditional\fR
 .Ip "\fIDebugging Options\fR" 4
 .IX Item "Debugging Options"
 \&\fB\-a  \-ax  \-d\fR\fIletters\fR  \fB\-dumpspecs  \-dumpmachine  \-dumpversion 
-\&\-fdump-unnumbered \-fdump-translation-unit=\fR\fIfile\fR 
-\&\fB\-fdump-class-layout=\fR\fIfile\fR  \fB\-fmem-report  \-fpretend-float 
+\&\-fdump-unnumbered \-fdump-translation-unit\fR[\fB-\fR\fIn\fR] \fB\-fdump-class-hierarchy\fR[\fB-\fR\fIn\fR] 
+\&\fB\-fdump-ast-original\fR[\fB-\fR\fIn\fR] \fB\-fdump-ast-optimized\fR[\fB-\fR\fIn\fR] 
+\&\fB\-fmem-report  \-fpretend-float 
 \&\-fprofile-arcs  \-ftest-coverage  \-ftime-report 
 \&\-g  \-g\fR\fIlevel\fR  \fB\-gcoff  \-gdwarf  \-gdwarf-1  \-gdwarf-1+  \-gdwarf-2 
 \&\-ggdb  \-gstabs  \-gstabs+  \-gxcoff  \-gxcoff+ 
 \&\-p  \-pg  \-print-file-name=\fR\fIlibrary\fR  \fB\-print-libgcc-file-name 
+\&\-print-multi-directory  \-print-multi-lib 
 \&\-print-prog-name=\fR\fIprogram\fR  \fB\-print-search-dirs  \-Q 
 \&\-save-temps  \-time\fR
 .Ip "\fIOptimization Options\fR" 4
@@ -283,11 +287,12 @@ in the following sections.
 \&\-fcse-follow-jumps  \-fcse-skip-blocks  \-fdata-sections  \-fdce 
 \&\-fdelayed-branch  \-fdelete-null-pointer-checks 
 \&\-fexpensive-optimizations  \-ffast-math  \-ffloat-store 
-\&\-fforce-addr  \-fforce-mem  \-ffunction-sections  \-fgcse  \-fgcse-lm \-fgcse-sm 
+\&\-fforce-addr  \-fforce-mem  \-ffunction-sections 
+\&\-fgcse  \-fgcse-lm  \-fgcse-sm 
 \&\-finline-functions  \-finline-limit=\fR\fIn\fR  \fB\-fkeep-inline-functions 
 \&\-fkeep-static-consts  \-fmove-all-movables 
 \&\-fno-default-inline  \-fno-defer-pop 
-\&\-fno-function-cse   \-fno-guess-branch-probability 
+\&\-fno-function-cse  \-fno-guess-branch-probability 
 \&\-fno-inline  \-fno-math-errno  \-fno-peephole 
 \&\-funsafe-math-optimizations \-fno-trapping-math 
 \&\-fomit-frame-pointer  \-foptimize-register-move 
@@ -308,7 +313,7 @@ in the following sections.
 \&\-idirafter\fR \fIdir\fR 
 \&\fB\-include\fR \fIfile\fR  \fB\-imacros\fR \fIfile\fR 
 \&\fB\-iprefix\fR \fIfile\fR  \fB\-iwithprefix\fR \fIdir\fR 
-\&\fB\-iwithprefixbefore\fR \fIdir\fR  \fB\-isystem\fR \fIdir\fR \fB\-isystem-c++\fR \fIdir\fR 
+\&\fB\-iwithprefixbefore\fR \fIdir\fR  \fB\-isystem\fR \fIdir\fR 
 \&\fB\-M  \-MM  \-MF  \-MG  \-MP  \-MQ  \-MT  \-nostdinc  \-P  \-remap 
 \&\-trigraphs  \-undef  \-U\fR\fImacro\fR  \fB\-Wp,\fR\fIoption\fR
 .Ip "\fIAssembler Option\fR" 4
@@ -333,9 +338,9 @@ in the following sections.
 \&\fIM680x0 Options\fR
 .Sp
 \&\fB\-m68000  \-m68020  \-m68020\-40  \-m68020\-60  \-m68030  \-m68040 
-\&\-m68060  \-mcpu32 \-m5200  \-m68881  \-mbitfield  \-mc68000  \-mc68020   
-\&\-mfpa \-mnobitfield  \-mrtd  \-mshort  \-msoft-float  \-mpcrel 
-\&\-malign-int \-mstrict-align\fR
+\&\-m68060  \-mcpu32  \-m5200  \-m68881  \-mbitfield  \-mc68000  \-mc68020   
+\&\-mfpa  \-mnobitfield  \-mrtd  \-mshort  \-msoft-float  \-mpcrel 
+\&\-malign-int  \-mstrict-align\fR
 .Sp
 \&\fIM68hc1x Options\fR
 .Sp
@@ -353,11 +358,11 @@ in the following sections.
 \&\fB\-mcmodel=\fR\fIcode model\fR 
 \&\fB\-m32  \-m64 
 \&\-mapp-regs  \-mbroken-saverestore  \-mcypress 
-\&\-mepilogue \-mfaster-structs \-mflat 
+\&\-mepilogue  \-mfaster-structs  \-mflat 
 \&\-mfpu  \-mhard-float  \-mhard-quad-float 
 \&\-mimpure-text  \-mlive-g0  \-mno-app-regs 
-\&\-mno-epilogue \-mno-faster-structs \-mno-flat  \-mno-fpu 
-\&\-mno-impure-text \-mno-stack-bias  \-mno-unaligned-doubles 
+\&\-mno-epilogue  \-mno-faster-structs  \-mno-flat  \-mno-fpu 
+\&\-mno-impure-text  \-mno-stack-bias  \-mno-unaligned-doubles 
 \&\-msoft-float  \-msoft-quad-float  \-msparclite  \-mstack-bias 
 \&\-msupersparc  \-munaligned-doubles  \-mv8\fR
 .Sp
@@ -379,37 +384,28 @@ in the following sections.
 .Sp
 \&\fI\s-1ARM\s0 Options\fR
 .Sp
-\&\fB\-mapcs-frame \-mno-apcs-frame 
-\&\-mapcs-26 \-mapcs-32 
-\&\-mapcs-stack-check \-mno-apcs-stack-check 
-\&\-mapcs-float \-mno-apcs-float 
-\&\-mapcs-reentrant \-mno-apcs-reentrant 
-\&\-msched-prolog \-mno-sched-prolog 
-\&\-mlittle-endian \-mbig-endian \-mwords-little-endian 
-\&\-malignment-traps \-mno-alignment-traps 
-\&\-msoft-float \-mhard-float \-mfpe 
-\&\-mthumb-interwork \-mno-thumb-interwork 
-\&\-mcpu= \-march= \-mfpe=  
-\&\-mstructure-size-boundary= 
-\&\-mbsd \-mxopen \-mno-symrename 
+\&\fB\-mapcs-frame  \-mno-apcs-frame 
+\&\-mapcs-26  \-mapcs-32 
+\&\-mapcs-stack-check  \-mno-apcs-stack-check 
+\&\-mapcs-float  \-mno-apcs-float 
+\&\-mapcs-reentrant  \-mno-apcs-reentrant 
+\&\-msched-prolog  \-mno-sched-prolog 
+\&\-mlittle-endian  \-mbig-endian  \-mwords-little-endian 
+\&\-malignment-traps  \-mno-alignment-traps 
+\&\-msoft-float  \-mhard-float  \-mfpe 
+\&\-mthumb-interwork  \-mno-thumb-interwork 
+\&\-mcpu=\fR\fIname\fR  \fB\-march=\fR\fIname\fR  \fB\-mfpe=\fR\fIname\fR  
+\&\fB\-mstructure-size-boundary=\fR\fIn\fR 
+\&\fB\-mbsd \-mxopen  \-mno-symrename 
 \&\-mabort-on-noreturn 
-\&\-mlong-calls \-mno-long-calls 
-\&\-mnop-fun-dllimport \-mno-nop-fun-dllimport 
-\&\-msingle-pic-base \-mno-single-pic-base 
-\&\-mpic-register=\fR
-.Sp
-\&\fIThumb Options\fR
-.Sp
-\&\fB\-mtpcs-frame \-mno-tpcs-frame 
-\&\-mtpcs-leaf-frame \-mno-tpcs-leaf-frame 
-\&\-mlittle-endian  \-mbig-endian 
-\&\-mthumb-interwork \-mno-thumb-interwork 
-\&\-mstructure-size-boundary= 
-\&\-mnop-fun-dllimport \-mno-nop-fun-dllimport 
-\&\-mcallee-super-interworking \-mno-callee-super-interworking 
-\&\-mcaller-super-interworking \-mno-caller-super-interworking 
-\&\-msingle-pic-base \-mno-single-pic-base 
-\&\-mpic-register=\fR
+\&\-mlong-calls  \-mno-long-calls 
+\&\-msingle-pic-base  \-mno-single-pic-base 
+\&\-mpic-register=\fR\fIreg\fR 
+\&\fB\-mnop-fun-dllimport 
+\&\-mpoke-function-name 
+\&\-mthumb  \-marm 
+\&\-mtpcs-frame  \-mtpcs-leaf-frame 
+\&\-mcaller-super-interworking  \-mcallee-super-interworking\fR 
 .Sp
 \&\fI\s-1MN10200\s0 Options\fR
 .Sp
@@ -470,43 +466,43 @@ in the following sections.
 .Sp
 \&\fI\s-1MIPS\s0 Options\fR
 .Sp
-\&\fB\-mabicalls  \-mcpu=\fR\fIcpu type\fR
+\&\fB\-mabicalls  \-mcpu=\fR\fIcpu type\fR 
 \&\fB\-membedded-data  \-muninit-const-in-rodata 
 \&\-membedded-pic  \-mfp32  \-mfp64  \-mgas  \-mgp32  \-mgp64 
 \&\-mgpopt  \-mhalf-pic  \-mhard-float  \-mint64  \-mips1 
-\&\-mips2  \-mips3 \-mips4 \-mlong64  \-mlong32 \-mlong-calls  \-mmemcpy 
+\&\-mips2  \-mips3  \-mips4  \-mlong64  \-mlong32  \-mlong-calls  \-mmemcpy 
 \&\-mmips-as  \-mmips-tfile  \-mno-abicalls 
-\&\-mno-embedded-data  \-mno-uninit-const-in-rodata  \-mno-embedded-pic 
-\&\-mno-gpopt  \-mno-long-calls 
+\&\-mno-embedded-data  \-mno-uninit-const-in-rodata 
+\&\-mno-embedded-pic  \-mno-gpopt  \-mno-long-calls 
 \&\-mno-memcpy  \-mno-mips-tfile  \-mno-rnames  \-mno-stats 
 \&\-mrnames  \-msoft-float 
 \&\-m4650  \-msingle-float  \-mmad 
 \&\-mstats  \-EL  \-EB  \-G\fR \fInum\fR  \fB\-nocpp 
-\&\-mabi=32 \-mabi=n32 \-mabi=64 \-mabi=eabi 
-\&\-mfix7000 \-mno-crt0\fR
+\&\-mabi=32  \-mabi=n32  \-mabi=64  \-mabi=eabi 
+\&\-mfix7000  \-mno-crt0\fR
 .Sp
 \&\fIi386 Options\fR
 .Sp
-\&\fB\-mcpu=\fR\fIcpu type\fR \fB\-march=\fR\fIcpu type\fR 
+\&\fB\-mcpu=\fR\fIcpu type\fR  \fB\-march=\fR\fIcpu type\fR 
 \&\fB\-mintel-syntax \-mieee-fp  \-mno-fancy-math-387 
 \&\-mno-fp-ret-in-387  \-msoft-float  \-msvr3\-shlib 
 \&\-mno-wide-multiply  \-mrtd  \-malign-double 
 \&\-mpreferred-stack-boundary=\fR\fInum\fR 
-\&\fB\-mthreads \-mno-align-stringops \-minline-all-stringops 
-\&\-mpush-args \-maccumulate-outgoing-args \-m128bit-long-double 
-\&\-m96bit-long-double \-mregparm=\fR\fInum\fR \fB\-momit-leaf-frame-pointer\fR
+\&\fB\-mthreads  \-mno-align-stringops  \-minline-all-stringops 
+\&\-mpush-args  \-maccumulate-outgoing-args  \-m128bit-long-double 
+\&\-m96bit-long-double  \-mregparm=\fR\fInum\fR  \fB\-momit-leaf-frame-pointer\fR
 .Sp
 \&\fI\s-1HPPA\s0 Options\fR
 .Sp
 \&\fB\-march=\fR\fIarchitecture type\fR 
-\&\fB\-mbig-switch  \-mdisable-fpregs  \-mdisable-indexing   
-\&\-mfast-indirect-calls \-mgas  \-mjump-in-delay   
+\&\fB\-mbig-switch  \-mdisable-fpregs  \-mdisable-indexing 
+\&\-mfast-indirect-calls  \-mgas  \-mjump-in-delay 
 \&\-mlong-load-store  \-mno-big-switch  \-mno-disable-fpregs 
 \&\-mno-disable-indexing  \-mno-fast-indirect-calls  \-mno-gas 
-\&\-mno-jump-in-delay  \-mno-long-load-store   
+\&\-mno-jump-in-delay  \-mno-long-load-store 
 \&\-mno-portable-runtime  \-mno-soft-float 
-\&\-mno-space-regs  \-msoft-float  \-mpa-risc-1\-0   
-\&\-mpa-risc-1\-1  \-mpa-risc-2\-0 \-mportable-runtime 
+\&\-mno-space-regs  \-msoft-float  \-mpa-risc-1\-0 
+\&\-mpa-risc-1\-1  \-mpa-risc-2\-0  \-mportable-runtime 
 \&\-mschedule=\fR\fIcpu type\fR  \fB\-mspace-regs\fR
 .Sp
 \&\fIIntel 960 Options\fR
@@ -522,13 +518,13 @@ in the following sections.
 .Sp
 \&\fI\s-1DEC\s0 Alpha Options\fR
 .Sp
-\&\fB\-mfp-regs  \-mno-fp-regs \-mno-soft-float  \-msoft-float 
-\&\-malpha-as \-mgas 
+\&\fB\-mfp-regs  \-mno-fp-regs  \-mno-soft-float  \-msoft-float 
+\&\-malpha-as  \-mgas 
 \&\-mieee  \-mieee-with-inexact  \-mieee-conformant 
 \&\-mfp-trap-mode=\fR\fImode\fR  \fB\-mfp-rounding-mode=\fR\fImode\fR 
 \&\fB\-mtrap-precision=\fR\fImode\fR  \fB\-mbuild-constants 
 \&\-mcpu=\fR\fIcpu type\fR 
-\&\fB\-mbwx \-mno-bwx \-mcix \-mno-cix \-mmax \-mno-max 
+\&\fB\-mbwx  \-mno-bwx  \-mcix  \-mno-cix  \-mmax  \-mno-max 
 \&\-mmemory-latency=\fR\fItime\fR
 .Sp
 \&\fIClipper Options\fR
@@ -537,7 +533,7 @@ in the following sections.
 .Sp
 \&\fIH8/300 Options\fR
 .Sp
-\&\fB\-mrelax  \-mh \-ms \-mint32  \-malign-300\fR
+\&\fB\-mrelax  \-mh  \-ms  \-mint32  \-malign-300\fR
 .Sp
 \&\fI\s-1SH\s0 Options\fR
 .Sp
@@ -561,43 +557,44 @@ in the following sections.
 .Sp
 \&\fITMS320C3x/C4x Options\fR
 .Sp
-\&\fB\-mcpu=\fR\fIcpu\fR \fB\-mbig \-msmall \-mregparm \-mmemparm 
-\&\-mfast-fix \-mmpyi \-mbk \-mti \-mdp-isr-reload 
-\&\-mrpts=\fR\fIcount\fR  \fB\-mrptb \-mdb \-mloop-unsigned 
-\&\-mparallel-insns \-mparallel-mpy \-mpreserve-float\fR
+\&\fB\-mcpu=\fR\fIcpu\fR  \fB\-mbig  \-msmall  \-mregparm  \-mmemparm 
+\&\-mfast-fix  \-mmpyi  \-mbk  \-mti  \-mdp-isr-reload 
+\&\-mrpts=\fR\fIcount\fR  \fB\-mrptb  \-mdb  \-mloop-unsigned 
+\&\-mparallel-insns  \-mparallel-mpy  \-mpreserve-float\fR
 .Sp
 \&\fIV850 Options\fR
 .Sp
-\&\fB\-mlong-calls \-mno-long-calls \-mep \-mno-ep 
-\&\-mprolog-function \-mno-prolog-function \-mspace 
-\&\-mtda=\fR\fIn\fR \fB\-msda=\fR\fIn\fR \fB\-mzda=\fR\fIn\fR 
-\&\fB\-mv850 \-mbig-switch\fR
+\&\fB\-mlong-calls  \-mno-long-calls  \-mep  \-mno-ep 
+\&\-mprolog-function  \-mno-prolog-function  \-mspace 
+\&\-mtda=\fR\fIn\fR  \fB\-msda=\fR\fIn\fR  \fB\-mzda=\fR\fIn\fR 
+\&\fB\-mv850  \-mbig-switch\fR
 .Sp
 \&\fI\s-1NS32K\s0 Options\fR
 .Sp
-\&\fB\-m32032 \-m32332 \-m32532 \-m32081 \-m32381 \-mmult-add \-mnomult-add 
-\&\-msoft-float \-mrtd \-mnortd \-mregparam \-mnoregparam \-msb \-mnosb 
-\&\-mbitfield \-mnobitfield \-mhimem \-mnohimem\fR
+\&\fB\-m32032  \-m32332  \-m32532  \-m32081  \-m32381 
+\&\-mmult-add  \-mnomult-add  \-msoft-float  \-mrtd  \-mnortd 
+\&\-mregparam  \-mnoregparam  \-msb  \-mnosb 
+\&\-mbitfield  \-mnobitfield  \-mhimem  \-mnohimem\fR
 .Sp
 \&\fI\s-1AVR\s0 Options\fR
 .Sp
-\&\fB\-mmcu=\fR\fImcu\fR \fB\-msize \-minit-stack=\fR\fIn\fR \fB\-mno-interrupts 
-\&\-mcall-prologues \-mno-tablejump \-mtiny-stack\fR
+\&\fB\-mmcu=\fR\fImcu\fR  \fB\-msize  \-minit-stack=\fR\fIn\fR  \fB\-mno-interrupts 
+\&\-mcall-prologues  \-mno-tablejump  \-mtiny-stack\fR
 .Sp
 \&\fIMCore Options\fR
 .Sp
-\&\fB\-mhardlit \-mno-hardlit \-mdiv \-mno-div \-mrelax-immediates  
-\&\-mno-relax-immediates \-mwide-bitfields \-mno-wide-bitfields 
-\&\-m4byte-functions \-mno-4byte-functions \-mcallgraph-data 
-\&\-mno-callgraph-data \-mslow-bytes \-mno-slow-bytes \-mno-lsim 
-\&\-mlittle-endian \-mbig-endian \-m210 \-m340 \-mstack-increment\fR
+\&\fB\-mhardlit  \-mno-hardlit  \-mdiv  \-mno-div  \-mrelax-immediates 
+\&\-mno-relax-immediates  \-mwide-bitfields  \-mno-wide-bitfields 
+\&\-m4byte-functions  \-mno-4byte-functions  \-mcallgraph-data 
+\&\-mno-callgraph-data  \-mslow-bytes  \-mno-slow-bytes  \-mno-lsim 
+\&\-mlittle-endian  \-mbig-endian  \-m210  \-m340  \-mstack-increment\fR
 .Sp
 \&\fI\s-1IA-64\s0 Options\fR
 .Sp
-\&\fB\-mbig-endian \-mlittle-endian \-mgnu-as \-mgnu-ld \-mno-pic 
-\&\-mvolatile-asm-stop \-mb-step \-mregister-names \-mno-sdata 
-\&\-mconstant-gp \-mauto-pic \-minline-divide-min-latency 
-\&\-minline-divide-max-throughput \-mno-dwarf2\-asm 
+\&\fB\-mbig-endian  \-mlittle-endian  \-mgnu-as  \-mgnu-ld  \-mno-pic 
+\&\-mvolatile-asm-stop  \-mb-step  \-mregister-names  \-mno-sdata 
+\&\-mconstant-gp  \-mauto-pic  \-minline-divide-min-latency 
+\&\-minline-divide-max-throughput  \-mno-dwarf2\-asm 
 \&\-mfixed-range=\fR\fIregister range\fR
 .Ip "\fICode Generation Options\fR" 4
 .IX Item "Code Generation Options"
@@ -608,12 +605,12 @@ in the following sections.
 \&\-fno-common  \-fno-ident  \-fno-gnu-linker 
 \&\-fpcc-struct-return  \-fpic  \-fPIC 
 \&\-freg-struct-return  \-fshared-data  \-fshort-enums 
-\&\-fshort-double  \-fvolatile  \-fvolatile-global \-fvolatile-static 
+\&\-fshort-double  \-fvolatile 
+\&\-fvolatile-global  \-fvolatile-static 
 \&\-fverbose-asm  \-fpack-struct  \-fstack-check 
 \&\-fstack-limit-register=\fR\fIreg\fR  \fB\-fstack-limit-symbol=\fR\fIsym\fR 
 \&\fB\-fargument-alias  \-fargument-noalias 
-\&\-fargument-noalias-global 
-\&\-fleading-underscore\fR
+\&\-fargument-noalias-global  \-fleading-underscore\fR
 .Sh "Options Controlling the Kind of Output"
 .IX Subsection "Options Controlling the Kind of Output"
 Compilation can involve up to four stages: preprocessing, compilation
@@ -911,6 +908,21 @@ effects as \fB\-ansi\fR, except that features that were not in \s-1ISO\s0 C89
 but are in the specified version (for example, \fB//\fR comments and
 the \f(CW\*(C`inline\*(C'\fR keyword in \s-1ISO\s0 C99) are not disabled.
 .RE
+.Ip "\fB\-aux-info\fR \fIfilename\fR" 4
+.IX Item "-aux-info filename"
+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.
+.Sp
+Besides declarations, the file indicates, in comments, the origin of
+each declaration (source file and line), whether the declaration was
+implicit, prototyped or unprototyped (\fBI\fR, \fBN\fR for new or
+\&\fBO\fR for old, respectively, in the first character after the line
+number and the colon), and whether it came from a declaration or a
+definition (\fBC\fR or \fBF\fR, 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.
 .Ip "\fB\-fno-asm\fR" 4
 .IX Item "-fno-asm"
 Do not recognize \f(CW\*(C`asm\*(C'\fR, \f(CW\*(C`inline\*(C'\fR or \f(CW\*(C`typeof\*(C'\fR as a
@@ -936,6 +948,13 @@ may become inline copy loops.  The resulting code is often both smaller
 and faster, but since the function calls no longer appear as such, you
 cannot set a breakpoint on those calls, nor can you change the behavior
 of the functions by linking with a different library.
+.Sp
+In \*(C+, \fB\-fno-builtin\fR is always in effect.  The \fB\-fbuiltin\fR
+option has no effect.  Therefore, in \*(C+, the only way to get the
+optimization benefits of builtin functions is to call the function
+using the \fB_\|_builtin_\fR prefix.  The \s-1GNU\s0 \*(C+ Standard Library uses
+builtin functions to implement many functions (like
+\&\f(CW\*(C`std::strchr\*(C'\fR), so that you automatically get efficient code.
 .Ip "\fB\-fhosted\fR" 4
 .IX Item "-fhosted"
 Assert that compilation takes place in a hosted environment.  This implies
@@ -952,9 +971,8 @@ not necessarily be at \f(CW\*(C`main\*(C'\fR.  The most obvious example is an \s
 This is equivalent to \fB\-fno-hosted\fR.
 .Ip "\fB\-trigraphs\fR" 4
 .IX Item "-trigraphs"
-Support \s-1ISO\s0 C trigraphs.  You don't want to know about this
-brain-damage.  The \fB\-ansi\fR option (and \fB\-std\fR options for
-strict \s-1ISO\s0 C conformance) implies \fB\-trigraphs\fR.
+Support \s-1ISO\s0 C trigraphs.  The \fB\-ansi\fR option (and \fB\-std\fR
+options for strict \s-1ISO\s0 C conformance) implies \fB\-trigraphs\fR.
 .Ip "\fB\-traditional\fR" 4
 .IX Item "-traditional"
 Attempt to support some aspects of traditional C compilers.
@@ -1071,15 +1089,6 @@ Let the type \f(CW\*(C`char\*(C'\fR be signed, like \f(CW\*(C`signed char\*(C'\f
 Note that this is equivalent to \fB\-fno-unsigned-char\fR, which is
 the negative form of \fB\-funsigned-char\fR.  Likewise, the option
 \&\fB\-fno-signed-char\fR is equivalent to \fB\-funsigned-char\fR.
-.Sp
-You may wish to use \fB\-fno-builtin\fR as well as \fB\-traditional\fR
-if your program uses names that are normally \s-1GNU\s0 C builtin functions for
-other purposes of its own.
-.Sp
-You cannot use \fB\-traditional\fR if you include any header files that
-rely on \s-1ISO\s0 C features.  Some vendors are starting to ship systems with
-\&\s-1ISO\s0 C header files and you cannot use \fB\-traditional\fR on such
-systems to compile files that include any system headers.
 .Ip "\fB\-fsigned-bitfields\fR" 4
 .IX Item "-fsigned-bitfields"
 .PD 0
@@ -1236,16 +1245,6 @@ it. For compatibility with earlier versions of g++, the compiler will,
 by default, ignore \f(CW\*(C`namespace\-declarations\*(C'\fR,
 \&\f(CW\*(C`using\-declarations\*(C'\fR, \f(CW\*(C`using\-directives\*(C'\fR, and
 \&\f(CW\*(C`namespace\-names\*(C'\fR, if they involve \f(CW\*(C`std\*(C'\fR.
-.Ip "\fB\-fhuge-objects\fR" 4
-.IX Item "-fhuge-objects"
-Support virtual function calls for objects that exceed the size
-representable by a \fBshort int\fR.  Users should not use this flag by
-default; if you need to use it, the compiler will tell you so.
-.Sp
-This flag is not useful when compiling with \-fvtable-thunks.
-.Sp
-Like all options that change the \s-1ABI\s0, all \*(C+ code, \fIincluding
-libgcc\fR must be built with the same setting of this option.
 .Ip "\fB\-fno-implicit-templates\fR" 4
 .IX Item "-fno-implicit-templates"
 Never emit code for non-inline templates which are instantiated
@@ -1314,25 +1313,19 @@ Register destructors for objects with static storage duration with the
 This option is required for fully standards-compliant handling of static
 destructors, but will only work if your C library supports
 \&\f(CW\*(C`_\|_cxa_atexit\*(C'\fR.
-.Ip "\fB\-fvtable-thunks\fR" 4
-.IX Item "-fvtable-thunks"
-Use \fBthunks\fR to implement the virtual function dispatch table
-(\fBvtable\fR).  The traditional (cfront-style) approach to
-implementing vtables was to store a pointer to the function and two
-offsets for adjusting the \fBthis\fR pointer at the call site.  Newer
-implementations store a single pointer to a \fBthunk\fR function which
-does any necessary adjustment and then calls the target function.
-.Sp
-This option also enables a heuristic for controlling emission of
-vtables; if a class has any non-inline virtual functions, the vtable
-will be emitted in the translation unit containing the first one of
-those.
-.Sp
-Like all options that change the \s-1ABI\s0, all \*(C+ code, \fIincluding
-libgcc.a\fR must be built with the same setting of this option.
+.Ip "\fB\-fvtable-gc\fR" 4
+.IX Item "-fvtable-gc"
+Emit special relocations for vtables and virtual function references
+so that the linker can identify unused virtual functions and zero out
+vtable slots that refer to them.  This is most useful with
+\&\fB\-ffunction-sections\fR and \fB\-Wl,\-\-gc-sections\fR, in order to
+also discard the functions themselves.
+.Sp
+This optimization requires \s-1GNU\s0 as and \s-1GNU\s0 ld.  Not all systems support
+this option.  \fB\-Wl,\-\-gc-sections\fR is ignored without \fB\-static\fR.
 .Ip "\fB\-fno-weak\fR" 4
 .IX Item "-fno-weak"
-Do not use weak symbol support, even if it is provied by the linker.
+Do not use weak symbol support, even if it is provided by the linker.
 By default, G++ will use weak symbols if they are available.  This
 option exists only for testing, and should not be used by end-users;
 it will result in inferior code and has no benefits.  This option may
@@ -1405,7 +1398,8 @@ but disables the helpful warning.
 .IX Item "-Wold-style-cast ( only)"
 Warn if an old-style (C-style) cast is used within a \*(C+ program.  The
 new-style casts (\fBstatic_cast\fR, \fBreinterpret_cast\fR, and
-\&\fBconst_cast\fR) are less vulnerable to unintended effects.
+\&\fBconst_cast\fR) are less vulnerable to unintended effects, and much
+easier to grep for.
 .Ip "\fB\-Woverloaded-virtual (\*(C+ only)\fR" 4
 .IX Item "-Woverloaded-virtual ( only)"
 Warn when a function declaration hides virtual functions from a
@@ -1774,15 +1768,9 @@ The present implementation of this option only works for C programs.  A
 future implementation may also work for \*(C+ programs.
 .Sp
 There is some controversy over the precise meaning of the sequence point
-rules in subtle cases.  Alternative formal definitions may be found in
-Clive Feather's ``Annex S''
-<\fBhttp://wwwold.dkuug.dk/JTC1/SC22/WG14/www/docs/n925.htm\fR> and in
-Michael Norrish's thesis
-<\fBhttp://www.cl.cam.ac.uk/users/mn200/PhD/thesis-report.ps.gz\fR>.
-Other discussions are by Raymond Mak
-<\fBhttp://wwwold.dkuug.dk/JTC1/SC22/WG14/www/docs/n926.htm\fR> and
-D. Hugh Redelmeier
-<\fBhttp://wwwold.dkuug.dk/JTC1/SC22/WG14/www/docs/n927.htm\fR>.
+rules in subtle cases.  Links to papers with alternative formal definitions
+and other related discussions may be found on our readings page
+<\fBhttp://gcc.gnu.org/readings.html\fR>.
 .Ip "\fB\-Wreturn-type\fR" 4
 .IX Item "-Wreturn-type"
 Warn whenever a function is defined with a return-type that defaults to
@@ -2088,11 +2076,6 @@ Warn if an undefined identifier is evaluated in an \fB#if\fR directive.
 .IX Item "-Wshadow"
 Warn whenever a local variable shadows another local variable, parameter or
 global variable or whenever a built-in function is shadowed.
-.Ip "\fB\-Wid-clash-\fR\fIlen\fR" 4
-.IX Item "-Wid-clash-len"
-Warn whenever two distinct identifiers match in the first \fIlen\fR
-characters.  This may help you prepare a program that will compile
-with certain obsolete, brain-damaged compilers.
 .Ip "\fB\-Wlarger-than-\fR\fIlen\fR" 4
 .IX Item "-Wlarger-than-len"
 Warn whenever an object of larger than \fIlen\fR bytes is defined.
@@ -2677,18 +2660,63 @@ When doing debugging dumps (see \-d option above), suppress instruction
 numbers and line number note output.  This makes it more feasible to
 use diff on debugging dumps for compiler invocations with different
 options, in particular with and without \-g.
-.Ip "\fB\-fdump-translation-unit=\fR\fIfile\fR \fB(C and \*(C+ only)\fR" 4
-.IX Item "-fdump-translation-unit=file (C and  only)"
-Dump a representation of the tree structure for the entire translation
-unit to \fIfile\fR.
-.Ip "\fB\-fdump-class_layout=\fR\fIfile\fR \fB(\*(C+ only)\fR" 4
-.IX Item "-fdump-class_layout=file ( only)"
+.Ip "\fB\-fdump-translation-unit (C and \*(C+ only)\fR" 4
+.IX Item "-fdump-translation-unit (C and  only)"
 .PD 0
-.Ip "\fB\-fdump-class_layout (\*(C+ only)\fR" 4
-.IX Item "-fdump-class_layout ( only)"
+.Ip "\fB\-fdump-translation-unit-\fR\fInumber\fR \fB(C and \*(C+ only)\fR" 4
+.IX Item "-fdump-translation-unit-number (C and  only)"
 .PD
-Dump a representation of each class's heirarchy to \fIfile\fR, or
-\&\f(CW\*(C`stderr\*(C'\fR if not specified.
+Dump a representation of the tree structure for the entire translation
+unit to a file. The file name is made by appending \fI.tu\fR to the
+source file name. If the -\fInumber\fR form is used, \fInumber\fR
+controls the details of the dump as described for the \-fdump-tree options.
+.Ip "\fB\-fdump-class-hierarchy (\*(C+ only)\fR" 4
+.IX Item "-fdump-class-hierarchy ( only)"
+.PD 0
+.Ip "\fB\-fdump-class-hierarchy-\fR\fInumber\fR \fB(\*(C+ only)\fR" 4
+.IX Item "-fdump-class-hierarchy-number ( only)"
+.PD
+Dump a representation of each class's hierarchy and virtual function
+table layout to a file. The file name is made by appending \fI.class\fR
+to the source file name. If the -\fInumber\fR form is used, \fInumber\fR
+controls the details of the dump as described for the \-fdump-tree
+options.
+.Ip "\fB\-fdump-ast-\fR\fIswitch\fR \fB(\*(C+ only)\fR" 4
+.IX Item "-fdump-ast-switch ( only)"
+.PD 0
+.Ip "\fB\-fdump-ast-\fR\fIswitch\fR\fB-\fR\fInumber\fR \fB(\*(C+ only)\fR" 4
+.IX Item "-fdump-ast-switch-number ( only)"
+.PD
+Control the dumping at various stages of processing the abstract syntax
+tree to a file. The file name is generated by appending a switch
+specific suffix to the source file name. If the -\fInumber\fR form is
+used, \fInumber\fR is a bit mask which controls the details of the
+dump. The following bits are meaningful (these are not set symbolically,
+as the primary function of these dumps is for debugging gcc itself):
+.RS 4
+.Ip "\fBbit0 (1)\fR" 4
+.IX Item "bit0 (1)"
+Print the address of each node. Usually this is not meaningful as it
+changes according to the environment and source file.
+.Ip "\fBbit1 (2)\fR" 4
+.IX Item "bit1 (2)"
+Inhibit dumping of members of a scope or body of a function, unless they
+are reachable by some other path.
+.RE
+.RS 4
+.Sp
+The following tree dumps are possible:
+.RS 4
+.RE
+.Ip "\fBoriginal\fR" 4
+.IX Item "original"
+Dump before any tree based optimization, to \fI\fIfile\fI.original\fR.
+.Ip "\fBoptimized\fR" 4
+.IX Item "optimized"
+Dump after all tree based optimization, to \fI\fIfile\fI.optimized\fR.
+.RE
+.RS 4
+.RE
 .Ip "\fB\-fpretend-float\fR" 4
 .IX Item "-fpretend-float"
 When running a cross-compiler, pretend that the target machine uses the
@@ -2724,6 +2752,18 @@ Print the full absolute name of the library file \fIlibrary\fR that
 would be used when linking\-\-\-and don't do anything else.  With this
 option, \s-1GCC\s0 does not compile or link anything; it just prints the
 file name.
+.Ip "\fB\-print-multi-directory\fR" 4
+.IX Item "-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 \fB\s-1GCC_EXEC_PREFIX\s0\fR.
+.Ip "\fB\-print-multi-lib\fR" 4
+.IX Item "-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
+\&\fB;\fR, and each switch starts with an \fB@} instead of the
+\&\f(CB@samp\fB{-\fR, without spaces between multiple switches.  This is supposed to
+ease shell-processing.
 .Ip "\fB\-print-prog-name=\fR\fIprogram\fR" 4
 .IX Item "-print-prog-name=program"
 Like \fB\-print-file-name\fR, but searches for a program such as \fBcpp\fR.
@@ -3280,7 +3320,7 @@ If \fIn\fR is not specified, use a machine-dependent default.
 .IX Item "-fssa"
 Perform optimizations in static single assignment form.  Each function's
 flow graph is translated into \s-1SSA\s0 form, optimizations are performed, and
-the flow graph is translated back from \s-1SSA\s0 form.  User's should not
+the flow graph is translated back from \s-1SSA\s0 form.  Users should not
 specify this option, since it is not yet ready for production use.
 .Ip "\fB\-fdce\fR" 4
 .IX Item "-fdce"
@@ -3564,6 +3604,17 @@ Only \fB#define\fR \fIname\fR is included in the output.
 .IX Item "-dI"
 Output \fB#include\fR directives in addition to the result of
 preprocessing.
+.Ip "\fB\-fpreprocessed\fR" 4
+.IX Item "-fpreprocessed"
+Indicate to the preprocessor that the input file has already been
+preprocessed.  This suppresses things like macro expansion, trigraph
+conversion, escaped newline splicing, and processing of most directives.
+In this mode the integrated preprocessor is little more than a tokenizer
+for the front ends.
+.Sp
+\&\fB\-fpreprocessed\fR is implicit if the input file has one of the
+extensions \fBi\fR, \fBii\fR or \fBmi\fR indicating it has already
+been preprocessed.
 .Ip "\fB\-trigraphs\fR" 4
 .IX Item "-trigraphs"
 Process \s-1ISO\s0 standard trigraph sequences.  These are three-character
@@ -4607,31 +4658,9 @@ Generate code for a processor running with a 32\-bit program counter,
 and conforming to the function calling standards for the \s-1APCS\s0 32\-bit
 option.  This option replaces the \fB\-m6\fR option of previous releases
 of the compiler.
-.Ip "\fB\-mapcs-stack-check\fR" 4
-.IX Item "-mapcs-stack-check"
-Generate code to check the amount of stack space available upon entry to
-every function (that actually uses some stack space).  If there is
-insufficient space available then either the function
-\&\fB_\|_rt_stkovf_split_small\fR or \fB_\|_rt_stkovf_split_big\fR will be
-called, depending upon the amount of stack space required.  The run time
-system is required to provide these functions.  The default is
-\&\fB\-mno-apcs-stack-check\fR, since this produces smaller code.
-.Ip "\fB\-mapcs-float\fR" 4
-.IX Item "-mapcs-float"
-Pass floating point arguments using the float point registers.  This is
-one of the variants of the \s-1APCS\s0.  This option is recommended if the
-target hardware has a floating point unit or if a lot of floating point
-arithmetic is going to be performed by the code.  The default is
-\&\fB\-mno-apcs-float\fR, since integer only code is slightly increased in
-size if \fB\-mapcs-float\fR is used.
-.Ip "\fB\-mapcs-reentrant\fR" 4
-.IX Item "-mapcs-reentrant"
-Generate reentrant, position independent code.  This is the equivalent
-to specifying the \fB\-fpic\fR option.  The default is
-\&\fB\-mno-apcs-reentrant\fR.
 .Ip "\fB\-mthumb-interwork\fR" 4
 .IX Item "-mthumb-interwork"
-Generate code which supports calling between the \s-1ARM\s0 and \s-1THUMB\s0
+Generate code which supports calling between the \s-1ARM\s0 and Thumb
 instruction sets.  Without this option the two instruction sets cannot
 be reliably used inside one program.  The default is
 \&\fB\-mno-thumb-interwork\fR, since slightly larger code is generated
@@ -4699,7 +4728,7 @@ objects in memory.
 .IX Item "-mno-alignment-traps"
 Generate code that assumes that the \s-1MMU\s0 will not trap unaligned
 accesses.  This produces better code when the target instruction set
-does not have half-word memory operations (implementations prior to
+does not have half-word memory operations (i.e. implementations prior to
 ARMv4).
 .Sp
 Note that you cannot use this option to access unaligned word objects,
@@ -4711,16 +4740,18 @@ this produces better code when there are no half-word memory
 instructions available.
 .Ip "\fB\-mshort-load-bytes\fR" 4
 .IX Item "-mshort-load-bytes"
-This is a deprecated alias for \fB\-malignment-traps\fR.
+.PD 0
+.Ip "\fB\-mno-short-load-words\fR" 4
+.IX Item "-mno-short-load-words"
+.PD
+These are deprecated aliases for \fB\-malignment-traps\fR.
 .Ip "\fB\-mno-short-load-bytes\fR" 4
 .IX Item "-mno-short-load-bytes"
-This is a deprecated alias for \fB\-mno-alignment-traps\fR.
+.PD 0
 .Ip "\fB\-mshort-load-words\fR" 4
 .IX Item "-mshort-load-words"
-This is a deprecated alias for \fB\-mno-alignment-traps\fR.
-.Ip "\fB\-mno-short-load-words\fR" 4
-.IX Item "-mno-short-load-words"
-This is a deprecated alias for \fB\-malignment-traps\fR.
+.PD
+This are deprecated aliases for \fB\-mno-alignment-traps\fR.
 .Ip "\fB\-mbsd\fR" 4
 .IX Item "-mbsd"
 This option only applies to \s-1RISC\s0 iX.  Emulate the native BSD-mode
@@ -4737,43 +4768,44 @@ Normally it is necessary to modify some of the standard symbols in
 preparation for linking with the \s-1RISC\s0 iX C library; this option
 suppresses this pass.  The post-processor is never run when the
 compiler is built for cross-compilation.
-.Ip "\fB\-mcpu=<name>\fR" 4
-.IX Item "-mcpu=<name>"
+.Ip "\fB\-mcpu=\fR\fIname\fR" 4
+.IX Item "-mcpu=name"
 This specifies the name of the target \s-1ARM\s0 processor.  \s-1GCC\s0 uses this name
-to determine what kind of instructions it can use when generating
+to determine what kind of instructions it can emit when generating
 assembly code.  Permissible names are: arm2, arm250, arm3, arm6, arm60,
 arm600, arm610, arm620, arm7, arm7m, arm7d, arm7dm, arm7di, arm7dmi,
 arm70, arm700, arm700i, arm710, arm710c, arm7100, arm7500, arm7500fe,
 arm7tdmi, arm8, strongarm, strongarm110, strongarm1100, arm8, arm810,
-arm9, arm920, arm920t, arm9tdmi.
-.Ip "\fB\-mtune=<name>\fR" 4
-.IX Item "-mtune=<name>"
+arm9, arm9e, arm920, arm920t, arm940t, arm9tdmi, arm10tdmi, arm1020t,
+xscale.
+.Ip "\fB\-mtune=\fR\fIname\fR" 4
+.IX Item "-mtune=name"
 This option is very similar to the \fB\-mcpu=\fR option, except that
 instead of specifying the actual target processor type, and hence
 restricting which instructions can be used, it specifies that \s-1GCC\s0 should
 tune the performance of the code as if the target were of the type
 specified in this option, but still choosing the instructions that it
 will generate based on the cpu specified by a \fB\-mcpu=\fR option.
-For some arm implementations better performance can be obtained by using
+For some \s-1ARM\s0 implementations better performance can be obtained by using
 this option.
-.Ip "\fB\-march=<name>\fR" 4
-.IX Item "-march=<name>"
+.Ip "\fB\-march=\fR\fIname\fR" 4
+.IX Item "-march=name"
 This specifies the name of the target \s-1ARM\s0 architecture.  \s-1GCC\s0 uses this
-name to determine what kind of instructions it can use when generating
+name to determine what kind of instructions it can emit when generating
 assembly code.  This option can be used in conjunction with or instead
 of the \fB\-mcpu=\fR option.  Permissible names are: armv2, armv2a,
-armv3, armv3m, armv4, armv4t, armv5.
-.Ip "\fB\-mfpe=<number>\fR" 4
-.IX Item "-mfpe=<number>"
+armv3, armv3m, armv4, armv4t, armv5, armv5t, armv5te.
+.Ip "\fB\-mfpe=\fR\fInumber\fR" 4
+.IX Item "-mfpe=number"
 .PD 0
-.Ip "\fB\-mfp=<number>\fR" 4
-.IX Item "-mfp=<number>"
+.Ip "\fB\-mfp=\fR\fInumber\fR" 4
+.IX Item "-mfp=number"
 .PD
 This specifies the version of the floating point emulation available on
 the target.  Permissible values are 2 and 3.  \fB\-mfp=\fR is a synonym
-for \fB\-mfpe=\fR to support older versions of \s-1GCC\s0.
-.Ip "\fB\-mstructure-size-boundary=<n>\fR" 4
-.IX Item "-mstructure-size-boundary=<n>"
+for \fB\-mfpe=\fR, for compatibility with older versions of \s-1GCC\s0.
+.Ip "\fB\-mstructure-size-boundary=\fR\fIn\fR" 4
+.IX Item "-mstructure-size-boundary=n"
 The size of all structures and unions will be rounded up to a multiple
 of the number of bits set by this option.  Permissible values are 8 and
 32.  The default value varies for different toolchains.  For the \s-1COFF\s0
@@ -4782,12 +4814,12 @@ can produce faster, more efficient code, but can also increase the size
 of the program.  The two values are potentially incompatible.  Code
 compiled with one value cannot necessarily expect to work with code or
 libraries compiled with the other value, if they exchange information
-using structures or unions.  Programmers are encouraged to use the 32
-value as future versions of the toolchain may default to this value.
+using structures or unions.
 .Ip "\fB\-mabort-on-noreturn\fR" 4
 .IX Item "-mabort-on-noreturn"
-Generate a call to the function abort at the end of a noreturn function.
-It will be executed if the function tries to return.
+Generate a call to the function \f(CW\*(C`abort\*(C'\fR at the end of a
+\&\f(CW\*(C`noreturn\*(C'\fR function.  It will be executed if the function tries to
+return.
 .Ip "\fB\-mlong-calls\fR" 4
 .IX Item "-mlong-calls"
 .PD 0
@@ -4812,66 +4844,59 @@ the scope of a \fB#pragma long_calls\fR directive, will always be
 turned into long calls.
 .Sp
 This feature is not enabled by default.  Specifying
-\&\fB\*(--no-long-calls\fR will restore the default behaviour, as will
+\&\fB\-mno-long-calls\fR will restore the default behaviour, as will
 placing the function calls within the scope of a \fB#pragma
 long_calls_off\fR directive.  Note these switches have no effect on how
 the compiler generates code to handle function calls via function
 pointers.
 .Ip "\fB\-mnop-fun-dllimport\fR" 4
 .IX Item "-mnop-fun-dllimport"
-Disable the support for the \fIdllimport\fR attribute.
+Disable support for the \fIdllimport\fR attribute.
 .Ip "\fB\-msingle-pic-base\fR" 4
 .IX Item "-msingle-pic-base"
 Treat the register used for \s-1PIC\s0 addressing as read-only, rather than
 loading it in the prologue for each function.  The run-time system is
 responsible for initialising this register with an appropriate value
 before execution begins.
-.Ip "\fB\-mpic-register=<reg>\fR" 4
-.IX Item "-mpic-register=<reg>"
+.Ip "\fB\-mpic-register=\fR\fIreg\fR" 4
+.IX Item "-mpic-register=reg"
 Specify the register to be used for \s-1PIC\s0 addressing.  The default is R10
 unless stack-checking is enabled, when R9 is used.
-.PP
-.I "Thumb Options"
-.IX Subsection "Thumb Options"
-.Ip "\fB\-mthumb-interwork\fR" 4
-.IX Item "-mthumb-interwork"
-Generate code which supports calling between the \s-1THUMB\s0 and \s-1ARM\s0
-instruction sets.  Without this option the two instruction sets cannot
-be reliably used inside one program.  The default is
-\&\fB\-mno-thumb-interwork\fR, since slightly smaller code is generated
-with this option.
+.Ip "\fB\-mpoke-function-name\fR" 4
+.IX Item "-mpoke-function-name"
+Write the name of each function into the text section, directly
+preceding the function prologue.  The generated code is similar to this:
+.Sp
+.Vb 9
+\&             t0
+\&                 .ascii "arm_poke_function_name", 0
+\&                 .align
+\&             t1
+\&                 .word 0xff000000 + (t1 - t0)
+\&             arm_poke_function_name
+\&                 mov     ip, sp
+\&                 stmfd   sp!, {fp, ip, lr, pc}
+\&                 sub     fp, ip, #4
+.Ve
+When performing a stack backtrace, code can inspect the value of
+\&\f(CW\*(C`pc\*(C'\fR stored at \f(CW\*(C`fp + 0\*(C'\fR.  If the trace function then looks at
+location \f(CW\*(C`pc \- 12\*(C'\fR and the top 8 bits are set, then we know that
+there is a function name embedded immediately preceding this location
+and has length \f(CW\*(C`((pc[\-3]) & 0xff000000)\*(C'\fR.
+.Ip "\fB\-mthumb\fR" 4
+.IX Item "-mthumb"
+Generate code for the 16\-bit Thumb instruction set.  The default is to
+use the 32\-bit \s-1ARM\s0 instruction set.
 .Ip "\fB\-mtpcs-frame\fR" 4
 .IX Item "-mtpcs-frame"
 Generate a stack frame that is compliant with the Thumb Procedure Call
 Standard for all non-leaf functions.  (A leaf function is one that does
-not call any other functions).  The default is \fB\-mno-apcs-frame\fR.
+not call any other functions.)  The default is \fB\-mno-tpcs-frame\fR.
 .Ip "\fB\-mtpcs-leaf-frame\fR" 4
 .IX Item "-mtpcs-leaf-frame"
 Generate a stack frame that is compliant with the Thumb Procedure Call
 Standard for all leaf functions.  (A leaf function is one that does
-not call any other functions).  The default is \fB\-mno-apcs-leaf-frame\fR.
-.Ip "\fB\-mlittle-endian\fR" 4
-.IX Item "-mlittle-endian"
-Generate code for a processor running in little-endian mode.  This is
-the default for all standard configurations.
-.Ip "\fB\-mbig-endian\fR" 4
-.IX Item "-mbig-endian"
-Generate code for a processor running in big-endian mode.
-.Ip "\fB\-mstructure-size-boundary=<n>\fR" 4
-.IX Item "-mstructure-size-boundary=<n>"
-The size of all structures and unions will be rounded up to a multiple
-of the number of bits set by this option.  Permissible values are 8 and
-32.  The default value varies for different toolchains.  For the \s-1COFF\s0
-targeted toolchain the default value is 8.  Specifying the larger number
-can produced faster, more efficient code, but can also increase the size
-of the program.  The two values are potentially incompatible.  Code
-compiled with one value cannot necessarily expect to work with code or
-libraries compiled with the other value, if they exchange information
-using structures or unions.  Programmers are encouraged to use the 32
-value as future versions of the toolchain may default to this value.
-.Ip "\fB\-mnop-fun-dllimport\fR" 4
-.IX Item "-mnop-fun-dllimport"
-Disable the support for the \fIdllimport\fR attribute.
+not call any other functions.)  The default is \fB\-mno-apcs-leaf-frame\fR.
 .Ip "\fB\-mcallee-super-interworking\fR" 4
 .IX Item "-mcallee-super-interworking"
 Gives all externally visible functions in the file being compiled an \s-1ARM\s0
@@ -4884,15 +4909,6 @@ Allows calls via function pointers (including virtual functions) to
 execute correctly regardless of whether the target code has been
 compiled for interworking or not.  There is a small overhead in the cost
 of executing a function pointer if this option is enabled.
-.Ip "\fB\-msingle-pic-base\fR" 4
-.IX Item "-msingle-pic-base"
-Treat the register used for \s-1PIC\s0 addressing as read-only, rather than
-loading it in the prologue for each function.  The run-time system is
-responsible for initialising this register with an appropriate value
-before execution begins.
-.Ip "\fB\-mpic-register=<reg>\fR" 4
-.IX Item "-mpic-register=<reg>"
-Specify the register to be used for \s-1PIC\s0 addressing.  The default is R10.
 .PP
 .I "\s-1MN10200\s0 Options"
 .IX Subsection "MN10200 Options"
@@ -6363,11 +6379,11 @@ this to work.
 .IX Subsection "Intel 960 Options"
 .PP
 These \fB\-m\fR options are defined for the Intel 960 implementations:
-.Ip "\fB\-m\fR\fIcpu type\fR" 4
-.IX Item "-mcpu type"
-Assume the defaults for the machine type \fIcpu type\fR for some of
+.Ip "\fB\-m\fR\fIcpu-type\fR" 4
+.IX Item "-mcpu-type"
+Assume the defaults for the machine type \fIcpu-type\fR for some of
 the other options, including instruction scheduling, floating point
-support, and addressing modes.  The choices for \fIcpu type\fR are
+support, and addressing modes.  The choices for \fIcpu-type\fR are
 \&\fBka\fR, \fBkb\fR, \fBmc\fR, \fBca\fR, \fBcf\fR,
 \&\fBsa\fR, and \fBsb\fR.
 The default is
@@ -7526,7 +7542,7 @@ exceptions.  For some targets, this implies \s-1GNU\s0 \s-1CC\s0 will generate f
 unwind information for all functions, which can produce significant data
 size overhead, although it does not affect execution.  If you do not
 specify this option, \s-1GNU\s0 \s-1CC\s0 will enable it by default for languages like
-\&\*(C+ which normally require exception handling, and disable itfor
+\&\*(C+ which normally require exception handling, and disable it for
 languages like C that do not normally require it.  However, you may need
 to enable this option when compiling C code that needs to interoperate
 properly with exception handlers written in \*(C+.  You may also wish to
@@ -7579,7 +7595,7 @@ shared between processes running the same program, while private data
 exists in one copy per process.
 .Ip "\fB\-fno-common\fR" 4
 .IX Item "-fno-common"
-Allocate even uninitialized global variables in the data section of the
+In C, allocate even uninitialized global variables in the data section of the
 object file, rather than generating them as common blocks.  This has the
 effect that if the same variable is declared (without \f(CW\*(C`extern\*(C'\fR) in
 two different compilations, you will get an error when you link them.
@@ -7774,9 +7790,11 @@ function and its call site.  (On some platforms,
 function, so the call site information may not be available to the
 profiling functions otherwise.)
 .Sp
-.Vb 2
-\&        void __cyg_profile_func_enter (void *this_fn, void *call_site);
-\&        void __cyg_profile_func_exit  (void *this_fn, void *call_site);
+.Vb 4
+\&        void __cyg_profile_func_enter (void *this_fn,
+\&                                       void *call_site);
+\&        void __cyg_profile_func_exit  (void *this_fn,
+\&                                       void *call_site);
 .Ve
 The first argument is the address of the start of the current function,
 which may be looked up exactly in the symbol table.
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 8b4eb12..0591979 100644
--- a/gcc/doc/invoke.texi
+++ b/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