diff options
Diffstat (limited to 'gcc/doc/cpp.texi')
| -rw-r--r-- | gcc/doc/cpp.texi | 129 |
1 files changed, 6 insertions, 123 deletions
diff --git a/gcc/doc/cpp.texi b/gcc/doc/cpp.texi index 90b2767..edf22bf 100644 --- a/gcc/doc/cpp.texi +++ b/gcc/doc/cpp.texi @@ -8,38 +8,6 @@ @include gcc-common.texi -@copying -@c man begin COPYRIGHT -Copyright @copyright{} 1987-2022 Free Software Foundation, Inc. - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation. A copy of -the license is included in the -@c man end -section entitled ``GNU Free Documentation License''. -@ignore -@c man begin COPYRIGHT -man page gfdl(7). -@c man end -@end ignore - -@c man begin COPYRIGHT -This manual contains no Invariant Sections. The Front-Cover Texts are -(a) (see below), and the Back-Cover Texts are (b) (see below). - -(a) The FSF's Front-Cover Text is: - - A GNU Manual - -(b) The FSF's Back-Cover Text is: - - You have freedom to copy and modify this GNU Manual, like GNU - software. Copies published by the Free Software Foundation raise - funds for GNU development. -@c man end -@end copying - @c Create a separate index for command line options. @defcodeindex op @syncodeindex vr op @@ -93,82 +61,6 @@ useful on its own. * Option Index:: * Concept Index:: -@detailmenu - --- The Detailed Node Listing --- - -Overview - -* Character sets:: -* Initial processing:: -* Tokenization:: -* The preprocessing language:: - -Header Files - -* Include Syntax:: -* Include Operation:: -* Search Path:: -* Once-Only Headers:: -* Alternatives to Wrapper #ifndef:: -* Computed Includes:: -* Wrapper Headers:: -* System Headers:: - -Macros - -* Object-like Macros:: -* Function-like Macros:: -* Macro Arguments:: -* Stringizing:: -* Concatenation:: -* Variadic Macros:: -* Predefined Macros:: -* Undefining and Redefining Macros:: -* Directives Within Macro Arguments:: -* Macro Pitfalls:: - -Predefined Macros - -* Standard Predefined Macros:: -* Common Predefined Macros:: -* System-specific Predefined Macros:: -* C++ Named Operators:: - -Macro Pitfalls - -* Misnesting:: -* Operator Precedence Problems:: -* Swallowing the Semicolon:: -* Duplication of Side Effects:: -* Self-Referential Macros:: -* Argument Prescan:: -* Newlines in Arguments:: - -Conditionals - -* Conditional Uses:: -* Conditional Syntax:: -* Deleted Code:: - -Conditional Syntax - -* Ifdef:: -* If:: -* Defined:: -* Else:: -* Elif:: - -Implementation Details - -* Implementation-defined behavior:: -* Implementation limits:: -* Obsolete Features:: - -Obsolete Features - -* Obsolete Features:: - -@end detailmenu @end menu @insertcopying @@ -176,7 +68,7 @@ Obsolete Features @node Overview @chapter Overview -@c man begin DESCRIPTION + The C preprocessor, often known as @dfn{cpp}, is a @dfn{macro processor} that is used automatically by the C compiler to transform your program before compilation. It is called a macro processor because it allows @@ -225,7 +117,6 @@ Mode}. For clarity, unless noted otherwise, references to @samp{CPP} in this manual refer to GNU CPP@. -@c man end @menu * Character sets:: @@ -4506,8 +4397,8 @@ pertaining to compilation phases after preprocessing are ignored. Only options specific to preprocessing behavior are documented here. Refer to the GCC manual for full documentation of other driver options. -@ignore -@c man begin SYNOPSIS +@subsubheading Synopsis + cpp [@option{-D}@var{macro}[=@var{defn}]@dots{}] [@option{-U}@var{macro}] [@option{-I}@var{dir}@dots{}] [@option{-iquote}@var{dir}@dots{}] [@option{-M}|@option{-MM}] [@option{-MG}] [@option{-MF} @var{filename}] @@ -4519,14 +4410,9 @@ Only the most useful options are given above; see below for a more complete list of preprocessor-specific options. In addition, @command{cpp} accepts most @command{gcc} driver options, which are not listed here. Refer to the GCC documentation for details. -@c man end -@c man begin SEEALSO -gpl(7), gfdl(7), fsf-funding(7), -gcc(1), and the Info entries for @file{cpp} and @file{gcc}. -@c man end -@end ignore - -@c man begin OPTIONS + +@subsubheading Options + The @command{cpp} command expects two file names as arguments, @var{infile} and @var{outfile}. The preprocessor reads @var{infile} together with any other files it specifies with @samp{#include}. All the output generated @@ -4557,12 +4443,10 @@ options may @emph{not} be grouped: @option{-dM} is very different from @include cppdiropts.texi @include cppwarnopts.texi @end table -@c man end @node Environment Variables @chapter Environment Variables @cindex environment variables -@c man begin ENVIRONMENT This section describes the environment variables that affect how CPP operates. You can use them to specify directories or prefixes to use @@ -4575,7 +4459,6 @@ environment variables, which in turn take precedence over the configuration of GCC@. @include cppenv.texi -@c man end @page @include fdl.texi |