gcc/c.opt

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