From mboxrd@z Thu Jan  1 00:00:00 1970
From: Andrew Cagney <cagney@gnu.org>
To: Eli Zaretskii <eliz@gnu.org>
Cc: Karl Berry <karl@gnu.org>, gdb-patches@sources.redhat.com
Subject: Re: @dircategory for gdb manuals
Date: Tue, 25 May 2004 21:27:00 -0000
Message-id: <40B3BA23.2090407@gnu.org>
References: <200404101902.i3AJ2UD13760@tug.org>
X-SW-Source: 2004-05/msg00719.html

Eli, are the attatched tweaks ok, for 6.1.1?

Andrew
---  Begin Message  ---

>From : karl at gnu dot org (Karl Berry)
To : gdb at sources dot redhat dot com
Date : Sat, 10 Apr 2004 21:02:30 +0200
Subject : @dircategory for gdb manuals
Delivery-date : Sat, 10 Apr 2004 15:02:55 -0400
Envelope-to : cagney@gnu.org

(Sorry if this is the wrong place, mail to bug-gdb only elicited a
suggestion to try here.)

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

---  End Message  ---