From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1851) id 96480383D03B; Fri, 28 May 2021 13:06:27 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 96480383D03B Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Martin Liska To: gcc-cvs@gcc.gnu.org Subject: [gcc/devel/sphinx] Clean up some more manual pages. X-Act-Checkin: gcc X-Git-Author: Martin Liska X-Git-Refname: refs/heads/devel/sphinx X-Git-Oldrev: 5061fad94b04b91a6f21012477ba5ec0c58d4e5b X-Git-Newrev: b4fb6461c1fd820ed7190bd0b0edb6ba1730ca5f Message-Id: <20210528130627.96480383D03B@sourceware.org> Date: Fri, 28 May 2021 13:06:27 +0000 (GMT) X-BeenThere: gcc-cvs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 28 May 2021 13:06:27 -0000 https://gcc.gnu.org/g:b4fb6461c1fd820ed7190bd0b0edb6ba1730ca5f commit b4fb6461c1fd820ed7190bd0b0edb6ba1730ca5f Author: Martin Liska 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