diff options
| author | Zach Pfeffer <zach.pfeffer@linaro.org> | 2012-10-19 20:44:10 -0500 |
|---|---|---|
| committer | Zach Pfeffer <zach.pfeffer@linaro.org> | 2012-10-19 20:44:10 -0500 |
| commit | 1dd57a1984f3f599435f9704529510028dd37db0 (patch) | |
| tree | 230e79b1c38a691b19bfcc41578d1a3326b50d59 /share/doc/gcc-linaro-aarch64-linux-gnu/html/gcc/Preprocessor-Options.html | |
| parent | b4bd0c6cdcbe66376b4d7e0d7800fbcc90113670 (diff) | |
| download | gcc-linaro-aarch64-linux-gnu-4.7-1dd57a1984f3f599435f9704529510028dd37db0.tar.gz | |
gcc-linaro-aarch64-linux-gnu-4.7+bzr115029-20121015+bzr2506_linux.tar.bz2
from http://people.linaro.org/~toolchain/aarch64/.
Change-Id: I67a1ea4064dafacaee01d7683ddcfa151f463e42
Signed-off-by: Zach Pfeffer <zach.pfeffer@linaro.org>
Diffstat (limited to 'share/doc/gcc-linaro-aarch64-linux-gnu/html/gcc/Preprocessor-Options.html')
| -rw-r--r-- | share/doc/gcc-linaro-aarch64-linux-gnu/html/gcc/Preprocessor-Options.html | 144 |
1 files changed, 72 insertions, 72 deletions
diff --git a/share/doc/gcc-linaro-aarch64-linux-gnu/html/gcc/Preprocessor-Options.html b/share/doc/gcc-linaro-aarch64-linux-gnu/html/gcc/Preprocessor-Options.html index 1b17833..f9869ca 100644 --- a/share/doc/gcc-linaro-aarch64-linux-gnu/html/gcc/Preprocessor-Options.html +++ b/share/doc/gcc-linaro-aarch64-linux-gnu/html/gcc/Preprocessor-Options.html @@ -56,7 +56,7 @@ Up: <a rel="up" accesskey="u" href="Invoking-GCC.html#Invoking-GCC">Invokin <h3 class="section">3.11 Options Controlling the Preprocessor</h3> -<p><a name="index-preprocessor-options-904"></a><a name="index-options_002c-preprocessor-905"></a> +<p><a name="index-preprocessor-options-906"></a><a name="index-options_002c-preprocessor-907"></a> These options control the C preprocessor, which is run on each C source file before actual compilation. @@ -66,7 +66,7 @@ they cause the preprocessor output to be unsuitable for actual compilation. <dl> -<dt><code>-Wp,</code><var>option</var><dd><a name="index-Wp-906"></a>You can use <samp><span class="option">-Wp,</span><var>option</var></samp> to bypass the compiler driver +<dt><code>-Wp,</code><var>option</var><dd><a name="index-Wp-908"></a>You can use <samp><span class="option">-Wp,</span><var>option</var></samp> to bypass the compiler driver and pass <var>option</var> directly through to the preprocessor. If <var>option</var> contains commas, it is split into multiple options at the commas. However, many options are modified, translated or interpreted @@ -76,7 +76,7 @@ interface is undocumented and subject to change, so whenever possible you should avoid using <samp><span class="option">-Wp</span></samp> and let the driver handle the options instead. - <br><dt><code>-Xpreprocessor </code><var>option</var><dd><a name="index-Xpreprocessor-907"></a>Pass <var>option</var> as an option to the preprocessor. You can use this to + <br><dt><code>-Xpreprocessor </code><var>option</var><dd><a name="index-Xpreprocessor-909"></a>Pass <var>option</var> as an option to the preprocessor. You can use this to supply system-specific preprocessor options that GCC does not know how to recognize. @@ -94,7 +94,7 @@ recognize. <!-- If this file is included with the flag ``cppmanual'' set, it is --> <!-- formatted for inclusion in the CPP manual; otherwise the main GCC manual. --> <dl> -<dt><code>-D </code><var>name</var><dd><a name="index-D-908"></a>Predefine <var>name</var> as a macro, with definition <code>1</code>. +<dt><code>-D </code><var>name</var><dd><a name="index-D-910"></a>Predefine <var>name</var> as a macro, with definition <code>1</code>. <br><dt><code>-D </code><var>name</var><code>=</code><var>definition</var><dd>The contents of <var>definition</var> are tokenized and processed as if they appeared during translation phase three in a ‘<samp><span class="samp">#define</span></samp>’ @@ -116,13 +116,13 @@ are given on the command line. All <samp><span class="option">-imacros </span>< <samp><span class="option">-include </span><var>file</var></samp> options are processed after all <samp><span class="option">-D</span></samp> and <samp><span class="option">-U</span></samp> options. - <br><dt><code>-U </code><var>name</var><dd><a name="index-U-909"></a>Cancel any previous definition of <var>name</var>, either built in or + <br><dt><code>-U </code><var>name</var><dd><a name="index-U-911"></a>Cancel any previous definition of <var>name</var>, either built in or provided with a <samp><span class="option">-D</span></samp> option. - <br><dt><code>-undef</code><dd><a name="index-undef-910"></a>Do not predefine any system-specific or GCC-specific macros. The + <br><dt><code>-undef</code><dd><a name="index-undef-912"></a>Do not predefine any system-specific or GCC-specific macros. The standard predefined macros remain defined. - <br><dt><code>-I </code><var>dir</var><dd><a name="index-I-911"></a>Add the directory <var>dir</var> to the list of directories to be searched + <br><dt><code>-I </code><var>dir</var><dd><a name="index-I-913"></a>Add the directory <var>dir</var> to the list of directories to be searched for header files. Directories named by <samp><span class="option">-I</span></samp> are searched before the standard system include directories. If the directory <var>dir</var> is a standard @@ -133,23 +133,23 @@ of system headers are not defeated If <var>dir</var> begins with <code>=</code>, then the <code>=</code> will be replaced by the sysroot prefix; see <samp><span class="option">--sysroot</span></samp> and <samp><span class="option">-isysroot</span></samp>. - <br><dt><code>-o </code><var>file</var><dd><a name="index-o-912"></a>Write output to <var>file</var>. This is the same as specifying <var>file</var> + <br><dt><code>-o </code><var>file</var><dd><a name="index-o-914"></a>Write output to <var>file</var>. This is the same as specifying <var>file</var> as the second non-option argument to <samp><span class="command">cpp</span></samp>. <samp><span class="command">gcc</span></samp> has a different interpretation of a second non-option argument, so you must use <samp><span class="option">-o</span></samp> to specify the output file. - <br><dt><code>-Wall</code><dd><a name="index-Wall-913"></a>Turns on all optional warnings which are desirable for normal code. + <br><dt><code>-Wall</code><dd><a name="index-Wall-915"></a>Turns on all optional warnings which are desirable for normal code. At present this is <samp><span class="option">-Wcomment</span></samp>, <samp><span class="option">-Wtrigraphs</span></samp>, <samp><span class="option">-Wmultichar</span></samp> and a warning about integer promotion causing a change of sign in <code>#if</code> expressions. Note that many of the preprocessor's warnings are on by default and have no options to control them. - <br><dt><code>-Wcomment</code><dt><code>-Wcomments</code><dd><a name="index-Wcomment-914"></a><a name="index-Wcomments-915"></a>Warn whenever a comment-start sequence ‘<samp><span class="samp">/*</span></samp>’ appears in a ‘<samp><span class="samp">/*</span></samp>’ + <br><dt><code>-Wcomment</code><dt><code>-Wcomments</code><dd><a name="index-Wcomment-916"></a><a name="index-Wcomments-917"></a>Warn whenever a comment-start sequence ‘<samp><span class="samp">/*</span></samp>’ appears in a ‘<samp><span class="samp">/*</span></samp>’ comment, or whenever a backslash-newline appears in a ‘<samp><span class="samp">//</span></samp>’ comment. (Both forms have the same effect.) - <br><dt><code>-Wtrigraphs</code><dd><a name="index-Wtrigraphs-916"></a><a name="Wtrigraphs"></a>Most trigraphs in comments cannot affect the meaning of the program. + <br><dt><code>-Wtrigraphs</code><dd><a name="index-Wtrigraphs-918"></a><a name="Wtrigraphs"></a>Most trigraphs in comments cannot affect the meaning of the program. However, a trigraph that would form an escaped newline (‘<samp><span class="samp">??/</span></samp>’ at the end of a line) can, by changing where the comment begins or ends. Therefore, only trigraphs that would form escaped newlines produce @@ -160,15 +160,15 @@ given, this option is still enabled unless trigraphs are enabled. To get trigraph conversion without warnings, but get the other <samp><span class="option">-Wall</span></samp> warnings, use ‘<samp><span class="samp">-trigraphs -Wall -Wno-trigraphs</span></samp>’. - <br><dt><code>-Wtraditional</code><dd><a name="index-Wtraditional-917"></a>Warn about certain constructs that behave differently in traditional and + <br><dt><code>-Wtraditional</code><dd><a name="index-Wtraditional-919"></a>Warn about certain constructs that behave differently in traditional and ISO C. Also warn about ISO C constructs that have no traditional C equivalent, and problematic constructs which should be avoided. - <br><dt><code>-Wundef</code><dd><a name="index-Wundef-918"></a>Warn whenever an identifier which is not a macro is encountered in an + <br><dt><code>-Wundef</code><dd><a name="index-Wundef-920"></a>Warn whenever an identifier which is not a macro is encountered in an ‘<samp><span class="samp">#if</span></samp>’ directive, outside of ‘<samp><span class="samp">defined</span></samp>’. Such identifiers are replaced with zero. - <br><dt><code>-Wunused-macros</code><dd><a name="index-Wunused_002dmacros-919"></a>Warn about macros defined in the main file that are unused. A macro + <br><dt><code>-Wunused-macros</code><dd><a name="index-Wunused_002dmacros-921"></a>Warn about macros defined in the main file that are unused. A macro is <dfn>used</dfn> if it is expanded or tested for existence at least once. The preprocessor will also warn if the macro has not been used at the time it is redefined or undefined. @@ -185,7 +185,7 @@ Alternatively, you could provide a dummy use with something like: <pre class="smallexample"> #if defined the_macro_causing_the_warning #endif </pre> - <br><dt><code>-Wendif-labels</code><dd><a name="index-Wendif_002dlabels-920"></a>Warn whenever an ‘<samp><span class="samp">#else</span></samp>’ or an ‘<samp><span class="samp">#endif</span></samp>’ are followed by text. + <br><dt><code>-Wendif-labels</code><dd><a name="index-Wendif_002dlabels-922"></a>Warn whenever an ‘<samp><span class="samp">#else</span></samp>’ or an ‘<samp><span class="samp">#endif</span></samp>’ are followed by text. This usually happens in code of the form <pre class="smallexample"> #if FOO @@ -197,24 +197,24 @@ This usually happens in code of the form <p class="noindent">The second and third <code>FOO</code> should be in comments, but often are not in older programs. This warning is on by default. - <br><dt><code>-Werror</code><dd><a name="index-Werror-921"></a>Make all warnings into hard errors. Source code which triggers warnings + <br><dt><code>-Werror</code><dd><a name="index-Werror-923"></a>Make all warnings into hard errors. Source code which triggers warnings will be rejected. - <br><dt><code>-Wsystem-headers</code><dd><a name="index-Wsystem_002dheaders-922"></a>Issue warnings for code in system headers. These are normally unhelpful + <br><dt><code>-Wsystem-headers</code><dd><a name="index-Wsystem_002dheaders-924"></a>Issue warnings for code in system headers. These are normally unhelpful in finding bugs in your own code, therefore suppressed. If you are responsible for the system library, you may want to see them. - <br><dt><code>-w</code><dd><a name="index-w-923"></a>Suppress all warnings, including those which GNU CPP issues by default. + <br><dt><code>-w</code><dd><a name="index-w-925"></a>Suppress all warnings, including those which GNU CPP issues by default. - <br><dt><code>-pedantic</code><dd><a name="index-pedantic-924"></a>Issue all the mandatory diagnostics listed in the C standard. Some of + <br><dt><code>-pedantic</code><dd><a name="index-pedantic-926"></a>Issue all the mandatory diagnostics listed in the C standard. Some of them are left out by default, since they trigger frequently on harmless code. - <br><dt><code>-pedantic-errors</code><dd><a name="index-pedantic_002derrors-925"></a>Issue all the mandatory diagnostics, and make all mandatory diagnostics + <br><dt><code>-pedantic-errors</code><dd><a name="index-pedantic_002derrors-927"></a>Issue all the mandatory diagnostics, and make all mandatory diagnostics into errors. This includes mandatory diagnostics that GCC issues without ‘<samp><span class="samp">-pedantic</span></samp>’ but treats as warnings. - <br><dt><code>-M</code><dd><a name="index-M-926"></a><a name="index-g_t_0040command_007bmake_007d-927"></a><a name="index-dependencies_002c-_0040command_007bmake_007d-928"></a>Instead of outputting the result of preprocessing, output a rule + <br><dt><code>-M</code><dd><a name="index-M-928"></a><a name="index-g_t_0040command_007bmake_007d-929"></a><a name="index-dependencies_002c-_0040command_007bmake_007d-930"></a>Instead of outputting the result of preprocessing, output a rule suitable for <samp><span class="command">make</span></samp> describing the dependencies of the main source file. The preprocessor outputs one <samp><span class="command">make</span></samp> rule containing the object file name for that source file, a colon, and the names of all @@ -238,7 +238,7 @@ will still be sent to the regular output stream as normal. <p>Passing <samp><span class="option">-M</span></samp> to the driver implies <samp><span class="option">-E</span></samp>, and suppresses warnings with an implicit <samp><span class="option">-w</span></samp>. - <br><dt><code>-MM</code><dd><a name="index-MM-929"></a>Like <samp><span class="option">-M</span></samp> but do not mention header files that are found in + <br><dt><code>-MM</code><dd><a name="index-MM-931"></a>Like <samp><span class="option">-M</span></samp> but do not mention header files that are found in system header directories, nor header files that are included, directly or indirectly, from such a header. @@ -247,7 +247,7 @@ directly or indirectly, from such a header. header will appear in <samp><span class="option">-MM</span></samp> dependency output. This is a slight change in semantics from GCC versions 3.0 and earlier. - <p><a name="dashMF"></a><br><dt><code>-MF </code><var>file</var><dd><a name="index-MF-930"></a>When used with <samp><span class="option">-M</span></samp> or <samp><span class="option">-MM</span></samp>, specifies a + <p><a name="dashMF"></a><br><dt><code>-MF </code><var>file</var><dd><a name="index-MF-932"></a>When used with <samp><span class="option">-M</span></samp> or <samp><span class="option">-MM</span></samp>, specifies a file to write the dependencies to. If no <samp><span class="option">-MF</span></samp> switch is given the preprocessor sends the rules to the same place it would have sent preprocessed output. @@ -255,7 +255,7 @@ preprocessed output. <p>When used with the driver options <samp><span class="option">-MD</span></samp> or <samp><span class="option">-MMD</span></samp>, <samp><span class="option">-MF</span></samp> overrides the default dependency output file. - <br><dt><code>-MG</code><dd><a name="index-MG-931"></a>In conjunction with an option such as <samp><span class="option">-M</span></samp> requesting + <br><dt><code>-MG</code><dd><a name="index-MG-933"></a>In conjunction with an option such as <samp><span class="option">-M</span></samp> requesting dependency generation, <samp><span class="option">-MG</span></samp> assumes missing header files are generated files and adds them to the dependency list without raising an error. The dependency filename is taken directly from the @@ -265,7 +265,7 @@ this useless. <p>This feature is used in automatic updating of makefiles. - <br><dt><code>-MP</code><dd><a name="index-MP-932"></a>This option instructs CPP to add a phony target for each dependency + <br><dt><code>-MP</code><dd><a name="index-MP-934"></a>This option instructs CPP to add a phony target for each dependency other than the main file, causing each to depend on nothing. These dummy rules work around errors <samp><span class="command">make</span></samp> gives if you remove header files without updating the <samp><span class="file">Makefile</span></samp> to match. @@ -276,7 +276,7 @@ files without updating the <samp><span class="file">Makefile</span></samp> to ma test.h: </pre> - <br><dt><code>-MT </code><var>target</var><dd><a name="index-MT-933"></a> + <br><dt><code>-MT </code><var>target</var><dd><a name="index-MT-935"></a> Change the target of the rule emitted by dependency generation. By default CPP takes the name of the main input file, deletes any directory components and any file suffix such as ‘<samp><span class="samp">.c</span></samp>’, and @@ -290,7 +290,7 @@ argument to <samp><span class="option">-MT</span></samp>, or use multiple <samp> <pre class="smallexample"> $(objpfx)foo.o: foo.c </pre> - <br><dt><code>-MQ </code><var>target</var><dd><a name="index-MQ-934"></a> + <br><dt><code>-MQ </code><var>target</var><dd><a name="index-MQ-936"></a> Same as <samp><span class="option">-MT</span></samp>, but it quotes any characters which are special to Make. <samp><span class="option">-MQ '$(objpfx)foo.o'<!-- /@w --></span></samp> gives @@ -299,7 +299,7 @@ Make. <samp><span class="option">-MQ '$(objpfx)foo.o'<!-- /@w --></span></ <p>The default target is automatically quoted, as if it were given with <samp><span class="option">-MQ</span></samp>. - <br><dt><code>-MD</code><dd><a name="index-MD-935"></a><samp><span class="option">-MD</span></samp> is equivalent to <samp><span class="option">-M -MF </span><var>file</var></samp>, except that + <br><dt><code>-MD</code><dd><a name="index-MD-937"></a><samp><span class="option">-MD</span></samp> is equivalent to <samp><span class="option">-M -MF </span><var>file</var></samp>, except that <samp><span class="option">-E</span></samp> is not implied. The driver determines <var>file</var> based on whether an <samp><span class="option">-o</span></samp> option is given. If it is, the driver uses its argument but with a suffix of <samp><span class="file">.d</span></samp>, otherwise it takes the name @@ -314,17 +314,17 @@ is understood to specify a target object file. <p>Since <samp><span class="option">-E</span></samp> is not implied, <samp><span class="option">-MD</span></samp> can be used to generate a dependency output file as a side-effect of the compilation process. - <br><dt><code>-MMD</code><dd><a name="index-MMD-936"></a>Like <samp><span class="option">-MD</span></samp> except mention only user header files, not system + <br><dt><code>-MMD</code><dd><a name="index-MMD-938"></a>Like <samp><span class="option">-MD</span></samp> except mention only user header files, not system header files. - <br><dt><code>-fpch-deps</code><dd><a name="index-fpch_002ddeps-937"></a>When using precompiled headers (see <a href="Precompiled-Headers.html#Precompiled-Headers">Precompiled Headers</a>), this flag + <br><dt><code>-fpch-deps</code><dd><a name="index-fpch_002ddeps-939"></a>When using precompiled headers (see <a href="Precompiled-Headers.html#Precompiled-Headers">Precompiled Headers</a>), this flag will cause the dependency-output flags to also list the files from the precompiled header's dependencies. If not specified only the precompiled header would be listed and not the files that were used to create it because those files are not consulted when a precompiled header is used. - <br><dt><code>-fpch-preprocess</code><dd><a name="index-fpch_002dpreprocess-938"></a>This option allows use of a precompiled header (see <a href="Precompiled-Headers.html#Precompiled-Headers">Precompiled Headers</a>) together with <samp><span class="option">-E</span></samp>. It inserts a special <code>#pragma</code>, + <br><dt><code>-fpch-preprocess</code><dd><a name="index-fpch_002dpreprocess-940"></a>This option allows use of a precompiled header (see <a href="Precompiled-Headers.html#Precompiled-Headers">Precompiled Headers</a>) together with <samp><span class="option">-E</span></samp>. It inserts a special <code>#pragma</code>, <code>#pragma GCC pch_preprocess "</code><var>filename</var><code>"</code> in the output to mark the place where the precompiled header was found, and its <var>filename</var>. When <samp><span class="option">-fpreprocessed</span></samp> is in use, GCC recognizes this <code>#pragma</code> @@ -339,7 +339,7 @@ safe to edit the filename if the PCH file is available in a different location. The filename may be absolute or it may be relative to GCC's current directory. - <br><dt><code>-x c</code><dt><code>-x c++</code><dt><code>-x objective-c</code><dt><code>-x assembler-with-cpp</code><dd><a name="index-x-939"></a>Specify the source language: C, C++, Objective-C, or assembly. This has + <br><dt><code>-x c</code><dt><code>-x c++</code><dt><code>-x objective-c</code><dt><code>-x assembler-with-cpp</code><dd><a name="index-x-941"></a>Specify the source language: C, C++, Objective-C, or assembly. This has nothing to do with standards conformance or extensions; it merely selects which base syntax to expect. If you give none of these options, cpp will deduce the language from the extension of the source file: @@ -353,7 +353,7 @@ which selected both the language and the standards conformance level. This option has been removed, because it conflicts with the <samp><span class="option">-l</span></samp> option. - <br><dt><code>-std=</code><var>standard</var><dt><code>-ansi</code><dd><a name="index-ansi-940"></a><a name="index-std_003d-941"></a>Specify the standard to which the code should conform. Currently CPP + <br><dt><code>-std=</code><var>standard</var><dt><code>-ansi</code><dd><a name="index-ansi-942"></a><a name="index-std_003d-943"></a>Specify the standard to which the code should conform. Currently CPP knows about C and C++ standards; others may be added in the future. <p><var>standard</var> @@ -384,7 +384,7 @@ publication, this was known as C1X. default for C++ code. </dl> - <br><dt><code>-I-</code><dd><a name="index-I_002d-942"></a>Split the include path. Any directories specified with <samp><span class="option">-I</span></samp> + <br><dt><code>-I-</code><dd><a name="index-I_002d-944"></a>Split the include path. Any directories specified with <samp><span class="option">-I</span></samp> options before <samp><span class="option">-I-</span></samp> are searched only for headers requested with <code>#include "</code><var>file</var><code>"<!-- /@w --></code>; they are not searched for <code>#include <</code><var>file</var><code>><!-- /@w --></code>. If additional directories are @@ -395,15 +395,15 @@ directories are searched for all ‘<samp><span class="samp">#include</span> file directory as the first search directory for <code>#include "</code><var>file</var><code>"<!-- /@w --></code>. This option has been deprecated. - <br><dt><code>-nostdinc</code><dd><a name="index-nostdinc-943"></a>Do not search the standard system directories for header files. + <br><dt><code>-nostdinc</code><dd><a name="index-nostdinc-945"></a>Do not search the standard system directories for header files. Only the directories you have specified with <samp><span class="option">-I</span></samp> options (and the directory of the current file, if appropriate) are searched. - <br><dt><code>-nostdinc++</code><dd><a name="index-nostdinc_002b_002b-944"></a>Do not search for header files in the C++-specific standard directories, + <br><dt><code>-nostdinc++</code><dd><a name="index-nostdinc_002b_002b-946"></a>Do not search for header files in the C++-specific standard directories, but do still search the other standard directories. (This option is used when building the C++ library.) - <br><dt><code>-include </code><var>file</var><dd><a name="index-include-945"></a>Process <var>file</var> as if <code>#include "file"</code> appeared as the first + <br><dt><code>-include </code><var>file</var><dd><a name="index-include-947"></a>Process <var>file</var> as if <code>#include "file"</code> appeared as the first line of the primary source file. However, the first directory searched for <var>file</var> is the preprocessor's working directory <em>instead of</em> the directory containing the main source file. If not found there, it @@ -413,7 +413,7 @@ chain as normal. <p>If multiple <samp><span class="option">-include</span></samp> options are given, the files are included in the order they appear on the command line. - <br><dt><code>-imacros </code><var>file</var><dd><a name="index-imacros-946"></a>Exactly like <samp><span class="option">-include</span></samp>, except that any output produced by + <br><dt><code>-imacros </code><var>file</var><dd><a name="index-imacros-948"></a>Exactly like <samp><span class="option">-include</span></samp>, except that any output produced by scanning <var>file</var> is thrown away. Macros it defines remain defined. This allows you to acquire all the macros from a header without also processing its declarations. @@ -421,44 +421,44 @@ processing its declarations. <p>All files specified by <samp><span class="option">-imacros</span></samp> are processed before all files specified by <samp><span class="option">-include</span></samp>. - <br><dt><code>-idirafter </code><var>dir</var><dd><a name="index-idirafter-947"></a>Search <var>dir</var> for header files, but do it <em>after</em> all + <br><dt><code>-idirafter </code><var>dir</var><dd><a name="index-idirafter-949"></a>Search <var>dir</var> for header files, but do it <em>after</em> all directories specified with <samp><span class="option">-I</span></samp> and the standard system directories have been exhausted. <var>dir</var> is treated as a system include directory. If <var>dir</var> begins with <code>=</code>, then the <code>=</code> will be replaced by the sysroot prefix; see <samp><span class="option">--sysroot</span></samp> and <samp><span class="option">-isysroot</span></samp>. - <br><dt><code>-iprefix </code><var>prefix</var><dd><a name="index-iprefix-948"></a>Specify <var>prefix</var> as the prefix for subsequent <samp><span class="option">-iwithprefix</span></samp> + <br><dt><code>-iprefix </code><var>prefix</var><dd><a name="index-iprefix-950"></a>Specify <var>prefix</var> as the prefix for subsequent <samp><span class="option">-iwithprefix</span></samp> options. If the prefix represents a directory, you should include the final ‘<samp><span class="samp">/</span></samp>’. - <br><dt><code>-iwithprefix </code><var>dir</var><dt><code>-iwithprefixbefore </code><var>dir</var><dd><a name="index-iwithprefix-949"></a><a name="index-iwithprefixbefore-950"></a>Append <var>dir</var> to the prefix specified previously with + <br><dt><code>-iwithprefix </code><var>dir</var><dt><code>-iwithprefixbefore </code><var>dir</var><dd><a name="index-iwithprefix-951"></a><a name="index-iwithprefixbefore-952"></a>Append <var>dir</var> to the prefix specified previously with <samp><span class="option">-iprefix</span></samp>, and add the resulting directory to the include search path. <samp><span class="option">-iwithprefixbefore</span></samp> puts it in the same place <samp><span class="option">-I</span></samp> would; <samp><span class="option">-iwithprefix</span></samp> puts it where <samp><span class="option">-idirafter</span></samp> would. - <br><dt><code>-isysroot </code><var>dir</var><dd><a name="index-isysroot-951"></a>This option is like the <samp><span class="option">--sysroot</span></samp> option, but applies only to + <br><dt><code>-isysroot </code><var>dir</var><dd><a name="index-isysroot-953"></a>This option is like the <samp><span class="option">--sysroot</span></samp> option, but applies only to header files (except for Darwin targets, where it applies to both header files and libraries). See the <samp><span class="option">--sysroot</span></samp> option for more information. - <br><dt><code>-imultilib </code><var>dir</var><dd><a name="index-imultilib-952"></a>Use <var>dir</var> as a subdirectory of the directory containing + <br><dt><code>-imultilib </code><var>dir</var><dd><a name="index-imultilib-954"></a>Use <var>dir</var> as a subdirectory of the directory containing target-specific C++ headers. - <br><dt><code>-isystem </code><var>dir</var><dd><a name="index-isystem-953"></a>Search <var>dir</var> for header files, after all directories specified by + <br><dt><code>-isystem </code><var>dir</var><dd><a name="index-isystem-955"></a>Search <var>dir</var> for header files, after all directories specified by <samp><span class="option">-I</span></samp> but before the standard system directories. Mark it as a system directory, so that it gets the same special treatment as is applied to the standard system directories. If <var>dir</var> begins with <code>=</code>, then the <code>=</code> will be replaced by the sysroot prefix; see <samp><span class="option">--sysroot</span></samp> and <samp><span class="option">-isysroot</span></samp>. - <br><dt><code>-iquote </code><var>dir</var><dd><a name="index-iquote-954"></a>Search <var>dir</var> only for header files requested with + <br><dt><code>-iquote </code><var>dir</var><dd><a name="index-iquote-956"></a>Search <var>dir</var> only for header files requested with <code>#include "</code><var>file</var><code>"<!-- /@w --></code>; they are not searched for <code>#include <</code><var>file</var><code>><!-- /@w --></code>, before all directories specified by <samp><span class="option">-I</span></samp> and before the standard system directories. If <var>dir</var> begins with <code>=</code>, then the <code>=</code> will be replaced by the sysroot prefix; see <samp><span class="option">--sysroot</span></samp> and <samp><span class="option">-isysroot</span></samp>. - <br><dt><code>-fdirectives-only</code><dd><a name="index-fdirectives_002donly-955"></a>When preprocessing, handle directives, but do not expand macros. + <br><dt><code>-fdirectives-only</code><dd><a name="index-fdirectives_002donly-957"></a>When preprocessing, handle directives, but do not expand macros. <p>The option's behavior depends on the <samp><span class="option">-E</span></samp> and <samp><span class="option">-fpreprocessed</span></samp> options. @@ -478,13 +478,13 @@ files previously preprocessed with <code>-E -fdirectives-only</code>. <samp><span class="option">-fpreprocessed</span></samp> take precedence. This enables full preprocessing of files previously preprocessed with <code>-E -fdirectives-only</code>. - <br><dt><code>-fdollars-in-identifiers</code><dd><a name="index-fdollars_002din_002didentifiers-956"></a><a name="fdollars_002din_002didentifiers"></a>Accept ‘<samp><span class="samp">$</span></samp>’ in identifiers. + <br><dt><code>-fdollars-in-identifiers</code><dd><a name="index-fdollars_002din_002didentifiers-958"></a><a name="fdollars_002din_002didentifiers"></a>Accept ‘<samp><span class="samp">$</span></samp>’ in identifiers. - <br><dt><code>-fextended-identifiers</code><dd><a name="index-fextended_002didentifiers-957"></a>Accept universal character names in identifiers. This option is + <br><dt><code>-fextended-identifiers</code><dd><a name="index-fextended_002didentifiers-959"></a>Accept universal character names in identifiers. This option is experimental; in a future version of GCC, it will be enabled by default for C99 and C++. - <br><dt><code>-fpreprocessed</code><dd><a name="index-fpreprocessed-958"></a>Indicate to the preprocessor that the input file has already been + <br><dt><code>-fpreprocessed</code><dd><a name="index-fpreprocessed-960"></a>Indicate to the preprocessor that the input file has already been preprocessed. This suppresses things like macro expansion, trigraph conversion, escaped newline splicing, and processing of most directives. The preprocessor still recognizes and removes comments, so that you can @@ -497,12 +497,12 @@ extensions ‘<samp><span class="samp">.i</span></samp>’, ‘<samp extensions that GCC uses for preprocessed files created by <samp><span class="option">-save-temps</span></samp>. - <br><dt><code>-ftabstop=</code><var>width</var><dd><a name="index-ftabstop-959"></a>Set the distance between tab stops. This helps the preprocessor report + <br><dt><code>-ftabstop=</code><var>width</var><dd><a name="index-ftabstop-961"></a>Set the distance between tab stops. This helps the preprocessor report correct column numbers in warnings or errors, even if tabs appear on the line. If the value is less than 1 or greater than 100, the option is ignored. The default is 8. - <br><dt><code>-fdebug-cpp</code><dd><a name="index-fdebug_002dcpp-960"></a>This option is only useful for debugging GCC. When used with + <br><dt><code>-fdebug-cpp</code><dd><a name="index-fdebug_002dcpp-962"></a>This option is only useful for debugging GCC. When used with <samp><span class="option">-E</span></samp>, dumps debugging information about location maps. Every token in the output is preceded by the dump of the map its location belongs to. The dump of the map holding the location of a token would @@ -511,7 +511,7 @@ be: </pre> <p>When used without <samp><span class="option">-E</span></samp>, this option has no effect. - <br><dt><code>-ftrack-macro-expansion</code><span class="roman">[</span><code>=</code><var>level</var><span class="roman">]</span><dd><a name="index-ftrack_002dmacro_002dexpansion-961"></a>Track locations of tokens across macro expansions. This allows the + <br><dt><code>-ftrack-macro-expansion</code><span class="roman">[</span><code>=</code><var>level</var><span class="roman">]</span><dd><a name="index-ftrack_002dmacro_002dexpansion-963"></a>Track locations of tokens across macro expansions. This allows the compiler to emit diagnostic about the current macro expansion stack when a compilation error occurs in a macro expansion. Using this option makes the preprocessor and the compiler consume more @@ -527,18 +527,18 @@ tokens locations completely. This value is the most memory hungry. When this option is given no argument, the default parameter value is ‘<samp><span class="samp">2</span></samp>’. - <br><dt><code>-fexec-charset=</code><var>charset</var><dd><a name="index-fexec_002dcharset-962"></a><a name="index-character-set_002c-execution-963"></a>Set the execution character set, used for string and character + <br><dt><code>-fexec-charset=</code><var>charset</var><dd><a name="index-fexec_002dcharset-964"></a><a name="index-character-set_002c-execution-965"></a>Set the execution character set, used for string and character constants. The default is UTF-8. <var>charset</var> can be any encoding supported by the system's <code>iconv</code> library routine. - <br><dt><code>-fwide-exec-charset=</code><var>charset</var><dd><a name="index-fwide_002dexec_002dcharset-964"></a><a name="index-character-set_002c-wide-execution-965"></a>Set the wide execution character set, used for wide string and + <br><dt><code>-fwide-exec-charset=</code><var>charset</var><dd><a name="index-fwide_002dexec_002dcharset-966"></a><a name="index-character-set_002c-wide-execution-967"></a>Set the wide execution character set, used for wide string and character constants. The default is UTF-32 or UTF-16, whichever corresponds to the width of <code>wchar_t</code>. As with <samp><span class="option">-fexec-charset</span></samp>, <var>charset</var> can be any encoding supported by the system's <code>iconv</code> library routine; however, you will have problems with encodings that do not fit exactly in <code>wchar_t</code>. - <br><dt><code>-finput-charset=</code><var>charset</var><dd><a name="index-finput_002dcharset-966"></a><a name="index-character-set_002c-input-967"></a>Set the input character set, used for translation from the character + <br><dt><code>-finput-charset=</code><var>charset</var><dd><a name="index-finput_002dcharset-968"></a><a name="index-character-set_002c-input-969"></a>Set the input character set, used for translation from the character set of the input file to the source character set used by GCC. If the locale does not specify, or GCC cannot get this information from the locale, the default is UTF-8. This can be overridden by either the locale @@ -546,7 +546,7 @@ or this command line option. Currently the command line option takes precedence if there's a conflict. <var>charset</var> can be any encoding supported by the system's <code>iconv</code> library routine. - <br><dt><code>-fworking-directory</code><dd><a name="index-fworking_002ddirectory-968"></a><a name="index-fno_002dworking_002ddirectory-969"></a>Enable generation of linemarkers in the preprocessor output that will + <br><dt><code>-fworking-directory</code><dd><a name="index-fworking_002ddirectory-970"></a><a name="index-fno_002dworking_002ddirectory-971"></a>Enable generation of linemarkers in the preprocessor output that will let the compiler know the current working directory at the time of preprocessing. When this option is enabled, the preprocessor will emit, after the initial linemarker, a second linemarker with the @@ -559,11 +559,11 @@ form <samp><span class="option">-fno-working-directory</span></samp>. If the <s present in the command line, this option has no effect, since no <code>#line</code> directives are emitted whatsoever. - <br><dt><code>-fno-show-column</code><dd><a name="index-fno_002dshow_002dcolumn-970"></a>Do not print column numbers in diagnostics. This may be necessary if + <br><dt><code>-fno-show-column</code><dd><a name="index-fno_002dshow_002dcolumn-972"></a>Do not print column numbers in diagnostics. This may be necessary if diagnostics are being scanned by a program that does not understand the column numbers, such as <samp><span class="command">dejagnu</span></samp>. - <br><dt><code>-A </code><var>predicate</var><code>=</code><var>answer</var><dd><a name="index-A-971"></a>Make an assertion with the predicate <var>predicate</var> and answer + <br><dt><code>-A </code><var>predicate</var><code>=</code><var>answer</var><dd><a name="index-A-973"></a>Make an assertion with the predicate <var>predicate</var> and answer <var>answer</var>. This form is preferred to the older form <samp><span class="option">-A </span><var>predicate</var><span class="option">(</span><var>answer</var><span class="option">)</span></samp>, which is still supported, because it does not use shell special characters. @@ -578,7 +578,7 @@ are silently ignored. If you specify characters whose behavior conflicts, the result is undefined. <dl> -<dt>‘<samp><span class="samp">M</span></samp>’<dd><a name="index-dM-972"></a>Instead of the normal output, generate a list of ‘<samp><span class="samp">#define</span></samp>’ +<dt>‘<samp><span class="samp">M</span></samp>’<dd><a name="index-dM-974"></a>Instead of the normal output, generate a list of ‘<samp><span class="samp">#define</span></samp>’ directives for all the macros defined during the execution of the preprocessor, including predefined macros. This gives you a way of finding out what is predefined in your version of the preprocessor. @@ -592,29 +592,29 @@ Assuming you have no file <samp><span class="file">foo.h</span></samp>, the comm interpreted as a synonym for <samp><span class="option">-fdump-rtl-mach</span></samp>. See <a href="../gcc/Debugging-Options.html#Debugging-Options">Debugging Options</a>. - <br><dt>‘<samp><span class="samp">D</span></samp>’<dd><a name="index-dD-973"></a>Like ‘<samp><span class="samp">M</span></samp>’ except in two respects: it does <em>not</em> include the + <br><dt>‘<samp><span class="samp">D</span></samp>’<dd><a name="index-dD-975"></a>Like ‘<samp><span class="samp">M</span></samp>’ except in two respects: it does <em>not</em> include the predefined macros, and it outputs <em>both</em> the ‘<samp><span class="samp">#define</span></samp>’ directives and the result of preprocessing. Both kinds of output go to the standard output file. - <br><dt>‘<samp><span class="samp">N</span></samp>’<dd><a name="index-dN-974"></a>Like ‘<samp><span class="samp">D</span></samp>’, but emit only the macro names, not their expansions. + <br><dt>‘<samp><span class="samp">N</span></samp>’<dd><a name="index-dN-976"></a>Like ‘<samp><span class="samp">D</span></samp>’, but emit only the macro names, not their expansions. - <br><dt>‘<samp><span class="samp">I</span></samp>’<dd><a name="index-dI-975"></a>Output ‘<samp><span class="samp">#include</span></samp>’ directives in addition to the result of + <br><dt>‘<samp><span class="samp">I</span></samp>’<dd><a name="index-dI-977"></a>Output ‘<samp><span class="samp">#include</span></samp>’ directives in addition to the result of preprocessing. - <br><dt>‘<samp><span class="samp">U</span></samp>’<dd><a name="index-dU-976"></a>Like ‘<samp><span class="samp">D</span></samp>’ except that only macros that are expanded, or whose + <br><dt>‘<samp><span class="samp">U</span></samp>’<dd><a name="index-dU-978"></a>Like ‘<samp><span class="samp">D</span></samp>’ except that only macros that are expanded, or whose definedness is tested in preprocessor directives, are output; the output is delayed until the use or test of the macro; and ‘<samp><span class="samp">#undef</span></samp>’ directives are also output for macros tested but undefined at the time. </dl> - <br><dt><code>-P</code><dd><a name="index-P-977"></a>Inhibit generation of linemarkers in the output from the preprocessor. + <br><dt><code>-P</code><dd><a name="index-P-979"></a>Inhibit generation of linemarkers in the output from the preprocessor. This might be useful when running the preprocessor on something that is not C code, and will be sent to a program which might be confused by the linemarkers. - <br><dt><code>-C</code><dd><a name="index-C-978"></a>Do not discard comments. All comments are passed through to the output + <br><dt><code>-C</code><dd><a name="index-C-980"></a>Do not discard comments. All comments are passed through to the output file, except for comments in processed directives, which are deleted along with the directive. @@ -636,10 +636,10 @@ the source line. <p>The <samp><span class="option">-CC</span></samp> option is generally used to support lint comments. - <br><dt><code>-traditional-cpp</code><dd><a name="index-traditional_002dcpp-979"></a>Try to imitate the behavior of old-fashioned C preprocessors, as + <br><dt><code>-traditional-cpp</code><dd><a name="index-traditional_002dcpp-981"></a>Try to imitate the behavior of old-fashioned C preprocessors, as opposed to ISO C preprocessors. - <br><dt><code>-trigraphs</code><dd><a name="index-trigraphs-980"></a>Process trigraph sequences. + <br><dt><code>-trigraphs</code><dd><a name="index-trigraphs-982"></a>Process trigraph sequences. These are three-character sequences, all starting with ‘<samp><span class="samp">??</span></samp>’, that are defined by ISO C to stand for single characters. For example, ‘<samp><span class="samp">??/</span></samp>’ stands for ‘<samp><span class="samp">\</span></samp>’, so ‘<samp><span class="samp">'??/n'</span></samp>’ is a character @@ -652,22 +652,22 @@ standard-conforming modes it converts them. See the <samp><span class="option"> <pre class="smallexample"> Trigraph: ??( ??) ??< ??> ??= ??/ ??' ??! ??- Replacement: [ ] { } # \ ^ | ~ </pre> - <br><dt><code>-remap</code><dd><a name="index-remap-981"></a>Enable special code to work around file systems which only permit very + <br><dt><code>-remap</code><dd><a name="index-remap-983"></a>Enable special code to work around file systems which only permit very short file names, such as MS-DOS. - <dt><code>--help</code><dt><code>--target-help</code><dd><a name="index-help-982"></a><a name="index-target_002dhelp-983"></a>Print text describing all the command line options instead of + <dt><code>--help</code><dt><code>--target-help</code><dd><a name="index-help-984"></a><a name="index-target_002dhelp-985"></a>Print text describing all the command line options instead of preprocessing anything. - <br><dt><code>-v</code><dd><a name="index-v-984"></a>Verbose mode. Print out GNU CPP's version number at the beginning of + <br><dt><code>-v</code><dd><a name="index-v-986"></a>Verbose mode. Print out GNU CPP's version number at the beginning of execution, and report the final form of the include path. - <br><dt><code>-H</code><dd><a name="index-H-985"></a>Print the name of each header file used, in addition to other normal + <br><dt><code>-H</code><dd><a name="index-H-987"></a>Print the name of each header file used, in addition to other normal activities. Each name is indented to show how deep in the ‘<samp><span class="samp">#include</span></samp>’ stack it is. Precompiled header files are also printed, even if they are found to be invalid; an invalid precompiled header file is printed with ‘<samp><span class="samp">...x</span></samp>’ and a valid one with ‘<samp><span class="samp">...!</span></samp>’ . - <br><dt><code>-version</code><dt><code>--version</code><dd><a name="index-version-986"></a>Print out GNU CPP's version number. With one dash, proceed to + <br><dt><code>-version</code><dt><code>--version</code><dd><a name="index-version-988"></a>Print out GNU CPP's version number. With one dash, proceed to preprocess as normal. With two dashes, exit immediately. </dl> |