This is the mail archive of the gdb@sources.redhat.com mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

@dircategory for gdb manuals


(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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]