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