@dircategory Software development

@dircategory Software development

[Karl Berry]

rms asked me to try systematize the Texinfo dir categories to match the
Free Software Directory where possible.  So I hope you will be ok
with changing the gcc manuals to say
@dircategory Software development
instead of
@dircategory Programming
(and "Software libraries" instead of "GNU libraries" for libiberty.)

A patch is appended.  I left the "GNU Ada Tools" manuals alone
(gnat_rm.texi and gnat_ugn.texi), since it wasn't immediately clear to
me why they were categorized differently than the rest.  Whatever you
think best.

Also, I noticed that cppinternals.texi needs to be changed to use
@copying; it still has the old @ifinfo license statement.

Also, FYI, @dircategory and @direntry do not need to be wrapped in
@ifinfo or @ifnottex or whatever.  Texinfo processors all understand
those commands.  However, the conditional doesn't hurt anything, so I
didn't bother changing it.

Thanks,
Karl

*** gcc-4.1.1/gcc/doc/ORIG/cppinternals.texi	Sat Mar  5 11:56:31 2005
--- gcc-4.1.1/gcc/doc/cppinternals.texi	Mon May 29 06:53:45 2006
***************
*** 6,10 ****
  
  @ifinfo
! @dircategory Programming
  @direntry
  * Cpplib: (cppinternals).      Cpplib internals.
--- 6,10 ----
  
  @ifinfo
! @dircategory Software development
  @direntry
  * Cpplib: (cppinternals).      Cpplib internals.
*** gcc-4.1.1/gcc/doc/ORIG/cpp.texi	Mon May 29 06:54:43 2006
--- gcc-4.1.1/gcc/doc/cpp.texi	Mon May 29 06:54:53 2006
***************
*** 51,55 ****
  
  @ifinfo
! @dircategory Programming
  @direntry
  * Cpp: (cpp).		       The GNU C preprocessor.
--- 51,55 ----
  
  @ifinfo
! @dircategory Software development
  @direntry
  * Cpp: (cpp).		       The GNU C preprocessor.
*** gcc-4.1.1/gcc/doc/ORIG/gcc.texi	Tue Jun 28 17:14:32 2005
--- gcc-4.1.1/gcc/doc/gcc.texi	Mon May 29 06:55:20 2006
***************
*** 63,67 ****
  @end copying
  @ifnottex
! @dircategory Programming
  @direntry
  * gcc: (gcc).                  The GNU Compiler Collection.
--- 63,67 ----
  @end copying
  @ifnottex
! @dircategory Software development
  @direntry
  * gcc: (gcc).                  The GNU Compiler Collection.
*** gcc-4.1.1/gcc/doc/ORIG/gccint.texi	Mon May 29 06:55:53 2006
--- gcc-4.1.1/gcc/doc/gccint.texi	Mon May 29 06:56:01 2006
***************
*** 49,53 ****
  @end copying
  @ifnottex
! @dircategory Programming
  @direntry
  * gccint: (gccint).            Internals of the GNU Compiler Collection.
--- 49,53 ----
  @end copying
  @ifnottex
! @dircategory Software development
  @direntry
  * gccint: (gccint).            Internals of the GNU Compiler Collection.
*** gcc-4.1.1/gcc/doc/ORIG/install.texi	Mon May 22 13:03:45 2006
--- gcc-4.1.1/gcc/doc/install.texi	Mon May 29 06:56:21 2006
***************
*** 88,92 ****
  @insertcopying
  @end ifinfo
! @dircategory Programming
  @direntry
  * gccinstall: (gccinstall).    Installing the GNU Compiler Collection.
--- 88,92 ----
  @insertcopying
  @end ifinfo
! @dircategory Software development
  @direntry
  * gccinstall: (gccinstall).    Installing the GNU Compiler Collection.
*** gcc-4.1.1/gcc/java/ORIG/gcj.texi	Fri Jan  6 13:23:36 2006
--- gcc-4.1.1/gcc/java/gcj.texi	Mon May 29 06:56:51 2006
***************
*** 58,62 ****
  @ifinfo
  @format
! @dircategory Programming
  @direntry
  * Gcj: (gcj).               Ahead-of-time compiler for the Java language
--- 58,62 ----
  @ifinfo
  @format
! @dircategory Software development
  @direntry
  * Gcj: (gcj).               Ahead-of-time compiler for the Java language
*** gcc-4.1.1/gcc/ada/ORIG/gnat-style.texi	Tue Nov 15 06:05:45 2005
--- gcc-4.1.1/gcc/ada/gnat-style.texi	Mon May 29 06:57:26 2006
***************
*** 29,33 ****
  
  
! @dircategory Programming
  @direntry
  * gnat-style: (gnat-style).      GNAT Coding Style
--- 29,33 ----
  
  
! @dircategory Software development
  @direntry
  * gnat-style: (gnat-style).      GNAT Coding Style
*** gcc-4.1.1/gcc/fortran/ORIG/gfortran.texi	Sun Mar  5 10:34:17 2006
--- gcc-4.1.1/gcc/fortran/gfortran.texi	Mon May 29 06:58:10 2006
***************
*** 62,66 ****
  
  @ifinfo
! @dircategory Programming
  @direntry
  * gfortran: (gfortran).                  The GNU Fortran 95 Compiler.
--- 62,66 ----
  
  @ifinfo
! @dircategory Software development
  @direntry
  * gfortran: (gfortran).                  The GNU Fortran 95 Compiler.
*** gcc-4.1.1/gcc/treelang/ORIG/treelang.texi	Fri Jun 24 17:59:41 2005
--- gcc-4.1.1/gcc/treelang/treelang.texi	Mon May 29 06:58:43 2006
***************
*** 101,105 ****
  
  @ifnottex
! @dircategory Programming
  @direntry
  * treelang: (treelang).                  The GNU Treelang compiler.
--- 101,105 ----
  
  @ifnottex
! @dircategory Software development
  @direntry
  * treelang: (treelang).                  The GNU Treelang compiler.

Re: @dircategory Software development

[Joseph S. Myers]

On Mon, 29 May 2006, Karl Berry wrote:

> rms asked me to try systematize the Texinfo dir categories to match the
> Free Software Directory where possible.  So I hope you will be ok
> with changing the gcc manuals to say
> @dircategory Software development
> instead of
> @dircategory Programming
> (and "Software libraries" instead of "GNU libraries" for libiberty.)
> 
> A patch is appended.  I left the "GNU Ada Tools" manuals alone
> (gnat_rm.texi and gnat_ugn.texi), since it wasn't immediately clear to
> me why they were categorized differently than the rest.  Whatever you
> think best.

Please submit a patch against SVN trunk to gcc-patches@gcc.gnu.org with 
ChangeLog entries for each relevant ChangeLog.  (As a doc fix it can be 
applied to release branches as well as trunk, and the same patch might 
apply to both, but we need to fix trunk first.)

http://gcc.gnu.org/contribute.html

-- 
Joseph S. Myers               http://www.srcf.ucam.org/~jsm28/gcc/
    jsm@polyomino.org.uk (personal mail)
    joseph@codesourcery.com (CodeSourcery mail)
    jsm28@gcc.gnu.org (Bugzilla assignments and CCs)

Re: @dircategory Software development

[Karl Berry]

    Please submit a patch against SVN trunk to gcc-patches@gcc.gnu.org with 
    ChangeLog entries

I regret that I cannot spend more time on this than I already have.  If
you don't want to use my diffs, then please just consider it as a bug
report.  If you don't want to do that either, then I guess the
dircategory entries will just stay wrong.  Life goes on.

I hope someone will at least change cppinternals.texi to use @copying;
it still has the old @ifinfo license statement, so the HTML output is
legally problematic at the moment.

Regards,
Karl