texinfo update (Fri Jul 6 13:53:01 EDT 2007)

[Karl Berry]

Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.724
retrieving revision 1.725
diff -u -r1.724 -r1.725
--- ChangeLog   5 Jul 2007 17:13:42 -0000       1.724
+++ ChangeLog   6 Jul 2007 17:35:19 -0000       1.725
@@ -1,7 +1,12 @@
+2007-07-06  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Other Info Directories): recommend columns 32
+       and 48.  Suggestion from Antonio Diaz Diaz.
+
 2007-07-05  Karl Berry  <address@hidden>
 
-       * (\setnonasciicharscatcodenonglobal, \setnonasciicharscatcode):
-       no newline after #1, that counts as a space.
+       * texinfo.tex (\setnonasciicharscatcodenonglobal,
+        \setnonasciicharscatcode): no newline after #1, that counts as a space.
        (\pagebody, \pagesizesyyy): likewise.
 
 2007-07-03  Oleg Katsitadze  <address@hidden>
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.196
retrieving revision 1.197
diff -u -r1.196 -r1.197
--- doc/texinfo.txi     2 Jul 2007 21:40:32 -0000       1.196
+++ doc/texinfo.txi     6 Jul 2007 17:35:19 -0000       1.197
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.196 2007/07/02 21:40:32 olegkat Exp $
address@hidden $Id: texinfo.txi,v 1.197 2007/07/06 17:35:19 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -16153,6 +16153,11 @@
 command.  If you use them later on in the input, @code{install-info}
 will not notice them.
 
+As a matter of convention, please start the description for the main
+entry (above, @samp{The GNU documentation format}) at column 32.  This
+will make it align with most others.  Description for individual
+utilities best start in column 48, where possible.
+
 If you use @code{@@dircategory} more than once in the Texinfo source,
 each usage specifies the `current' category; any subsequent
 @code{@@direntry} commands will add to that category.
@@ -18740,7 +18745,7 @@
 (@url{http://www.gnu.org/software/rcs}) version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.196 2007/07/02 21:40:32 olegkat Exp $
+$Id: texinfo.txi,v 1.197 2007/07/06 17:35:19 karl Exp $
 @end example
 (This is useful in all sources that use version control, not just manuals.)
 You may wish to include the @samp{$Id:} comment in the @code{@@copying}
@@ -18806,7 +18811,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.196 2007/07/02 21:40:32 olegkat Exp $
address@hidden $Id: texinfo.txi,v 1.197 2007/07/06 17:35:19 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi
P ChangeLog
P doc/texinfo.txi