]> git.ipfire.org Git - thirdparty/gcc.git/blame - gcc/c.opt
re PR tree-optimization/37258 (ice in simplify_subreg, at simplify-rtx.c:4957)
[thirdparty/gcc.git] / gcc / c.opt
CommitLineData
fef3106c 1; Options for the C, ObjC, C++ and ObjC++ front ends.
da1c7394 2; Copyright (C) 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
fef3106c
NB
3;
4; This file is part of GCC.
5;
6; GCC is free software; you can redistribute it and/or modify it under
7; the terms of the GNU General Public License as published by the Free
9dcd6f09 8; Software Foundation; either version 3, or (at your option) any later
fef3106c 9; version.
c22cacf3 10;
fef3106c
NB
11; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12; WARRANTY; without even the implied warranty of MERCHANTABILITY or
13; FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14; for more details.
c22cacf3 15;
fef3106c 16; You should have received a copy of the GNU General Public License
9dcd6f09
NC
17; along with GCC; see the file COPYING3. If not see
18; <http://www.gnu.org/licenses/>.
fef3106c 19
8abb6b22 20; See the GCC internals manual for a description of this file's format.
fef3106c 21
fef3106c
NB
22; Please try to keep this file in ASCII collating order.
23
be43ab4e
NB
24Language
25C
26
27Language
28ObjC
29
30Language
31C++
32
33Language
34ObjC++
35
fef3106c
NB
36-output-pch=
37C ObjC C++ ObjC++ Joined Separate
38
39A
40C ObjC C++ ObjC++ Joined Separate
72de27ea 41-A<question>=<answer> Assert the <answer> to <question>. Putting '-' before <question> disables the <answer> to <question>
fef3106c
NB
42
43C
44C ObjC C++ ObjC++
72de27ea 45Do not discard comments
fef3106c
NB
46
47CC
48C ObjC C++ ObjC++
72de27ea 49Do not discard comments in macro expansions
fef3106c
NB
50
51D
52C ObjC C++ ObjC++ Joined Separate
72de27ea 53-D<macro>[=<val>] Define a <macro> with <val> as its value. If just <macro> is given, <val> is taken to be 1
fef3106c
NB
54
55E
f2ac9964 56C ObjC C++ ObjC++ Undocumented
fef3106c 57
94d1613b
MS
58F
59C ObjC C++ ObjC++ Joined Separate
4e994432 60-F <dir> Add <dir> to the end of the main framework include path
94d1613b 61
fef3106c
NB
62H
63C ObjC C++ ObjC++
72de27ea 64Print the name of header files as they are used
fef3106c
NB
65
66I
67C ObjC C++ ObjC++ Joined Separate
4bed3787 68-I <dir> Add <dir> to the end of the main include path
fef3106c
NB
69
70M
71C ObjC C++ ObjC++
72de27ea 72Generate make dependencies
fef3106c
NB
73
74MD
75C ObjC C++ ObjC++ Separate
72de27ea 76Generate make dependencies and compile
fef3106c
NB
77
78MF
79C ObjC C++ ObjC++ Joined Separate
72de27ea 80-MF <file> Write dependency output to the given file
fef3106c
NB
81
82MG
83C ObjC C++ ObjC++
72de27ea 84Treat missing header files as generated files
fef3106c
NB
85
86MM
87C ObjC C++ ObjC++
72de27ea 88Like -M but ignore system header files
fef3106c
NB
89
90MMD
91C ObjC C++ ObjC++ Separate
72de27ea 92Like -MD but ignore system header files
fef3106c
NB
93
94MP
95C ObjC C++ ObjC++
72de27ea 96Generate phony targets for all headers
fef3106c
NB
97
98MQ
99C ObjC C++ ObjC++ Joined Separate
72de27ea 100-MQ <target> Add a MAKE-quoted target
fef3106c
NB
101
102MT
103C ObjC C++ ObjC++ Joined Separate
72de27ea 104-MT <target> Add an unquoted target
fef3106c
NB
105
106P
107C ObjC C++ ObjC++
72de27ea 108Do not generate #line directives
fef3106c
NB
109
110U
111C ObjC C++ ObjC++ Joined Separate
72de27ea 112-U<macro> Undefine <macro>
fef3106c
NB
113
114Wabi
c662432e 115C++ ObjC++ Var(warn_abi) Warning
7619c085 116Warn about things that will change when compiling with an ABI-compliant compiler
fef3106c 117
c116cd05
MLI
118Waddress
119C ObjC C++ ObjC++ Var(warn_address) Warning
120Warn about suspicious uses of memory addresses
121
fef3106c 122Wall
c662432e 123C ObjC C++ ObjC++ Warning
5a170a05 124Enable most warning messages
fef3106c 125
6e955430 126Wassign-intercept
c662432e 127ObjC ObjC++ Var(warn_assign_intercept) Warning
6e955430
ZL
128Warn whenever an Objective-C assignment is being intercepted by the garbage collector
129
fef3106c 130Wbad-function-cast
c662432e 131C ObjC Var(warn_bad_function_cast) Warning
5a170a05 132Warn about casting functions to incompatible types
fef3106c 133
b7e20b53 134Wc++-compat
2cbac420 135C ObjC Var(warn_cxx_compat) Warning
b7e20b53
GDR
136Warn about C constructs that are not in the common subset of C and C++
137
e1f1ee86 138Wc++0x-compat
21af5cdf 139C++ ObjC++ Var(warn_cxx0x_compat) Warning
e1f1ee86 140Warn about C++ constructs whose meaning differs between ISO C++ 1998 and ISO C++ 200x
b7e20b53 141
fef3106c 142Wcast-qual
c662432e 143C ObjC C++ ObjC++ Var(warn_cast_qual) Warning
5a170a05 144Warn about casts which discard qualifiers
fef3106c
NB
145
146Wchar-subscripts
c662432e 147C ObjC C++ ObjC++ Var(warn_char_subscripts) Warning
5a170a05 148Warn about subscripts whose type is \"char\"
fef3106c 149
2b001724 150Wclobbered
c662432e 151C ObjC C++ ObjC++ Var(warn_clobbered) Init(-1) Warning
2b001724
MLI
152Warn about variables that might be changed by \"longjmp\" or \"vfork\"
153
fef3106c 154Wcomment
c662432e 155C ObjC C++ ObjC++ Warning
72de27ea 156Warn about possibly nested block comments, and C++ comments spanning more than one physical line
fef3106c
NB
157
158Wcomments
c662432e 159C ObjC C++ ObjC++ Warning
72de27ea 160Synonym for -Wcomment
fef3106c
NB
161
162Wconversion
c662432e 163C ObjC C++ ObjC++ Var(warn_conversion) Warning
05170031 164Warn for implicit type conversions that may change a value
fef3106c 165
7060db96
MLI
166Wsign-conversion
167C ObjC C++ ObjC++ Var(warn_sign_conversion) Init(-1)
168Warn for implicit type conversions between signed and unsigned integers
169
fef3106c 170Wctor-dtor-privacy
c662432e 171C++ ObjC++ Var(warn_ctor_dtor_privacy) Warning
bae92bf3 172Warn when all constructors and destructors are private
fef3106c 173
85617eba 174Wdeclaration-after-statement
c662432e 175C ObjC Var(warn_declaration_after_statement) Warning
85617eba
HPN
176Warn when a declaration is found after a statement
177
fef3106c 178Wdeprecated
899015a0 179C C++ ObjC ObjC++ Var(warn_deprecated) Init(1) Warning
bae92bf3 180Warn about deprecated compiler features
fef3106c
NB
181
182Wdiv-by-zero
2cbac420 183C ObjC C++ ObjC++ Var(warn_div_by_zero) Init(1) Warning
5a170a05 184Warn about compile-time integer division by zero
fef3106c
NB
185
186Weffc++
c662432e 187C++ ObjC++ Var(warn_ecpp) Warning
bae92bf3 188Warn about violations of Effective C++ style rules
fef3106c 189
b3b433c5 190Wempty-body
c662432e 191C ObjC C++ ObjC++ Var(warn_empty_body) Init(-1) Warning
b3b433c5
MLI
192Warn about an empty body in an if or else statement
193
fef3106c 194Wendif-labels
c662432e 195C ObjC C++ ObjC++ Warning
72de27ea 196Warn about stray tokens after #elif and #endif
fef3106c 197
a3299096
MM
198Wenum-compare
199C++ ObjC++ Var(warn_enum_compare) Init(1) Warning
200Warn about comparison of different enum types
201
fef3106c
NB
202Werror
203C ObjC C++ ObjC++
72de27ea 204; Documented in common.opt
fef3106c
NB
205
206Werror-implicit-function-declaration
c662432e 207C ObjC RejectNegative Warning
dc90f45b 208This switch is deprecated; use -Werror=implicit-function-declaration instead
fef3106c
NB
209
210Wfloat-equal
c662432e 211C ObjC C++ ObjC++ Var(warn_float_equal) Warning
5a170a05 212Warn if testing floating point numbers for equality
fef3106c
NB
213
214Wformat
c662432e 215C ObjC C++ ObjC++ Warning
5a170a05 216Warn about printf/scanf/strftime/strfmon format string anomalies
fef3106c
NB
217
218Wformat-extra-args
c662432e 219C ObjC C++ ObjC++ Var(warn_format_extra_args) Warning
5a170a05 220Warn if passing too many arguments to a function for its format string
fef3106c
NB
221
222Wformat-nonliteral
c662432e 223C ObjC C++ ObjC++ Var(warn_format_nonliteral) Warning
5a170a05 224Warn about format strings that are not literals
fef3106c 225
ca178f85 226Wformat-contains-nul
6d16b6e7 227C ObjC C++ ObjC++ Var(warn_format_contains_nul) Warning
ca178f85
BK
228Warn about format strings that contain NUL bytes
229
fef3106c 230Wformat-security
c662432e 231C ObjC C++ ObjC++ Var(warn_format_security) Warning
5a170a05 232Warn about possible security problems with format functions
fef3106c
NB
233
234Wformat-y2k
c662432e 235C ObjC C++ ObjC++ Var(warn_format_y2k) Warning
5a170a05 236Warn about strftime formats yielding 2-digit years
fef3106c
NB
237
238Wformat-zero-length
c662432e 239C ObjC Var(warn_format_zero_length) Warning
7619c085 240Warn about zero-length formats
fef3106c
NB
241
242Wformat=
c662432e 243C ObjC C++ ObjC++ Joined Warning
fef3106c 244
5db2e9ca
DK
245Wignored-qualifiers
246C C++ Var(warn_ignored_qualifiers) Init(-1) Warning
247Warn whenever type qualifiers are ignored.
248
3390f9c9 249Winit-self
c662432e 250C ObjC C++ ObjC++ Var(warn_init_self) Warning
ab532386 251Warn about variables which are initialized to themselves
3390f9c9 252
fef3106c 253Wimplicit
c662432e 254C ObjC C++ ObjC++ Warning
fef3106c
NB
255
256Wimplicit-function-declaration
dc90f45b 257C ObjC Var(warn_implicit_function_declaration) Init(-1) Warning
5a170a05 258Warn about implicit function declarations
fef3106c
NB
259
260Wimplicit-int
c662432e 261C ObjC Var(warn_implicit_int) Warning
5a170a05 262Warn when a declaration does not specify a type
fef3106c
NB
263
264Wimport
c24d4112 265C ObjC C++ ObjC++ Undocumented
fef3106c 266
53a2494e 267Wint-to-pointer-cast
c662432e 268C ObjC Var(warn_int_to_pointer_cast) Init(1) Warning
53a2494e
JM
269Warn when there is a cast to a pointer from an integer of a different size
270
fef3106c 271Winvalid-offsetof
c662432e 272C++ ObjC++ Var(warn_invalid_offsetof) Init(1) Warning
bae92bf3 273Warn about invalid uses of the \"offsetof\" macro
fef3106c
NB
274
275Winvalid-pch
c662432e 276C ObjC C++ ObjC++ Warning
5a170a05 277Warn about PCH files that are found but not used
fef3106c
NB
278
279Wlong-long
c662432e 280C ObjC C++ ObjC++ Var(warn_long_long) Init(1) Warning
5a170a05 281Do not warn about using \"long long\" when -pedantic
fef3106c
NB
282
283Wmain
4003301d 284C ObjC C++ ObjC++ Var(warn_main) Init(-1) Warning
5a170a05 285Warn about suspicious declarations of \"main\"
fef3106c
NB
286
287Wmissing-braces
c662432e 288C ObjC C++ ObjC++ Var(warn_missing_braces) Warning
5a170a05 289Warn about possibly missing braces around initializers
fef3106c
NB
290
291Wmissing-declarations
c662432e 292C ObjC C++ ObjC++ Var(warn_missing_declarations) Warning
5a170a05 293Warn about global functions without previous declarations
fef3106c 294
eaac4679 295Wmissing-field-initializers
c662432e 296C ObjC C++ ObjC++ Var(warn_missing_field_initializers) Init(-1) Warning
eaac4679
RS
297Warn about missing fields in struct initializers
298
fef3106c 299Wmissing-format-attribute
c662432e 300C ObjC C++ ObjC++ Var(warn_missing_format_attribute) Warning
5a170a05 301Warn about functions which might be candidates for format attributes
fef3106c 302
b02398bd 303Wmissing-include-dirs
c662432e 304C ObjC C++ ObjC++ Warning
b02398bd
BE
305Warn about user-specified include directories that do not exist
306
cb4af25a 307Wmissing-parameter-type
c662432e 308C ObjC Var(warn_missing_parameter_type) Init(-1) Warning
cb4af25a
MLI
309Warn about function parameters declared without a type specifier in K&R-style functions
310
fef3106c 311Wmissing-prototypes
c662432e 312C ObjC Var(warn_missing_prototypes) Warning
5a170a05 313Warn about global functions without prototypes
fef3106c
NB
314
315Wmultichar
c662432e 316C ObjC C++ ObjC++ Warning
5a170a05 317Warn about use of multi-character character constants
fef3106c
NB
318
319Wnested-externs
c662432e 320C ObjC Var(warn_nested_externs) Warning
5a170a05 321Warn about \"extern\" declarations not at file scope
fef3106c
NB
322
323Wnon-template-friend
c662432e 324C++ ObjC++ Var(warn_nontemplate_friend) Init(1) Warning
bae92bf3 325Warn when non-templatized friend functions are declared within a template
fef3106c
NB
326
327Wnon-virtual-dtor
c662432e 328C++ ObjC++ Var(warn_nonvdtor) Warning
bae92bf3 329Warn about non-virtual destructors
fef3106c
NB
330
331Wnonnull
c662432e 332C ObjC Var(warn_nonnull) Warning
7619c085 333Warn about NULL being passed to argument slots marked as requiring non-NULL
fef3106c 334
50668cf6 335Wnormalized=
c662432e 336C ObjC C++ ObjC++ Joined Warning
50668cf6
GK
337-Wnormalized=<id|nfc|nfkc> Warn about non-normalised Unicode strings
338
fef3106c 339Wold-style-cast
c662432e 340C++ ObjC++ Var(warn_old_style_cast) Warning
bae92bf3 341Warn if a C-style cast is used in a program
fef3106c 342
b1ed4cb4 343Wold-style-declaration
c662432e 344C ObjC Var(warn_old_style_declaration) Init(-1) Warning
b1ed4cb4
MLI
345Warn for obsolescent usage in a declaration
346
c034f121 347Wold-style-definition
c662432e 348C ObjC Var(warn_old_style_definition) Warning
c034f121
AJ
349Warn if an old-style parameter definition is used
350
89a42ac8 351Woverlength-strings
c662432e 352C ObjC C++ ObjC++ Var(warn_overlength_strings) Init(-1) Warning
89a42ac8
ZW
353Warn if a string is longer than the maximum portable length specified by the standard
354
fef3106c 355Woverloaded-virtual
c662432e 356C++ ObjC++ Var(warn_overloaded_virtual) Warning
bae92bf3 357Warn about overloaded virtual function names
fef3106c 358
7ed322d7 359Woverride-init
c662432e 360C ObjC Var(warn_override_init) Init(-1) Warning
7ed322d7
JM
361Warn about overriding initializers without side effects
362
fef3106c 363Wparentheses
c662432e 364C ObjC C++ ObjC++ Var(warn_parentheses) Warning
5a170a05 365Warn about possibly missing parentheses
fef3106c
NB
366
367Wpmf-conversions
c662432e 368C++ ObjC++ Var(warn_pmf2ptr) Init(1) Warning
bae92bf3 369Warn when converting the type of pointers to member functions
fef3106c
NB
370
371Wpointer-arith
c662432e 372C ObjC C++ ObjC++ Var(warn_pointer_arith) Warning
5a170a05 373Warn about function pointer arithmetic
fef3106c 374
53a2494e 375Wpointer-to-int-cast
c662432e 376C ObjC Var(warn_pointer_to_int_cast) Init(1) Warning
53a2494e
JM
377Warn when a pointer is cast to an integer of a different size
378
b9b8dde3 379Wpragmas
c662432e 380C ObjC C++ ObjC++ Var(warn_pragmas) Init(1) Warning
b9b8dde3
DD
381Warn about misuses of pragmas
382
fef3106c 383Wprotocol
c662432e 384ObjC ObjC++ Var(warn_protocol) Init(1) Warning
f2ac9964 385Warn if inherited methods are unimplemented
fef3106c
NB
386
387Wredundant-decls
c662432e 388C ObjC C++ ObjC++ Var(warn_redundant_decls) Warning
5a170a05 389Warn about multiple declarations of the same object
fef3106c
NB
390
391Wreorder
c662432e 392C++ ObjC++ Var(warn_reorder) Warning
bae92bf3 393Warn when the compiler reorders code
fef3106c
NB
394
395Wreturn-type
c662432e 396C ObjC C++ ObjC++ Var(warn_return_type) Warning
bae92bf3 397Warn whenever a function's return type defaults to \"int\" (C), or about inconsistent return types (C++)
fef3106c
NB
398
399Wselector
c662432e 400ObjC ObjC++ Var(warn_selector) Warning
f2ac9964 401Warn if a selector has multiple methods
fef3106c
NB
402
403Wsequence-point
c662432e 404C ObjC C++ ObjC++ Var(warn_sequence_point) Warning
5a170a05 405Warn about possible violations of sequence point rules
fef3106c
NB
406
407Wsign-compare
c662432e 408C ObjC C++ ObjC++ Var(warn_sign_compare) Init(-1) Warning
5a170a05 409Warn about signed-unsigned comparisons
fef3106c
NB
410
411Wsign-promo
c662432e 412C++ ObjC++ Var(warn_sign_promo) Warning
bae92bf3 413Warn when overload promotes from unsigned to signed
fef3106c 414
b2f97e4a 415Wstrict-null-sentinel
c662432e 416C++ ObjC++ Warning
b2f97e4a
MM
417Warn about uncasted NULL used as sentinel
418
fef3106c 419Wstrict-prototypes
c662432e 420C ObjC Var(warn_strict_prototypes) Warning
5a170a05 421Warn about unprototyped function declarations
fef3106c 422
6e955430 423Wstrict-selector-match
c662432e 424ObjC ObjC++ Var(warn_strict_selector_match) Warning
6e955430
ZL
425Warn if type signatures of candidate methods do not match exactly
426
fef3106c 427Wsynth
c662432e 428C++ ObjC++ Var(warn_synth) Warning
802e3f8c 429Deprecated. This switch has no effect
fef3106c
NB
430
431Wsystem-headers
c662432e 432C ObjC C++ ObjC++ Warning
72de27ea 433Do not suppress warnings from system headers
fef3106c
NB
434
435Wtraditional
c662432e 436C ObjC Var(warn_traditional) Warning
72de27ea 437Warn about features not present in traditional C
fef3106c 438
05170031 439Wtraditional-conversion
c662432e 440C ObjC Var(warn_traditional_conversion) Warning
05170031
MLI
441Warn of prototypes causing type conversions different from what would happen in the absence of prototype
442
fef3106c 443Wtrigraphs
c662432e 444C ObjC C++ ObjC++ Warning
72de27ea 445Warn if trigraphs are encountered that might affect the meaning of the program
fef3106c
NB
446
447Wundeclared-selector
c662432e 448ObjC ObjC++ Var(warn_undeclared_selector) Warning
7619c085 449Warn about @selector()s without previously declared methods
fef3106c
NB
450
451Wundef
c662432e 452C ObjC C++ ObjC++ Warning
72de27ea 453Warn if an undefined macro is used in an #if directive
fef3106c
NB
454
455Wunknown-pragmas
c662432e 456C ObjC C++ ObjC++ Warning
5a170a05 457Warn about unrecognized pragmas
fef3106c
NB
458
459Wunused-macros
c662432e 460C ObjC C++ ObjC++ Warning
72de27ea 461Warn about macros defined in the main file that are not used
fef3106c 462
e5b79219 463Wvariadic-macros
c662432e 464C ObjC C++ ObjC++ Warning
e5b79219
RH
465Do not warn about using variadic macros when -pedantic
466
50d50fc7
SP
467Wvla
468C ObjC C++ ObjC++ Var(warn_vla) Init(-1) Warning
469Warn if a variable length array is used
470
16302daf
MLI
471Wvolatile-register-var
472C ObjC C++ ObjC++ Var(warn_volatile_register_var) Warning
473Warn when a register variable is declared volatile
474
fef3106c 475Wwrite-strings
c662432e 476C ObjC C++ ObjC++ Var(warn_write_strings) Warning
d539b114 477In C++, nonzero means warn about deprecated conversion from string literals to `char *'. In C, similar warning, except that the conversion is of course not deprecated by the ISO C standard.
fef3106c 478
f2fd3821 479Wpointer-sign
c662432e 480C ObjC Var(warn_pointer_sign) Init(-1) Warning
c85ce869 481Warn when a pointer differs in signedness in an assignment
f2fd3821 482
fef3106c
NB
483ansi
484C ObjC C++ ObjC++
c85ce869 485A synonym for -std=c89 (for C) or -std=c++98 (for C++)
fef3106c
NB
486
487d
488C ObjC C++ ObjC++ Joined
72de27ea 489; Documented in common.opt. FIXME - what about -dI, -dD, -dN and -dD?
fef3106c 490
fef3106c
NB
491faccess-control
492C++ ObjC++
bae92bf3 493Enforce class member access control semantics
fef3106c
NB
494
495fall-virtual
496C++ ObjC++
497
498falt-external-templates
499C++ ObjC++
bae92bf3 500Change when template instances are emitted
fef3106c
NB
501
502fasm
503C ObjC C++ ObjC++
5a170a05 504Recognize the \"asm\" keyword
fef3106c
NB
505
506fbuiltin
507C ObjC C++ ObjC++
5a170a05 508Recognize built-in functions
fef3106c
NB
509
510fbuiltin-
511C ObjC C++ ObjC++ Joined
512
513fcheck-new
514C++ ObjC++
bae92bf3 515Check the return value of new
fef3106c
NB
516
517fcond-mismatch
518C ObjC C++ ObjC++
5a170a05 519Allow the arguments of the '?' operator to have different types
fef3106c
NB
520
521fconserve-space
522C++ ObjC++
bae92bf3 523Reduce the size of object files
fef3106c 524
fef3106c
NB
525fconstant-string-class=
526ObjC ObjC++ Joined
f2ac9964 527-fconst-string-class=<name> Use class <name> for constant strings
fef3106c
NB
528
529fdefault-inline
530C++ ObjC++
bae92bf3 531Inline member functions by default
fef3106c 532
ccfc4c91
OW
533fdirectives-only
534C ObjC C++ ObjC++
535Preprocess directives only.
536
fef3106c
NB
537fdollars-in-identifiers
538C ObjC C++ ObjC++
72de27ea 539Permit '$' as an identifier character
fef3106c 540
fef3106c
NB
541felide-constructors
542C++ ObjC++
543
544fenforce-eh-specs
545C++ ObjC++
bae92bf3 546Generate code to check exception specifications
fef3106c
NB
547
548fenum-int-equiv
549C++ ObjC++
550
e6cc3a24
ZW
551fexec-charset=
552C ObjC C++ ObjC++ Joined RejectNegative
72de27ea 553-fexec-charset=<cset> Convert all strings and character constants to character set <cset>
e6cc3a24 554
af15a2fe
JM
555fextended-identifiers
556C ObjC C++ ObjC++
557Permit universal character names (\\u and \\U) in identifiers
558
16dd5cfe
EC
559finput-charset=
560C ObjC C++ ObjC++ Joined RejectNegative
c85ce869 561-finput-charset=<cset> Specify the default character set for source files
16dd5cfe
EC
562
563
fef3106c
NB
564fexternal-templates
565C++ ObjC++
566
fef3106c
NB
567ffor-scope
568C++ ObjC++
bae92bf3 569Scope of for-init-statement variables is local to the loop
fef3106c
NB
570
571ffreestanding
820b51ae 572C ObjC C++ ObjC++
5a170a05 573Do not assume that standard C libraries and \"main\" exist
fef3106c
NB
574
575fgnu-keywords
576C++ ObjC++
bae92bf3 577Recognize GNU-defined keywords
fef3106c
NB
578
579fgnu-runtime
580ObjC ObjC++
f2ac9964 581Generate code for GNU runtime environment
fef3106c 582
da1c7394 583fgnu89-inline
2cbac420 584C ObjC Var(flag_gnu89_inline) Init(-1)
da1c7394
ILT
585Use traditional GNU semantics for inline functions
586
fef3106c
NB
587fguiding-decls
588C++ ObjC++
589
590fhandle-exceptions
c662432e 591C++ ObjC++ Optimization
fef3106c
NB
592
593fhonor-std
594C++ ObjC++
595
596fhosted
597C ObjC
5a170a05 598Assume normal C execution environment
fef3106c
NB
599
600fhuge-objects
601C++ ObjC++
bae92bf3 602Enable support for huge objects
fef3106c
NB
603
604fimplement-inlines
605C++ ObjC++
bae92bf3 606Export functions even if they can be inlined
fef3106c
NB
607
608fimplicit-inline-templates
609C++ ObjC++
bae92bf3 610Emit implicit instantiations of inline templates
fef3106c
NB
611
612fimplicit-templates
613C++ ObjC++
bae92bf3 614Emit implicit instantiations of templates
fef3106c 615
d63d5d0c 616ffriend-injection
2cbac420 617C++ ObjC++ Var(flag_friend_injection)
d63d5d0c
ILT
618Inject friend functions into enclosing namespace
619
fef3106c
NB
620flabels-ok
621C++ ObjC++
622
00c8e9f6
MS
623flax-vector-conversions
624C ObjC C++ ObjC++
625Allow implicit conversions between vectors with differing numbers of subparts and/or differing element types.
626
fef3106c
NB
627fms-extensions
628C ObjC C++ ObjC++
bae92bf3 629Don't warn about uses of Microsoft extensions
fef3106c
NB
630
631fname-mangling-version-
632C++ ObjC++ Joined
633
634fnew-abi
635C++ ObjC++
636
637fnext-runtime
638ObjC ObjC++
264fa2db
ZL
639Generate code for NeXT (Apple Mac OS X) runtime environment
640
641fnil-receivers
642ObjC ObjC++
643Assume that receivers of Objective-C messages may be nil
fef3106c
NB
644
645fnonansi-builtins
646C++ ObjC++
647
648fnonnull-objects
649C++ ObjC++
650
6e955430
ZL
651; Generate special '- .cxx_construct' and '- .cxx_destruct' methods
652; to initialize any non-POD ivars in Objective-C++ classes.
653fobjc-call-cxx-cdtors
654ObjC++ Var(flag_objc_call_cxx_cdtors)
655Generate special Objective-C methods to initialize/destroy non-POD C++ ivars, if needed
656
657fobjc-direct-dispatch
658ObjC ObjC++ Var(flag_objc_direct_dispatch)
659Allow fast jumps to the message dispatcher
660
661; Nonzero means that we will allow new ObjC exception syntax (@throw,
662; @try, etc.) in source code.
264fa2db 663fobjc-exceptions
6e955430 664ObjC ObjC++ Var(flag_objc_exceptions)
264fa2db
ZL
665Enable Objective-C exception and synchronization syntax
666
6e955430
ZL
667fobjc-gc
668ObjC ObjC++ Var(flag_objc_gc)
669Enable garbage collection (GC) in Objective-C/Objective-C++ programs
670
671; Nonzero means that we generate NeXT setjmp based exceptions.
093c7153 672fobjc-sjlj-exceptions
6e955430 673ObjC ObjC++ Var(flag_objc_sjlj_exceptions) Init(-1)
093c7153
RH
674Enable Objective-C setjmp exception handling runtime
675
953ff289
DN
676fopenmp
677C ObjC C++ ObjC++ Var(flag_openmp)
678Enable OpenMP
679
fef3106c
NB
680foperator-names
681C++ ObjC++
1cbc62c0 682Recognize C++ keywords like \"compl\" and \"xor\"
fef3106c
NB
683
684foptional-diags
685C++ ObjC++
bae92bf3 686Enable optional diagnostics
fef3106c
NB
687
688fpch-deps
689C ObjC C++ ObjC++
690
c0d578e6
GK
691fpch-preprocess
692C ObjC C++ ObjC++
693Look for and use PCH files even when preprocessing
694
fef3106c
NB
695fpermissive
696C++ ObjC++
bae92bf3 697Downgrade conformance errors to warnings
fef3106c
NB
698
699fpreprocessed
700C ObjC C++ ObjC++
72de27ea 701Treat the input file as already preprocessed
fef3106c 702
264fa2db
ZL
703freplace-objc-classes
704ObjC ObjC++
705Used in Fix-and-Continue mode to indicate that object files may be swapped in at runtime
706
fef3106c
NB
707frepo
708C++ ObjC++
bae92bf3 709Enable automatic template instantiation
fef3106c
NB
710
711frtti
c662432e 712C++ ObjC++ Optimization
bae92bf3 713Generate run time type descriptor information
fef3106c
NB
714
715fshort-double
c662432e 716C ObjC C++ ObjC++ Optimization
5a170a05 717Use the same size for double as for float
fef3106c
NB
718
719fshort-enums
c662432e 720C ObjC C++ ObjC++ Optimization
5a170a05 721Use the narrowest integer type possible for enumeration types
fef3106c
NB
722
723fshort-wchar
c662432e 724C ObjC C++ ObjC++ Optimization
5a170a05 725Force the underlying type for \"wchar_t\" to be \"unsigned short\"
fef3106c 726
fef3106c
NB
727fsigned-bitfields
728C ObjC C++ ObjC++
5a170a05 729When \"signed\" or \"unsigned\" is not given make the bitfield signed
fef3106c
NB
730
731fsigned-char
732C ObjC C++ ObjC++
5a170a05 733Make \"char\" signed by default
fef3106c
NB
734
735fsquangle
736C++ ObjC++
737
738fstats
739C++ ObjC++
bae92bf3 740Display statistics accumulated during compilation
fef3106c
NB
741
742fstrict-prototype
743C++ ObjC++
744
745ftabstop=
7b086b11 746C ObjC C++ ObjC++ Joined RejectNegative UInteger
72de27ea 747-ftabstop=<number> Distance between tab stops for column reporting
fef3106c
NB
748
749ftemplate-depth-
c22cacf3 750C++ ObjC++ Joined RejectNegative UInteger
bae92bf3 751-ftemplate-depth-<number> Specify maximum template instantiation depth
fef3106c
NB
752
753fthis-is-variable
754C++ ObjC++
755
40aac948 756fthreadsafe-statics
c662432e 757C++ ObjC++ Optimization
c85ce869 758-fno-threadsafe-statics Do not generate thread-safe code for initializing local statics
40aac948 759
fef3106c
NB
760funsigned-bitfields
761C ObjC C++ ObjC++
5a170a05 762When \"signed\" or \"unsigned\" is not given make the bitfield unsigned
fef3106c
NB
763
764funsigned-char
765C ObjC C++ ObjC++
5a170a05 766Make \"char\" unsigned by default
fef3106c
NB
767
768fuse-cxa-atexit
769C++ ObjC++
bae92bf3 770Use __cxa_atexit to register destructors
fef3106c 771
c7b5e395
GK
772fuse-cxa-get-exception-ptr
773C++ ObjC++
774Use __cxa_get_exception_ptr in exception handling
775
d7afec4b 776fvisibility-inlines-hidden
d0b07283 777C++ ObjC++
d7afec4b
ND
778Marks all inlined methods as having hidden visibility
779
ddbfd28d
GK
780fvisibility-ms-compat
781C++ ObjC++ Var(flag_visibility_ms_compat)
782Changes visibility to match Microsoft Visual Studio by default
783
fef3106c
NB
784fvtable-gc
785C++ ObjC++
bae92bf3 786Discard unused virtual functions
fef3106c
NB
787
788fvtable-thunks
789C++ ObjC++
bae92bf3 790Implement vtables using thunks
fef3106c
NB
791
792fweak
793C++ ObjC++
bae92bf3 794Emit common-like symbols as weak symbols
fef3106c 795
e6cc3a24
ZW
796fwide-exec-charset=
797C ObjC C++ ObjC++ Joined RejectNegative
72de27ea 798-fwide-exec-charset=<cset> Convert all wide strings and character constants to character set <cset>
e6cc3a24 799
b20d9f0c
AO
800fworking-directory
801C ObjC C++ ObjC++
802Generate a #line directive pointing at the current working directory
803
fef3106c
NB
804fxref
805C++ ObjC++
bae92bf3 806Emit cross referencing information
fef3106c 807
264fa2db
ZL
808fzero-link
809ObjC ObjC++
810Generate lazy class lookup (via objc_getClass()) for use in Zero-Link mode
811
fef3106c
NB
812gen-decls
813ObjC ObjC++
f2ac9964 814Dump declarations to a .decl file
fef3106c 815
39ef6592
LC
816femit-struct-debug-baseonly
817C ObjC C++ ObjC++
818-femit-struct-debug-baseonly Aggressive reduced debug info for structs
819
820femit-struct-debug-reduced
821C ObjC C++ ObjC++
822-femit-struct-debug-reduced Conservative reduced debug info for structs
823
824femit-struct-debug-detailed=
825C ObjC C++ ObjC++ Joined
826-femit-struct-debug-detailed=<spec-list> Detailed reduced debug info for structs
827
fef3106c
NB
828idirafter
829C ObjC C++ ObjC++ Joined Separate
72de27ea 830-idirafter <dir> Add <dir> to the end of the system include path
fef3106c
NB
831
832imacros
833C ObjC C++ ObjC++ Joined Separate
72de27ea 834-imacros <file> Accept definition of macros in <file>
fef3106c 835
2b6dd222
JM
836imultilib
837C ObjC C++ ObjC++ Joined Separate
838-imultilib <dir> Set <dir> to be the multilib include subdirectory
839
fef3106c
NB
840include
841C ObjC C++ ObjC++ Joined Separate
72de27ea 842-include <file> Include the contents of <file> before other files
fef3106c
NB
843
844iprefix
845C ObjC C++ ObjC++ Joined Separate
72de27ea 846-iprefix <path> Specify <path> as a prefix for next two options
fef3106c
NB
847
848isysroot
849C ObjC C++ ObjC++ Joined Separate
72de27ea 850-isysroot <dir> Set <dir> to be the system root directory
fef3106c
NB
851
852isystem
853C ObjC C++ ObjC++ Joined Separate
72de27ea 854-isystem <dir> Add <dir> to the start of the system include path
fef3106c 855
4bed3787
MS
856iquote
857C ObjC C++ ObjC++ Joined Separate
858-iquote <dir> Add <dir> to the end of the quote include path
859
fef3106c
NB
860iwithprefix
861C ObjC C++ ObjC++ Joined Separate
72de27ea 862-iwithprefix <dir> Add <dir> to the end of the system include path
fef3106c
NB
863
864iwithprefixbefore
865C ObjC C++ ObjC++ Joined Separate
72de27ea 866-iwithprefixbefore <dir> Add <dir> to the end of the main include path
fef3106c
NB
867
868lang-asm
f2ac9964 869C Undocumented
fef3106c
NB
870
871lang-objc
f2ac9964 872C ObjC C++ ObjC++ Undocumented
fef3106c
NB
873
874nostdinc
875C ObjC C++ ObjC++
72de27ea 876Do not search standard system include directories (those specified with -isystem will still be used)
fef3106c
NB
877
878nostdinc++
72de27ea
NB
879C++ ObjC++
880Do not search standard system include directories for C++
fef3106c
NB
881
882o
883C ObjC C++ ObjC++ Joined Separate
72de27ea 884; Documented in common.opt
fef3106c
NB
885
886pedantic
887C ObjC C++ ObjC++
72de27ea 888; Documented in common.opt
fef3106c
NB
889
890pedantic-errors
891C ObjC C++ ObjC++
72de27ea 892; Documented in common.opt
fef3106c
NB
893
894print-objc-runtime-info
895ObjC ObjC++
f2ac9964 896Generate C header of platform-specific features
fef3106c 897
3fd30b88
GK
898print-pch-checksum
899C ObjC C++ ObjC++
c85ce869 900Print a checksum of the executable for PCH validity checking, and stop
3fd30b88 901
fef3106c
NB
902remap
903C ObjC C++ ObjC++
72de27ea 904Remap file names when including files
fef3106c
NB
905
906std=c++98
907C++ ObjC++
72de27ea 908Conform to the ISO 1998 C++ standard
fef3106c 909
966541e3
DG
910std=c++0x
911C++ ObjC++
912Conform to the ISO 1998 C++ standard, with extensions that are likely to
913become a part of the upcoming ISO C++ standard, dubbed C++0x. Note that the
914extensions enabled by this mode are experimental and may be removed in
915future releases of GCC.
916
fef3106c
NB
917std=c89
918C ObjC
72de27ea 919Conform to the ISO 1990 C standard
fef3106c
NB
920
921std=c99
922C ObjC
72de27ea 923Conform to the ISO 1999 C standard
fef3106c
NB
924
925std=c9x
926C ObjC
72de27ea 927Deprecated in favor of -std=c99
fef3106c
NB
928
929std=gnu++98
930C++ ObjC++
72de27ea 931Conform to the ISO 1998 C++ standard with GNU extensions
fef3106c 932
966541e3
DG
933std=gnu++0x
934C++ ObjC++
935Conform to the ISO 1998 C++ standard, with GNU extensions and
936extensions that are likely to become a part of the upcoming ISO C++
937standard, dubbed C++0x. Note that the extensions enabled by this mode
938are experimental and may be removed in future releases of GCC.
939
fef3106c
NB
940std=gnu89
941C ObjC
72de27ea 942Conform to the ISO 1990 C standard with GNU extensions
fef3106c
NB
943
944std=gnu99
945C ObjC
72de27ea 946Conform to the ISO 1999 C standard with GNU extensions
fef3106c
NB
947
948std=gnu9x
949C ObjC
72de27ea 950Deprecated in favor of -std=gnu99
fef3106c
NB
951
952std=iso9899:1990
953C ObjC
3a1e400e 954Conform to the ISO 1990 C standard
fef3106c
NB
955
956std=iso9899:199409
957C ObjC
72de27ea 958Conform to the ISO 1990 C standard as amended in 1994
fef3106c
NB
959
960std=iso9899:1999
961C ObjC
3a1e400e 962Conform to the ISO 1999 C standard
fef3106c
NB
963
964std=iso9899:199x
965C ObjC
3a1e400e 966Deprecated in favor of -std=iso9899:1999
fef3106c
NB
967
968traditional-cpp
969C ObjC C++ ObjC++
72de27ea 970Enable traditional preprocessing
fef3106c
NB
971
972trigraphs
973C ObjC C++ ObjC++
72de27ea 974-trigraphs Support ISO C trigraphs
fef3106c
NB
975
976undef
977C ObjC C++ ObjC++
72de27ea 978Do not predefine system-specific and GCC-specific macros
fef3106c
NB
979
980v
b3eaaf1a 981Common C ObjC C++ ObjC++
72de27ea 982Enable verbose output
fef3106c
NB
983
984w
985C ObjC C++ ObjC++
72de27ea 986; Documented in common.opt
e11a4ae5
NB
987
988; This comment is to ensure we retain the blank line above.