final 5.1 gdb.texinfo diff

final 5.1 gdb.texinfo diff

[Brian Youmans]

This last diff fixes or at least ameliorates 3 Overfull hbox problems,
by the expedient of un-indenting the examples.  It would be better if
someone rewrote these examples with shorter lines instead, but these
patches more or less fix the problems, at the cost of some ugliness.

- Brian Y., FSF office staff

----------------------------------------------------------

*** gdbyesterday.texinfo	Thu Jan 17 13:59:08 2002
--- gdb.texinfo	Thu Jan 17 13:50:38 2002
***************
*** 10960,10967 ****
  debugged program's data segment:
  
  @smallexample
! (@value{GDBP}) info dos ldt $ds
! 0x13f: base=0x11970000 limit=0x0009ffff 32-Bit Data (Read/Write, Exp-up)
  @end smallexample
  
  @noindent
--- 10960,10967 ----
  debugged program's data segment:
  
  @smallexample
! @exdent @code{(@value{GDBP}) info dos ldt $ds}
! @exdent @code{0x13f: base=0x11970000 limit=0x0009ffff 32-Bit Data (Read/Write, Exp-up)}
  @end smallexample
  
  @noindent
***************
*** 11003,11012 ****
  example, here's how to display the Page Table entry for the page where
  the variable @code{i} is stored:
  
! @smallexample
! (@value{GDBP}) info dos address-pte __djgpp_base_address + (char *)&i
! Page Table entry for address 0x11a00d30:
! Base=0x02698000 Dirty Acc. Not-Cached Write-Back Usr Read-Write +0xd30
  @end smallexample
  
  @noindent
--- 11003,11012 ----
  example, here's how to display the Page Table entry for the page where
  the variable @code{i} is stored:
  
! @smallexample 
! @exdent @code{(@value{GDBP}) info dos address-pte __djgpp_base_address + (char *)&i}
! @exdent @code{Page Table entry for address 0x11a00d30:}
! @exdent @code{Base=0x02698000 Dirty Acc. Not-Cached Write-Back Usr Read-Write +0xd30} 
  @end smallexample
  
  @noindent
***************
*** 11025,11033 ****
  transfer buffer:
  
  @smallexample
! (@value{GDBP}) info dos address-pte *((unsigned *)&_go32_info_block + 3)
! Page Table entry for address 0x29110:
! Base=0x00029000 Dirty Acc. Not-Cached Write-Back Usr Read-Write +0x110
  @end smallexample
  
  @noindent
--- 11025,11033 ----
  transfer buffer:
  
  @smallexample
! @exdent @code{(@value{GDBP}) info dos address-pte *((unsigned *)&_go32_info_block + 3)}
! @exdent @code{Page Table entry for address 0x29110:}
! @exdent @code{Base=0x00029000 Dirty Acc. Not-Cached Write-Back Usr Read-Write +0x110}
  @end smallexample
  
  @noindent

Re: final 5.1 gdb.texinfo diff

[Andrew Cagney]

[-- Attachment #1: Type: text/plain, Size: 1499 bytes --]

Um, building the trunk, I'm seeing:

makeinfo -I 
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/../../readline/doc 
-I /home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/../mi -I 
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc -o ./gdb.info 
gdb.texinfo
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/../../readline/doc/rluser.texinfo:1331: 
warning: @sc argument all uppercase, thus no effect.
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/gdb.texinfo:14575: 
Next field of node `Installing GDB' not pointed to.
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/fdl.texi:2: This 
node (GNU Free Documentation License) has the bad Prev.
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/fdl.texi:2: Next 
reference to nonexistent node `Intro'.
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/gdb.texinfo:14869: 
Prev field of node `Index' not pointed to.
/home/scratch/PENDING/2002-01-15-maint-doco/src/gdb/doc/fdl.texi:2: This 
node (GNU Free Documentation License) has the bad Next.
makeinfo: Removing output file `./gdb.info' due to errors; use --force 
to preserve.
gmake: *** [gdb.info] Error 2
ac131313@nettle$ makeinfo --version
makeinfo (GNU texinfo) 4.0

Copyright (C) 1999 Free Software Foundation, Inc.
There is NO warranty.  You may redistribute this software
under the terms of the GNU General Public License.
For more information about these matters, see the files named COPYING.

So I've checked in the attached.

Andrew

[-- Attachment #2: diffs --]
[-- Type: text/plain, Size: 675 bytes --]

2002-01-17  Andrew Cagney  <ac131313@redhat.com>

	* fdl.texi: Remove next/prev from @node.

Index: fdl.texi
===================================================================
RCS file: /cvs/src/src/gdb/doc/fdl.texi,v
retrieving revision 1.1
diff -p -r1.1 fdl.texi
*** fdl.texi	2002/01/17 08:54:12	1.1
--- fdl.texi	2002/01/17 22:54:10
***************
*** 1,5 ****
  @c -*-texinfo-*-
! @node GNU Free Documentation License, Intro, Copying, Top
  
  @appendix GNU Free Documentation License
  @center Version 1.1, March 2000
--- 1,5 ----
  @c -*-texinfo-*-
! @node GNU Free Documentation License
  
  @appendix GNU Free Documentation License
  @center Version 1.1, March 2000

Re: final 5.1 gdb.texinfo diff

[Eli Zaretskii]

On Thu, 17 Jan 2002, Brian Youmans wrote:

> This last diff fixes or at least ameliorates 3 Overfull hbox problems,
> by the expedient of un-indenting the examples.

Thanks, I committed those.

> It would be better if
> someone rewrote these examples with shorter lines instead

Sorry, it's impossible: these commands indeed produce long lines, and I 
cannot make it shorter without removing something important.