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 ; 2011 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 Driver 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 fconstexpr-depth=
 723 C++ ObjC++ Joined RejectNegative UInteger Var(max_constexpr_depth) Init(512)
 724 -fconstexpr-depth=<number>      Specify maximum constexpr recursion depth
 725
 726 fdeduce-init-list
 727 C++ ObjC++ Var(flag_deduce_init_list) Init(1)
 728 -fno-deduce-init-list   disable deduction of std::initializer_list for a template type parameter from a brace-enclosed initializer-list
 729
 730 fdefault-inline
 731 C++ ObjC++ Ignore
 732 Does nothing.  Preserved for backward compatibility.
 733
 734 fdirectives-only
 735 C ObjC C++ ObjC++
 736 Preprocess directives only.
 737
 738 fdollars-in-identifiers
 739 C ObjC C++ ObjC++
 740 Permit '$' as an identifier character
 741
 742 felide-constructors
 743 C++ ObjC++ Var(flag_elide_constructors) Init(1)
 744
 745 fenforce-eh-specs
 746 C++ ObjC++ Var(flag_enforce_eh_specs) Init(1)
 747 Generate code to check exception specifications
 748
 749 fenum-int-equiv
 750 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 751
 752 fexec-charset=
 753 C ObjC C++ ObjC++ Joined RejectNegative
 754 -fexec-charset=<cset>   Convert all strings and character constants to character set <cset>
 755
 756 fextended-identifiers
 757 C ObjC C++ ObjC++
 758 Permit universal character names (\\u and \\U) in identifiers
 759
 760 finput-charset=
 761 C ObjC C++ ObjC++ Joined RejectNegative
 762 -finput-charset=<cset>  Specify the default character set for source files
 763
 764
 765 fexternal-templates
 766 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 767
 768 ffor-scope
 769 C++ ObjC++ Var(flag_new_for_scope) Init(1)
 770 Scope of for-init-statement variables is local to the loop
 771
 772 ffreestanding
 773 C ObjC C++ ObjC++
 774 Do not assume that standard C libraries and \"main\" exist
 775
 776 fgnu-keywords
 777 C++ ObjC++ Var(flag_no_gnu_keywords, 0)
 778 Recognize GNU-defined keywords
 779
 780 fgnu-runtime
 781 ObjC ObjC++
 782 Generate code for GNU runtime environment
 783
 784 fgnu89-inline
 785 C ObjC Var(flag_gnu89_inline) Init(-1)
 786 Use traditional GNU semantics for inline functions
 787
 788 fguiding-decls
 789 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 790
 791 fhandle-exceptions
 792 C++ ObjC++ Optimization Alias(fexceptions) Warn({-fhandle-exceptions has been renamed -fexceptions (and is now on by default)})
 793
 794 fhonor-std
 795 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 796
 797 fhosted
 798 C ObjC
 799 Assume normal C execution environment
 800
 801 fhuge-objects
 802 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 803 No longer supported
 804
 805 fimplement-inlines
 806 C++ ObjC++ Var(flag_implement_inlines) Init(1)
 807 Export functions even if they can be inlined
 808
 809 fimplicit-inline-templates
 810 C++ ObjC++ Var(flag_implicit_inline_templates) Init(1)
 811 Emit implicit instantiations of inline templates
 812
 813 fimplicit-templates
 814 C++ ObjC++ Var(flag_implicit_templates) Init(1)
 815 Emit implicit instantiations of templates
 816
 817 ffriend-injection
 818 C++ ObjC++ Var(flag_friend_injection)
 819 Inject friend functions into enclosing namespace
 820
 821 fkeep-inline-dllexport
 822 C C++ ObjC ObjC++ Var(flag_keep_inline_dllexport) Init(1) Report Condition(TARGET_DLLIMPORT_DECL_ATTRIBUTES)
 823 Don't emit dllexported inline functions unless needed
 824
 825 flabels-ok
 826 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 827
 828 flax-vector-conversions
 829 C ObjC C++ ObjC++ Var(flag_lax_vector_conversions)
 830 Allow implicit conversions between vectors with differing numbers of subparts and/or differing element types.
 831
 832 fms-extensions
 833 C ObjC C++ ObjC++ Var(flag_ms_extensions)
 834 Don't warn about uses of Microsoft extensions
 835
 836 fname-mangling-version-
 837 C++ ObjC++ Joined Ignore Warn(switch %qs is no longer supported)
 838
 839 fnew-abi
 840 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 841
 842 fnext-runtime
 843 ObjC ObjC++
 844 Generate code for NeXT (Apple Mac OS X) runtime environment
 845
 846 fnil-receivers
 847 ObjC ObjC++ Var(flag_nil_receivers) Init(1)
 848 Assume that receivers of Objective-C messages may be nil
 849
 850 fnonansi-builtins
 851 C++ ObjC++ Var(flag_no_nonansi_builtin, 0)
 852
 853 fnonnull-objects
 854 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 855
 856 fnothrow-opt
 857 C++ ObjC++ Optimization Var(flag_nothrow_opt)
 858 Treat a throw() exception specification as noexcept to improve code size
 859
 860 fobjc-abi-version=
 861 ObjC ObjC++ Joined Report RejectNegative UInteger Var(flag_objc_abi)
 862 Specify which ABI to use for Objective-C family code and meta-data generation.
 863
 864 ; Generate special '- .cxx_construct' and '- .cxx_destruct' methods
 865 ; to initialize any non-POD ivars in Objective-C++ classes.
 866 fobjc-call-cxx-cdtors
 867 ObjC++ Var(flag_objc_call_cxx_cdtors)
 868 Generate special Objective-C methods to initialize/destroy non-POD C++ ivars, if needed
 869
 870 fobjc-direct-dispatch
 871 ObjC ObjC++ Var(flag_objc_direct_dispatch)
 872 Allow fast jumps to the message dispatcher
 873
 874 ; Nonzero means that we will allow new ObjC exception syntax (@throw,
 875 ; @try, etc.) in source code.
 876 fobjc-exceptions
 877 ObjC ObjC++ Var(flag_objc_exceptions)
 878 Enable Objective-C exception and synchronization syntax
 879
 880 fobjc-gc
 881 ObjC ObjC++ Var(flag_objc_gc)
 882 Enable garbage collection (GC) in Objective-C/Objective-C++ programs
 883
 884 fobjc-nilcheck
 885 ObjC ObjC++ Var(flag_objc_nilcheck,1)
 886 Enable inline checks for nil receivers with the NeXT runtime and ABI version 2.
 887
 888 ; Nonzero means that we generate NeXT setjmp based exceptions.
 889 fobjc-sjlj-exceptions
 890 ObjC ObjC++ Var(flag_objc_sjlj_exceptions) Init(-1)
 891 Enable Objective-C setjmp exception handling runtime
 892
 893 fobjc-std=objc1
 894 ObjC ObjC++ Var(flag_objc1_only)
 895 Conform to the Objective-C 1.0 language as implemented in GCC 4.0
 896
 897 fopenmp
 898 C ObjC C++ ObjC++ Var(flag_openmp)
 899 Enable OpenMP (implies -frecursive in Fortran)
 900
 901 foperator-names
 902 C++ ObjC++
 903 Recognize C++ keywords like \"compl\" and \"xor\"
 904
 905 foptional-diags
 906 C++ ObjC++ Ignore
 907 Does nothing.  Preserved for backward compatibility.
 908
 909 fpch-deps
 910 C ObjC C++ ObjC++
 911
 912 fpch-preprocess
 913 C ObjC C++ ObjC++
 914 Look for and use PCH files even when preprocessing
 915
 916 fpermissive
 917 C++ ObjC++
 918 Downgrade conformance errors to warnings
 919
 920 fplan9-extensions
 921 C ObjC Var(flag_plan9_extensions)
 922 Enable Plan 9 language extensions
 923
 924 fpreprocessed
 925 C ObjC C++ ObjC++
 926 Treat the input file as already preprocessed
 927
 928 fpretty-templates
 929 C++ ObjC++ Var(flag_pretty_templates) Init(1)
 930 -fno-pretty-templates Do not pretty-print template specializations as the template signature followed by the arguments
 931
 932 freplace-objc-classes
 933 ObjC ObjC++ Var(flag_replace_objc_classes)
 934 Used in Fix-and-Continue mode to indicate that object files may be swapped in at runtime
 935
 936 frepo
 937 C++ ObjC++
 938 Enable automatic template instantiation
 939
 940 frtti
 941 C++ ObjC++ Optimization Var(flag_rtti) Init(1)
 942 Generate run time type descriptor information
 943
 944 fshort-double
 945 C ObjC C++ ObjC++ Optimization Var(flag_short_double)
 946 Use the same size for double as for float
 947
 948 fshort-enums
 949 C ObjC C++ ObjC++ Optimization Var(flag_short_enums)
 950 Use the narrowest integer type possible for enumeration types
 951
 952 fshort-wchar
 953 C ObjC C++ ObjC++ Optimization Var(flag_short_wchar)
 954 Force the underlying type for \"wchar_t\" to be \"unsigned short\"
 955
 956 fsigned-bitfields
 957 C ObjC C++ ObjC++ Var(flag_signed_bitfields) Init(1)
 958 When \"signed\" or \"unsigned\" is not given make the bitfield signed
 959
 960 fsigned-char
 961 C ObjC C++ ObjC++ LTO Var(flag_signed_char)
 962 Make \"char\" signed by default
 963
 964 fsquangle
 965 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 966
 967 fstats
 968 C++ ObjC++ Var(flag_detailed_statistics)
 969 Display statistics accumulated during compilation
 970
 971 fstrict-enums
 972 C++ ObjC++ Optimization Var(flag_strict_enums)
 973 Assume that values of enumeration type are always within the minimum range of that type
 974
 975 fstrict-prototype
 976 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 977
 978 ftabstop=
 979 C ObjC C++ ObjC++ Joined RejectNegative UInteger
 980 -ftabstop=<number>      Distance between tab stops for column reporting
 981
 982 ftemplate-depth-
 983 C++ ObjC++ Joined RejectNegative Undocumented Alias(ftemplate-depth=)
 984
 985 ftemplate-depth=
 986 C++ ObjC++ Joined RejectNegative UInteger
 987 -ftemplate-depth=<number>       Specify maximum template instantiation depth
 988
 989 fthis-is-variable
 990 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 991
 992 fthreadsafe-statics
 993 C++ ObjC++ Optimization Var(flag_threadsafe_statics) Init(1)
 994 -fno-threadsafe-statics Do not generate thread-safe code for initializing local statics
 995
 996 funsigned-bitfields
 997 C ObjC C++ ObjC++ Var(flag_signed_bitfields, 0)
 998 When \"signed\" or \"unsigned\" is not given make the bitfield unsigned
 999
1000 funsigned-char
1001 C ObjC C++ ObjC++ LTO Var(flag_signed_char, 0)
1002 Make \"char\" unsigned by default
1003
1004 fuse-cxa-atexit
1005 C++ ObjC++ Var(flag_use_cxa_atexit) Init(DEFAULT_USE_CXA_ATEXIT)
1006 Use __cxa_atexit to register destructors
1007
1008 fuse-cxa-get-exception-ptr
1009 C++ ObjC++ Var(flag_use_cxa_get_exception_ptr) Init(2)
1010 Use __cxa_get_exception_ptr in exception handling
1011
1012 fvisibility-inlines-hidden
1013 C++ ObjC++
1014 Marks all inlined methods as having hidden visibility
1015
1016 fvisibility-ms-compat
1017 C++ ObjC++ Var(flag_visibility_ms_compat)
1018 Changes visibility to match Microsoft Visual Studio by default
1019
1020 fvtable-gc
1021 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1022 No longer supported
1023
1024 fvtable-thunks
1025 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1026 No longer supported
1027
1028 fweak
1029 C++ ObjC++ Var(flag_weak) Init(1)
1030 Emit common-like symbols as weak symbols
1031
1032 fwide-exec-charset=
1033 C ObjC C++ ObjC++ Joined RejectNegative
1034 -fwide-exec-charset=<cset>      Convert all wide strings and character constants to character set <cset>
1035
1036 fworking-directory
1037 C ObjC C++ ObjC++ Var(flag_working_directory) Init(-1)
1038 Generate a #line directive pointing at the current working directory
1039
1040 fxref
1041 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1042 No longer supported
1043
1044 fzero-link
1045 ObjC ObjC++ Var(flag_zero_link)
1046 Generate lazy class lookup (via objc_getClass()) for use in Zero-Link mode
1047
1048 gen-decls
1049 ObjC ObjC++ Var(flag_gen_declaration)
1050 Dump declarations to a .decl file
1051
1052 femit-struct-debug-baseonly
1053 C ObjC C++ ObjC++
1054 -femit-struct-debug-baseonly    Aggressive reduced debug info for structs
1055
1056 femit-struct-debug-reduced
1057 C ObjC C++ ObjC++
1058 -femit-struct-debug-reduced     Conservative reduced debug info for structs
1059
1060 femit-struct-debug-detailed=
1061 C ObjC C++ ObjC++ Joined
1062 -femit-struct-debug-detailed=<spec-list>        Detailed reduced debug info for structs
1063
1064 idirafter
1065 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1066 -idirafter <dir>        Add <dir> to the end of the system include path
1067
1068 imacros
1069 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1070 -imacros <file> Accept definition of macros in <file>
1071
1072 imultilib
1073 C ObjC C++ ObjC++ Joined Separate
1074 -imultilib <dir>        Set <dir> to be the multilib include subdirectory
1075
1076 include
1077 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1078 -include <file> Include the contents of <file> before other files
1079
1080 iprefix
1081 C ObjC C++ ObjC++ Joined Separate
1082 -iprefix <path> Specify <path> as a prefix for next two options
1083
1084 isysroot
1085 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1086 -isysroot <dir> Set <dir> to be the system root directory
1087
1088 isystem
1089 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1090 -isystem <dir>  Add <dir> to the start of the system include path
1091
1092 iquote
1093 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1094 -iquote <dir>   Add <dir> to the end of the quote include path
1095
1096 iwithprefix
1097 C ObjC C++ ObjC++ Joined Separate
1098 -iwithprefix <dir>      Add <dir> to the end of the system include path
1099
1100 iwithprefixbefore
1101 C ObjC C++ ObjC++ Joined Separate
1102 -iwithprefixbefore <dir>        Add <dir> to the end of the main include path
1103
1104 lang-asm
1105 C Undocumented RejectDriver
1106
1107 no-integrated-cpp
1108 Driver
1109
1110 nostdinc
1111 C ObjC C++ ObjC++
1112 Do not search standard system include directories (those specified with -isystem will still be used)
1113
1114 nostdinc++
1115 C++ ObjC++
1116 Do not search standard system include directories for C++
1117
1118 o
1119 C ObjC C++ ObjC++ Joined Separate
1120 ; Documented in common.opt
1121
1122 pedantic
1123 C ObjC C++ ObjC++
1124 ; Documented in common.opt
1125
1126 pedantic-errors
1127 C ObjC C++ ObjC++
1128 ; Documented in common.opt
1129
1130 print-objc-runtime-info
1131 ObjC ObjC++
1132 Generate C header of platform-specific features
1133
1134 remap
1135 C ObjC C++ ObjC++
1136 Remap file names when including files
1137
1138 std=c++98
1139 C++ ObjC++
1140 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1141
1142 std=c++03
1143 C++ ObjC++ Alias(std=c++98)
1144 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1145
1146 std=c++0x
1147 C++ ObjC++
1148 Conform to the ISO 1998 C++ standard, with extensions that are likely to
1149 become a part of the upcoming ISO C++ standard, dubbed C++0x. Note that the
1150 extensions enabled by this mode are experimental and may be removed in
1151 future releases of GCC.
1152
1153 std=c1x
1154 C ObjC
1155 Conform to the ISO 201X C standard draft (experimental and incomplete support)
1156
1157 std=c89
1158 C ObjC Alias(std=c90)
1159 Conform to the ISO 1990 C standard
1160
1161 std=c90
1162 C ObjC
1163 Conform to the ISO 1990 C standard
1164
1165 std=c99
1166 C ObjC
1167 Conform to the ISO 1999 C standard
1168
1169 std=c9x
1170 C ObjC Alias(std=c99)
1171 Deprecated in favor of -std=c99
1172
1173 std=gnu++98
1174 C++ ObjC++
1175 Conform to the ISO 1998 C++ standard with GNU extensions
1176
1177 std=gnu++0x
1178 C++ ObjC++
1179 Conform to the ISO 1998 C++ standard, with GNU extensions and
1180 extensions that are likely to become a part of the upcoming ISO C++
1181 standard, dubbed C++0x. Note that the extensions enabled by this mode
1182 are experimental and may be removed in future releases of GCC.
1183
1184 std=gnu1x
1185 C ObjC
1186 Conform to the ISO 201X C standard draft with GNU extensions (experimental and incomplete support)
1187
1188 std=gnu89
1189 C ObjC Alias(std=gnu90)
1190 Conform to the ISO 1990 C standard with GNU extensions
1191
1192 std=gnu90
1193 C ObjC
1194 Conform to the ISO 1990 C standard with GNU extensions
1195
1196 std=gnu99
1197 C ObjC
1198 Conform to the ISO 1999 C standard with GNU extensions
1199
1200 std=gnu9x
1201 C ObjC Alias(std=gnu99)
1202 Deprecated in favor of -std=gnu99
1203
1204 std=iso9899:1990
1205 C ObjC Alias(std=c90)
1206 Conform to the ISO 1990 C standard
1207
1208 std=iso9899:199409
1209 C ObjC
1210 Conform to the ISO 1990 C standard as amended in 1994
1211
1212 std=iso9899:1999
1213 C ObjC Alias(std=c99)
1214 Conform to the ISO 1999 C standard
1215
1216 std=iso9899:199x
1217 C ObjC Alias(std=c99)
1218 Deprecated in favor of -std=iso9899:1999
1219
1220 traditional
1221 Driver
1222
1223 traditional-cpp
1224 C ObjC C++ ObjC++
1225 Enable traditional preprocessing
1226
1227 trigraphs
1228 C ObjC C++ ObjC++
1229 -trigraphs      Support ISO C trigraphs
1230
1231 undef
1232 C ObjC C++ ObjC++ Var(flag_undef)
1233 Do not predefine system-specific and GCC-specific macros
1234
1235 v
1236 C ObjC C++ ObjC++
1237 ; Documented in common.opt
1238
1239 w
1240 C ObjC C++ ObjC++
1241 ; Documented in common.opt
1242
1243 ; This comment is to ensure we retain the blank line above.