Merge branch 'vendor/GCC47'
[dragonfly.git] / contrib / gcc-4.7 / 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, 2012 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 Deprecated in favor of -Wc++11-compat
293
294 Wc++11-compat
295 C++ ObjC++ Warning Alias(Wc++0x-compat)
296 Warn about C++ constructs whose meaning differs between ISO C++ 1998 and ISO C++ 2011
297
298 Wcast-qual
299 C ObjC C++ ObjC++ Var(warn_cast_qual) Warning
300 Warn about casts which discard qualifiers
301
302 Wchar-subscripts
303 C ObjC C++ ObjC++ Var(warn_char_subscripts) Warning
304 Warn about subscripts whose type is \"char\"
305
306 Wclobbered
307 C ObjC C++ ObjC++ Var(warn_clobbered) Init(-1) Warning
308 Warn about variables that might be changed by \"longjmp\" or \"vfork\"
309
310 Wcomment
311 C ObjC C++ ObjC++ Warning
312 Warn about possibly nested block comments, and C++ comments spanning more than one physical line
313
314 Wcomments
315 C ObjC C++ ObjC++ Warning Alias(Wcomment)
316 Synonym for -Wcomment
317
318 Wconversion
319 C ObjC C++ ObjC++ Var(warn_conversion) Warning
320 Warn for implicit type conversions that may change a value
321
322 Wconversion-null
323 C++ ObjC++ Var(warn_conversion_null) Init(1) Warning
324 Warn for converting NULL from/to a non-pointer type
325
326 Wsign-conversion
327 C ObjC C++ ObjC++ Var(warn_sign_conversion) Init(-1)
328 Warn for implicit type conversions between signed and unsigned integers
329
330 Wctor-dtor-privacy
331 C++ ObjC++ Var(warn_ctor_dtor_privacy) Warning
332 Warn when all constructors and destructors are private
333
334 Wdeclaration-after-statement
335 C ObjC Var(warn_declaration_after_statement) Warning
336 Warn when a declaration is found after a statement
337
338 Wdelete-non-virtual-dtor
339 C++ ObjC++ Var(warn_delnonvdtor) Warning
340 Warn about deleting polymorphic objects with non-virtual destructors
341
342 Wdeprecated
343 C C++ ObjC ObjC++ Var(warn_deprecated) Init(1) Warning
344 Warn if a deprecated compiler feature, class, method, or field is used
345
346 Wdiv-by-zero
347 C ObjC C++ ObjC++ Var(warn_div_by_zero) Init(1) Warning
348 Warn about compile-time integer division by zero
349
350 Weffc++
351 C++ ObjC++ Var(warn_ecpp) Warning
352 Warn about violations of Effective C++ style rules
353
354 Wempty-body
355 C ObjC C++ ObjC++ Var(warn_empty_body) Init(-1) Warning
356 Warn about an empty body in an if or else statement
357
358 Wendif-labels
359 C ObjC C++ ObjC++ Warning
360 Warn about stray tokens after #elif and #endif
361
362 Wenum-compare
363 C ObjC C++ ObjC++ Var(warn_enum_compare) Init(-1) Warning
364 Warn about comparison of different enum types
365
366 Werror
367 C ObjC C++ ObjC++
368 ; Documented in common.opt
369
370 Werror-implicit-function-declaration
371 C ObjC RejectNegative Warning Alias(Werror=, implicit-function-declaration)
372 This switch is deprecated; use -Werror=implicit-function-declaration instead
373
374 Wfloat-equal
375 C ObjC C++ ObjC++ Var(warn_float_equal) Warning
376 Warn if testing floating point numbers for equality
377
378 Wformat
379 C ObjC C++ ObjC++ Warning
380 Warn about printf/scanf/strftime/strfmon format string anomalies
381
382 Wformat-extra-args
383 C ObjC C++ ObjC++ Var(warn_format_extra_args) Warning
384 Warn if passing too many arguments to a function for its format string
385
386 Wformat-nonliteral
387 C ObjC C++ ObjC++ Var(warn_format_nonliteral) Warning
388 Warn about format strings that are not literals
389
390 Wformat-contains-nul
391 C ObjC C++ ObjC++ Var(warn_format_contains_nul) Warning
392 Warn about format strings that contain NUL bytes
393
394 Wformat-security
395 C ObjC C++ ObjC++ Var(warn_format_security) Warning
396 Warn about possible security problems with format functions
397
398 Wformat-y2k
399 C ObjC C++ ObjC++ Var(warn_format_y2k) Warning
400 Warn about strftime formats yielding 2-digit years
401
402 Wformat-zero-length
403 C ObjC C++ ObjC++ Var(warn_format_zero_length) Warning
404 Warn about zero-length formats
405
406 Wformat=
407 C ObjC C++ ObjC++ Joined Warning
408
409 Wignored-qualifiers
410 C C++ Var(warn_ignored_qualifiers) Init(-1) Warning
411 Warn whenever type qualifiers are ignored.
412
413 Winit-self
414 C ObjC C++ ObjC++ Var(warn_init_self) Warning
415 Warn about variables which are initialized to themselves
416
417 Wimplicit
418 C ObjC Var(warn_implicit) Init(-1) Warning
419 Warn about implicit declarations
420
421 Wdouble-promotion
422 C ObjC C++ ObjC++ Var(warn_double_promotion) Warning
423 Warn about implicit conversions from \"float\" to \"double\"
424
425 Wimplicit-function-declaration
426 C ObjC Var(warn_implicit_function_declaration) Init(-1) Warning
427 Warn about implicit function declarations
428
429 Wimplicit-int
430 C ObjC Var(warn_implicit_int) Init(-1) Warning
431 Warn when a declaration does not specify a type
432
433 Wimport
434 C ObjC C++ ObjC++ Undocumented Ignore
435
436 Wint-to-pointer-cast
437 C ObjC C++ ObjC++ Var(warn_int_to_pointer_cast) Init(1) Warning
438 Warn when there is a cast to a pointer from an integer of a different size
439
440 Winvalid-offsetof
441 C++ ObjC++ Var(warn_invalid_offsetof) Init(1) Warning
442 Warn about invalid uses of the \"offsetof\" macro
443
444 Winvalid-pch
445 C ObjC C++ ObjC++ Warning
446 Warn about PCH files that are found but not used
447
448 Wjump-misses-init
449 C ObjC Var(warn_jump_misses_init) Init(-1) Warning
450 Warn when a jump misses a variable initialization
451
452 Wlogical-op
453 C ObjC C++ ObjC++ Var(warn_logical_op) Init(0) Warning 
454 Warn when a logical operator is suspiciously always evaluating to true or false
455
456 Wlong-long
457 C ObjC C++ ObjC++ Var(warn_long_long) Init(-1) Warning
458 Do not warn about using \"long long\" when -pedantic
459
460 Wmain
461 C ObjC C++ ObjC++ Var(warn_main) Init(-1) Warning
462 Warn about suspicious declarations of \"main\"
463
464 Wmissing-braces
465 C ObjC C++ ObjC++ Var(warn_missing_braces) Warning
466 Warn about possibly missing braces around initializers
467
468 Wmissing-declarations
469 C ObjC C++ ObjC++ Var(warn_missing_declarations) Warning
470 Warn about global functions without previous declarations
471
472 Wmissing-field-initializers
473 C ObjC C++ ObjC++ Var(warn_missing_field_initializers) Init(-1) Warning
474 Warn about missing fields in struct initializers
475
476 Wmissing-format-attribute
477 C ObjC C++ ObjC++ Var(warn_missing_format_attribute) Warning
478 Warn about functions which might be candidates for format attributes
479
480 Wmissing-include-dirs
481 C ObjC C++ ObjC++ Warning
482 Warn about user-specified include directories that do not exist
483
484 Wmissing-parameter-type
485 C ObjC Var(warn_missing_parameter_type) Init(-1) Warning
486 Warn about function parameters declared without a type specifier in K&R-style functions
487
488 Wmissing-prototypes
489 C ObjC Var(warn_missing_prototypes) Warning
490 Warn about global functions without prototypes
491
492 Wmudflap
493 C ObjC C++ ObjC++ Var(warn_mudflap) Init(1) Warning
494 Warn about constructs not instrumented by -fmudflap
495
496 Wmultichar
497 C ObjC C++ ObjC++ Warning
498 Warn about use of multi-character character constants
499
500 Wnarrowing
501 C ObjC C++ ObjC++ Warning Var(warn_narrowing) Init(-1)
502 Warn about narrowing conversions within { } that are ill-formed in C++11
503
504 Wnested-externs
505 C ObjC Var(warn_nested_externs) Warning
506 Warn about \"extern\" declarations not at file scope
507
508 Wnoexcept
509 C++ ObjC++ Var(warn_noexcept) Warning
510 Warn when a noexcept expression evaluates to false even though the expression can't actually throw
511
512 Wnon-template-friend
513 C++ ObjC++ Var(warn_nontemplate_friend) Init(1) Warning
514 Warn when non-templatized friend functions are declared within a template
515
516 Wnon-virtual-dtor
517 C++ ObjC++ Var(warn_nonvdtor) Warning
518 Warn about non-virtual destructors
519
520 Wnonnull
521 C ObjC C++ ObjC++ Var(warn_nonnull) Warning
522 Warn about NULL being passed to argument slots marked as requiring non-NULL
523
524 Wnormalized=
525 C ObjC C++ ObjC++ Joined Warning
526 -Wnormalized=<id|nfc|nfkc>      Warn about non-normalised Unicode strings
527
528 Wold-style-cast
529 C++ ObjC++ Var(warn_old_style_cast) Warning
530 Warn if a C-style cast is used in a program
531
532 Wold-style-declaration
533 C ObjC Var(warn_old_style_declaration) Init(-1) Warning
534 Warn for obsolescent usage in a declaration
535
536 Wold-style-definition
537 C ObjC Var(warn_old_style_definition) Warning
538 Warn if an old-style parameter definition is used
539
540 Woverlength-strings
541 C ObjC C++ ObjC++ Var(warn_overlength_strings) Init(-1) Warning
542 Warn if a string is longer than the maximum portable length specified by the standard
543
544 Woverloaded-virtual
545 C++ ObjC++ Var(warn_overloaded_virtual) Warning
546 Warn about overloaded virtual function names
547
548 Woverride-init
549 C ObjC Var(warn_override_init) Init(-1) Warning
550 Warn about overriding initializers without side effects
551
552 Wpacked-bitfield-compat
553 C ObjC C++ ObjC++ Var(warn_packed_bitfield_compat) Init(-1) Warning
554 Warn about packed bit-fields whose offset changed in GCC 4.4
555
556 Wparentheses
557 C ObjC C++ ObjC++ Var(warn_parentheses) Warning
558 Warn about possibly missing parentheses
559
560 Wpmf-conversions
561 C++ ObjC++ Var(warn_pmf2ptr) Init(1) Warning
562 Warn when converting the type of pointers to member functions
563
564 Wpointer-arith
565 C ObjC C++ ObjC++ Var(warn_pointer_arith) Warning
566 Warn about function pointer arithmetic
567
568 Wpointer-to-int-cast
569 C ObjC Var(warn_pointer_to_int_cast) Init(1) Warning
570 Warn when a pointer is cast to an integer of a different size
571
572 Wpragmas
573 C ObjC C++ ObjC++ Var(warn_pragmas) Init(1) Warning
574 Warn about misuses of pragmas
575
576 Wproperty-assign-default
577 ObjC ObjC++ Var(warn_property_assign_default) Init(1) Warning
578 Warn if a property for an Objective-C object has no assign semantics specified
579
580 Wprotocol
581 ObjC ObjC++ Var(warn_protocol) Init(1) Warning
582 Warn if inherited methods are unimplemented
583
584 Wredundant-decls
585 C ObjC C++ ObjC++ Var(warn_redundant_decls) Warning
586 Warn about multiple declarations of the same object
587
588 Wreorder
589 C++ ObjC++ Var(warn_reorder) Warning
590 Warn when the compiler reorders code
591
592 Wreturn-type
593 C ObjC C++ ObjC++ Var(warn_return_type) Warning
594 Warn whenever a function's return type defaults to \"int\" (C), or about inconsistent return types (C++)
595
596 Wselector
597 ObjC ObjC++ Var(warn_selector) Warning
598 Warn if a selector has multiple methods
599
600 Wsequence-point
601 C ObjC C++ ObjC++ Var(warn_sequence_point) Warning
602 Warn about possible violations of sequence point rules
603
604 Wsign-compare
605 C ObjC C++ ObjC++ Var(warn_sign_compare) Init(-1) Warning
606 Warn about signed-unsigned comparisons
607
608 Wsign-promo
609 C++ ObjC++ Var(warn_sign_promo) Warning
610 Warn when overload promotes from unsigned to signed
611
612 Wstrict-null-sentinel
613 C++ ObjC++ Warning Var(warn_strict_null_sentinel)
614 Warn about uncasted NULL used as sentinel
615
616 Wstrict-prototypes
617 C ObjC Var(warn_strict_prototypes) Warning
618 Warn about unprototyped function declarations
619
620 Wstrict-selector-match
621 ObjC ObjC++ Var(warn_strict_selector_match) Warning
622 Warn if type signatures of candidate methods do not match exactly
623
624 Wsync-nand
625 C C++ Var(warn_sync_nand) Init(1) Warning
626 Warn when __sync_fetch_and_nand and __sync_nand_and_fetch built-in functions are used
627
628 Wsynth
629 C++ ObjC++ Var(warn_synth) Warning
630 Deprecated.  This switch has no effect
631
632 Wsystem-headers
633 C ObjC C++ ObjC++ Warning
634 ; Documented in common.opt
635
636 Wtraditional
637 C ObjC Var(warn_traditional) Warning
638 Warn about features not present in traditional C
639
640 Wtraditional-conversion
641 C ObjC Var(warn_traditional_conversion) Warning
642 Warn of prototypes causing type conversions different from what would happen in the absence of prototype
643
644 Wtrigraphs
645 C ObjC C++ ObjC++ Warning
646 Warn if trigraphs are encountered that might affect the meaning of the program
647
648 Wundeclared-selector
649 ObjC ObjC++ Var(warn_undeclared_selector) Warning
650 Warn about @selector()s without previously declared methods
651
652 Wundef
653 C ObjC C++ ObjC++ Warning
654 Warn if an undefined macro is used in an #if directive
655
656 Wunknown-pragmas
657 C ObjC C++ ObjC++ Warning
658 Warn about unrecognized pragmas
659
660 Wunsuffixed-float-constants
661 C ObjC Var(warn_unsuffixed_float_constants) Warning
662 Warn about unsuffixed float constants
663
664 Wunused-local-typedefs
665 C ObjC C++ ObjC++ Var(warn_unused_local_typedefs) Warning
666 Warn when typedefs locally defined in a function are not used
667
668 Wunused-macros
669 C ObjC C++ ObjC++ Warning
670 Warn about macros defined in the main file that are not used
671
672 Wunused-result
673 C ObjC C++ ObjC++ Var(warn_unused_result) Init(1) Warning
674 Warn if a caller of a function, marked with attribute warn_unused_result, does not use its return value
675
676 Wvariadic-macros
677 C ObjC C++ ObjC++ Warning
678 Do not warn about using variadic macros when -pedantic
679
680 Wvla
681 C ObjC C++ ObjC++ Var(warn_vla) Init(-1) Warning
682 Warn if a variable length array is used
683
684 Wvolatile-register-var
685 C ObjC C++ ObjC++ Var(warn_volatile_register_var) Warning
686 Warn when a register variable is declared volatile
687
688 Wwrite-strings
689 C ObjC C++ ObjC++ Var(warn_write_strings) Warning
690 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.
691
692 Wpointer-sign
693 C ObjC Var(warn_pointer_sign) Init(-1) Warning
694 Warn when a pointer differs in signedness in an assignment
695
696 Wzero-as-null-pointer-constant
697 C++ ObjC++ Var(warn_zero_as_null_pointer_constant) Warning
698 Warn when a literal '0' is used as null pointer
699
700 ansi
701 C ObjC C++ ObjC++
702 A synonym for -std=c89 (for C) or -std=c++98 (for C++)
703
704 d
705 C ObjC C++ ObjC++ Joined
706 ; Documented in common.opt.  FIXME - what about -dI, -dD, -dN and -dD?
707
708 faccess-control
709 C++ ObjC++ Var(flag_access_control) Init(1)
710 Enforce class member access control semantics
711
712 fall-virtual
713 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
714
715 fallow-parameterless-variadic-functions
716 C ObjC Var(flag_allow_parameterless_variadic_functions)
717 Allow variadic functions without named parameter
718
719 falt-external-templates
720 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
721 No longer supported
722
723 fasm
724 C ObjC C++ ObjC++ Var(flag_no_asm, 0)
725 Recognize the \"asm\" keyword
726
727 ; Define extra predefined macros for use in libgcc.
728 fbuilding-libgcc
729 C ObjC C++ ObjC++ Undocumented Var(flag_building_libgcc)
730
731 fbuiltin
732 C ObjC C++ ObjC++ Var(flag_no_builtin, 0)
733 Recognize built-in functions
734
735 fbuiltin-
736 C ObjC C++ ObjC++ Joined
737
738 fcheck-new
739 C++ ObjC++ Var(flag_check_new)
740 Check the return value of new
741
742 fcond-mismatch
743 C ObjC C++ ObjC++
744 Allow the arguments of the '?' operator to have different types
745
746 fconserve-space
747 C++ ObjC++ Var(flag_conserve_space)
748 Reduce the size of object files
749
750 fconstant-string-class=
751 ObjC ObjC++ Joined MissingArgError(no class name specified with %qs)
752 -fconst-string-class=<name>     Use class <name> for constant strings
753
754 fconstexpr-depth=
755 C++ ObjC++ Joined RejectNegative UInteger Var(max_constexpr_depth) Init(512)
756 -fconstexpr-depth=<number>      Specify maximum constexpr recursion depth
757
758 fdebug-cpp
759 C ObjC C++ ObjC++
760 Emit debug annotations during preprocessing
761
762 fdeduce-init-list
763 C++ ObjC++ Var(flag_deduce_init_list) Init(0)
764 -fdeduce-init-list      enable deduction of std::initializer_list for a template type parameter from a brace-enclosed initializer-list
765
766 fdefault-inline
767 C++ ObjC++ Ignore
768 Does nothing.  Preserved for backward compatibility.
769
770 fdirectives-only
771 C ObjC C++ ObjC++
772 Preprocess directives only.
773
774 fdollars-in-identifiers
775 C ObjC C++ ObjC++
776 Permit '$' as an identifier character
777
778 felide-constructors
779 C++ ObjC++ Var(flag_elide_constructors) Init(1)
780
781 fenforce-eh-specs
782 C++ ObjC++ Var(flag_enforce_eh_specs) Init(1)
783 Generate code to check exception specifications
784
785 fenum-int-equiv
786 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
787
788 fexec-charset=
789 C ObjC C++ ObjC++ Joined RejectNegative
790 -fexec-charset=<cset>   Convert all strings and character constants to character set <cset>
791
792 fextended-identifiers
793 C ObjC C++ ObjC++
794 Permit universal character names (\\u and \\U) in identifiers
795
796 finput-charset=
797 C ObjC C++ ObjC++ Joined RejectNegative
798 -finput-charset=<cset>  Specify the default character set for source files
799
800
801 fexternal-templates
802 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
803
804 ffor-scope
805 C++ ObjC++ Var(flag_new_for_scope) Init(1)
806 Scope of for-init-statement variables is local to the loop
807
808 ffreestanding
809 C ObjC C++ ObjC++
810 Do not assume that standard C libraries and \"main\" exist
811
812 fgnu-keywords
813 C++ ObjC++ Var(flag_no_gnu_keywords, 0)
814 Recognize GNU-defined keywords
815
816 fgnu-runtime
817 ObjC ObjC++ LTO Report RejectNegative Var(flag_next_runtime,0) Init(NEXT_OBJC_RUNTIME)
818 Generate code for GNU runtime environment
819
820 fgnu89-inline
821 C ObjC Var(flag_gnu89_inline) Init(-1)
822 Use traditional GNU semantics for inline functions
823
824 fguiding-decls
825 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
826
827 fhandle-exceptions
828 C++ ObjC++ Optimization Alias(fexceptions) Warn({-fhandle-exceptions has been renamed -fexceptions (and is now on by default)})
829
830 fhonor-std
831 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
832
833 fhosted
834 C ObjC
835 Assume normal C execution environment
836
837 fhuge-objects
838 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
839 No longer supported
840
841 fimplement-inlines
842 C++ ObjC++ Var(flag_implement_inlines) Init(1)
843 Export functions even if they can be inlined
844
845 fimplicit-inline-templates
846 C++ ObjC++ Var(flag_implicit_inline_templates) Init(1)
847 Emit implicit instantiations of inline templates
848
849 fimplicit-templates
850 C++ ObjC++ Var(flag_implicit_templates) Init(1)
851 Emit implicit instantiations of templates
852
853 ffriend-injection
854 C++ ObjC++ Var(flag_friend_injection)
855 Inject friend functions into enclosing namespace
856
857 fkeep-inline-dllexport
858 C C++ ObjC ObjC++ Var(flag_keep_inline_dllexport) Init(1) Report Condition(TARGET_DLLIMPORT_DECL_ATTRIBUTES)
859 Don't emit dllexported inline functions unless needed
860
861 flabels-ok
862 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
863
864 flax-vector-conversions
865 C ObjC C++ ObjC++ Var(flag_lax_vector_conversions)
866 Allow implicit conversions between vectors with differing numbers of subparts and/or differing element types.
867
868 fms-extensions
869 C ObjC C++ ObjC++ Var(flag_ms_extensions)
870 Don't warn about uses of Microsoft extensions
871
872 fmudflap
873 C ObjC C++ ObjC++ RejectNegative Report Var(flag_mudflap)
874 Add mudflap bounds-checking instrumentation for single-threaded program
875
876 fmudflapth
877 C ObjC C++ ObjC++ RejectNegative Report Var(flag_mudflap,2)
878 Add mudflap bounds-checking instrumentation for multi-threaded program
879
880 fmudflapir
881 C ObjC C++ ObjC++ RejectNegative Report Var(flag_mudflap_ignore_reads)
882 Ignore read operations when inserting mudflap instrumentation
883
884 fname-mangling-version-
885 C++ ObjC++ Joined Ignore Warn(switch %qs is no longer supported)
886
887 fnew-abi
888 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
889
890 fnext-runtime
891 ObjC ObjC++ LTO Report RejectNegative Var(flag_next_runtime)
892 Generate code for NeXT (Apple Mac OS X) runtime environment
893
894 fnil-receivers
895 ObjC ObjC++ Var(flag_nil_receivers) Init(1)
896 Assume that receivers of Objective-C messages may be nil
897
898 fnonansi-builtins
899 C++ ObjC++ Var(flag_no_nonansi_builtin, 0)
900
901 fnonnull-objects
902 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
903
904 fnothrow-opt
905 C++ ObjC++ Optimization Var(flag_nothrow_opt)
906 Treat a throw() exception specification as noexcept to improve code size
907
908 fobjc-abi-version=
909 ObjC ObjC++ LTO Joined Report RejectNegative UInteger Var(flag_objc_abi)
910 Specify which ABI to use for Objective-C family code and meta-data generation.
911
912 ; Generate special '- .cxx_construct' and '- .cxx_destruct' methods
913 ; to initialize any non-POD ivars in Objective-C++ classes.
914 fobjc-call-cxx-cdtors
915 ObjC++ Var(flag_objc_call_cxx_cdtors)
916 Generate special Objective-C methods to initialize/destroy non-POD C++ ivars, if needed
917
918 fobjc-direct-dispatch
919 ObjC ObjC++ Var(flag_objc_direct_dispatch)
920 Allow fast jumps to the message dispatcher
921
922 ; Nonzero means that we will allow new ObjC exception syntax (@throw,
923 ; @try, etc.) in source code.
924 fobjc-exceptions
925 ObjC ObjC++ Var(flag_objc_exceptions)
926 Enable Objective-C exception and synchronization syntax
927
928 fobjc-gc
929 ObjC ObjC++ LTO Var(flag_objc_gc)
930 Enable garbage collection (GC) in Objective-C/Objective-C++ programs
931
932 fobjc-nilcheck
933 ObjC ObjC++ Var(flag_objc_nilcheck,1)
934 Enable inline checks for nil receivers with the NeXT runtime and ABI version 2.
935
936 ; Nonzero means that we generate NeXT setjmp based exceptions.
937 fobjc-sjlj-exceptions
938 ObjC ObjC++ Var(flag_objc_sjlj_exceptions) Init(-1)
939 Enable Objective-C setjmp exception handling runtime
940
941 fobjc-std=objc1
942 ObjC ObjC++ Var(flag_objc1_only)
943 Conform to the Objective-C 1.0 language as implemented in GCC 4.0
944
945 fopenmp
946 C ObjC C++ ObjC++ Var(flag_openmp)
947 Enable OpenMP (implies -frecursive in Fortran)
948
949 foperator-names
950 C++ ObjC++
951 Recognize C++ keywords like \"compl\" and \"xor\"
952
953 foptional-diags
954 C++ ObjC++ Ignore
955 Does nothing.  Preserved for backward compatibility.
956
957 fpch-deps
958 C ObjC C++ ObjC++
959
960 fpch-preprocess
961 C ObjC C++ ObjC++
962 Look for and use PCH files even when preprocessing
963
964 fpermissive
965 C++ ObjC++
966 Downgrade conformance errors to warnings
967
968 fplan9-extensions
969 C ObjC Var(flag_plan9_extensions)
970 Enable Plan 9 language extensions
971
972 fpreprocessed
973 C ObjC C++ ObjC++
974 Treat the input file as already preprocessed
975
976 ftrack-macro-expansion
977 C ObjC C++ ObjC++ JoinedOrMissing RejectNegative UInteger
978 ; converted into ftrack-macro-expansion=
979
980 ftrack-macro-expansion=
981 C ObjC C++ ObjC++ JoinedOrMissing RejectNegative UInteger
982 -ftrack-macro-expansion=<0|1|2>  Track locations of tokens coming from macro expansion and display them in error messages
983
984 fpretty-templates
985 C++ ObjC++ Var(flag_pretty_templates) Init(1)
986 -fno-pretty-templates Do not pretty-print template specializations as the template signature followed by the arguments
987
988 freplace-objc-classes
989 ObjC ObjC++ LTO Var(flag_replace_objc_classes)
990 Used in Fix-and-Continue mode to indicate that object files may be swapped in at runtime
991
992 frepo
993 C++ ObjC++
994 Enable automatic template instantiation
995
996 frtti
997 C++ ObjC++ Optimization Var(flag_rtti) Init(1)
998 Generate run time type descriptor information
999
1000 fshort-double
1001 C ObjC C++ ObjC++ Optimization Var(flag_short_double)
1002 Use the same size for double as for float
1003
1004 fshort-enums
1005 C ObjC C++ ObjC++ Optimization Var(flag_short_enums)
1006 Use the narrowest integer type possible for enumeration types
1007
1008 fshort-wchar
1009 C ObjC C++ ObjC++ Optimization Var(flag_short_wchar)
1010 Force the underlying type for \"wchar_t\" to be \"unsigned short\"
1011
1012 fsigned-bitfields
1013 C ObjC C++ ObjC++ Var(flag_signed_bitfields) Init(1)
1014 When \"signed\" or \"unsigned\" is not given make the bitfield signed
1015
1016 fsigned-char
1017 C ObjC C++ ObjC++ LTO Var(flag_signed_char)
1018 Make \"char\" signed by default
1019
1020 fsquangle
1021 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1022
1023 fstats
1024 C++ ObjC++ Var(flag_detailed_statistics)
1025 Display statistics accumulated during compilation
1026
1027 fstrict-enums
1028 C++ ObjC++ Optimization Var(flag_strict_enums)
1029 Assume that values of enumeration type are always within the minimum range of that type
1030
1031 fstrict-prototype
1032 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1033
1034 ftabstop=
1035 C ObjC C++ ObjC++ Joined RejectNegative UInteger
1036 -ftabstop=<number>      Distance between tab stops for column reporting
1037
1038 ftemplate-depth-
1039 C++ ObjC++ Joined RejectNegative Undocumented Alias(ftemplate-depth=)
1040
1041 ftemplate-depth=
1042 C++ ObjC++ Joined RejectNegative UInteger
1043 -ftemplate-depth=<number>       Specify maximum template instantiation depth
1044
1045 fthis-is-variable
1046 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1047
1048 fthreadsafe-statics
1049 C++ ObjC++ Optimization Var(flag_threadsafe_statics) Init(1)
1050 -fno-threadsafe-statics Do not generate thread-safe code for initializing local statics
1051
1052 funsigned-bitfields
1053 C ObjC C++ ObjC++ Var(flag_signed_bitfields, 0)
1054 When \"signed\" or \"unsigned\" is not given make the bitfield unsigned
1055
1056 funsigned-char
1057 C ObjC C++ ObjC++ LTO Var(flag_signed_char, 0)
1058 Make \"char\" unsigned by default
1059
1060 fuse-cxa-atexit
1061 C++ ObjC++ Var(flag_use_cxa_atexit) Init(DEFAULT_USE_CXA_ATEXIT)
1062 Use __cxa_atexit to register destructors
1063
1064 fuse-cxa-get-exception-ptr
1065 C++ ObjC++ Var(flag_use_cxa_get_exception_ptr) Init(2)
1066 Use __cxa_get_exception_ptr in exception handling
1067
1068 fvisibility-inlines-hidden
1069 C++ ObjC++
1070 Marks all inlined functions and methods as having hidden visibility
1071
1072 fvisibility-ms-compat
1073 C++ ObjC++ Var(flag_visibility_ms_compat)
1074 Changes visibility to match Microsoft Visual Studio by default
1075
1076 fvtable-gc
1077 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1078 No longer supported
1079
1080 fvtable-thunks
1081 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1082 No longer supported
1083
1084 fweak
1085 C++ ObjC++ Var(flag_weak) Init(1)
1086 Emit common-like symbols as weak symbols
1087
1088 fwide-exec-charset=
1089 C ObjC C++ ObjC++ Joined RejectNegative
1090 -fwide-exec-charset=<cset>      Convert all wide strings and character constants to character set <cset>
1091
1092 fworking-directory
1093 C ObjC C++ ObjC++ Var(flag_working_directory) Init(-1)
1094 Generate a #line directive pointing at the current working directory
1095
1096 fxref
1097 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1098 No longer supported
1099
1100 fzero-link
1101 ObjC ObjC++ Var(flag_zero_link)
1102 Generate lazy class lookup (via objc_getClass()) for use in Zero-Link mode
1103
1104 gen-decls
1105 ObjC ObjC++ Var(flag_gen_declaration)
1106 Dump declarations to a .decl file
1107
1108 femit-struct-debug-baseonly
1109 C ObjC C++ ObjC++
1110 -femit-struct-debug-baseonly    Aggressive reduced debug info for structs
1111
1112 femit-struct-debug-reduced
1113 C ObjC C++ ObjC++
1114 -femit-struct-debug-reduced     Conservative reduced debug info for structs
1115
1116 femit-struct-debug-detailed=
1117 C ObjC C++ ObjC++ Joined
1118 -femit-struct-debug-detailed=<spec-list>        Detailed reduced debug info for structs
1119
1120 idirafter
1121 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1122 -idirafter <dir>        Add <dir> to the end of the system include path
1123
1124 imacros
1125 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1126 -imacros <file> Accept definition of macros in <file>
1127
1128 imultilib
1129 C ObjC C++ ObjC++ Joined Separate
1130 -imultilib <dir>        Set <dir> to be the multilib include subdirectory
1131
1132 include
1133 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1134 -include <file> Include the contents of <file> before other files
1135
1136 iprefix
1137 C ObjC C++ ObjC++ Joined Separate
1138 -iprefix <path> Specify <path> as a prefix for next two options
1139
1140 isysroot
1141 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1142 -isysroot <dir> Set <dir> to be the system root directory
1143
1144 isystem
1145 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1146 -isystem <dir>  Add <dir> to the start of the system include path
1147
1148 iquote
1149 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1150 -iquote <dir>   Add <dir> to the end of the quote include path
1151
1152 iwithprefix
1153 C ObjC C++ ObjC++ Joined Separate
1154 -iwithprefix <dir>      Add <dir> to the end of the system include path
1155
1156 iwithprefixbefore
1157 C ObjC C++ ObjC++ Joined Separate
1158 -iwithprefixbefore <dir>        Add <dir> to the end of the main include path
1159
1160 lang-asm
1161 C Undocumented RejectDriver
1162
1163 no-integrated-cpp
1164 Driver
1165
1166 nostdinc
1167 C ObjC C++ ObjC++
1168 Do not search standard system include directories (those specified with -isystem will still be used)
1169
1170 nostdinc++
1171 C++ ObjC++
1172 Do not search standard system include directories for C++
1173
1174 o
1175 C ObjC C++ ObjC++ Joined Separate
1176 ; Documented in common.opt
1177
1178 pedantic
1179 C ObjC C++ ObjC++
1180 ; Documented in common.opt
1181
1182 pedantic-errors
1183 C ObjC C++ ObjC++
1184 ; Documented in common.opt
1185
1186 print-objc-runtime-info
1187 ObjC ObjC++
1188 Generate C header of platform-specific features
1189
1190 remap
1191 C ObjC C++ ObjC++
1192 Remap file names when including files
1193
1194 std=c++98
1195 C++ ObjC++
1196 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1197
1198 std=c++03
1199 C++ ObjC++ Alias(std=c++98)
1200 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1201
1202 std=c++11
1203 C++ ObjC++
1204 Conform to the ISO 2011 C++ standard (experimental and incomplete support)
1205
1206 std=c++0x
1207 C++ ObjC++ Alias(std=c++11)
1208 Deprecated in favor of -std=c++11
1209
1210 std=c11
1211 C ObjC
1212 Conform to the ISO 2011 C standard (experimental and incomplete support)
1213
1214 std=c1x
1215 C ObjC Alias(std=c11)
1216 Deprecated in favor of -std=c11
1217
1218 std=c89
1219 C ObjC Alias(std=c90)
1220 Conform to the ISO 1990 C standard
1221
1222 std=c90
1223 C ObjC
1224 Conform to the ISO 1990 C standard
1225
1226 std=c99
1227 C ObjC
1228 Conform to the ISO 1999 C standard
1229
1230 std=c9x
1231 C ObjC Alias(std=c99)
1232 Deprecated in favor of -std=c99
1233
1234 std=gnu++98
1235 C++ ObjC++
1236 Conform to the ISO 1998 C++ standard revised by the 2003 technical
1237 corrigendum with GNU extensions
1238
1239 std=gnu++03
1240 C++ ObjC++ Alias(std=gnu++98)
1241 Conform to the ISO 1998 C++ standard revised by the 2003 technical
1242 corrigendum with GNU extensions
1243
1244 std=gnu++11
1245 C++ ObjC++
1246 Conform to the ISO 2011 C++ standard with GNU extensions (experimental and incomplete support)
1247
1248 std=gnu++0x
1249 C++ ObjC++ Alias(std=gnu++11)
1250 Deprecated in favor of -std=gnu++11
1251
1252 std=gnu11
1253 C ObjC
1254 Conform to the ISO 2011 C standard with GNU extensions (experimental and incomplete support)
1255
1256 std=gnu1x
1257 C ObjC Alias(std=gnu11)
1258 Deprecated in favor of -std=gnu11
1259
1260 std=gnu89
1261 C ObjC Alias(std=gnu90)
1262 Conform to the ISO 1990 C standard with GNU extensions
1263
1264 std=gnu90
1265 C ObjC
1266 Conform to the ISO 1990 C standard with GNU extensions
1267
1268 std=gnu99
1269 C ObjC
1270 Conform to the ISO 1999 C standard with GNU extensions
1271
1272 std=gnu9x
1273 C ObjC Alias(std=gnu99)
1274 Deprecated in favor of -std=gnu99
1275
1276 std=iso9899:1990
1277 C ObjC Alias(std=c90)
1278 Conform to the ISO 1990 C standard
1279
1280 std=iso9899:199409
1281 C ObjC
1282 Conform to the ISO 1990 C standard as amended in 1994
1283
1284 std=iso9899:1999
1285 C ObjC Alias(std=c99)
1286 Conform to the ISO 1999 C standard
1287
1288 std=iso9899:199x
1289 C ObjC Alias(std=c99)
1290 Deprecated in favor of -std=iso9899:1999
1291
1292 std=iso9899:2011
1293 C ObjC Alias(std=c11)
1294 Conform to the ISO 2011 C standard (experimental and incomplete support)
1295
1296 traditional
1297 Driver
1298
1299 traditional-cpp
1300 C ObjC C++ ObjC++
1301 Enable traditional preprocessing
1302
1303 trigraphs
1304 C ObjC C++ ObjC++
1305 -trigraphs      Support ISO C trigraphs
1306
1307 undef
1308 C ObjC C++ ObjC++ Var(flag_undef)
1309 Do not predefine system-specific and GCC-specific macros
1310
1311 v
1312 C ObjC C++ ObjC++
1313 ; Documented in common.opt
1314
1315 w
1316 C ObjC C++ ObjC++
1317 ; Documented in common.opt
1318
1319 ; This comment is to ensure we retain the blank line above.