OSDN Git Service

* config/mips/t-iris6 (CRTSTUFF_T_CFLAGS): Add -Wno-error.
[pf3gnuchains/gcc-fork.git] / gcc / c.opt
index ca0c1d8..4f9859f 100644 (file)
--- a/gcc/c.opt
+++ b/gcc/c.opt
 ; output.  However, if the help text contains a tab character, the
 ; text to the left of the tab is output instead of the switch, and the
 ; text to its right forms the help.  This is useful for elaborating on
-; what type of argument a switch takes, for example.
+; what type of argument a switch takes, for example.  If the second
+; field contains "Undocumented" then nothing is output with --help.
+; Only do this with good reason like the switch being internal between
+; the driver and the front end - it is not an excuse to leave a switch
+; undocumented.
 
 ; Comments can appear on their own line anwhere in the file, preceded
 ; by a semicolon.  Whitespace is permitted before the semicolon.
@@ -87,7 +91,7 @@ C ObjC C++ ObjC++ Joined Separate
 -D<macro>[=<val>]      Define a <macro> with <val> as its value.  If just <macro> is given, <val> is taken to be 1
 
 E
-C ObjC C++ ObjC++
+C ObjC C++ ObjC++ Undocumented
 
 H
 C ObjC C++ ObjC++
@@ -146,16 +150,19 @@ C++ ObjC++
 
 Wall
 C ObjC C++ ObjC++
-Enable most preprocessor warnings
+Enable most warning messages
 
 Wbad-function-cast
 C ObjC
+Warn about casting functions to incompatible types
 
 Wcast-qual
 C ObjC C++ ObjC++
+Warn about casts which discard qualifiers
 
 Wchar-subscripts
 C ObjC C++ ObjC++
+Warn about subscripts whose type is \"char\"
 
 Wcomment
 C ObjC C++ ObjC++
@@ -167,18 +174,27 @@ Synonym for -Wcomment
 
 Wconversion
 C ObjC C++ ObjC++
+Warn about possibly confusing type conversions
 
 Wctor-dtor-privacy
 C++ ObjC++
+Warn when all constructors and destructors are private
+
+Wdeclaration-after-statement
+C ObjC
+Warn when a declaration is found after a statement
 
 Wdeprecated
 C++ ObjC++
+Warn about deprecated compiler features
 
 Wdiv-by-zero
 C ObjC
+Warn about compile-time integer division by zero
 
 Weffc++
 C++ ObjC++
+Warn about violations of Effective C++ style rules
 
 Wendif-labels
 C ObjC C++ ObjC++
@@ -190,24 +206,31 @@ C ObjC C++ ObjC++
 
 Werror-implicit-function-declaration
 C ObjC RejectNegative
+Make implicit function declarations an error
 
 Wfloat-equal
 C ObjC C++ ObjC++
+Warn if testing floating point numbers for equality
 
 Wformat
 C ObjC C++ ObjC++
+Warn about printf/scanf/strftime/strfmon format string anomalies
 
 Wformat-extra-args
 C ObjC C++ ObjC++
+Warn if passing too many arguments to a function for its format string
 
 Wformat-nonliteral
 C ObjC C++ ObjC++
+Warn about format strings that are not literals
 
 Wformat-security
 C ObjC C++ ObjC++
+Warn about possible security problems with format functions
 
 Wformat-y2k
 C ObjC C++ ObjC++
+Warn about strftime formats yielding 2-digit years
 
 Wformat-zero-length
 C ObjC
@@ -215,102 +238,139 @@ C ObjC
 Wformat=
 C ObjC C++ ObjC++ Joined
 
+Winit-self
+C ObjC C++ ObjC++
+Warn about variables which are initialized to themselves.
+
 Wimplicit
 C ObjC C++ ObjC++
 
 Wimplicit-function-declaration
 C ObjC
+Warn about implicit function declarations
 
 Wimplicit-int
 C ObjC
+Warn when a declaration does not specify a type
 
 Wimport
 C ObjC C++ ObjC++
-Warn about uses of the #import directive
+Deprecated.  This switch has no effect.
 
 Winvalid-offsetof
 C++ ObjC++
+Warn about invalid uses of the \"offsetof\" macro
 
 Winvalid-pch
 C ObjC C++ ObjC++
+Warn about PCH files that are found but not used
 
 Wlong-long
 C ObjC C++ ObjC++
+Do not warn about using \"long long\" when -pedantic
 
 Wmain
 C ObjC
+Warn about suspicious declarations of \"main\"
 
 Wmissing-braces
 C ObjC C++ ObjC++
+Warn about possibly missing braces around initializers
 
 Wmissing-declarations
 C ObjC
+Warn about global functions without previous declarations
 
 Wmissing-format-attribute
 C ObjC C++ ObjC++
+Warn about functions which might be candidates for format attributes
 
 Wmissing-prototypes
 C ObjC
+Warn about global functions without prototypes
 
 Wmultichar
 C ObjC C++ ObjC++
+Warn about use of multi-character character constants
 
 Wnested-externs
 C ObjC
+Warn about \"extern\" declarations not at file scope
 
 Wnon-template-friend
 C++ ObjC++
+Warn when non-templatized friend functions are declared within a template
 
 Wnon-virtual-dtor
 C++ ObjC++
+Warn about non-virtual destructors
 
 Wnonnull
 C ObjC
 
 Wold-style-cast
 C++ ObjC++
+Warn if a C-style cast is used in a program
+
+Wold-style-definition
+C ObjC
+Warn if an old-style parameter definition is used
 
 Woverloaded-virtual
 C++ ObjC++
+Warn about overloaded virtual function names
 
 Wparentheses
 C ObjC C++ ObjC++
+Warn about possibly missing parentheses
 
 Wpmf-conversions
 C++ ObjC++
+Warn when converting the type of pointers to member functions
 
 Wpointer-arith
 C ObjC C++ ObjC++
+Warn about function pointer arithmetic
 
 Wprotocol
 ObjC ObjC++
+Warn if inherited methods are unimplemented
 
 Wredundant-decls
 C ObjC C++ ObjC++
+Warn about multiple declarations of the same object
 
 Wreorder
 C++ ObjC++
+Warn when the compiler reorders code
 
 Wreturn-type
 C ObjC C++ ObjC++
+Warn whenever a function's return type defaults to \"int\" (C), or about inconsistent return types (C++)
 
 Wselector
 ObjC ObjC++
+Warn if a selector has multiple methods
 
 Wsequence-point
 C ObjC
+Warn about possible violations of sequence point rules
 
 Wsign-compare
 C ObjC C++ ObjC++
+Warn about signed-unsigned comparisons
 
 Wsign-promo
 C++ ObjC++
+Warn when overload promotes from unsigned to signed
 
 Wstrict-prototypes
 C ObjC
+Warn about unprototyped function declarations
 
 Wsynth
 C++ ObjC++
+Warn when synthesis behavior differs from Cfront
 
 Wsystem-headers
 C ObjC C++ ObjC++
@@ -333,6 +393,7 @@ Warn if an undefined macro is used in an #if directive
 
 Wunknown-pragmas
 C ObjC C++ ObjC++
+Warn about unrecognized pragmas
 
 Wunused-macros
 C ObjC C++ ObjC++
@@ -340,9 +401,11 @@ Warn about macros defined in the main file that are not used
 
 Wwrite-strings
 C ObjC C++ ObjC++
+Give strings the type \"array of char\"
 
 ansi
 C ObjC C++ ObjC++
+A synonym for -std=c89.  In a future version of GCC it will become synonymous with -std=c99 instead
 
 d
 C ObjC C++ ObjC++ Joined
@@ -353,39 +416,49 @@ C++ ObjC++ Joined UInteger
 
 faccess-control
 C++ ObjC++
+Enforce class member access control semantics
 
 fall-virtual
 C++ ObjC++
 
 falt-external-templates
 C++ ObjC++
+Change when template instances are emitted
 
 fasm
 C ObjC C++ ObjC++
+Recognize the \"asm\" keyword
 
 fbuiltin
 C ObjC C++ ObjC++
+Recognize built-in functions
 
 fbuiltin-
 C ObjC C++ ObjC++ Joined
 
 fcheck-new
 C++ ObjC++
+Check the return value of new
 
 fcond-mismatch
 C ObjC C++ ObjC++
+Allow the arguments of the '?' operator to have different types
 
 fconserve-space
 C++ ObjC++
+Reduce the size of object files
 
 fconst-strings
 C++ ObjC++
+Make string literals \"const char[]\" not \"char[]\"
 
 fconstant-string-class=
 ObjC ObjC++ Joined
+-fconst-string-class=<name>    Use class <name> for constant strings
 
 fdefault-inline
 C++ ObjC++
+Inline member functions by default
 
 fdollars-in-identifiers
 C ObjC C++ ObjC++
@@ -393,12 +466,14 @@ Permit '$' as an identifier character
 
 fdump-
 C ObjC C++ ObjC++ Joined RejectNegative
+-fdump-<type>  Dump various compiler internals to a file
 
 felide-constructors
 C++ ObjC++
 
 fenforce-eh-specs
 C++ ObjC++
+Generate code to check exception specifications
 
 fenum-int-equiv
 C++ ObjC++
@@ -418,15 +493,19 @@ C ObjC Joined
 
 ffor-scope
 C++ ObjC++
+Scope of for-init-statement variables is local to the loop
 
 ffreestanding
 C ObjC
+Do not assume that standard C libraries and \"main\" exist
 
 fgnu-keywords
 C++ ObjC++
+Recognize GNU-defined keywords
 
 fgnu-runtime
 ObjC ObjC++
+Generate code for GNU runtime environment
 
 fguiding-decls
 C++ ObjC++
@@ -439,24 +518,30 @@ C++ ObjC++
 
 fhosted
 C ObjC
+Assume normal C execution environment
 
 fhuge-objects
 C++ ObjC++
+Enable support for huge objects
 
 fimplement-inlines
 C++ ObjC++
+Export functions even if they can be inlined
 
 fimplicit-inline-templates
 C++ ObjC++
+Emit implicit instantiations of inline templates
 
 fimplicit-templates
 C++ ObjC++
+Emit implicit instantiations of templates
 
 flabels-ok
 C++ ObjC++
 
 fms-extensions
 C ObjC C++ ObjC++
+Don't warn about uses of Microsoft extensions
 
 fname-mangling-version-
 C++ ObjC++ Joined
@@ -466,6 +551,11 @@ C++ ObjC++
 
 fnext-runtime
 ObjC ObjC++
+Generate code for NeXT (Apple Mac OS X) runtime environment
+
+fnil-receivers
+ObjC ObjC++
+Assume that receivers of Objective-C messages may be nil
 
 fnonansi-builtins
 C++ ObjC++
@@ -473,51 +563,70 @@ C++ ObjC++
 fnonnull-objects
 C++ ObjC++
 
+fobjc-exceptions
+ObjC ObjC++
+Enable Objective-C exception and synchronization syntax
+
 foperator-names
 C++ ObjC++
+Recognize C++ kewords like \"compl\" and \"xor\"
 
 foptional-diags
 C++ ObjC++
+Enable optional diagnostics
 
 fpch-deps
 C ObjC C++ ObjC++
 
 fpermissive
 C++ ObjC++
+Downgrade conformance errors to warnings
 
 fpreprocessed
 C ObjC C++ ObjC++
 Treat the input file as already preprocessed
 
+freplace-objc-classes
+ObjC ObjC++
+Used in Fix-and-Continue mode to indicate that object files may be swapped in at runtime
+
 frepo
 C++ ObjC++
+Enable automatic template instantiation
 
 frtti
 C++ ObjC++
+Generate run time type descriptor information
 
 fshort-double
 C ObjC C++ ObjC++
+Use the same size for double as for float
 
 fshort-enums
 C ObjC C++ ObjC++
+Use the narrowest integer type possible for enumeration types
 
 fshort-wchar
 C ObjC C++ ObjC++
+Force the underlying type for \"wchar_t\" to be \"unsigned short\"
 
 fshow-column
 C ObjC C++ ObjC++
 
 fsigned-bitfields
 C ObjC C++ ObjC++
+When \"signed\" or \"unsigned\" is not given make the bitfield signed
 
 fsigned-char
 C ObjC C++ ObjC++
+Make \"char\" signed by default
 
 fsquangle
 C++ ObjC++
 
 fstats
 C++ ObjC++
+Display statistics accumulated during compilation
 
 fstrict-prototype
 C++ ObjC++
@@ -528,37 +637,54 @@ C ObjC C++ ObjC++ Joined RejectNegative UInteger
 
 ftemplate-depth-
 C++ ObjC++ Joined RejectNegative UInteger 
+-ftemplate-depth-<number>      Specify maximum template instantiation depth
 
 fthis-is-variable
 C++ ObjC++
 
 funsigned-bitfields
 C ObjC C++ ObjC++
+When \"signed\" or \"unsigned\" is not given make the bitfield unsigned
 
 funsigned-char
 C ObjC C++ ObjC++
+Make \"char\" unsigned by default
 
 fuse-cxa-atexit
 C++ ObjC++
+Use __cxa_atexit to register destructors
 
 fvtable-gc
 C++ ObjC++
+Discard unused virtual functions
 
 fvtable-thunks
 C++ ObjC++
+Implement vtables using thunks
 
 fweak
 C++ ObjC++
+Emit common-like symbols as weak symbols
 
 fwide-exec-charset=
 C ObjC C++ ObjC++ Joined RejectNegative
 -fwide-exec-charset=<cset>     Convert all wide strings and character constants to character set <cset>
 
+fworking-directory
+C ObjC C++ ObjC++
+Generate a #line directive pointing at the current working directory
+
 fxref
 C++ ObjC++
+Emit cross referencing information
+
+fzero-link
+ObjC ObjC++
+Generate lazy class lookup (via objc_getClass()) for use in Zero-Link mode
 
 gen-decls
 ObjC ObjC++
+Dump declarations to a .decl file
 
 idirafter
 C ObjC C++ ObjC++ Joined Separate
@@ -593,12 +719,10 @@ C ObjC C++ ObjC++ Joined Separate
 -iwithprefixbefore <dir>       Add <dir> to the end of the main include path
 
 lang-asm
-C
-For internal use only
+C Undocumented
 
 lang-objc
-C ObjC C++ ObjC++
-For internal use only
+C ObjC C++ ObjC++ Undocumented
 
 nostdinc
 C ObjC C++ ObjC++
@@ -622,6 +746,7 @@ C ObjC C++ ObjC++
 
 print-objc-runtime-info
 ObjC ObjC++
+Generate C header of platform-specific features
 
 remap
 C ObjC C++ ObjC++