Module Name: src
Committed By: mrg
Date: Wed Jul 6 11:37:27 UTC 2016
Modified Files:
src/external/gpl3/gcc.old/dist/gcc/doc: cpp.1
src/external/gpl3/gcc/dist/gcc/doc: cpp.1
Log Message:
missed from previous:
remove old generated versions of man pages.
update the dist versions of man and info pages to include local changes.
To generate a diff of this commit:
cvs rdiff -u -r1.3 -r1.4 src/external/gpl3/gcc.old/dist/gcc/doc/cpp.1
cvs rdiff -u -r1.6 -r1.7 src/external/gpl3/gcc/dist/gcc/doc/cpp.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/gpl3/gcc.old/dist/gcc/doc/cpp.1
diff -u src/external/gpl3/gcc.old/dist/gcc/doc/cpp.1:1.3 src/external/gpl3/gcc.old/dist/gcc/doc/cpp.1:1.4
--- src/external/gpl3/gcc.old/dist/gcc/doc/cpp.1:1.3 Wed Sep 23 03:39:18 2015
+++ src/external/gpl3/gcc.old/dist/gcc/doc/cpp.1 Wed Jul 6 11:37:26 2016
@@ -1,15 +1,7 @@
-.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)
.\"
.\" Standard preamble:
.\" ========================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
@@ -46,6 +38,8 @@
. ds PI \(*p
. ds L" ``
. ds R" ''
+. ds C`
+. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
@@ -53,20 +47,27 @@
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{
+. if \nF \{
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
..
+. if !\nF==2 \{
+. nr % 0
+. nr F 2
+. \}
+. \}
.\}
+.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
@@ -143,6 +144,7 @@ cpp \- The C Preprocessor
.IX Header "SYNOPSIS"
cpp [\fB\-D\fR\fImacro\fR[=\fIdefn\fR]...] [\fB\-U\fR\fImacro\fR]
[\fB\-I\fR\fIdir\fR...] [\fB\-iquote\fR\fIdir\fR...]
+ [\fB\-iremap\fR\fIsrc\fR:\fIdst\fR]
[\fB\-W\fR\fIwarn\fR...]
[\fB\-M\fR|\fB\-MM\fR] [\fB\-MG\fR] [\fB\-MF\fR \fIfilename\fR]
[\fB\-MP\fR] [\fB\-MQ\fR \fItarget\fR...]
@@ -180,11 +182,11 @@ Wherever possible, you should use a prep
you are writing in. Modern versions of the \s-1GNU\s0 assembler have macro
facilities. Most high level programming languages have their own
conditional compilation and inclusion mechanism. If all else fails,
-try a true general text processor, such as \s-1GNU\s0 M4.
+try a true general text processor, such as \s-1GNU M4.\s0
.PP
-C preprocessors vary in some details. This manual discusses the \s-1GNU\s0 C
+C preprocessors vary in some details. This manual discusses the \s-1GNU C\s0
preprocessor, which provides a small superset of the features of \s-1ISO\s0
-Standard C. In its default mode, the \s-1GNU\s0 C preprocessor does not do a
+Standard C. In its default mode, the \s-1GNU C\s0 preprocessor does not do a
few things required by the standard. These are features which are
rarely, if ever, used, and may cause surprising changes to the meaning
of a program which does not expect them. To get strict \s-1ISO\s0 Standard C,
@@ -201,7 +203,7 @@ differences that do exist are detailed i
Mode\fR.
.PP
For clarity, unless noted otherwise, references to \fB\s-1CPP\s0\fR in this
-manual refer to \s-1GNU\s0 \s-1CPP\s0.
+manual refer to \s-1GNU CPP.\s0
.SH "OPTIONS"
.IX Header "OPTIONS"
The C preprocessor expects two file names as arguments, \fIinfile\fR and
@@ -305,7 +307,7 @@ get trigraph conversion without warnings
.IP "\fB\-Wtraditional\fR" 4
.IX Item "-Wtraditional"
Warn about certain constructs that behave differently in traditional and
-\&\s-1ISO\s0 C. Also warn about \s-1ISO\s0 C constructs that have no traditional C
+\&\s-1ISO C. \s0 Also warn about \s-1ISO C\s0 constructs that have no traditional C
equivalent, and problematic constructs which should be avoided.
.IP "\fB\-Wundef\fR" 4
.IX Item "-Wundef"
@@ -358,7 +360,7 @@ in finding bugs in your own code, theref
responsible for the system library, you may want to see them.
.IP "\fB\-w\fR" 4
.IX Item "-w"
-Suppress all warnings, including those which \s-1GNU\s0 \s-1CPP\s0 issues by default.
+Suppress all warnings, including those which \s-1GNU CPP\s0 issues by default.
.IP "\fB\-pedantic\fR" 4
.IX Item "-pedantic"
Issue all the mandatory diagnostics listed in the C standard. Some of
@@ -530,7 +532,7 @@ may be one of:
.el .IP "\f(CWiso9899:1990\fR" 4
.IX Item "iso9899:1990"
.PD
-The \s-1ISO\s0 C standard from 1990. \fBc90\fR is the customary shorthand for
+The \s-1ISO C\s0 standard from 1990. \fBc90\fR is the customary shorthand for
this version of the standard.
.Sp
The \fB\-ansi\fR option is equivalent to \fB\-std=c90\fR.
@@ -552,7 +554,7 @@ The 1990 C standard, as amended in 1994.
.el .IP "\f(CWc9x\fR" 4
.IX Item "c9x"
.PD
-The revised \s-1ISO\s0 C standard, published in December 1999. Before
+The revised \s-1ISO C\s0 standard, published in December 1999. Before
publication, this was known as C9X.
.ie n .IP """iso9899:2011""" 4
.el .IP "\f(CWiso9899:2011\fR" 4
@@ -565,7 +567,7 @@ publication, this was known as C9X.
.el .IP "\f(CWc1x\fR" 4
.IX Item "c1x"
.PD
-The revised \s-1ISO\s0 C standard, published in December 2011. Before
+The revised \s-1ISO C\s0 standard, published in December 2011. Before
publication, this was known as C1X.
.ie n .IP """gnu90""" 4
.el .IP "\f(CWgnu90\fR" 4
@@ -597,7 +599,7 @@ The 2011 C standard plus \s-1GNU\s0 exte
.ie n .IP """c++98""" 4
.el .IP "\f(CWc++98\fR" 4
.IX Item "c++98"
-The 1998 \s-1ISO\s0 \*(C+ standard plus amendments.
+The 1998 \s-1ISO \*(C+\s0 standard plus amendments.
.ie n .IP """gnu++98""" 4
.el .IP "\f(CWgnu++98\fR" 4
.IX Item "gnu++98"
@@ -690,6 +692,12 @@ is applied to the standard system direct
.Sp
If \fIdir\fR begins with \f(CW\*(C`=\*(C'\fR, then the \f(CW\*(C`=\*(C'\fR will be replaced
by the sysroot prefix; see \fB\-\-sysroot\fR and \fB\-isysroot\fR.
+.IP "\fB\-cxx\-isystem\fR \fIdir\fR" 4
+.IX Item "-cxx-isystem dir"
+Search \fIdir\fR for \*(C+ header files, after all directories specified by
+\&\fB\-I\fR 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.
.IP "\fB\-iquote\fR \fIdir\fR" 4
.IX Item "-iquote dir"
Search \fIdir\fR only for header files requested with
@@ -720,13 +728,18 @@ files previously preprocessed with \f(CW
With both \fB\-E\fR and \fB\-fpreprocessed\fR, the rules for
\&\fB\-fpreprocessed\fR take precedence. This enables full preprocessing of
files previously preprocessed with \f(CW\*(C`\-E \-fdirectives\-only\*(C'\fR.
+.IP "\fB\-iremap\fR \fIsrc\fR\fB:\fR\fIdst\fR" 4
+.IX Item "-iremap src:dst"
+Replace the prefix \fIsrc\fR in _\|_FILE_\|_ with \fIdst\fR at expansion time.
+This option can be specified more than once. Processing stops at the first
+match.
.IP "\fB\-fdollars\-in\-identifiers\fR" 4
.IX Item "-fdollars-in-identifiers"
Accept \fB$\fR in identifiers.
.IP "\fB\-fextended\-identifiers\fR" 4
.IX Item "-fextended-identifiers"
Accept universal character names in identifiers. This option is
-experimental; in a future version of \s-1GCC\s0, it will be enabled by
+experimental; in a future version of \s-1GCC,\s0 it will be enabled by
default for C99 and \*(C+.
.IP "\fB\-fno\-canonical\-system\-headers\fR" 4
.IX Item "-fno-canonical-system-headers"
@@ -753,7 +766,7 @@ line. If the value is less than 1 or gr
ignored. The default is 8.
.IP "\fB\-fdebug\-cpp\fR" 4
.IX Item "-fdebug-cpp"
-This option is only useful for debugging \s-1GCC\s0. When used with
+This option is only useful for debugging \s-1GCC. \s0 When used with
\&\fB\-E\fR, 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
@@ -786,12 +799,12 @@ Note that \-ftrack\-macro\-expansion=2 i
.IP "\fB\-fexec\-charset=\fR\fIcharset\fR" 4
.IX Item "-fexec-charset=charset"
Set the execution character set, used for string and character
-constants. The default is \s-1UTF\-8\s0. \fIcharset\fR can be any encoding
+constants. The default is \s-1UTF\-8. \s0\fIcharset\fR can be any encoding
supported by the system's \f(CW\*(C`iconv\*(C'\fR library routine.
.IP "\fB\-fwide\-exec\-charset=\fR\fIcharset\fR" 4
.IX Item "-fwide-exec-charset=charset"
Set the wide execution character set, used for wide string and
-character constants. The default is \s-1UTF\-32\s0 or \s-1UTF\-16\s0, whichever
+character constants. The default is \s-1UTF\-32\s0 or \s-1UTF\-16,\s0 whichever
corresponds to the width of \f(CW\*(C`wchar_t\*(C'\fR. As with
\&\fB\-fexec\-charset\fR, \fIcharset\fR can be any encoding supported
by the system's \f(CW\*(C`iconv\*(C'\fR library routine; however, you will have
@@ -799,9 +812,9 @@ problems with encodings that do not fit
.IP "\fB\-finput\-charset=\fR\fIcharset\fR" 4
.IX Item "-finput-charset=charset"
Set the input character set, used for translation from the character
-set of the input file to the source character set used by \s-1GCC\s0. If the
+set of the input file to the source character set used by \s-1GCC. \s0 If the
locale does not specify, or \s-1GCC\s0 cannot get this information from the
-locale, the default is \s-1UTF\-8\s0. This can be overridden by either the locale
+locale, the default is \s-1UTF\-8. \s0 This can be overridden by either the locale
or this command line option. Currently the command line option takes
precedence if there's a conflict. \fIcharset\fR can be any encoding
supported by the system's \f(CW\*(C`iconv\*(C'\fR library routine.
@@ -838,7 +851,7 @@ Cancel an assertion with the predicate \
.IX Item "-dCHARS"
\&\fI\s-1CHARS\s0\fR is a sequence of one or more of the following characters,
and must not be preceded by a space. Other characters are interpreted
-by the compiler proper, or reserved for future versions of \s-1GCC\s0, and so
+by the compiler proper, or reserved for future versions of \s-1GCC,\s0 and so
are silently ignored. If you specify characters whose behavior
conflicts, the result is undefined.
.RS 4
@@ -914,7 +927,7 @@ The \fB\-CC\fR option is generally used
.IP "\fB\-traditional\-cpp\fR" 4
.IX Item "-traditional-cpp"
Try to imitate the behavior of old-fashioned C preprocessors, as
-opposed to \s-1ISO\s0 C preprocessors.
+opposed to \s-1ISO C\s0 preprocessors.
.IP "\fB\-trigraphs\fR" 4
.IX Item "-trigraphs"
Process trigraph sequences.
@@ -932,7 +945,7 @@ Print text describing all the command li
preprocessing anything.
.IP "\fB\-v\fR" 4
.IX Item "-v"
-Verbose mode. Print out \s-1GNU\s0 \s-1CPP\s0's version number at the beginning of
+Verbose mode. Print out \s-1GNU CPP\s0's version number at the beginning of
execution, and report the final form of the include path.
.IP "\fB\-H\fR" 4
.IX Item "-H"
@@ -947,7 +960,7 @@ header file is printed with \fB...x\fR a
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
.PD
-Print out \s-1GNU\s0 \s-1CPP\s0's version number. With one dash, proceed to
+Print out \s-1GNU CPP\s0's version number. With one dash, proceed to
preprocess as normal. With two dashes, exit immediately.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
@@ -959,7 +972,7 @@ Note that you can also specify places to
\&\fB\-I\fR, and control dependency output with options like
\&\fB\-M\fR. These take precedence over
environment variables, which in turn take precedence over the
-configuration of \s-1GCC\s0.
+configuration of \s-1GCC.\s0
.IP "\fB\s-1CPATH\s0\fR" 4
.IX Item "CPATH"
.PD 0
@@ -1013,6 +1026,11 @@ This variable is the same as \fB\s-1DEPE
except that system header files are not ignored, so it implies
\&\fB\-M\fR rather than \fB\-MM\fR. However, the dependence on the
main input file is omitted.
+.IP "\fB\s-1CPP_RESTRICTED\s0\fR" 4
+.IX Item "CPP_RESTRICTED"
+If this variable is defined, cpp will skip any include file which is not a
+regular file, and will continue searching for the requested name (this is
+always done if the found file is a directory).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIgpl\fR\|(7), \fIgfdl\fR\|(7), \fIfsf\-funding\fR\|(7),
Index: src/external/gpl3/gcc/dist/gcc/doc/cpp.1
diff -u src/external/gpl3/gcc/dist/gcc/doc/cpp.1:1.6 src/external/gpl3/gcc/dist/gcc/doc/cpp.1:1.7
--- src/external/gpl3/gcc/dist/gcc/doc/cpp.1:1.6 Tue Jun 7 06:14:17 2016
+++ src/external/gpl3/gcc/dist/gcc/doc/cpp.1 Wed Jul 6 11:37:27 2016
@@ -1,15 +1,7 @@
-.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)
.\"
.\" Standard preamble:
.\" ========================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
@@ -46,6 +38,8 @@
. ds PI \(*p
. ds L" ``
. ds R" ''
+. ds C`
+. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
@@ -53,20 +47,27 @@
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{
+. if \nF \{
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
..
+. if !\nF==2 \{
+. nr % 0
+. nr F 2
+. \}
+. \}
.\}
+.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
@@ -143,6 +144,7 @@ cpp \- The C Preprocessor
.IX Header "SYNOPSIS"
cpp [\fB\-D\fR\fImacro\fR[=\fIdefn\fR]...] [\fB\-U\fR\fImacro\fR]
[\fB\-I\fR\fIdir\fR...] [\fB\-iquote\fR\fIdir\fR...]
+ [\fB\-iremap\fR\fIsrc\fR:\fIdst\fR]
[\fB\-W\fR\fIwarn\fR...]
[\fB\-M\fR|\fB\-MM\fR] [\fB\-MG\fR] [\fB\-MF\fR \fIfilename\fR]
[\fB\-MP\fR] [\fB\-MQ\fR \fItarget\fR...]
@@ -180,11 +182,11 @@ Wherever possible, you should use a prep
you are writing in. Modern versions of the \s-1GNU\s0 assembler have macro
facilities. Most high level programming languages have their own
conditional compilation and inclusion mechanism. If all else fails,
-try a true general text processor, such as \s-1GNU\s0 M4.
+try a true general text processor, such as \s-1GNU M4.\s0
.PP
-C preprocessors vary in some details. This manual discusses the \s-1GNU\s0 C
+C preprocessors vary in some details. This manual discusses the \s-1GNU C\s0
preprocessor, which provides a small superset of the features of \s-1ISO\s0
-Standard C. In its default mode, the \s-1GNU\s0 C preprocessor does not do a
+Standard C. In its default mode, the \s-1GNU C\s0 preprocessor does not do a
few things required by the standard. These are features which are
rarely, if ever, used, and may cause surprising changes to the meaning
of a program which does not expect them. To get strict \s-1ISO\s0 Standard C,
@@ -201,7 +203,7 @@ differences that do exist are detailed i
Mode\fR.
.PP
For clarity, unless noted otherwise, references to \fB\s-1CPP\s0\fR in this
-manual refer to \s-1GNU\s0 \s-1CPP\s0.
+manual refer to \s-1GNU CPP.\s0
.SH "OPTIONS"
.IX Header "OPTIONS"
The C preprocessor expects two file names as arguments, \fIinfile\fR and
@@ -305,7 +307,7 @@ get trigraph conversion without warnings
.IP "\fB\-Wtraditional\fR" 4
.IX Item "-Wtraditional"
Warn about certain constructs that behave differently in traditional and
-\&\s-1ISO\s0 C. Also warn about \s-1ISO\s0 C constructs that have no traditional C
+\&\s-1ISO C. \s0 Also warn about \s-1ISO C\s0 constructs that have no traditional C
equivalent, and problematic constructs which should be avoided.
.IP "\fB\-Wundef\fR" 4
.IX Item "-Wundef"
@@ -358,7 +360,7 @@ in finding bugs in your own code, theref
responsible for the system library, you may want to see them.
.IP "\fB\-w\fR" 4
.IX Item "-w"
-Suppress all warnings, including those which \s-1GNU\s0 \s-1CPP\s0 issues by default.
+Suppress all warnings, including those which \s-1GNU CPP\s0 issues by default.
.IP "\fB\-pedantic\fR" 4
.IX Item "-pedantic"
Issue all the mandatory diagnostics listed in the C standard. Some of
@@ -530,7 +532,7 @@ may be one of:
.el .IP "\f(CWiso9899:1990\fR" 4
.IX Item "iso9899:1990"
.PD
-The \s-1ISO\s0 C standard from 1990. \fBc90\fR is the customary shorthand for
+The \s-1ISO C\s0 standard from 1990. \fBc90\fR is the customary shorthand for
this version of the standard.
.Sp
The \fB\-ansi\fR option is equivalent to \fB\-std=c90\fR.
@@ -552,7 +554,7 @@ The 1990 C standard, as amended in 1994.
.el .IP "\f(CWc9x\fR" 4
.IX Item "c9x"
.PD
-The revised \s-1ISO\s0 C standard, published in December 1999. Before
+The revised \s-1ISO C\s0 standard, published in December 1999. Before
publication, this was known as C9X.
.ie n .IP """iso9899:2011""" 4
.el .IP "\f(CWiso9899:2011\fR" 4
@@ -565,7 +567,7 @@ publication, this was known as C9X.
.el .IP "\f(CWc1x\fR" 4
.IX Item "c1x"
.PD
-The revised \s-1ISO\s0 C standard, published in December 2011. Before
+The revised \s-1ISO C\s0 standard, published in December 2011. Before
publication, this was known as C1X.
.ie n .IP """gnu90""" 4
.el .IP "\f(CWgnu90\fR" 4
@@ -597,7 +599,7 @@ The 2011 C standard plus \s-1GNU\s0 exte
.ie n .IP """c++98""" 4
.el .IP "\f(CWc++98\fR" 4
.IX Item "c++98"
-The 1998 \s-1ISO\s0 \*(C+ standard plus amendments.
+The 1998 \s-1ISO \*(C+\s0 standard plus amendments.
.ie n .IP """gnu++98""" 4
.el .IP "\f(CWgnu++98\fR" 4
.IX Item "gnu++98"
@@ -690,6 +692,12 @@ is applied to the standard system direct
.Sp
If \fIdir\fR begins with \f(CW\*(C`=\*(C'\fR, then the \f(CW\*(C`=\*(C'\fR will be replaced
by the sysroot prefix; see \fB\-\-sysroot\fR and \fB\-isysroot\fR.
+.IP "\fB\-cxx\-isystem\fR \fIdir\fR" 4
+.IX Item "-cxx-isystem dir"
+Search \fIdir\fR for \*(C+ header files, after all directories specified by
+\&\fB\-I\fR 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.
.IP "\fB\-iquote\fR \fIdir\fR" 4
.IX Item "-iquote dir"
Search \fIdir\fR only for header files requested with
@@ -720,6 +728,11 @@ files previously preprocessed with \f(CW
With both \fB\-E\fR and \fB\-fpreprocessed\fR, the rules for
\&\fB\-fpreprocessed\fR take precedence. This enables full preprocessing of
files previously preprocessed with \f(CW\*(C`\-E \-fdirectives\-only\*(C'\fR.
+.IP "\fB\-iremap\fR \fIsrc\fR\fB:\fR\fIdst\fR" 4
+.IX Item "-iremap src:dst"
+Replace the prefix \fIsrc\fR in _\|_FILE_\|_ with \fIdst\fR at expansion time.
+This option can be specified more than once. Processing stops at the first
+match.
.IP "\fB\-fdollars\-in\-identifiers\fR" 4
.IX Item "-fdollars-in-identifiers"
Accept \fB$\fR in identifiers.
@@ -752,7 +765,7 @@ line. If the value is less than 1 or gr
ignored. The default is 8.
.IP "\fB\-fdebug\-cpp\fR" 4
.IX Item "-fdebug-cpp"
-This option is only useful for debugging \s-1GCC\s0. When used with
+This option is only useful for debugging \s-1GCC. \s0 When used with
\&\fB\-E\fR, 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
@@ -785,12 +798,12 @@ Note that \f(CW\*(C`\-ftrack\-macro\-exp
.IP "\fB\-fexec\-charset=\fR\fIcharset\fR" 4
.IX Item "-fexec-charset=charset"
Set the execution character set, used for string and character
-constants. The default is \s-1UTF\-8\s0. \fIcharset\fR can be any encoding
+constants. The default is \s-1UTF\-8. \s0\fIcharset\fR can be any encoding
supported by the system's \f(CW\*(C`iconv\*(C'\fR library routine.
.IP "\fB\-fwide\-exec\-charset=\fR\fIcharset\fR" 4
.IX Item "-fwide-exec-charset=charset"
Set the wide execution character set, used for wide string and
-character constants. The default is \s-1UTF\-32\s0 or \s-1UTF\-16\s0, whichever
+character constants. The default is \s-1UTF\-32\s0 or \s-1UTF\-16,\s0 whichever
corresponds to the width of \f(CW\*(C`wchar_t\*(C'\fR. As with
\&\fB\-fexec\-charset\fR, \fIcharset\fR can be any encoding supported
by the system's \f(CW\*(C`iconv\*(C'\fR library routine; however, you will have
@@ -798,9 +811,9 @@ problems with encodings that do not fit
.IP "\fB\-finput\-charset=\fR\fIcharset\fR" 4
.IX Item "-finput-charset=charset"
Set the input character set, used for translation from the character
-set of the input file to the source character set used by \s-1GCC\s0. If the
+set of the input file to the source character set used by \s-1GCC. \s0 If the
locale does not specify, or \s-1GCC\s0 cannot get this information from the
-locale, the default is \s-1UTF\-8\s0. This can be overridden by either the locale
+locale, the default is \s-1UTF\-8. \s0 This can be overridden by either the locale
or this command-line option. Currently the command-line option takes
precedence if there's a conflict. \fIcharset\fR can be any encoding
supported by the system's \f(CW\*(C`iconv\*(C'\fR library routine.
@@ -837,7 +850,7 @@ Cancel an assertion with the predicate \
.IX Item "-dCHARS"
\&\fI\s-1CHARS\s0\fR is a sequence of one or more of the following characters,
and must not be preceded by a space. Other characters are interpreted
-by the compiler proper, or reserved for future versions of \s-1GCC\s0, and so
+by the compiler proper, or reserved for future versions of \s-1GCC,\s0 and so
are silently ignored. If you specify characters whose behavior
conflicts, the result is undefined.
.RS 4
@@ -913,7 +926,7 @@ The \fB\-CC\fR option is generally used
.IP "\fB\-traditional\-cpp\fR" 4
.IX Item "-traditional-cpp"
Try to imitate the behavior of old-fashioned C preprocessors, as
-opposed to \s-1ISO\s0 C preprocessors.
+opposed to \s-1ISO C\s0 preprocessors.
.IP "\fB\-trigraphs\fR" 4
.IX Item "-trigraphs"
Process trigraph sequences.
@@ -931,7 +944,7 @@ Print text describing all the command-li
preprocessing anything.
.IP "\fB\-v\fR" 4
.IX Item "-v"
-Verbose mode. Print out \s-1GNU\s0 \s-1CPP\s0's version number at the beginning of
+Verbose mode. Print out \s-1GNU CPP\s0's version number at the beginning of
execution, and report the final form of the include path.
.IP "\fB\-H\fR" 4
.IX Item "-H"
@@ -946,7 +959,7 @@ header file is printed with \fB...x\fR a
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
.PD
-Print out \s-1GNU\s0 \s-1CPP\s0's version number. With one dash, proceed to
+Print out \s-1GNU CPP\s0's version number. With one dash, proceed to
preprocess as normal. With two dashes, exit immediately.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
@@ -958,7 +971,7 @@ Note that you can also specify places to
\&\fB\-I\fR, and control dependency output with options like
\&\fB\-M\fR. These take precedence over
environment variables, which in turn take precedence over the
-configuration of \s-1GCC\s0.
+configuration of \s-1GCC.\s0
.IP "\fB\s-1CPATH\s0\fR" 4
.IX Item "CPATH"
.PD 0
@@ -1012,6 +1025,11 @@ This variable is the same as \fB\s-1DEPE
except that system header files are not ignored, so it implies
\&\fB\-M\fR rather than \fB\-MM\fR. However, the dependence on the
main input file is omitted.
+.IP "\fB\s-1CPP_RESTRICTED\s0\fR" 4
+.IX Item "CPP_RESTRICTED"
+If this variable is defined, cpp will skip any include file which is not a
+regular file, and will continue searching for the requested name (this is
+always done if the found file is a directory).
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIgpl\fR\|(7), \fIgfdl\fR\|(7), \fIfsf\-funding\fR\|(7),
