@dircategory for gdb manuals

[Karl Berry]

I sent this back in November, but I guess it didn't get applied, as I
don't see the changes in gdb 6.1.  So am resending.  If you don't want
to apply these changes for some reason, let me know and I'll stop
bugging you :).

Thanks,
karl

From: address@hidden (Karl Berry)
To: address@hidden
Subject: @dircategory for gdb manuals

I'd like to suggest the following minor changes to the GDB manuals to
change their categories in the Texinfo dir file -- I've been trying to
rationalize these categories per rms's suggestions.  (I know that
"Software libraries" is not exactly right for internals documents, but
it is the closest we've got.)

Also, the frontmatter should be changed to use @copying, the GNU free
documentation license, @ifnottex around the Top node, etc. -- this patch
doesn't do those things.  See
  http://texinfo.org/manual/Document-Permissions.html
  http://texinfo.org/manual/GNU-Sample-Texts.html
for information and for an example of recommended frontmatter for GNU
manuals.  Right now, the copying information doesn't end up in the HTML
output, for instance, which is not a good thing.

Finally, at one point there seems to have been a libgdb.texinfo.  Is
that no longer being distributed?  I don't see it in the 6.0
distribution.  (I'd just like to remove it from my example dir file, if
it's truly gone.)

Please let me know if questions or problems.

Thanks,
karl (Texinfo maintainer)


*** ./ORIG/gdb.texinfo  Sat Aug  9 08:10:35 2003
--- ./gdb.texinfo       Sat Nov 15 09:03:32 2003
***************
*** 39,45 ****
  @c This is a dir.info fragment to support semi-automated addition of
  @c manuals to an info tree.
! @dircategory Programming & development tools.
  @direntry
! * Gdb: (gdb).                     The @sc{gnu} debugger.
  @end direntry
  
--- 39,45 ----
  @c This is a dir.info fragment to support semi-automated addition of
  @c manuals to an info tree.
! @dircategory Software development
  @direntry
! * Gdb: (gdb).                   The GNU debugger.
  @end direntry
  
*** ./ORIG/gdbint.texinfo       Mon Aug 18 13:12:32 2003
--- ./gdbint.texinfo    Sat Nov 15 09:05:42 2003
***************
*** 2,6 ****
  @setfilename gdbint.info
  @include gdb-cfg.texi
! @dircategory Programming & development tools.
  @direntry
  * Gdb-Internals: (gdbint).    The GNU debugger's internals.
--- 2,6 ----
  @setfilename gdbint.info
  @include gdb-cfg.texi
! @dircategory Software libraries
  @direntry
  * Gdb-Internals: (gdbint).      The GNU debugger's internals.
*** ./ORIG/stabs.texinfo        Mon Aug  4 13:43:36 2003
--- ./stabs.texinfo     Sat Nov 15 09:05:57 2003
***************
*** 4,14 ****
  @c @finalout
  
! @ifinfo
! @format
! START-INFO-DIR-ENTRY
  * Stabs: (stabs).                 The "stabs" debugging information format.
! END-INFO-DIR-ENTRY
! @end format
! @end ifinfo
  
  @ifinfo
--- 4,11 ----
  @c @finalout
  
! @dircategory Software libraries
! @direntry
  * Stabs: (stabs).               The "stabs" debugging information format.
! @end direntry
  
  @ifinfo
*** ./ORIG/bfd.texinfo  Thu Feb 13 03:26:41 2003
--- ./bfd.texinfo       Sat Nov 15 09:12:25 2003
***************
*** 20,30 ****
  @synindex fn cp
  
! @ifinfo
! @format
! START-INFO-DIR-ENTRY
  * Bfd: (bfd).                   The Binary File Descriptor library.
! END-INFO-DIR-ENTRY
! @end format
! @end ifinfo
  
  @ifinfo
--- 20,27 ----
  @synindex fn cp
  
! @dircategory Software libraries
! @direntry
  * Bfd: (bfd).                   The Binary File Descriptor library.
! @end direntry
  
  @ifinfo
*** ./ORIG/mmalloc.texi Thu Apr 15 18:34:49 1999
--- ./mmalloc.texi      Sat Nov 15 09:13:21 2003
***************
*** 2,11 ****
  @setfilename mmalloc.info
  
! @ifinfo
! @format
! START-INFO-DIR-ENTRY
  * Mmalloc: (mmalloc).         The GNU mapped-malloc package.
! END-INFO-DIR-ENTRY
! @end format
  
  This file documents the GNU mmalloc (mapped-malloc) package, written by
--- 2,9 ----
  @setfilename mmalloc.info
  
! @dircategory Software libraries
! @direntry
  * Mmalloc: (mmalloc).           The GNU mapped-malloc package.
! @end direntry
  
  This file documents the GNU mmalloc (mapped-malloc) package, written by