[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi
From: |
karl |
Subject: |
texinfo ChangeLog doc/texinfo.txi |
Date: |
Sun, 09 Sep 2012 19:07:10 +0000 |
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}
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/03
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/03
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/04
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/06
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/06
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/07
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/07
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/08
- texinfo ChangeLog doc/texinfo.txi,
karl <=
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/09
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/10
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/12
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/13
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/15
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/23