gcc/c-family/c.opt

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