fixes in the texinfo documentation

2012-06-15 Thread Patrice Dumas
Hello,

Please find attached a patch for the gdb documentation that fixes issues
such as @itemx instead of @item, empty @item, a missing @node, @menu
entries order inconsistent with respect with sectioning, and @@ to be
protected in @tex comments.

-- 
Pat
? GDBvn.texi
? Makefile
? annotate.info
? gdb-docs.diff
? gdb.info
? gdb.info-1
? gdb.info-2
? gdb.info-3
? gdb.info-4
? gdb.info-5
? gdbint.info
? gdbint.info-1
? gdbint.info-2
? stabs.info
Index: gdb.texinfo
===
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.974
diff -u -3 -p -r1.974 gdb.texinfo
--- gdb.texinfo 8 Jun 2012 13:05:55 -   1.974
+++ gdb.texinfo 15 Jun 2012 00:37:52 -
@@ -244,6 +244,7 @@ using either the Apple/NeXT or the GNU O
 
 @menu
 * Free Software::   Freely redistributable software
+* Free Documentation::  Free Software Needs Free Documentation
 * Contributors::Contributors to GDB
 @end menu
 
@@ -263,6 +264,7 @@ Fundamentally, the General Public Licens
 you have these freedoms and that you cannot take these freedoms away
 from anyone else.
 
+@node Free Documentation
 @unnumberedsec Free Software Needs Free Documentation
 
 The biggest deficiency in the free software community today is not in
@@ -5094,7 +5096,7 @@ invocations have returned.
 
 
 @kindex advance @var{location}
-@itemx advance @var{location}
+@item advance @var{location}
 Continue running the program up to the given @var{location}.  An argument is
 required, which should be of one of the forms described in
 @ref{Specify Location}.
@@ -5989,7 +5991,7 @@ function invocation, you end up at the b
 @kindex set exec-direction
 @item set exec-direction
 Set the direction of target execution.
-@itemx set exec-direction reverse
+@item set exec-direction reverse
 @cindex execute forward or backward in time
 @value{GDBN} will perform all execution commands in reverse, until the
 exec-direction mode is changed to ``forward''.  Affected commands include
@@ -19454,8 +19456,8 @@ acceptable commands.
 * MicroBlaze:: Xilinx MicroBlaze
 * MIPS Embedded::   MIPS Embedded
 * OpenRISC 1000::   OpenRisc 1000
-* PA::  HP PA Embedded
 * PowerPC Embedded::PowerPC Embedded
+* PA::  HP PA Embedded
 * Sparclet::Tsqware Sparclet
 * Sparclite::   Fujitsu Sparclite
 * Z8000::   Zilog Z8000
@@ -22562,10 +22564,10 @@ situation, a Python @code{KeyboardInterr
 * Blocks In Python::Accessing frame blocks from Python.
 * Symbols In Python::   Python representation of symbols.
 * Symbol Tables In Python:: Python representation of symbol tables.
-* Lazy Strings In Python::  Python representation of lazy strings.
 * Breakpoints In Python::   Manipulating breakpoints using Python.
 * Finish Breakpoints in Python:: Setting Breakpoints on function return
 using Python.
+* Lazy Strings In Python::  Python representation of lazy strings.
 @end menu
 
 @node Basic Python
@@ -40396,7 +40398,7 @@ A string in the constant pool is zero-te
 @printindex cp
 
 @tex
-% I think something like @colophon should be in texinfo.  In the
+% I think something like @@colophon should be in texinfo.  In the
 % meantime:
 \long\def\colophon{\hbox to0pt{}\vfill
 \centerline{The body of this manual is set in}
@@ -40408,7 +40410,7 @@ A string in the constant pool is zero-te
 \centerline{{\sl\fontname\tensl\/}}
 \centerline{are used for emphasis.}\vfill}
 \page\colophon
-% Blame: d...@cygnus.com, 1991.
+% Blame: doc@@cygnus.com, 1991.
 @end tex
 
 @bye
Index: gdbint.texinfo
===
RCS file: /cvs/src/src/gdb/doc/gdbint.texinfo,v
retrieving revision 1.337
diff -u -3 -p -r1.337 gdbint.texinfo
--- gdbint.texinfo  25 Apr 2012 10:59:10 -  1.337
+++ gdbint.texinfo  15 Jun 2012 00:37:53 -
@@ -34,7 +34,7 @@ This file documents the internals of the
 
 @titlepage
 @title @value{GDBN} Internals
-@subtitle{A guide to the internals of the GNU debugger}
+@subtitle A guide to the internals of the GNU debugger
 @author John Gilmore
 @author Cygnus Solutions
 @author Second Edition:
Index: stabs.texinfo
===
RCS file: /cvs/src/src/gdb/doc/stabs.texinfo,v
retrieving revision 1.27
diff -u -3 -p -r1.27 stabs.texinfo
--- stabs.texinfo   4 Jan 2012 08:17:21 -   1.27
+++ stabs.texinfo   15 Jun 2012 00:37:53 -
@@ -73,8 +73,8 @@ This document describes the stabs debugg
 * Questions::  Questions and anomalies
 * Stab Sections::  In some object file formats, stabs are
 in sections.
-* Symbol Types Index::  Index of symbolic stab symbol type names.
 * GNU Free Documentation License::  The 

Re: fixes in the texinfo documentation

2012-06-15 Thread Eli Zaretskii
 Date: Fri, 15 Jun 2012 02:43:35 +0200
 From: Patrice Dumas pertu...@free.fr
 Cc: Karl Berry k...@freefriends.org
 
 Please find attached a patch for the gdb documentation that fixes issues
 such as @itemx instead of @item, empty @item, a missing @node, @menu
 entries order inconsistent with respect with sectioning, and @@ to be
 protected in @tex comments.

Thanks, committed.

___
bug-gdb mailing list
bug-gdb@gnu.org
https://lists.gnu.org/mailman/listinfo/bug-gdb