[gcc/devel/sphinx] Clean up some more manual pages.

[gcc/devel/sphinx] Clean up some more manual pages.

[Martin Liska]

https://gcc.gnu.org/g:b4fb6461c1fd820ed7190bd0b0edb6ba1730ca5f

commit b4fb6461c1fd820ed7190bd0b0edb6ba1730ca5f
Author: Martin Liska <mliska@suse.cz>
Date:   Fri May 28 15:06:14 2021 +0200

    Clean up some more manual pages.

Diff:
---
 gcc/doc/cpp.texi          | 53 ++++++-----------------------------------------
 gcc/doc/cppenv.texi       |  2 --
 gcc/doc/cppinternals.texi | 14 -------------
 3 files changed, 6 insertions(+), 63 deletions(-)

diff --git a/gcc/doc/cpp.texi b/gcc/doc/cpp.texi
index 7272eb0902e..6c56988b7ea 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-2021 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
@@ -100,7 +68,7 @@ useful on its own.
 
 @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
@@ -149,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::
@@ -4412,8 +4379,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}]
@@ -4425,14 +4392,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
@@ -4463,12 +4425,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
@@ -4481,7 +4441,6 @@ environment variables, which in turn take precedence over the
 configuration of GCC@.
 
 @include cppenv.texi
-@c man end
 
 @page
 @include fdl.texi
diff --git a/gcc/doc/cppenv.texi b/gcc/doc/cppenv.texi
index c26d58819ea..ca39dd0f546 100644
--- a/gcc/doc/cppenv.texi
+++ b/gcc/doc/cppenv.texi
@@ -27,11 +27,9 @@ beginning or end of a path.  For instance, if the value of
 @env{CPATH} is @code{:/special/include}, that has the same
 effect as @samp{@w{-I. -I/special/include}}.
 
-@c man end
 @ifset cppmanual
 See also @ref{Search Path}.
 @end ifset
-@c man begin ENVIRONMENT
 
 @item DEPENDENCIES_OUTPUT
 @cindex dependencies for make as output
diff --git a/gcc/doc/cppinternals.texi b/gcc/doc/cppinternals.texi
index 9ddcf54bcd5..6a2df0ddd4a 100644
--- a/gcc/doc/cppinternals.texi
+++ b/gcc/doc/cppinternals.texi
@@ -46,21 +46,7 @@ into another language, under the above conditions for modified versions.
 @author Neil Booth
 @page
 @vskip 0pt plus 1filll
-@c man begin COPYRIGHT
-Copyright @copyright{} 2000-2021 Free Software Foundation, Inc.
 
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that
-the entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions.
-@c man end
 @end titlepage
 @contents
 @page