texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     12/09/09 19:07:10

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        @table arg should not be a macro

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1409&r2=1.1410
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.473&r2=1.474

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1409
retrieving revision 1.1410
diff -u -b -r1.1409 -r1.1410
--- ChangeLog   8 Sep 2012 16:11:29 -0000       1.1409
+++ ChangeLog   9 Sep 2012 19:07:09 -0000       1.1410
@@ -1,3 +1,8 @@
+2012-09-09  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (table): new commands defined with @macro
+       don't usually work as the argument to @table.
+
 2012-09-08  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (txicmd): skip putting @-commands in a new

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.473
retrieving revision 1.474
diff -u -b -r1.473 -r1.474
--- doc/texinfo.txi     8 Sep 2012 16:11:29 -0000       1.473
+++ doc/texinfo.txi     9 Sep 2012 19:07:09 -0000       1.474
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.473 2012/09/08 16:11:29 karl Exp $
address@hidden $Id: texinfo.txi,v 1.474 2012/09/09 19:07:09 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.
 
@@ -5113,7 +5113,7 @@
 resulting substandard Info output, in order not to confuse the Texinfo
 processors, you must still escape those characters, by using either
 special insertions (@pxref{Inserting a Comma}) or @code{@@asis}
-(@pxref{@@asis}).  For example:
+(@address@hidden@@asis}}).  For example:
 
 @example
 @@node foo@@address@hidden::@}bar
@@ -9075,8 +9075,8 @@
 
 @cindex Definition lists, typesetting
 Use the @code{@@table} command to produce two-column tables.  It is
-usually listed for ``definition lists'' of various sorts, where you
-have a list of terms and a brief text with each one.
+typically used when you have a list of items and a brief text with
+each one, such as ``definition lists''.
 
 Write the @code{@@table} command at the beginning of a line, after a
 blank line, and follow it on the same line with an argument that is a
@@ -9086,9 +9086,10 @@
 This command will be applied to the text that goes into the first
 column of each item and thus determines how it will be highlighted.
 For example, @code{@@table @@code} will cause the text in the first
-column to be output as if it @code{@@code} command.
+column to be output as if it had been the argument to an @code{@@code}
+command.
 
address@hidden@@asis}
address@hidden@code{@@asis}}
 @findex asis
 You may also use the @code{@@asis} command as an argument to
 @code{@@table}.  @code{@@asis} is a command that does nothing; if you
@@ -9096,10 +9097,11 @@
 output without added highlighting (``as is'').
 
 The @code{@@table} command works with other commands besides those
-explicitly mentioned here.  However, you can only use commands that
-normally take arguments in braces.  (In this case, however, you use
-the command name without an argument, because the subsequent
address@hidden@@item}'s will supply the argument.)
+explicitly mentioned here.  However, you can only use predefined
+Texinfo commands that normally take an argument in braces.  You cannot
+reliably use a new command defined with @code{@@macro}, but an
address@hidden@@alias} (for a suitable predefined command) is acceptable.
address@hidden New Texinfo Commands}.
 
 @findex item
 Begin each table entry with an @code{@@item} command at the beginning
@@ -9111,9 +9113,9 @@
 paragraphs.  But only the text on the same line as the @code{@@item}
 will be placed in the first column (including any footnotes).
 
-Normally, you should put a blank line before an @code{@@item} line.
-This puts a blank line in the Info file.  Except when the entries are
-very brief, a blank line looks better.
+Normally, you should put a blank line before an @code{@@item} line
+(except the first one).  This puts a blank line in the Info file.
+Except when the entries are very brief, a blank line looks better.
 
 End the table with a line consisting of @code{@@end table}, followed
 by a blank line.  @TeX{} will always start a new paragraph after the
@@ -19999,7 +20001,7 @@
 @item @@asis
 Used following @code{@@table}, @code{@@ftable}, and @code{@@vtable} to
 print the table's first column without highlighting (``as is'').
address@hidden@@asis}.
address@hidden@code{@@asis}}.
 
 @item @@author @var{author}
 Typeset @var{author} flushleft and underline it.  @xref{title
@@ -21824,7 +21826,7 @@
 or other version control systems, which expand it into a string such
 as:
 @example
-$Id: texinfo.txi,v 1.473 2012/09/08 16:11:29 karl Exp $
+$Id: texinfo.txi,v 1.474 2012/09/09 19:07:09 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}