gcc/c.opt

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