[src/trunk]: src/external/gpl3/gcc/dist/gcc/doc regen these for <GCC 7.4.0.

[mrg <mrg%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/65f4d3ac4589
branches:  trunk
changeset: 447627:65f4d3ac4589
user:      mrg <mrg%NetBSD.org@localhost>
date:      Sat Jan 19 17:04:06 2019 +0000

description:
regen these for <GCC 7.4.0.

diffstat:

 external/gpl3/gcc/dist/gcc/doc/cpp.1             |   826 +--
 external/gpl3/gcc/dist/gcc/doc/cpp.info          |   Bin 
 external/gpl3/gcc/dist/gcc/doc/cppinternals.info |   Bin 
 external/gpl3/gcc/dist/gcc/doc/g++.1             |   402 +-
 external/gpl3/gcc/dist/gcc/doc/gcc.1             |  4654 ++++++++++++++-------
 external/gpl3/gcc/dist/gcc/doc/gcc.info          |   Bin 
 external/gpl3/gcc/dist/gcc/doc/gccinstall.info   |   Bin 
 external/gpl3/gcc/dist/gcc/doc/gccint.info       |   Bin 
 external/gpl3/gcc/dist/gcc/doc/gcov-tool.1       |    14 +-
 external/gpl3/gcc/dist/gcc/doc/gcov.1            |    16 +-
 10 files changed, 3623 insertions(+), 2289 deletions(-)

diffs (truncated from 9578 to 300 lines):

diff -r 6139aa4c492c -r 65f4d3ac4589 external/gpl3/gcc/dist/gcc/doc/cpp.1
--- a/external/gpl3/gcc/dist/gcc/doc/cpp.1      Sat Jan 19 16:58:29 2019 +0000
+++ b/external/gpl3/gcc/dist/gcc/doc/cpp.1      Sat Jan 19 17:04:06 2019 +0000
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
+.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -54,16 +54,20 @@
 .\" Avoid warning from groff about undefined register 'F'.
 .de IX
 ..
-.if !\nF .nr F 0
-.if \nF>0 \{\
-.    de IX
-.    tm Index:\\$1\t\\n%\t"\\$2"
+.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
+.        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.
@@ -129,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "CPP 1"
-.TH CPP 1 "2018-10-26" "gcc-6.5.0" "GNU"
+.TH CPP 1 "2018-12-06" "gcc-7.4.0" "GNU"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -145,11 +149,12 @@
     [\fB\-M\fR|\fB\-MM\fR] [\fB\-MG\fR] [\fB\-MF\fR \fIfilename\fR]
     [\fB\-MP\fR] [\fB\-MQ\fR \fItarget\fR...]
     [\fB\-MT\fR \fItarget\fR...]
-    [\fB\-P\fR] [\fB\-fno\-working\-directory\fR]
-    [\fB\-x\fR \fIlanguage\fR] [\fB\-std=\fR\fIstandard\fR]
-    \fIinfile\fR \fIoutfile\fR
+    \fIinfile\fR [[\fB\-o\fR] \fIoutfile\fR]
 .PP
-Only the most useful options are listed here; see below for the remainder.
+Only the most useful options are given above; see below for a more
+complete list of preprocessor-specific options.  
+In addition, \fBcpp\fR accepts most \fBgcc\fR driver options, which
+are not listed here.  Refer to the \s-1GCC\s0 documentation for details.
 .SH "DESCRIPTION"
 .IX Header "DESCRIPTION"
 The C preprocessor, often known as \fIcpp\fR, is a \fImacro processor\fR
@@ -202,15 +207,17 @@
 manual refer to \s-1GNU CPP.\s0
 .SH "OPTIONS"
 .IX Header "OPTIONS"
-The C preprocessor expects two file names as arguments, \fIinfile\fR and
+The \fBcpp\fR command expects two file names as arguments, \fIinfile\fR and
 \&\fIoutfile\fR.  The preprocessor reads \fIinfile\fR together with any
 other files it specifies with \fB#include\fR.  All the output generated
 by the combined input files is written in \fIoutfile\fR.
 .PP
 Either \fIinfile\fR or \fIoutfile\fR may be \fB\-\fR, which as
 \&\fIinfile\fR means to read from standard input and as \fIoutfile\fR
-means to write to standard output.  Also, if either file is omitted, it
+means to write to standard output.  If either file is omitted, it
 means the same as if \fB\-\fR had been specified for that file.
+You can also use the \fB\-o\fR \fIoutfile\fR option to specify the 
+output file.
 .PP
 Unless otherwise noted, or the option ends in \fB=\fR, all options
 which take an argument may have that argument appear either immediately
@@ -227,7 +234,7 @@
 .IX Item "-D name=definition"
 The contents of \fIdefinition\fR are tokenized and processed as if
 they appeared during translation phase three in a \fB#define\fR
-directive.  In particular, the definition will be truncated by
+directive.  In particular, the definition is truncated by
 embedded newline characters.
 .Sp
 If you are invoking the preprocessor from a shell or shell-like
@@ -236,8 +243,8 @@
 .Sp
 If you wish to define a function-like macro on the command line, write
 its argument list with surrounding parentheses before the equals sign
-(if any).  Parentheses are meaningful to most shells, so you will need
-to quote the option.  With \fBsh\fR and \fBcsh\fR,
+(if any).  Parentheses are meaningful to most shells, so you should
+quote the option.  With \fBsh\fR and \fBcsh\fR,
 \&\fB\-D'\fR\fIname\fR\fB(\fR\fIargs...\fR\fB)=\fR\fIdefinition\fR\fB'\fR works.
 .Sp
 \&\fB\-D\fR and \fB\-U\fR options are processed in the order they
@@ -248,125 +255,36 @@
 .IX Item "-U name"
 Cancel any previous definition of \fIname\fR, either built in or
 provided with a \fB\-D\fR option.
+.IP "\fB\-include\fR \fIfile\fR" 4
+.IX Item "-include file"
+Process \fIfile\fR as if \f(CW\*(C`#include "file"\*(C'\fR appeared as the first
+line of the primary source file.  However, the first directory searched
+for \fIfile\fR is the preprocessor's working directory \fIinstead of\fR
+the directory containing the main source file.  If not found there, it
+is searched for in the remainder of the \f(CW\*(C`#include "..."\*(C'\fR search
+chain as normal.
+.Sp
+If multiple \fB\-include\fR options are given, the files are included
+in the order they appear on the command line.
+.IP "\fB\-imacros\fR \fIfile\fR" 4
+.IX Item "-imacros file"
+Exactly like \fB\-include\fR, except that any output produced by
+scanning \fIfile\fR is thrown away.  Macros it defines remain defined.
+This allows you to acquire all the macros from a header without also
+processing its declarations.
+.Sp
+All files specified by \fB\-imacros\fR are processed before all files
+specified by \fB\-include\fR.
 .IP "\fB\-undef\fR" 4
 .IX Item "-undef"
 Do not predefine any system-specific or GCC-specific macros.  The
 standard predefined macros remain defined.
-.IP "\fB\-I\fR \fIdir\fR" 4
-.IX Item "-I dir"
-Add the directory \fIdir\fR to the list of directories to be searched
-for header files.
-.Sp
-Directories named by \fB\-I\fR are searched before the standard
-system include directories.  If the directory \fIdir\fR is a standard
-system include directory, the option is ignored to ensure that the
-default search order for system directories and the special treatment
-of system headers are not defeated
-\&.
-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\-o\fR \fIfile\fR" 4
-.IX Item "-o file"
-Write output to \fIfile\fR.  This is the same as specifying \fIfile\fR
-as the second non-option argument to \fBcpp\fR.  \fBgcc\fR has a
-different interpretation of a second non-option argument, so you must
-use \fB\-o\fR to specify the output file.
-.IP "\fB\-Wall\fR" 4
-.IX Item "-Wall"
-Turns on all optional warnings which are desirable for normal code.
-At present this is \fB\-Wcomment\fR, \fB\-Wtrigraphs\fR,
-\&\fB\-Wmultichar\fR and a warning about integer promotion causing a
-change of sign in \f(CW\*(C`#if\*(C'\fR expressions.  Note that many of the
-preprocessor's warnings are on by default and have no options to
-control them.
-.IP "\fB\-Wcomment\fR" 4
-.IX Item "-Wcomment"
-.PD 0
-.IP "\fB\-Wcomments\fR" 4
-.IX Item "-Wcomments"
-.PD
-Warn whenever a comment-start sequence \fB/*\fR appears in a \fB/*\fR
-comment, or whenever a backslash-newline appears in a \fB//\fR comment.
-(Both forms have the same effect.)
-.IP "\fB\-Wtrigraphs\fR" 4
-.IX Item "-Wtrigraphs"
-Most trigraphs in comments cannot affect the meaning of the program.
-However, a trigraph that would form an escaped newline (\fB??/\fR at
-the end of a line) can, by changing where the comment begins or ends.
-Therefore, only trigraphs that would form escaped newlines produce
-warnings inside a comment.
-.Sp
-This option is implied by \fB\-Wall\fR.  If \fB\-Wall\fR is not
-given, this option is still enabled unless trigraphs are enabled.  To
-get trigraph conversion without warnings, but get the other
-\&\fB\-Wall\fR warnings, use \fB\-trigraphs \-Wall \-Wno\-trigraphs\fR.
-.IP "\fB\-Wtraditional\fR" 4
-.IX Item "-Wtraditional"
-Warn about certain constructs that behave differently in traditional and
-\&\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"
-Warn whenever an identifier which is not a macro is encountered in an
-\&\fB#if\fR directive, outside of \fBdefined\fR.  Such identifiers are
-replaced with zero.
-.IP "\fB\-Wunused\-macros\fR" 4
-.IX Item "-Wunused-macros"
-Warn about macros defined in the main file that are unused.  A macro
-is \fIused\fR 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.
-.Sp
-Built-in macros, macros defined on the command line, and macros
-defined in include files are not warned about.
-.Sp
-\&\fINote:\fR If a macro is actually used, but only used in skipped
-conditional blocks, then \s-1CPP\s0 will report it as unused.  To avoid the
-warning in such a case, you might improve the scope of the macro's
-definition by, for example, moving it into the first skipped block.
-Alternatively, you could provide a dummy use with something like:
-.Sp
-.Vb 2
-\&        #if defined the_macro_causing_the_warning
-\&        #endif
-.Ve
-.IP "\fB\-Wendif\-labels\fR" 4
-.IX Item "-Wendif-labels"
-Warn whenever an \fB#else\fR or an \fB#endif\fR are followed by text.
-This usually happens in code of the form
-.Sp
-.Vb 5
-\&        #if FOO
-\&        ...
-\&        #else FOO
-\&        ...
-\&        #endif FOO
-.Ve
-.Sp
-The second and third \f(CW\*(C`FOO\*(C'\fR should be in comments, but often are not
-in older programs.  This warning is on by default.
-.IP "\fB\-Werror\fR" 4
-.IX Item "-Werror"
-Make all warnings into hard errors.  Source code which triggers warnings
-will be rejected.
-.IP "\fB\-Wsystem\-headers\fR" 4
-.IX Item "-Wsystem-headers"
-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.
-.IP "\fB\-w\fR" 4
-.IX Item "-w"
-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
-them are left out by default, since they trigger frequently on harmless
-code.
-.IP "\fB\-pedantic\-errors\fR" 4
-.IX Item "-pedantic-errors"
-Issue all the mandatory diagnostics, and make all mandatory diagnostics
-into errors.  This includes mandatory diagnostics that \s-1GCC\s0 issues
-without \fB\-pedantic\fR but treats as warnings.
+.IP "\fB\-pthread\fR" 4
+.IX Item "-pthread"
+Define additional macros required for using the \s-1POSIX\s0 threads library.
+You should use this option consistently for both compilation and linking.
+This option is supported on GNU/Linux targets, most other Unix derivatives,
+and also on x86 Cygwin and MinGW targets.
 .IP "\fB\-M\fR" 4
 .IX Item "-M"
 Instead of outputting the result of preprocessing, output a rule
@@ -388,7 +306,7 @@
 rules you should explicitly specify the dependency output file with
 \&\fB\-MF\fR, or use an environment variable like
 \&\fB\s-1DEPENDENCIES_OUTPUT\s0\fR.  Debug output
-will still be sent to the regular output stream as normal.
+is still sent to the regular output stream as normal.
 .Sp
 Passing \fB\-M\fR to the driver implies \fB\-E\fR, and suppresses
 warnings with an implicit \fB\-w\fR.
@@ -400,13 +318,12 @@
 .Sp
 This implies that the choice of angle brackets or double quotes in an
 \&\fB#include\fR directive does not in itself determine whether that
-header will appear in \fB\-MM\fR dependency output.  This is a
-slight change in semantics from \s-1GCC\s0 versions 3.0 and earlier.
+header appears in \fB\-MM\fR dependency output.
 .IP "\fB\-MF\fR \fIfile\fR" 4
 .IX Item "-MF file"
 When used with \fB\-M\fR or \fB\-MM\fR, specifies a
 file to write the dependencies to.  If no \fB\-MF\fR switch is given
-the preprocessor sends the rules to the same place it would have sent
+the preprocessor sends the rules to the same place it would send
 preprocessed output.
 .Sp
 When used with the driver options \fB\-MD\fR or \fB\-MMD\fR,
@@ -443,7 +360,7 @@
 directory components and any file suffix such as \fB.c\fR, and
 appends the platform's usual object suffix.  The result is the target.
 .Sp
-An \fB\-MT\fR option will set the target to be exactly the string you
+An \fB\-MT\fR option sets the target to be exactly the string you
 specify.  If you want multiple targets, you can specify them as a single
 argument to \fB\-MT\fR, or use multiple \fB\-MT\fR options.
 .Sp
@@ -482,227 +399,26 @@
 .IX Item "-MMD"
 Like \fB\-MD\fR except mention only user header files, not system
 header files.
-.IP "\fB\-x c\fR" 4
-.IX Item "-x c"
-.PD 0
-.IP "\fB\-x c++\fR" 4
-.IX Item "-x c++"
-.IP "\fB\-x objective-c\fR" 4
-.IX Item "-x objective-c"