Patchwork [doc] cpp manual nits

login
register
mail settings
Submitter Ralf Wildenhues
Date Jan. 8, 2011, 7:30 p.m.
Message ID <20110108193009.GM4786@gmx.de>
Download mbox | patch
Permalink /patch/77979/
State New
Headers show

Comments

Ralf Wildenhues - Jan. 8, 2011, 7:30 p.m.
Tested 'make info pdf html', OK for trunk?
The @ifnottex part follows recommendation from the Texinfo manual.

Thanks,
Ralf

doc: cpp manual nits

gcc/ChangeLog:
2010-01-08  Ralf Wildenhues  <Ralf.Wildenhues@gmx.de>

	* doc/cpp.texi (C++ Named Operators): Fix markup for header
	file name.
	* doc/cppinternals.texi (Top): Wrap node in @ifnottex to avoid
	two extra empty pages in PDF output.
Gerald Pfeifer - Jan. 8, 2011, 7:58 p.m.
On Sat, 8 Jan 2011, Ralf Wildenhues wrote:
> Tested 'make info pdf html', OK for trunk?
> The @ifnottex part follows recommendation from the Texinfo manual.

Looks good, thanks.

Gerald
Joseph S. Myers - Jan. 8, 2011, 10:05 p.m.
On Sat, 8 Jan 2011, Ralf Wildenhues wrote:

> diff --git a/gcc/doc/cpp.texi b/gcc/doc/cpp.texi
> index 7d78d12..195fcda 100644
> --- a/gcc/doc/cpp.texi
> +++ b/gcc/doc/cpp.texi
> @@ -2429,7 +2429,7 @@ check specifically for features you need, using a tool such as
>  @subsection C++ Named Operators
>  @cindex named operators
>  @cindex C++ named operators
> -@cindex iso646.h
> +@cindex @file{iso646.h}

I tried to avoid various parts of the manual using @file{} for standard 
headers, using @code{<iso646.h>} instead, since the standard does not 
require that the standard headers actually correspond to files of the same 
name.  But I see that cpp.texi is generally using @file{} here.

Patch

diff --git a/gcc/doc/cpp.texi b/gcc/doc/cpp.texi
index 7d78d12..195fcda 100644
--- a/gcc/doc/cpp.texi
+++ b/gcc/doc/cpp.texi
@@ -2429,7 +2429,7 @@  check specifically for features you need, using a tool such as
 @subsection C++ Named Operators
 @cindex named operators
 @cindex C++ named operators
-@cindex iso646.h
+@cindex @file{iso646.h}
 
 In C++, there are eleven keywords which are simply alternate spellings
 of operators normally written with punctuation.  These keywords are
diff --git a/gcc/doc/cppinternals.texi b/gcc/doc/cppinternals.texi
index 15e4a4c..a22ef0d 100644
--- a/gcc/doc/cppinternals.texi
+++ b/gcc/doc/cppinternals.texi
@@ -67,6 +67,7 @@  into another language, under the above conditions for modified versions.
 @contents
 @page
 
+@ifnottex
 @node Top
 @top
 @chapter Cpplib---the GNU C Preprocessor
@@ -101,6 +102,7 @@  the way they have.
 * Files::               File handling.
 * Concept Index::       Index.
 @end menu
+@end ifnottex
 
 @node Conventions
 @unnumbered Conventions