OSDN Git Service

1b6307b2215d526db24390b60e3ab930f9ad2a04
[pf3gnuchains/gcc-fork.git] / gcc / doc / cppopts.texi
1 @c Copyright (c) 1999, 2000, 2001, 2002, 2003, 2004
2 @c Free Software Foundation, Inc.
3 @c This is part of the CPP and GCC manuals.
4 @c For copying conditions, see the file gcc.texi.
5
6 @c ---------------------------------------------------------------------
7 @c Options affecting the preprocessor
8 @c ---------------------------------------------------------------------
9
10 @c If this file is included with the flag ``cppmanual'' set, it is
11 @c formatted for inclusion in the CPP manual; otherwise the main GCC manual.
12
13 @table @gcctabopt
14 @item -D @var{name}
15 @opindex D
16 Predefine @var{name} as a macro, with definition @code{1}.
17
18 @item -D @var{name}=@var{definition}
19 Predefine @var{name} as a macro, with definition @var{definition}.
20 There are no restrictions on the contents of @var{definition}, but if
21 you are invoking the preprocessor from a shell or shell-like program you
22 may need to use the shell's quoting syntax to protect characters such as
23 spaces that have a meaning in the shell syntax.
24
25 If you wish to define a function-like macro on the command line, write
26 its argument list with surrounding parentheses before the equals sign
27 (if any).  Parentheses are meaningful to most shells, so you will need
28 to quote the option.  With @command{sh} and @command{csh},
29 @option{-D'@var{name}(@var{args@dots{}})=@var{definition}'} works.
30
31 @option{-D} and @option{-U} options are processed in the order they
32 are given on the command line.  All @option{-imacros @var{file}} and
33 @option{-include @var{file}} options are processed after all
34 @option{-D} and @option{-U} options.
35
36 @item -U @var{name}
37 @opindex U
38 Cancel any previous definition of @var{name}, either built in or
39 provided with a @option{-D} option.
40
41 @item -undef
42 @opindex undef
43 Do not predefine any system-specific or GCC-specific macros.  The
44 standard predefined macros remain defined.
45 @ifset cppmanual
46 @xref{Standard Predefined Macros}.
47 @end ifset
48
49 @item -I @var{dir}
50 @opindex I
51 Add the directory @var{dir} to the list of directories to be searched
52 for header files.
53 @ifset cppmanual
54 @xref{Search Path}.
55 @end ifset
56 Directories named by @option{-I} are searched before the standard
57 system include directories.  If the directory @var{dir} is a standard
58 system include directory, the option is ignored to ensure that the
59 default search order for system directories and the special treatment
60 of system headers are not defeated
61 @ifset cppmanual
62 (@pxref{System Headers})
63 @end ifset
64 .
65
66 @item -o @var{file}
67 @opindex o
68 Write output to @var{file}.  This is the same as specifying @var{file}
69 as the second non-option argument to @command{cpp}.  @command{gcc} has a
70 different interpretation of a second non-option argument, so you must
71 use @option{-o} to specify the output file.
72
73 @item -Wall
74 @opindex Wall
75 Turns on all optional warnings which are desirable for normal code.
76 At present this is @option{-Wcomment}, @option{-Wtrigraphs},
77 @option{-Wmultichar} and a warning about integer promotion causing a
78 change of sign in @code{#if} expressions.  Note that many of the
79 preprocessor's warnings are on by default and have no options to
80 control them.
81
82 @item -Wcomment
83 @itemx -Wcomments
84 @opindex Wcomment
85 @opindex Wcomments
86 Warn whenever a comment-start sequence @samp{/*} appears in a @samp{/*}
87 comment, or whenever a backslash-newline appears in a @samp{//} comment.
88 (Both forms have the same effect.)
89
90 @item -Wtrigraphs
91 @opindex Wtrigraphs
92 @anchor{Wtrigraphs}
93 Most trigraphs in comments cannot affect the meaning of the program.
94 However, a trigraph that would form an escaped newline (@samp{??/} at
95 the end of a line) can, by changing where the comment begins or ends.
96 Therefore, only trigraphs that would form escaped newlines produce
97 warnings inside a comment.
98
99 This option is implied by @option{-Wall}.  If @option{-Wall} is not
100 given, this option is still enabled unless trigraphs are enabled.  To
101 get trigraph conversion without warnings, but get the other
102 @option{-Wall} warnings, use @samp{-trigraphs -Wall -Wno-trigraphs}.
103
104 @item -Wtraditional
105 @opindex Wtraditional
106 Warn about certain constructs that behave differently in traditional and
107 ISO C@.  Also warn about ISO C constructs that have no traditional C
108 equivalent, and problematic constructs which should be avoided.
109 @ifset cppmanual
110 @xref{Traditional Mode}.
111 @end ifset
112
113 @item -Wimport
114 @opindex Wimport
115 Warn the first time @samp{#import} is used.
116
117 @item -Wundef
118 @opindex Wundef
119 Warn whenever an identifier which is not a macro is encountered in an
120 @samp{#if} directive, outside of @samp{defined}.  Such identifiers are
121 replaced with zero.
122
123 @item -Wunused-macros
124 @opindex Wunused-macros
125 Warn about macros defined in the main file that are unused.  A macro
126 is @dfn{used} if it is expanded or tested for existence at least once.
127 The preprocessor will also warn if the macro has not been used at the
128 time it is redefined or undefined.
129
130 Built-in macros, macros defined on the command line, and macros
131 defined in include files are not warned about.
132
133 @strong{Note:} If a macro is actually used, but only used in skipped
134 conditional blocks, then CPP will report it as unused.  To avoid the
135 warning in such a case, you might improve the scope of the macro's
136 definition by, for example, moving it into the first skipped block.
137 Alternatively, you could provide a dummy use with something like:
138
139 @smallexample
140 #if defined the_macro_causing_the_warning
141 #endif
142 @end smallexample
143
144 @item -Wendif-labels
145 @opindex Wendif-labels
146 Warn whenever an @samp{#else} or an @samp{#endif} are followed by text.
147 This usually happens in code of the form
148
149 @smallexample
150 #if FOO
151 @dots{}
152 #else FOO
153 @dots{}
154 #endif FOO
155 @end smallexample
156
157 @noindent
158 The second and third @code{FOO} should be in comments, but often are not
159 in older programs.  This warning is on by default.
160
161 @item -Werror
162 @opindex Werror
163 Make all warnings into hard errors.  Source code which triggers warnings
164 will be rejected.
165
166 @item -Wsystem-headers
167 @opindex Wsystem-headers
168 Issue warnings for code in system headers.  These are normally unhelpful
169 in finding bugs in your own code, therefore suppressed.  If you are
170 responsible for the system library, you may want to see them.
171
172 @item -w
173 @opindex w
174 Suppress all warnings, including those which GNU CPP issues by default.
175
176 @item -pedantic
177 @opindex pedantic
178 Issue all the mandatory diagnostics listed in the C standard.  Some of
179 them are left out by default, since they trigger frequently on harmless
180 code.
181
182 @item -pedantic-errors
183 @opindex pedantic-errors
184 Issue all the mandatory diagnostics, and make all mandatory diagnostics
185 into errors.  This includes mandatory diagnostics that GCC issues
186 without @samp{-pedantic} but treats as warnings.
187
188 @item -M
189 @opindex M
190 @cindex make
191 @cindex dependencies, make
192 Instead of outputting the result of preprocessing, output a rule
193 suitable for @command{make} describing the dependencies of the main
194 source file.  The preprocessor outputs one @command{make} rule containing
195 the object file name for that source file, a colon, and the names of all
196 the included files, including those coming from @option{-include} or
197 @option{-imacros} command line options.
198
199 Unless specified explicitly (with @option{-MT} or @option{-MQ}), the
200 object file name consists of the basename of the source file with any
201 suffix replaced with object file suffix.  If there are many included
202 files then the rule is split into several lines using @samp{\}-newline.
203 The rule has no commands.
204
205 This option does not suppress the preprocessor's debug output, such as
206 @option{-dM}.  To avoid mixing such debug output with the dependency
207 rules you should explicitly specify the dependency output file with
208 @option{-MF}, or use an environment variable like
209 @env{DEPENDENCIES_OUTPUT} (@pxref{Environment Variables}).  Debug output
210 will still be sent to the regular output stream as normal.
211
212 Passing @option{-M} to the driver implies @option{-E}, and suppresses
213 warnings with an implicit @option{-w}.
214
215 @item -MM
216 @opindex MM
217 Like @option{-M} but do not mention header files that are found in
218 system header directories, nor header files that are included,
219 directly or indirectly, from such a header.
220
221 This implies that the choice of angle brackets or double quotes in an
222 @samp{#include} directive does not in itself determine whether that
223 header will appear in @option{-MM} dependency output.  This is a
224 slight change in semantics from GCC versions 3.0 and earlier.
225
226 @anchor{dashMF}
227 @item -MF @var{file}
228 @opindex MF
229 When used with @option{-M} or @option{-MM}, specifies a
230 file to write the dependencies to.  If no @option{-MF} switch is given
231 the preprocessor sends the rules to the same place it would have sent
232 preprocessed output.
233
234 When used with the driver options @option{-MD} or @option{-MMD},
235 @option{-MF} overrides the default dependency output file.
236
237 @item -MG
238 @opindex MG
239 In conjunction with an option such as @option{-M} requesting
240 dependency generation, @option{-MG} assumes missing header files are
241 generated files and adds them to the dependency list without raising
242 an error.  The dependency filename is taken directly from the
243 @code{#include} directive without prepending any path.  @option{-MG}
244 also suppresses preprocessed output, as a missing header file renders
245 this useless.
246
247 This feature is used in automatic updating of makefiles.
248
249 @item -MP
250 @opindex MP
251 This option instructs CPP to add a phony target for each dependency
252 other than the main file, causing each to depend on nothing.  These
253 dummy rules work around errors @command{make} gives if you remove header
254 files without updating the @file{Makefile} to match.
255
256 This is typical output:
257
258 @smallexample
259 test.o: test.c test.h
260
261 test.h:
262 @end smallexample
263
264 @item -MT @var{target}
265 @opindex MT
266
267 Change the target of the rule emitted by dependency generation.  By
268 default CPP takes the name of the main input file, including any path,
269 deletes any file suffix such as @samp{.c}, and appends the platform's
270 usual object suffix.  The result is the target.
271
272 An @option{-MT} option will set the target to be exactly the string you
273 specify.  If you want multiple targets, you can specify them as a single
274 argument to @option{-MT}, or use multiple @option{-MT} options.
275
276 For example, @option{@w{-MT '$(objpfx)foo.o'}} might give
277
278 @smallexample
279 $(objpfx)foo.o: foo.c
280 @end smallexample
281
282 @item -MQ @var{target}
283 @opindex MQ
284
285 Same as @option{-MT}, but it quotes any characters which are special to
286 Make.  @option{@w{-MQ '$(objpfx)foo.o'}} gives
287
288 @smallexample
289 $$(objpfx)foo.o: foo.c
290 @end smallexample
291
292 The default target is automatically quoted, as if it were given with
293 @option{-MQ}.
294
295 @item -MD
296 @opindex MD
297 @option{-MD} is equivalent to @option{-M -MF @var{file}}, except that
298 @option{-E} is not implied.  The driver determines @var{file} based on
299 whether an @option{-o} option is given.  If it is, the driver uses its
300 argument but with a suffix of @file{.d}, otherwise it take the
301 basename of the input file and applies a @file{.d} suffix.
302
303 If @option{-MD} is used in conjunction with @option{-E}, any
304 @option{-o} switch is understood to specify the dependency output file
305 (but @pxref{dashMF,,-MF}), but if used without @option{-E}, each @option{-o}
306 is understood to specify a target object file.
307
308 Since @option{-E} is not implied, @option{-MD} can be used to generate
309 a dependency output file as a side-effect of the compilation process.
310
311 @item -MMD
312 @opindex MMD
313 Like @option{-MD} except mention only user header files, not system
314 -header files.
315
316 @ifclear cppmanual
317 @item -fpch-deps
318 @opindex fpch-deps
319 When using precompiled headers (@pxref{Precompiled Headers}), this flag
320 will cause the dependency-output flags to also list the files from the
321 precompiled header's dependencies.  If not specified only the
322 precompiled header would be listed and not the files that were used to
323 create it because those files are not consulted when a precompiled
324 header is used.
325
326 @item -fpch-preprocess
327 @opindex fpch-preprocess
328 This option allows use of a precompiled header (@pxref{Precompiled
329 Headers}) together with @option{-E}.  It inserts a special @code{#pragma},
330 @code{#pragma GCC pch_preprocess "<filename>"} in the output to mark
331 the place where the precompiled header was found, and its filename.  When
332 @code{-fpreprocessed} is in use, GCC recognizes this @code{#pragma} and
333 loads the PCH.
334
335 This option is off by default, because the resulting preprocessed output
336 is only really suitable as input to GCC.  It is switched on by
337 @option{-save-temps}.
338
339 You should not write this @code{#pragma} in your own code, but it is
340 safe to edit the filename if the PCH file is available in a different
341 location.  The filename may be absolute or it may be relative to GCC's
342 current directory.
343
344 @end ifclear
345 @item -x c
346 @itemx -x c++
347 @itemx -x objective-c
348 @itemx -x assembler-with-cpp
349 @opindex x
350 Specify the source language: C, C++, Objective-C, or assembly.  This has
351 nothing to do with standards conformance or extensions; it merely
352 selects which base syntax to expect.  If you give none of these options,
353 cpp will deduce the language from the extension of the source file:
354 @samp{.c}, @samp{.cc}, @samp{.m}, or @samp{.S}.  Some other common
355 extensions for C++ and assembly are also recognized.  If cpp does not
356 recognize the extension, it will treat the file as C; this is the most
357 generic mode.
358
359 @strong{Note:} Previous versions of cpp accepted a @option{-lang} option
360 which selected both the language and the standards conformance level.
361 This option has been removed, because it conflicts with the @option{-l}
362 option.
363
364 @item -std=@var{standard}
365 @itemx -ansi
366 @opindex ansi
367 @opindex std=
368 Specify the standard to which the code should conform.  Currently CPP
369 knows about C and C++ standards; others may be added in the future.
370
371 @var{standard}
372 may be one of:
373 @table @code
374 @item iso9899:1990
375 @itemx c89
376 The ISO C standard from 1990.  @samp{c89} is the customary shorthand for
377 this version of the standard.
378
379 The @option{-ansi} option is equivalent to @option{-std=c89}.
380
381 @item iso9899:199409
382 The 1990 C standard, as amended in 1994.
383
384 @item iso9899:1999
385 @itemx c99
386 @itemx iso9899:199x
387 @itemx c9x
388 The revised ISO C standard, published in December 1999.  Before
389 publication, this was known as C9X@.
390
391 @item gnu89
392 The 1990 C standard plus GNU extensions.  This is the default.
393
394 @item gnu99
395 @itemx gnu9x
396 The 1999 C standard plus GNU extensions.
397
398 @item c++98
399 The 1998 ISO C++ standard plus amendments.
400
401 @item gnu++98
402 The same as @option{-std=c++98} plus GNU extensions.  This is the
403 default for C++ code.
404 @end table
405
406 @item -I-
407 @opindex I-
408 Split the include path.  Any directories specified with @option{-I}
409 options before @option{-I-} are searched only for headers requested with
410 @code{@w{#include "@var{file}"}}; they are not searched for
411 @code{@w{#include <@var{file}>}}.  If additional directories are
412 specified with @option{-I} options after the @option{-I-}, those
413 directories are searched for all @samp{#include} directives.
414
415 In addition, @option{-I-} inhibits the use of the directory of the current
416 file directory as the first search directory for @code{@w{#include
417 "@var{file}"}}.
418 @ifset cppmanual
419 @xref{Search Path}.
420 @end ifset
421 This option has been deprecated.
422
423 @item -nostdinc
424 @opindex nostdinc
425 Do not search the standard system directories for header files.
426 Only the directories you have specified with @option{-I} options
427 (and the directory of the current file, if appropriate) are searched.
428
429 @item -nostdinc++
430 @opindex nostdinc++
431 Do not search for header files in the C++-specific standard directories,
432 but do still search the other standard directories.  (This option is
433 used when building the C++ library.)
434
435 @item -include @var{file}
436 @opindex include
437 Process @var{file} as if @code{#include "file"} appeared as the first
438 line of the primary source file.  However, the first directory searched
439 for @var{file} is the preprocessor's working directory @emph{instead of}
440 the directory containing the main source file.  If not found there, it
441 is searched for in the remainder of the @code{#include "@dots{}"} search
442 chain as normal.
443
444 If multiple @option{-include} options are given, the files are included
445 in the order they appear on the command line.
446
447 @item -imacros @var{file}
448 @opindex imacros
449 Exactly like @option{-include}, except that any output produced by
450 scanning @var{file} is thrown away.  Macros it defines remain defined.
451 This allows you to acquire all the macros from a header without also
452 processing its declarations.
453
454 All files specified by @option{-imacros} are processed before all files
455 specified by @option{-include}.
456
457 @item -idirafter @var{dir}
458 @opindex idirafter
459 Search @var{dir} for header files, but do it @emph{after} all
460 directories specified with @option{-I} and the standard system directories
461 have been exhausted.  @var{dir} is treated as a system include directory.
462
463 @item -iprefix @var{prefix}
464 @opindex iprefix
465 Specify @var{prefix} as the prefix for subsequent @option{-iwithprefix}
466 options.  If the prefix represents a directory, you should include the
467 final @samp{/}.
468
469 @item -iwithprefix @var{dir}
470 @itemx -iwithprefixbefore @var{dir}
471 @opindex iwithprefix
472 @opindex iwithprefixbefore
473 Append @var{dir} to the prefix specified previously with
474 @option{-iprefix}, and add the resulting directory to the include search
475 path.  @option{-iwithprefixbefore} puts it in the same place @option{-I}
476 would; @option{-iwithprefix} puts it where @option{-idirafter} would.
477
478 @item -isystem @var{dir}
479 @opindex isystem
480 Search @var{dir} for header files, after all directories specified by
481 @option{-I} but before the standard system directories.  Mark it
482 as a system directory, so that it gets the same special treatment as
483 is applied to the standard system directories.
484 @ifset cppmanual
485 @xref{System Headers}.
486 @end ifset
487
488 @item -iquote @var{dir}
489 @opindex iquote
490 Search @var{dir} only for header files requested with
491 @code{@w{#include "@var{file}"}}; they are not searched for
492 @code{@w{#include <@var{file}>}}, before all directories specified by
493 @option{-I} and before the standard system directories.
494 @ifset cppmanual
495 @xref{Search Path}.
496 @end ifset
497
498 @item -fdollars-in-identifiers
499 @opindex fdollars-in-identifiers
500 @anchor{fdollars-in-identifiers}
501 Accept @samp{$} in identifiers.
502 @ifset cppmanual
503   @xref{Identifier characters}.
504 @end ifset
505
506 @item -fpreprocessed
507 @opindex fpreprocessed
508 Indicate to the preprocessor that the input file has already been
509 preprocessed.  This suppresses things like macro expansion, trigraph
510 conversion, escaped newline splicing, and processing of most directives.
511 The preprocessor still recognizes and removes comments, so that you can
512 pass a file preprocessed with @option{-C} to the compiler without
513 problems.  In this mode the integrated preprocessor is little more than
514 a tokenizer for the front ends.
515
516 @option{-fpreprocessed} is implicit if the input file has one of the
517 extensions @samp{.i}, @samp{.ii} or @samp{.mi}.  These are the
518 extensions that GCC uses for preprocessed files created by
519 @option{-save-temps}.
520
521 @item -ftabstop=@var{width}
522 @opindex ftabstop
523 Set the distance between tab stops.  This helps the preprocessor report
524 correct column numbers in warnings or errors, even if tabs appear on the
525 line.  If the value is less than 1 or greater than 100, the option is
526 ignored.  The default is 8.
527
528 @item -fexec-charset=@var{charset}
529 @opindex fexec-charset
530 Set the execution character set, used for string and character
531 constants.  The default is UTF-8.  @var{charset} can be any encoding
532 supported by the system's @code{iconv} library routine.
533
534 @item -fwide-exec-charset=@var{charset}
535 @opindex fwide-exec-charset
536 Set the wide execution character set, used for wide string and
537 character constants.  The default is UTF-32 or UTF-16, whichever
538 corresponds to the width of @code{wchar_t}.  As with
539 @option{-fexec-charset}, @var{charset} can be any encoding supported
540 by the system's @code{iconv} library routine; however, you will have
541 problems with encodings that do not fit exactly in @code{wchar_t}.
542
543 @item -finput-charset=@var{charset}
544 @opindex finput-charset
545 Set the input character set, used for translation from the character
546 set of the input file to the source character set used by GCC. If the
547 locale does not specify, or GCC cannot get this information from the
548 locale, the default is UTF-8. This can be overridden by either the locale
549 or this command line option. Currently the command line option takes
550 precedence if there's a conflict. @var{charset} can be any encoding
551 supported by the system's @code{iconv} library routine.
552
553 @item -fworking-directory
554 @opindex fworking-directory
555 @opindex fno-working-directory
556 Enable generation of linemarkers in the preprocessor output that will
557 let the compiler know the current working directory at the time of
558 preprocessing.  When this option is enabled, the preprocessor will
559 emit, after the initial linemarker, a second linemarker with the
560 current working directory followed by two slashes.  GCC will use this
561 directory, when it's present in the preprocessed input, as the
562 directory emitted as the current working directory in some debugging
563 information formats.  This option is implicitly enabled if debugging
564 information is enabled, but this can be inhibited with the negated
565 form @option{-fno-working-directory}.  If the @option{-P} flag is
566 present in the command line, this option has no effect, since no
567 @code{#line} directives are emitted whatsoever.
568
569 @item -fno-show-column
570 @opindex fno-show-column
571 Do not print column numbers in diagnostics.  This may be necessary if
572 diagnostics are being scanned by a program that does not understand the
573 column numbers, such as @command{dejagnu}.
574
575 @item -A @var{predicate}=@var{answer}
576 @opindex A
577 Make an assertion with the predicate @var{predicate} and answer
578 @var{answer}.  This form is preferred to the older form @option{-A
579 @var{predicate}(@var{answer})}, which is still supported, because
580 it does not use shell special characters.
581 @ifset cppmanual
582 @xref{Assertions}.
583 @end ifset
584
585 @item -A -@var{predicate}=@var{answer}
586 Cancel an assertion with the predicate @var{predicate} and answer
587 @var{answer}.
588
589 @item -dCHARS
590 @var{CHARS} is a sequence of one or more of the following characters,
591 and must not be preceded by a space.  Other characters are interpreted
592 by the compiler proper, or reserved for future versions of GCC, and so
593 are silently ignored.  If you specify characters whose behavior
594 conflicts, the result is undefined.
595
596 @table @samp
597 @item M
598 @opindex dM
599 Instead of the normal output, generate a list of @samp{#define}
600 directives for all the macros defined during the execution of the
601 preprocessor, including predefined macros.  This gives you a way of
602 finding out what is predefined in your version of the preprocessor.
603 Assuming you have no file @file{foo.h}, the command
604
605 @smallexample
606 touch foo.h; cpp -dM foo.h
607 @end smallexample
608
609 @noindent
610 will show all the predefined macros.
611
612 @item D
613 @opindex dD
614 Like @samp{M} except in two respects: it does @emph{not} include the
615 predefined macros, and it outputs @emph{both} the @samp{#define}
616 directives and the result of preprocessing.  Both kinds of output go to
617 the standard output file.
618
619 @item N
620 @opindex dN
621 Like @samp{D}, but emit only the macro names, not their expansions.
622
623 @item I
624 @opindex dI
625 Output @samp{#include} directives in addition to the result of
626 preprocessing.
627 @end table
628
629 @item -P
630 @opindex P
631 Inhibit generation of linemarkers in the output from the preprocessor.
632 This might be useful when running the preprocessor on something that is
633 not C code, and will be sent to a program which might be confused by the
634 linemarkers.
635 @ifset cppmanual
636 @xref{Preprocessor Output}.
637 @end ifset
638
639 @item -C
640 @opindex C
641 Do not discard comments.  All comments are passed through to the output
642 file, except for comments in processed directives, which are deleted
643 along with the directive.
644
645 You should be prepared for side effects when using @option{-C}; it
646 causes the preprocessor to treat comments as tokens in their own right.
647 For example, comments appearing at the start of what would be a
648 directive line have the effect of turning that line into an ordinary
649 source line, since the first token on the line is no longer a @samp{#}.
650
651 @item -CC
652 Do not discard comments, including during macro expansion.  This is
653 like @option{-C}, except that comments contained within macros are
654 also passed through to the output file where the macro is expanded.
655
656 In addition to the side-effects of the @option{-C} option, the
657 @option{-CC} option causes all C++-style comments inside a macro
658 to be converted to C-style comments.  This is to prevent later use
659 of that macro from inadvertently commenting out the remainder of
660 the source line.
661
662 The @option{-CC} option is generally used to support lint comments.
663
664 @item -traditional-cpp
665 @opindex traditional-cpp
666 Try to imitate the behavior of old-fashioned C preprocessors, as
667 opposed to ISO C preprocessors.
668 @ifset cppmanual
669 @xref{Traditional Mode}.
670 @end ifset
671
672 @item -trigraphs
673 @opindex trigraphs
674 Process trigraph sequences.
675 @ifset cppmanual
676 @xref{Initial processing}.
677 @end ifset
678 @ifclear cppmanual
679 These are three-character sequences, all starting with @samp{??}, that
680 are defined by ISO C to stand for single characters.  For example,
681 @samp{??/} stands for @samp{\}, so @samp{'??/n'} is a character
682 constant for a newline.  By default, GCC ignores trigraphs, but in
683 standard-conforming modes it converts them.  See the @option{-std} and
684 @option{-ansi} options.
685
686 The nine trigraphs and their replacements are
687
688 @smallexample
689 Trigraph:       ??(  ??)  ??<  ??>  ??=  ??/  ??'  ??!  ??-
690 Replacement:      [    ]    @{    @}    #    \    ^    |    ~
691 @end smallexample
692 @end ifclear
693
694 @item -remap
695 @opindex remap
696 Enable special code to work around file systems which only permit very
697 short file names, such as MS-DOS@.
698
699 @itemx --help
700 @itemx --target-help
701 @opindex help
702 @opindex target-help
703 Print text describing all the command line options instead of
704 preprocessing anything.
705
706 @item -v
707 @opindex v
708 Verbose mode.  Print out GNU CPP's version number at the beginning of
709 execution, and report the final form of the include path.
710
711 @item -H
712 @opindex H
713 Print the name of each header file used, in addition to other normal
714 activities.  Each name is indented to show how deep in the
715 @samp{#include} stack it is.  Precompiled header files are also
716 printed, even if they are found to be invalid; an invalid precompiled
717 header file is printed with @samp{...x} and a valid one with @samp{...!} .
718
719 @item -version
720 @itemx --version
721 @opindex version
722 Print out GNU CPP's version number.  With one dash, proceed to
723 preprocess as normal.  With two dashes, exit immediately.
724 @end table