c.opt 24.6 KB
Newer Older
1
; Options for the C, ObjC, C++ and ObjC++ front ends.
2 3
; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009
; Free Software Foundation, Inc.
4 5 6 7 8
;
; This file is part of GCC.
;
; GCC is free software; you can redistribute it and/or modify it under
; 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.
Mike Stump committed
11
;
12 13 14 15
; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
; WARRANTY; without even the implied warranty of MERCHANTABILITY or
; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
; for more details.
Mike Stump committed
16
;
17
; You should have received a copy of the GNU General Public License
18 19
; along with GCC; see the file COPYING3.  If not see
; <http://www.gnu.org/licenses/>.
20

21
; See the GCC internals manual for a description of this file's format.
22 23 24

; Please try to keep this file in ASCII collating order.

25 26 27 28 29 30 31 32 33 34 35 36
Language
C

Language
ObjC

Language
C++

Language
ObjC++

37 38 39 40 41
-output-pch=
C ObjC C++ ObjC++ Joined Separate

A
C ObjC C++ ObjC++ Joined Separate
42
-A<question>=<answer>	Assert the <answer> to <question>.  Putting '-' before <question> disables the <answer> to <question>
43 44 45

C
C ObjC C++ ObjC++
46
Do not discard comments
47 48 49

CC
C ObjC C++ ObjC++
50
Do not discard comments in macro expansions
51 52 53

D
C ObjC C++ ObjC++ Joined Separate
54
-D<macro>[=<val>]	Define a <macro> with <val> as its value.  If just <macro> is given, <val> is taken to be 1
55 56

E
57
C ObjC C++ ObjC++ Undocumented
58

59 60
F
C ObjC C++ ObjC++ Joined Separate
61
-F <dir>	Add <dir> to the end of the main framework include path
62

63 64
H
C ObjC C++ ObjC++
65
Print the name of header files as they are used
66 67 68

I
C ObjC C++ ObjC++ Joined Separate
69
-I <dir>	Add <dir> to the end of the main include path
70 71 72

M
C ObjC C++ ObjC++
73
Generate make dependencies
74 75 76

MD
C ObjC C++ ObjC++ Separate
77
Generate make dependencies and compile
78 79 80

MF
C ObjC C++ ObjC++ Joined Separate
81
-MF <file>	Write dependency output to the given file
82 83 84

MG
C ObjC C++ ObjC++
85
Treat missing header files as generated files
86 87 88

MM
C ObjC C++ ObjC++
89
Like -M but ignore system header files
90 91 92

MMD
C ObjC C++ ObjC++ Separate
93
Like -MD but ignore system header files
94 95 96

MP
C ObjC C++ ObjC++
97
Generate phony targets for all headers
98 99 100

MQ
C ObjC C++ ObjC++ Joined Separate
101
-MQ <target>	Add a MAKE-quoted target
102 103 104

MT
C ObjC C++ ObjC++ Joined Separate
105
-MT <target>	Add an unquoted target
106 107 108

P
C ObjC C++ ObjC++
109
Do not generate #line directives
110 111 112

U
C ObjC C++ ObjC++ Joined Separate
113
-U<macro>	Undefine <macro>
114 115

Wabi
116
C ObjC C++ ObjC++ Var(warn_abi) Warning
117
Warn about things that will change when compiling with an ABI-compliant compiler
118

119 120 121
Wpsabi
C ObjC C++ ObjC++ Var(warn_psabi) Init(1) Undocumented

122 123 124 125
Waddress
C ObjC C++ ObjC++ Var(warn_address) Warning
Warn about suspicious uses of memory addresses

126
Wall
127
C ObjC C++ ObjC++ Warning
128
Enable most warning messages
129

130
Wassign-intercept
131
ObjC ObjC++ Var(warn_assign_intercept) Warning
132 133
Warn whenever an Objective-C assignment is being intercepted by the garbage collector

134
Wbad-function-cast
135
C ObjC Var(warn_bad_function_cast) Warning
136
Warn about casting functions to incompatible types
137

138 139 140 141
Wbuiltin-macro-redefined
C ObjC C++ ObjC++ Warning
Warn when a built-in preprocessor macro is undefined or redefined

142
Wc++-compat
143
C ObjC Var(warn_cxx_compat) Warning
144 145
Warn about C constructs that are not in the common subset of C and C++

146
Wc++0x-compat
147
C++ ObjC++ Var(warn_cxx0x_compat) Warning
148
Warn about C++ constructs whose meaning differs between ISO C++ 1998 and ISO C++ 200x
149

150
Wcast-qual
151
C ObjC C++ ObjC++ Var(warn_cast_qual) Warning
152
Warn about casts which discard qualifiers
153 154

Wchar-subscripts
155
C ObjC C++ ObjC++ Var(warn_char_subscripts) Warning
156
Warn about subscripts whose type is \"char\"
157

158
Wclobbered
159
C ObjC C++ ObjC++ Var(warn_clobbered) Init(-1) Warning
160 161
Warn about variables that might be changed by \"longjmp\" or \"vfork\"

162
Wcomment
163
C ObjC C++ ObjC++ Warning
164
Warn about possibly nested block comments, and C++ comments spanning more than one physical line
165 166

Wcomments
167
C ObjC C++ ObjC++ Warning
168
Synonym for -Wcomment
169 170

Wconversion
171
C ObjC C++ ObjC++ Var(warn_conversion) Warning
172
Warn for implicit type conversions that may change a value
173

174 175 176 177
Wsign-conversion
C ObjC C++ ObjC++ Var(warn_sign_conversion) Init(-1)
Warn for implicit type conversions between signed and unsigned integers

178
Wctor-dtor-privacy
179
C++ ObjC++ Var(warn_ctor_dtor_privacy) Warning
180
Warn when all constructors and destructors are private
181

182
Wdeclaration-after-statement
183
C ObjC Var(warn_declaration_after_statement) Warning
184 185
Warn when a declaration is found after a statement

186
Wdeprecated
187
C C++ ObjC ObjC++ Var(warn_deprecated) Init(1) Warning
188
Warn if a deprecated compiler feature, class, method, or field is used
189 190

Wdiv-by-zero
191
C ObjC C++ ObjC++ Var(warn_div_by_zero) Init(1) Warning
192
Warn about compile-time integer division by zero
193 194

Weffc++
195
C++ ObjC++ Var(warn_ecpp) Warning
196
Warn about violations of Effective C++ style rules
197

198
Wempty-body
199
C ObjC C++ ObjC++ Var(warn_empty_body) Init(-1) Warning
200 201
Warn about an empty body in an if or else statement

202
Wendif-labels
203
C ObjC C++ ObjC++ Warning
204
Warn about stray tokens after #elif and #endif
205

Michael Matz committed
206
Wenum-compare
207
C ObjC C++ ObjC++ Var(warn_enum_compare) Init(-1) Warning
Michael Matz committed
208 209
Warn about comparison of different enum types

210 211
Werror
C ObjC C++ ObjC++
212
; Documented in common.opt
213 214

Werror-implicit-function-declaration
215
C ObjC RejectNegative Warning
216
This switch is deprecated; use -Werror=implicit-function-declaration instead
217 218

Wfloat-equal
219
C ObjC C++ ObjC++ Var(warn_float_equal) Warning
220
Warn if testing floating point numbers for equality
221 222

Wformat
223
C ObjC C++ ObjC++ Warning
224
Warn about printf/scanf/strftime/strfmon format string anomalies
225 226

Wformat-extra-args
227
C ObjC C++ ObjC++ Var(warn_format_extra_args) Warning
228
Warn if passing too many arguments to a function for its format string
229 230

Wformat-nonliteral
231
C ObjC C++ ObjC++ Var(warn_format_nonliteral) Warning
232
Warn about format strings that are not literals
233

234
Wformat-contains-nul
235
C ObjC C++ ObjC++ Var(warn_format_contains_nul) Warning
236 237
Warn about format strings that contain NUL bytes

238
Wformat-security
239
C ObjC C++ ObjC++ Var(warn_format_security) Warning
240
Warn about possible security problems with format functions
241 242

Wformat-y2k
243
C ObjC C++ ObjC++ Var(warn_format_y2k) Warning
244
Warn about strftime formats yielding 2-digit years
245 246

Wformat-zero-length
247
C ObjC Var(warn_format_zero_length) Warning
248
Warn about zero-length formats
249 250

Wformat=
251
C ObjC C++ ObjC++ Joined Warning
252

253 254 255 256
Wignored-qualifiers
C C++ Var(warn_ignored_qualifiers) Init(-1) Warning
Warn whenever type qualifiers are ignored.

Andrew Pinski committed
257
Winit-self
258
C ObjC C++ ObjC++ Var(warn_init_self) Warning
259
Warn about variables which are initialized to themselves
Andrew Pinski committed
260

261
Wimplicit
262
C ObjC C++ ObjC++ Warning
263 264

Wimplicit-function-declaration
265
C ObjC Var(warn_implicit_function_declaration) Init(-1) Warning
266
Warn about implicit function declarations
267 268

Wimplicit-int
269
C ObjC Var(warn_implicit_int) Warning
270
Warn when a declaration does not specify a type
271 272

Wimport
273
C ObjC C++ ObjC++ Undocumented
274

275
Wint-to-pointer-cast
276
C ObjC Var(warn_int_to_pointer_cast) Init(1) Warning
277 278
Warn when there is a cast to a pointer from an integer of a different size

279
Winvalid-offsetof
280
C++ ObjC++ Var(warn_invalid_offsetof) Init(1) Warning
281
Warn about invalid uses of the \"offsetof\" macro
282 283

Winvalid-pch
284
C ObjC C++ ObjC++ Warning
285
Warn about PCH files that are found but not used
286

287 288 289 290
Wjump-misses-init
C Objc Var(warn_jump_misses_init) Init(-1) Warning
Warn when a jump misses a variable initialization

291
Wlogical-op
292
C ObjC C++ ObjC++ Var(warn_logical_op) Init(0) Warning 
293 294
Warn when a logical operator is suspiciously always evaluating to true or false

295
Wlong-long
296
C ObjC C++ ObjC++ Var(warn_long_long) Init(-1) Warning
297
Do not warn about using \"long long\" when -pedantic
298 299

Wmain
300
C ObjC C++ ObjC++ Var(warn_main) Init(-1) Warning
301
Warn about suspicious declarations of \"main\"
302 303

Wmissing-braces
304
C ObjC C++ ObjC++ Var(warn_missing_braces) Warning
305
Warn about possibly missing braces around initializers
306 307

Wmissing-declarations
308
C ObjC C++ ObjC++ Var(warn_missing_declarations) Warning
309
Warn about global functions without previous declarations
310

311
Wmissing-field-initializers
312
C ObjC C++ ObjC++ Var(warn_missing_field_initializers) Init(-1) Warning
313 314
Warn about missing fields in struct initializers

315
Wmissing-format-attribute
316
C ObjC C++ ObjC++ Var(warn_missing_format_attribute) Warning
317
Warn about functions which might be candidates for format attributes
318

319
Wmissing-include-dirs
320
C ObjC C++ ObjC++ Warning
321 322
Warn about user-specified include directories that do not exist

323
Wmissing-parameter-type
324
C ObjC Var(warn_missing_parameter_type) Init(-1) Warning
325 326
Warn about function parameters declared without a type specifier in K&R-style functions

327
Wmissing-prototypes
328
C ObjC Var(warn_missing_prototypes) Warning
329
Warn about global functions without prototypes
330 331

Wmultichar
332
C ObjC C++ ObjC++ Warning
333
Warn about use of multi-character character constants
334 335

Wnested-externs
336
C ObjC Var(warn_nested_externs) Warning
337
Warn about \"extern\" declarations not at file scope
338 339

Wnon-template-friend
340
C++ ObjC++ Var(warn_nontemplate_friend) Init(1) Warning
341
Warn when non-templatized friend functions are declared within a template
342 343

Wnon-virtual-dtor
344
C++ ObjC++ Var(warn_nonvdtor) Warning
345
Warn about non-virtual destructors
346 347

Wnonnull
348
C ObjC Var(warn_nonnull) Warning
349
Warn about NULL being passed to argument slots marked as requiring non-NULL
350

Geoffrey Keating committed
351
Wnormalized=
352
C ObjC C++ ObjC++ Joined Warning
Geoffrey Keating committed
353 354
-Wnormalized=<id|nfc|nfkc>	Warn about non-normalised Unicode strings

355
Wold-style-cast
356
C++ ObjC++ Var(warn_old_style_cast) Warning
357
Warn if a C-style cast is used in a program
358

359
Wold-style-declaration
360
C ObjC Var(warn_old_style_declaration) Init(-1) Warning
361 362
Warn for obsolescent usage in a declaration

363
Wold-style-definition
364
C ObjC Var(warn_old_style_definition) Warning
365 366
Warn if an old-style parameter definition is used

367
Woverlength-strings
368
C ObjC C++ ObjC++ Var(warn_overlength_strings) Init(-1) Warning
369 370
Warn if a string is longer than the maximum portable length specified by the standard

371
Woverloaded-virtual
372
C++ ObjC++ Var(warn_overloaded_virtual) Warning
373
Warn about overloaded virtual function names
374

375
Woverride-init
376
C ObjC Var(warn_override_init) Init(-1) Warning
377 378
Warn about overriding initializers without side effects

379
Wpacked-bitfield-compat
380
C ObjC C++ ObjC++ Var(warn_packed_bitfield_compat) Init(-1) Warning
381 382
Warn about packed bit-fields whose offset changed in GCC 4.4

383
Wparentheses
384
C ObjC C++ ObjC++ Var(warn_parentheses) Warning
385
Warn about possibly missing parentheses
386 387

Wpmf-conversions
388
C++ ObjC++ Var(warn_pmf2ptr) Init(1) Warning
389
Warn when converting the type of pointers to member functions
390 391

Wpointer-arith
392
C ObjC C++ ObjC++ Var(warn_pointer_arith) Warning
393
Warn about function pointer arithmetic
394

395
Wpointer-to-int-cast
396
C ObjC Var(warn_pointer_to_int_cast) Init(1) Warning
397 398
Warn when a pointer is cast to an integer of a different size

399
Wpragmas
400
C ObjC C++ ObjC++ Var(warn_pragmas) Init(1) Warning
401 402
Warn about misuses of pragmas

403
Wprotocol
404
ObjC ObjC++ Var(warn_protocol) Init(1) Warning
405
Warn if inherited methods are unimplemented
406 407

Wredundant-decls
408
C ObjC C++ ObjC++ Var(warn_redundant_decls) Warning
409
Warn about multiple declarations of the same object
410 411

Wreorder
412
C++ ObjC++ Var(warn_reorder) Warning
413
Warn when the compiler reorders code
414 415

Wreturn-type
416
C ObjC C++ ObjC++ Var(warn_return_type) Warning
417
Warn whenever a function's return type defaults to \"int\" (C), or about inconsistent return types (C++)
418 419

Wselector
420
ObjC ObjC++ Var(warn_selector) Warning
421
Warn if a selector has multiple methods
422 423

Wsequence-point
424
C ObjC C++ ObjC++ Var(warn_sequence_point) Warning
425
Warn about possible violations of sequence point rules
426 427

Wsign-compare
428
C ObjC C++ ObjC++ Var(warn_sign_compare) Init(-1) Warning
429
Warn about signed-unsigned comparisons
430 431

Wsign-promo
432
C++ ObjC++ Var(warn_sign_promo) Warning
433
Warn when overload promotes from unsigned to signed
434

435
Wstrict-null-sentinel
436
C++ ObjC++ Warning
437 438
Warn about uncasted NULL used as sentinel

439
Wstrict-prototypes
440
C ObjC Var(warn_strict_prototypes) Warning
441
Warn about unprototyped function declarations
442

443
Wstrict-selector-match
444
ObjC ObjC++ Var(warn_strict_selector_match) Warning
445 446
Warn if type signatures of candidate methods do not match exactly

447 448 449 450
Wsync-nand
C C++ Var(warn_sync_nand) Init(1) Warning
Warn when __sync_fetch_and_nand and __sync_nand_and_fetch built-in functions are used

451
Wsynth
452
C++ ObjC++ Var(warn_synth) Warning
453
Deprecated.  This switch has no effect
454 455

Wsystem-headers
456
C ObjC C++ ObjC++ Warning
457
; Documented in common.opt
458 459

Wtraditional
460
C ObjC Var(warn_traditional) Warning
461
Warn about features not present in traditional C
462

463
Wtraditional-conversion
464
C ObjC Var(warn_traditional_conversion) Warning
465 466
Warn of prototypes causing type conversions different from what would happen in the absence of prototype

467
Wtrigraphs
468
C ObjC C++ ObjC++ Warning
469
Warn if trigraphs are encountered that might affect the meaning of the program
470 471

Wundeclared-selector
472
ObjC ObjC++ Var(warn_undeclared_selector) Warning
473
Warn about @selector()s without previously declared methods
474 475

Wundef
476
C ObjC C++ ObjC++ Warning
477
Warn if an undefined macro is used in an #if directive
478 479

Wunknown-pragmas
480
C ObjC C++ ObjC++ Warning
481
Warn about unrecognized pragmas
482

483 484 485 486
Wunsuffixed-float-constants
C ObjC Var(warn_unsuffixed_float_constants) Warning
Warn about unsuffixed float constants

487
Wunused-macros
488
C ObjC C++ ObjC++ Warning
489
Warn about macros defined in the main file that are not used
490

491 492 493 494
Wunused-result
C ObjC C++ ObjC++ Var(warn_unused_result) Init(1) Warning
Warn if a caller of a function, marked with attribute warn_unused_result, does not use its return value

495
Wvariadic-macros
496
C ObjC C++ ObjC++ Warning
497 498
Do not warn about using variadic macros when -pedantic

499 500 501 502
Wvla
C ObjC C++ ObjC++ Var(warn_vla) Init(-1) Warning
Warn if a variable length array is used

503 504 505 506
Wvolatile-register-var
C ObjC C++ ObjC++ Var(warn_volatile_register_var) Warning
Warn when a register variable is declared volatile

507
Wwrite-strings
508
C ObjC C++ ObjC++ Var(warn_write_strings) Warning
509
In C++, nonzero means warn about deprecated conversion from string literals to `char *'.  In C, similar warning, except that the conversion is of course not deprecated by the ISO C standard.
510

Andreas Jaeger committed
511
Wpointer-sign
512
C ObjC Var(warn_pointer_sign) Init(-1) Warning
513
Warn when a pointer differs in signedness in an assignment
Andreas Jaeger committed
514

515 516
ansi
C ObjC C++ ObjC++
517
A synonym for -std=c89 (for C) or -std=c++98 (for C++)
518 519 520

d
C ObjC C++ ObjC++ Joined
521
; Documented in common.opt.  FIXME - what about -dI, -dD, -dN and -dD?
522 523 524

faccess-control
C++ ObjC++
525
Enforce class member access control semantics
526 527 528 529 530 531

fall-virtual
C++ ObjC++

falt-external-templates
C++ ObjC++
532
Change when template instances are emitted
533 534 535

fasm
C ObjC C++ ObjC++
536
Recognize the \"asm\" keyword
537 538 539

fbuiltin
C ObjC C++ ObjC++
540
Recognize built-in functions
541 542 543 544 545 546

fbuiltin-
C ObjC C++ ObjC++ Joined

fcheck-new
C++ ObjC++
547
Check the return value of new
548 549 550

fcond-mismatch
C ObjC C++ ObjC++
551
Allow the arguments of the '?' operator to have different types
552 553 554

fconserve-space
C++ ObjC++
555
Reduce the size of object files
556 557 558

fconstant-string-class=
ObjC ObjC++ Joined
559
-fconst-string-class=<name>	Use class <name> for constant strings
560 561 562

fdefault-inline
C++ ObjC++
563
Inline member functions by default
564

565 566 567 568
fdirectives-only
C ObjC C++ ObjC++
Preprocess directives only.

569 570
fdollars-in-identifiers
C ObjC C++ ObjC++
571
Permit '$' as an identifier character
572 573 574 575 576 577

felide-constructors
C++ ObjC++

fenforce-eh-specs
C++ ObjC++
578
Generate code to check exception specifications
579 580 581 582

fenum-int-equiv
C++ ObjC++

583 584
fexec-charset=
C ObjC C++ ObjC++ Joined RejectNegative
585
-fexec-charset=<cset>	Convert all strings and character constants to character set <cset>
586

587 588 589 590
fextended-identifiers
C ObjC C++ ObjC++
Permit universal character names (\\u and \\U) in identifiers

Eric Christopher committed
591 592
finput-charset=
C ObjC C++ ObjC++ Joined RejectNegative
593
-finput-charset=<cset>	Specify the default character set for source files
Eric Christopher committed
594 595


596 597 598 599 600
fexternal-templates
C++ ObjC++

ffor-scope
C++ ObjC++
601
Scope of for-init-statement variables is local to the loop
602 603

ffreestanding
604
C ObjC C++ ObjC++
605
Do not assume that standard C libraries and \"main\" exist
606 607 608

fgnu-keywords
C++ ObjC++
609
Recognize GNU-defined keywords
610 611 612

fgnu-runtime
ObjC ObjC++
613
Generate code for GNU runtime environment
614

615
fgnu89-inline
616
C ObjC Var(flag_gnu89_inline) Init(-1)
617 618
Use traditional GNU semantics for inline functions

619 620 621 622
fguiding-decls
C++ ObjC++

fhandle-exceptions
623
C++ ObjC++ Optimization
624 625 626 627 628 629

fhonor-std
C++ ObjC++

fhosted
C ObjC
630
Assume normal C execution environment
631 632 633

fhuge-objects
C++ ObjC++
634
Enable support for huge objects
635 636 637

fimplement-inlines
C++ ObjC++
638
Export functions even if they can be inlined
639 640 641

fimplicit-inline-templates
C++ ObjC++
642
Emit implicit instantiations of inline templates
643 644 645

fimplicit-templates
C++ ObjC++
646
Emit implicit instantiations of templates
647

648
ffriend-injection
649
C++ ObjC++ Var(flag_friend_injection)
650 651
Inject friend functions into enclosing namespace

652 653 654
flabels-ok
C++ ObjC++

655 656 657 658
flax-vector-conversions
C ObjC C++ ObjC++
Allow implicit conversions between vectors with differing numbers of subparts and/or differing element types.

659 660
fms-extensions
C ObjC C++ ObjC++
661
Don't warn about uses of Microsoft extensions
662 663 664 665 666 667 668 669 670

fname-mangling-version-
C++ ObjC++ Joined

fnew-abi
C++ ObjC++

fnext-runtime
ObjC ObjC++
671 672 673 674 675
Generate code for NeXT (Apple Mac OS X) runtime environment

fnil-receivers
ObjC ObjC++
Assume that receivers of Objective-C messages may be nil
676 677 678 679 680 681 682

fnonansi-builtins
C++ ObjC++

fnonnull-objects
C++ ObjC++

683 684 685 686 687 688 689 690 691 692 693 694
; Generate special '- .cxx_construct' and '- .cxx_destruct' methods
; to initialize any non-POD ivars in Objective-C++ classes.
fobjc-call-cxx-cdtors
ObjC++ Var(flag_objc_call_cxx_cdtors)
Generate special Objective-C methods to initialize/destroy non-POD C++ ivars, if needed

fobjc-direct-dispatch
ObjC ObjC++ Var(flag_objc_direct_dispatch)
Allow fast jumps to the message dispatcher

; Nonzero means that we will allow new ObjC exception syntax (@throw,
; @try, etc.) in source code.
695
fobjc-exceptions
696
ObjC ObjC++ Var(flag_objc_exceptions)
697 698
Enable Objective-C exception and synchronization syntax

699 700 701 702 703
fobjc-gc
ObjC ObjC++ Var(flag_objc_gc)
Enable garbage collection (GC) in Objective-C/Objective-C++ programs

; Nonzero means that we generate NeXT setjmp based exceptions.
704
fobjc-sjlj-exceptions
705
ObjC ObjC++ Var(flag_objc_sjlj_exceptions) Init(-1)
706 707
Enable Objective-C setjmp exception handling runtime

Diego Novillo committed
708 709
fopenmp
C ObjC C++ ObjC++ Var(flag_openmp)
710
Enable OpenMP (implies -frecursive in Fortran)
Diego Novillo committed
711

712 713
foperator-names
C++ ObjC++
714
Recognize C++ keywords like \"compl\" and \"xor\"
715 716 717

foptional-diags
C++ ObjC++
718
Enable optional diagnostics
719 720 721 722

fpch-deps
C ObjC C++ ObjC++

723 724 725 726
fpch-preprocess
C ObjC C++ ObjC++
Look for and use PCH files even when preprocessing

727 728
fpermissive
C++ ObjC++
729
Downgrade conformance errors to warnings
730 731 732

fpreprocessed
C ObjC C++ ObjC++
733
Treat the input file as already preprocessed
734

735 736 737 738
fpretty-templates
C++ ObjC++
-fno-pretty-templates Do not pretty-print template specializations as the template signature followed by the arguments

739 740 741 742
freplace-objc-classes
ObjC ObjC++
Used in Fix-and-Continue mode to indicate that object files may be swapped in at runtime

743 744
frepo
C++ ObjC++
745
Enable automatic template instantiation
746 747

frtti
748
C++ ObjC++ Optimization
749
Generate run time type descriptor information
750 751

fshort-double
752
C ObjC C++ ObjC++ Optimization
753
Use the same size for double as for float
754 755

fshort-enums
756
C ObjC C++ ObjC++ Optimization
757
Use the narrowest integer type possible for enumeration types
758 759

fshort-wchar
760
C ObjC C++ ObjC++ Optimization
761
Force the underlying type for \"wchar_t\" to be \"unsigned short\"
762 763 764

fsigned-bitfields
C ObjC C++ ObjC++
765
When \"signed\" or \"unsigned\" is not given make the bitfield signed
766 767 768

fsigned-char
C ObjC C++ ObjC++
769
Make \"char\" signed by default
770 771 772 773 774 775

fsquangle
C++ ObjC++

fstats
C++ ObjC++
776
Display statistics accumulated during compilation
777 778 779 780 781

fstrict-prototype
C++ ObjC++

ftabstop=
782
C ObjC C++ ObjC++ Joined RejectNegative UInteger
783
-ftabstop=<number>	Distance between tab stops for column reporting
784 785

ftemplate-depth-
Mike Stump committed
786
C++ ObjC++ Joined RejectNegative UInteger
787
-ftemplate-depth-<number>	Specify maximum template instantiation depth
788 789 790 791

fthis-is-variable
C++ ObjC++

792
fthreadsafe-statics
793
C++ ObjC++ Optimization
794
-fno-threadsafe-statics	Do not generate thread-safe code for initializing local statics
795

796 797
funsigned-bitfields
C ObjC C++ ObjC++
798
When \"signed\" or \"unsigned\" is not given make the bitfield unsigned
799 800 801

funsigned-char
C ObjC C++ ObjC++
802
Make \"char\" unsigned by default
803 804 805

fuse-cxa-atexit
C++ ObjC++
806
Use __cxa_atexit to register destructors
807

Geoffrey Keating committed
808 809 810 811
fuse-cxa-get-exception-ptr
C++ ObjC++
Use __cxa_get_exception_ptr in exception handling

812
fvisibility-inlines-hidden
813
C++ ObjC++
814 815
Marks all inlined methods as having hidden visibility

Geoffrey Keating committed
816 817 818 819
fvisibility-ms-compat
C++ ObjC++ Var(flag_visibility_ms_compat)
Changes visibility to match Microsoft Visual Studio by default

820 821
fvtable-gc
C++ ObjC++
822
Discard unused virtual functions
823 824 825

fvtable-thunks
C++ ObjC++
826
Implement vtables using thunks
827 828 829

fweak
C++ ObjC++
830
Emit common-like symbols as weak symbols
831

832 833
fwide-exec-charset=
C ObjC C++ ObjC++ Joined RejectNegative
834
-fwide-exec-charset=<cset>	Convert all wide strings and character constants to character set <cset>
835

836 837 838 839
fworking-directory
C ObjC C++ ObjC++
Generate a #line directive pointing at the current working directory

840 841
fxref
C++ ObjC++
842
Emit cross referencing information
843

844 845 846 847
fzero-link
ObjC ObjC++
Generate lazy class lookup (via objc_getClass()) for use in Zero-Link mode

848 849
gen-decls
ObjC ObjC++
850
Dump declarations to a .decl file
851

852 853 854 855 856 857 858 859 860 861 862 863
femit-struct-debug-baseonly
C ObjC C++ ObjC++
-femit-struct-debug-baseonly	Aggressive reduced debug info for structs

femit-struct-debug-reduced
C ObjC C++ ObjC++
-femit-struct-debug-reduced	Conservative reduced debug info for structs

femit-struct-debug-detailed=
C ObjC C++ ObjC++ Joined
-femit-struct-debug-detailed=<spec-list>	Detailed reduced debug info for structs

864 865
idirafter
C ObjC C++ ObjC++ Joined Separate
866
-idirafter <dir>	Add <dir> to the end of the system include path
867 868 869

imacros
C ObjC C++ ObjC++ Joined Separate
870
-imacros <file>	Accept definition of macros in <file>
871

872 873 874 875
imultilib
C ObjC C++ ObjC++ Joined Separate
-imultilib <dir> Set <dir> to be the multilib include subdirectory

876 877
include
C ObjC C++ ObjC++ Joined Separate
878
-include <file>	Include the contents of <file> before other files
879 880 881

iprefix
C ObjC C++ ObjC++ Joined Separate
882
-iprefix <path>	Specify <path> as a prefix for next two options
883 884 885

isysroot
C ObjC C++ ObjC++ Joined Separate
886
-isysroot <dir>	Set <dir> to be the system root directory
887 888 889

isystem
C ObjC C++ ObjC++ Joined Separate
890
-isystem <dir>	Add <dir> to the start of the system include path
891

892 893 894 895
iquote
C ObjC C++ ObjC++ Joined Separate
-iquote <dir>	Add <dir> to the end of the quote include path

896 897
iwithprefix
C ObjC C++ ObjC++ Joined Separate
898
-iwithprefix <dir>	Add <dir> to the end of the system include path
899 900 901

iwithprefixbefore
C ObjC C++ ObjC++ Joined Separate
902
-iwithprefixbefore <dir>	Add <dir> to the end of the main include path
903 904

lang-asm
905
C Undocumented
906 907

lang-objc
908
C ObjC C++ ObjC++ Undocumented
909 910 911

nostdinc
C ObjC C++ ObjC++
912
Do not search standard system include directories (those specified with -isystem will still be used)
913 914

nostdinc++
915 916
C++ ObjC++
Do not search standard system include directories for C++
917 918 919

o
C ObjC C++ ObjC++ Joined Separate
920
; Documented in common.opt
921 922 923

pedantic
C ObjC C++ ObjC++
924
; Documented in common.opt
925 926 927

pedantic-errors
C ObjC C++ ObjC++
928
; Documented in common.opt
929 930 931

print-objc-runtime-info
ObjC ObjC++
932
Generate C header of platform-specific features
933

934 935
print-pch-checksum
C ObjC C++ ObjC++
936
Print a checksum of the executable for PCH validity checking, and stop
937

938 939
remap
C ObjC C++ ObjC++
940
Remap file names when including files
941 942 943

std=c++98
C++ ObjC++
944
Conform to the ISO 1998 C++ standard
945

946 947 948 949 950 951 952
std=c++0x
C++ ObjC++
Conform to the ISO 1998 C++ standard, with extensions that are likely to
become a part of the upcoming ISO C++ standard, dubbed C++0x. Note that the
extensions enabled by this mode are experimental and may be removed in
future releases of GCC.

953 954
std=c89
C ObjC
955
Conform to the ISO 1990 C standard
956 957 958

std=c99
C ObjC
959
Conform to the ISO 1999 C standard
960 961 962

std=c9x
C ObjC
963
Deprecated in favor of -std=c99
964 965 966

std=gnu++98
C++ ObjC++
967
Conform to the ISO 1998 C++ standard with GNU extensions
968

969 970 971 972 973 974 975
std=gnu++0x
C++ ObjC++
Conform to the ISO 1998 C++ standard, with GNU extensions and
extensions that are likely to become a part of the upcoming ISO C++
standard, dubbed C++0x. Note that the extensions enabled by this mode
are experimental and may be removed in future releases of GCC.

976 977
std=gnu89
C ObjC
978
Conform to the ISO 1990 C standard with GNU extensions
979 980 981

std=gnu99
C ObjC
982
Conform to the ISO 1999 C standard with GNU extensions
983 984 985

std=gnu9x
C ObjC
986
Deprecated in favor of -std=gnu99
987 988 989

std=iso9899:1990
C ObjC
990
Conform to the ISO 1990 C standard
991 992 993

std=iso9899:199409
C ObjC
994
Conform to the ISO 1990 C standard as amended in 1994
995 996 997

std=iso9899:1999
C ObjC
998
Conform to the ISO 1999 C standard
999 1000 1001

std=iso9899:199x
C ObjC
1002
Deprecated in favor of -std=iso9899:1999
1003 1004 1005

traditional-cpp
C ObjC C++ ObjC++
1006
Enable traditional preprocessing
1007 1008 1009

trigraphs
C ObjC C++ ObjC++
1010
-trigraphs	Support ISO C trigraphs
1011 1012 1013

undef
C ObjC C++ ObjC++
1014
Do not predefine system-specific and GCC-specific macros
1015 1016

v
1017
Common C ObjC C++ ObjC++
1018
Enable verbose output
1019 1020 1021

w
C ObjC C++ ObjC++
1022
; Documented in common.opt
1023 1024

; This comment is to ensure we retain the blank line above.