texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     13/01/08 16:20:45

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (Lists and Tables, Floats): use @ in node names

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1504&r2=1.1505
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.515&r2=1.516

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1504
retrieving revision 1.1505
diff -u -b -r1.1504 -r1.1505
--- ChangeLog   8 Jan 2013 00:19:18 -0000       1.1504
+++ ChangeLog   8 Jan 2013 16:20:42 -0000       1.1505
@@ -1,3 +1,7 @@
+2013-01-08  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Lists and Tables, Floats): node names with @.
+
 2013-01-07  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (Cross References, Quotations and Examples):

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.515
retrieving revision 1.516
diff -u -b -r1.515 -r1.516
--- doc/texinfo.txi     8 Jan 2013 00:19:18 -0000       1.515
+++ doc/texinfo.txi     8 Jan 2013 16:20:43 -0000       1.516
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.515 2013/01/08 00:19:18 karl Exp $
address@hidden $Id: texinfo.txi,v 1.516 2013/01/08 16:20:43 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.
 
@@ -382,16 +382,16 @@
 Lists and Tables
 
 * Introducing Lists::           Texinfo formats lists for you.
-* itemize::                     How to construct a simple list.
-* enumerate::                   How to construct a numbered list.
+* @code{@@itemize}::                    How to construct a simple list.
+* @code{@@enumerate}::                   How to construct a numbered list.
 * Two-column Tables::           How to construct a two-column table.
 * Multi-column Tables::         How to construct generalized tables.
 
 Making a Two-column Table
 
-* table::                       How to construct a two-column table.
-* ftable vtable::               Automatic indexing for two-column tables.
-* itemx::                       How to put more entries in the first column.
+* @code{@@table}::                       How to construct a two-column table.
+* @code{@@ftable @@vtable}::               Automatic indexing for two-column 
tables.
+* @code{@@itemx}::                       How to put more entries in the first 
column.
 
 @code{@@multitable}: Multi-column Tables
 
@@ -406,9 +406,9 @@
 
 Floats
 
-* float::                       Producing floating material.
-* caption shortcaption::        Specifying descriptions for floats.
-* listoffloats::                A table of contents for floats.
+* @code{@@float}::                       Producing floating material.
+* @code{@@caption @@shortcaption}::       Specifying descriptions for floats.
+* @code{@@listoffloats}::                A table of contents for floats.
 
 Inserting Images
 
@@ -8577,11 +8577,11 @@
 like @code{@@display} but uses a smaller font size.
 @address@hidden@@address@hidden
 
-The @code{@@table} command (@pxref{table}) is not supported inside
address@hidden@@display}.  Since @code{@@display} is line-oriented, it doesn't
-make sense to use them together.  If you want to indent a table, try
address@hidden@@quotation} (@address@hidden@@quotation}})
-or @code{@@indentedblock} (@address@hidden@@indentedblock}}).
+The @code{@@table} command (@address@hidden@@table}}) is not supported
+inside @code{@@display}.  Since @code{@@display} is line-oriented, it
+doesn't make sense to use them together.  If you want to indent a
+table, try @code{@@quotation} (@address@hidden@@quotation}}) or
address@hidden@@indentedblock} (@address@hidden@@indentedblock}}).
 
 
 @node @code{@@format}
@@ -8910,8 +8910,8 @@
 
 @menu
 * Introducing Lists::           Texinfo formats lists for you.
-* itemize::                     How to construct a simple list.
-* enumerate::                   How to construct a numbered list.
+* @code{@@itemize}::                     How to construct a simple list.
+* @code{@@enumerate}::                   How to construct a numbered list.
 * Two-column Tables::           How to construct a two-column table.
 * Multi-column Tables::         How to construct generalized tables.
 @end menu
@@ -8988,10 +8988,12 @@
 @end table
 
 
address@hidden itemize
address@hidden @code{@@itemize}
 @section @code{@@itemize}: Making an Itemized List
address@hidden Itemization
+
address@hidden@c old name
 @findex itemize
address@hidden Itemization
 
 The @code{@@itemize} command produces sequences of indented
 paragraphs, with a bullet or other mark inside the left margin
@@ -9099,10 +9101,12 @@
 @end quotation
 
 
address@hidden enumerate
address@hidden @code{@@enumerate}
 @section @code{@@enumerate}: Making a Numbered or Lettered List
address@hidden Enumeration
+
address@hidden@c old name
 @findex enumerate
address@hidden Enumeration
 
 @code{@@enumerate} is like @code{@@itemize} (@pxref{itemize,,
 @code{@@itemize}}), except that the labels on the items are
@@ -9188,8 +9192,8 @@
 @item
 @code{@@enumerate}
 
-Without an argument, produce a numbered list, starting with the number
-1.
+Without an argument, produce a numbered list, starting with the
address@hidden
 
 @item
 @code{@@enumerate @var{positive-integer}}
@@ -9215,8 +9219,10 @@
 
 You can also nest enumerated lists, as in an outline.
 
+
 @node Two-column Tables
 @section Making a Two-column Table
+
 @cindex Tables, making two-column
 @findex table
 
@@ -9227,14 +9233,16 @@
 exhibits, and command-line option summaries.
 
 @menu
-* table::                       How to construct a two-column table.
-* ftable vtable::               Automatic indexing for two-column tables.
-* itemx::                       How to put more entries in the first column.
+* @code{@@table}::                       How to construct a two-column table.
+* @code{@@ftable @@vtable}::              Automatic indexing for two-column 
tables.
+* @code{@@itemx}::                       How to put more entries in the first 
column.
 @end menu
 
address@hidden table
address@hidden @code{@@table}
 @subsection Using the @code{@@table} Command
 
address@hidden@c old name
+
 @cindex Definition lists, typesetting
 Use the @code{@@table} command to produce two-column tables.  It is
 typically used when you have a list of items and a brief text with
@@ -9251,7 +9259,7 @@
 column to be output as if it had been the argument to an @code{@@code}
 command.
 
address@hidden@code{@@asis}}
address@hidden@code{@@address@hidden command name with @, for consistency
 @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
@@ -9312,15 +9320,17 @@
 @end table
 
 If you want to list two or more named items with a single block of
-text, use the @code{@@itemx} command.  (@xref{itemx,,@code{@@itemx}}.)
+text, use the @code{@@itemx} command.  (@address@hidden@@itemx}}.)
 
 
address@hidden ftable vtable
address@hidden @code{@@ftable @@vtable}
 @subsection @code{@@ftable} and @code{@@vtable}
address@hidden Tables with indexing
address@hidden Indexing table entries automatically
+
address@hidden address@hidden old name
 @findex ftable
 @findex vtable
address@hidden Tables with indexing
address@hidden Indexing table entries automatically
 
 The @code{@@ftable} and @code{@@vtable} commands are the same as the
 @code{@@table} command except that @code{@@ftable} automatically enters
@@ -9341,8 +9351,11 @@
 
 See the example for @code{@@table} in the previous section.
 
address@hidden itemx
address@hidden @code{@@itemx}
+
address@hidden @code{@@itemx}
address@hidden @code{@@itemx}: Second and Subsequent Items
+
address@hidden@c old name
 @cindex Two named items for @code{@@table}
 @findex itemx
 
@@ -9391,8 +9404,9 @@
 
 @node Multi-column Tables
 @section @code{@@multitable}: Multi-column Tables
address@hidden Tables, making multi-column
+
 @findex multitable
address@hidden Tables, making multi-column
 
 @code{@@multitable} allows you to construct tables with any number of
 columns, with each column having any width you like.
@@ -9458,6 +9472,7 @@
 
 @node Multitable Rows
 @subsection Multitable Rows
+
 @cindex Multitable rows
 @cindex Rows, of a multitable
 
@@ -9567,14 +9582,16 @@
 an @code{@@group} (@pxref{group,,@code{@@group}}).
 
 @menu
-* float::                       Producing floating material.
-* caption shortcaption::        Specifying descriptions for floats.
-* listoffloats::                A table of contents for floats.
+* @code{@@float}::                       Producing floating material.
+* @code{@@caption @@shortcaption}::       Specifying descriptions for floats.
+* @code{@@listoffloats}::                A table of contents for floats.
 @end menu
 
 
address@hidden float
address@hidden @code{@@float}
 @subsection @code{@@float} address@hidden,@var{label}]: Floating Material
+
address@hidden@c old name
 @findex float
 @cindex Float environment
 
@@ -9611,8 +9628,8 @@
 @item label
 Specifies a cross reference label for this float.  If given, this
 float is automatically given a number, and will appear in any
address@hidden@@listoffloats} output (@pxref{listoffloats}).  Cross references
-to @var{label} are allowed.
address@hidden@@listoffloats} output (@address@hidden@@listoffloats}}).  Cross
+references to @var{label} are allowed.
 
 @cindex Floats, making unnumbered
 @cindex Unnumbered float, creating
@@ -9637,8 +9654,10 @@
 These numbering conventions are not, at present, changeable.
 
 
address@hidden caption shortcaption
address@hidden @code{@@caption @@shortcaption}
 @subsection @code{@@caption} & @code{@@shortcaption}
+
address@hidden address@hidden old name
 @findex caption
 @findex shortcaption
 @cindex Captions, for floats
@@ -9692,17 +9711,19 @@
 there is an @code{@@shortcaption}.
 
 
address@hidden listoffloats
address@hidden @code{@@listoffloats}
 @subsection @code{@@listoffloats}: Tables of Contents for Floats
+
address@hidden@c old name
 @findex listoffloats
 @cindex List of floats
 @cindex Floats, list of
 @cindex Table of contents, for floats
 
 You can write an @code{@@listoffloats} command to generate a list of
-floats for a given float type (@pxref{float}), analogous to the
-document's overall table of contents.  Typically, it is written in its
-own @code{@@unnumbered} node to provide a heading and structure,
+floats for a given float type (@address@hidden@@float}}), analogous to
+the document's overall table of contents.  Typically, it is written in
+its own @code{@@unnumbered} node to provide a heading and structure,
 rather like @code{@@printindex} (@pxref{Printing Indices & Menus}).
 
 @code{@@listoffloats} takes one optional argument, the float type.
@@ -9720,9 +9741,9 @@
 @listoffloats Figure
 @end display
 
-Without any argument, @code{@@listoffloats} generates a list of
-floats for which no float type was specified, i.e., no first argument
-to the @code{@@float} command (@pxref{float}).
+Without any argument, @code{@@listoffloats} generates a list of floats
+for which no float type was specified, i.e., no first argument to the
address@hidden@@float} command (@address@hidden@@float}}).
 
 Each line in the list of floats contains the float type (if any),
 the float number, and the caption, if any---the @code{@@shortcaption}
@@ -11405,7 +11426,7 @@
 
 When you use @code{@@bullet} in @code{@@itemize}, you do not need to
 type the braces, because @code{@@itemize} supplies them.
-(@pxref{itemize, , @code{@@itemize}}).
+(@address@hidden@@itemize}}).
 
 
 @node TeX and copyright
@@ -11549,9 +11570,9 @@
 @code{@@example} because the width distinction is not made in the
 fixed-width font they use.
 
-When you use @code{@@minus} to specify the mark beginning each entry in
-an itemized list, you do not need to type the braces
-(@pxref{itemize, , @code{@@itemize}}).
+When you use @code{@@minus} to specify the mark beginning each entry
+in an itemized list, you do not need to type the braces
+(@address@hidden@@itemize}}).
 
 
 @node geq leq
@@ -11684,9 +11705,8 @@
 You can change the glyph produced by @code{@@click} with the command
 @code{@@clickstyle}, which takes a command name as its single argument
 on the rest of the line, much like @code{@@itemize} and friends
-(@pxref{itemize,,@code{@@itemize}}).  The command should produce a
-glyph, and the usual empty braces @address@hidden@}} are omitted.  Here's an
-example:
+(@address@hidden@@itemize}}).  The command should produce a glyph, and
+the usual empty braces @address@hidden@}} are omitted.  Here's an example:
 
 @example
 @@clickstyle @@result
@@ -12684,7 +12704,8 @@
 Each definition command has an `x' form: @code{@@defunx},
 @code{@@defvrx}, @code{@@deftypefunx}, etc.
 
-The `x' forms work similarly to @code{@@itemx} (@pxref{itemx}).
+The `x' forms work similarly to @code{@@itemx}
+(@address@hidden@@itemx}}).
 
 
 @node Def Cmds in Detail
@@ -18052,7 +18073,7 @@
 @item XREF_USE_FLOAT_LABEL
 For address@hidden  If set, for the float name in cross references, use the
 float label instead of the type followed by the float number
-(@pxref{float}).  The default is off.
+(@address@hidden@@float}}).  The default is off.
 
 @item XREF_USE_NODE_NAME_ARG
 For address@hidden  Only relevant for cross reference commands with no cross
@@ -19993,7 +20014,8 @@
 starts a comment.  @xref{Comments}.
 
 @item @@caption
-Define the full caption for an @code{@@float}.  @xref{caption shortcaption}.
+Define the full caption for an @code{@@float}.  @address@hidden@@caption
+@@shortcaption}}.
 
 @item @@cartouche
 Highlight an example or quotation by drawing a box with rounded
@@ -20303,8 +20325,7 @@
 @item @@enumerate address@hidden
 Begin a numbered list, using @code{@@item} for each entry.
 Optionally, start list with @var{number-or-letter}.  Pair with
address@hidden@@end enumerate}.  @xref{enumerate, ,
address@hidden@@enumerate}}.
address@hidden@@end enumerate}.  @address@hidden@@enumerate}}.
 
 @item @@address@hidden@address@hidden
 Indicate an environment variable name, such as @env{PATH}.
@@ -20411,8 +20432,7 @@
 Begin a two-column table, using @code{@@item} for each entry.
 Automatically enter each of the items in the first column into the
 index of functions.  Pair with @code{@@end ftable}.  The same as
address@hidden@@table}, except for indexing.  @xref{ftable vtable, ,
address@hidden@@ftable} and @code{@@vtable}}.
address@hidden@@table}, except for indexing.  @address@hidden@@ftable 
@@vtable}}.
 
 @item @@address@hidden@}
 Generate a greater-than-or-equal sign, address@hidden'.  @xref{geq leq}.
@@ -20573,15 +20593,14 @@
 
 @item @@itemize @var{mark-generating-character-or-command}
 Begin an unordered list: indented paragraphs with a mark, such as
address@hidden@@bullet}, inside the left margin at the beginning of each
-item.  Pair with @code{@@end itemize}.  @xref{itemize, ,
address@hidden@@itemize}}.
address@hidden@@bullet}, inside the left margin at the beginning of each item.
+Pair with @code{@@end itemize}.  @address@hidden@@itemize}}.
 
 @item @@itemx
 Like @code{@@item} but do not generate extra vertical space above the
 item text.  Thus, when several items have the same description, use
 @code{@@item} for the first and @code{@@itemx} for the others.
address@hidden, , @code{@@itemx}}.
address@hidden@code{@@itemx}}.
 
 @item @@address@hidden@address@hidden
 Indicate characters of input to be typed by users.  @xref{kbd,, @code{@@kbd}}.
@@ -20615,7 +20634,7 @@
 
 @item @@listoffloats
 Produce a table-of-contents-like listing of @code{@@float}s.
address@hidden
address@hidden@code{@@listoffloats}}.
 
 @item @@lowersections
 Change subsequent chapters to sections, sections to subsections, and so
@@ -20841,7 +20860,8 @@
 @address@hidden@@settitle}}.
 
 @item @@shortcaption
-Define the short caption for an @code{@@float}.  @xref{caption shortcaption}.
+Define the short caption for an @code{@@float}.  @address@hidden@@caption
+@@shortcaption}}.
 
 @item @@shortcontents
 Print a short table of contents, with chapter-level entries only.  Not
@@ -20951,8 +20971,7 @@
 @code{@@item}.  First column entries are printed in the font resulting
 from @var{formatting-command}.  Pair with @code{@@end table}.
 @xref{Two-column Tables, , Making a Two-column Table}.  Also see
address@hidden vtable, , @code{@@ftable} and @code{@@vtable}}, and
address@hidden, , @code{@@itemx}}.
address@hidden@code{@@ftable @@vtable}}, and @address@hidden@@itemx}}.
 
 @item @@address@hidden@}
 Generate the @TeX{} logo.  @xref{tex, , @TeX{} and @LaTeX{}}.
@@ -21108,8 +21127,7 @@
 Begin a two-column table, using @code{@@item} for each entry.
 Automatically enter each of the items in the first column into the
 index of variables.  Pair with @code{@@end vtable}.  The same as
address@hidden@@table}, except for indexing.  @xref{ftable vtable, ,
address@hidden@@ftable} and @code{@@vtable}}.
address@hidden@@table}, except for indexing.  @address@hidden@@ftable 
@@vtable}}.
 
 @item @@address@hidden@address@hidden
 Disallow line breaks within @var{text}.  @xref{w, , @code{@@w}}.
@@ -21795,7 +21813,7 @@
 as:
 
 @example
-$Id: texinfo.txi,v 1.515 2013/01/08 00:19:18 karl Exp $
+$Id: texinfo.txi,v 1.516 2013/01/08 16:20:43 karl Exp $
 @end example
 
 (This is potentially useful in all sources that use version control,