texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     13/01/08 00:19:18

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (Quotations and Examples): use @ in node names

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

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1503
retrieving revision 1.1504
diff -u -b -r1.1503 -r1.1504
--- ChangeLog   7 Jan 2013 18:36:38 -0000       1.1503
+++ ChangeLog   8 Jan 2013 00:19:18 -0000       1.1504
@@ -1,7 +1,7 @@
 2013-01-07  Karl Berry  <address@hidden>
 
-       * doc/texinfo.txi (Cross References): node names with @
-       throughout chapter.
+       * doc/texinfo.txi (Cross References, Quotations and Examples):
+       node names with @ throughout chapter.
 
 2013-01-06  Karl Berry  <address@hidden>
 

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.514
retrieving revision 1.515
diff -u -b -r1.514 -r1.515
--- doc/texinfo.txi     7 Jan 2013 18:36:39 -0000       1.514
+++ doc/texinfo.txi     8 Jan 2013 00:19:18 -0000       1.515
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.514 2013/01/07 18:36:39 karl Exp $
address@hidden $Id: texinfo.txi,v 1.515 2013/01/08 00:19:18 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.
 
@@ -365,19 +365,19 @@
 * Block Enclosing Commands::    Different constructs for different purposes.
 * @code{@@quotation}::                   Writing a quotation.
 * @code{@@indentedblock}::               Block of text indented on left.
-* example::                     Writing an example in a fixed-width font.
-* verbatim::                    Writing a verbatim example.
-* verbatiminclude::             Including a file verbatim.
-* lisp::                        Illustrating Lisp code.
-* small::                       Examples in a smaller font.
-* display::                     Writing an example in the current font.
-* format::                      Writing an example without narrowed margins.
-* exdent::                      Undo indentation on a line.
-* flushleft & flushright::      Pushing text flush left or flush right.
-* raggedright::                 Avoiding justification on the right.
-* noindent::                    Preventing paragraph indentation.
-* indent::                      Forcing paragraph indentation.
-* cartouche::                   Drawing rounded rectangles around text.
+* @code{@@example}::                    Writing an example in a fixed-width 
font.
+* @code{@@verbatim}::                   Writing a verbatim example.
+* @code{@@verbatiminclude}::            Including a file verbatim.
+* @code{@@lisp}::                       Illustrating Lisp code.
+* @code{@@address@hidden::                   Examples in a smaller font.
+* @code{@@display}::                    Writing an example in the current font.
+* @code{@@format}::                     Writing an example without narrowed 
margins.
+* @code{@@exdent}::                     Undo indentation on a line.
+* @code{@@flushleft @@flushright}::     Pushing text flush left or flush right.
+* @code{@@raggedright}::                Avoiding justification on the right.
+* @code{@@noindent}::                   Preventing paragraph indentation.
+* @code{@@indent}::                     Forcing paragraph indentation.
+* @code{@@cartouche}::                  Drawing rounded rectangles around text.
 
 Lists and Tables
 
@@ -1326,7 +1326,7 @@
 sequence used on some systems; so a @dfn{blank line} means exactly two
 consecutive newlines.  Sometimes blank lines are useful or convenient
 in other cases as well; you can use the @code{@@noindent} to inhibit
-paragraph indentation if required (@pxref{noindent,,@code{@@noindent}}).
+paragraph indentation if required (@address@hidden@@noindent}}).
 
 @item
 Texinfo supports the usual quotation marks used in English and in
@@ -8074,19 +8074,19 @@
 * Block Enclosing Commands::    Different constructs for different purposes.
 * @code{@@quotation}::                   Writing a quotation.
 * @code{@@indentedblock}::               Block of text indented on left.
-* example::                     Writing an example in a fixed-width font.
-* verbatim::                    Writing a verbatim example.
-* verbatiminclude::             Including a file verbatim.
-* lisp::                        Illustrating Lisp code.
-* small::                       Examples in a smaller font.
-* display::                     Writing an example in the current font.
-* format::                      Writing an example without narrowed margins.
-* exdent::                      Undo indentation on a line.
-* flushleft & flushright::      Pushing text flush left or flush right.
-* raggedright::                 Avoiding justification on the right.
-* noindent::                    Preventing paragraph indentation.
-* indent::                      Forcing paragraph indentation.
-* cartouche::                   Drawing rounded rectangles around text.
+* @code{@@example}::                    Writing an example in a fixed-width 
font.
+* @code{@@verbatim}::                   Writing a verbatim example.
+* @code{@@verbatiminclude}::            Including a file verbatim.
+* @code{@@lisp}::                       Illustrating Lisp code.
+* @code{@@address@hidden::                   Examples in a smaller font.
+* @code{@@display}::                    Writing an example in the current font.
+* @code{@@format}::                     Writing an example without narrowed 
margins.
+* @code{@@exdent}::                     Undo indentation on a line.
+* @code{@@flushleft @@flushright}::     Pushing text flush left or flush right.
+* @code{@@raggedright}::                Avoiding justification on the right.
+* @code{@@noindent}::                   Preventing paragraph indentation.
+* @code{@@indent}::                     Forcing paragraph indentation.
+* @code{@@cartouche}::                  Drawing rounded rectangles around text.
 @end menu
 
 
@@ -8291,11 +8291,13 @@
 possible.  @xref{small}.
 
 
address@hidden example
address@hidden @code{@@example}
 @section @code{@@example}: Example Text
+
address@hidden@c old name
address@hidden example
 @cindex Examples, formatting them
 @cindex Formatting examples
address@hidden example
 
 The @code{@@example} environment is used to indicate an example that
 is not part of the running text, such as computer input or output.
@@ -8313,7 +8315,7 @@
 @item The output uses a fixed-width font.
 @item Texinfo commands @emph{are} expanded; if you want the output to
 be the input verbatim, use the @code{@@verbatim} environment instead
-(@pxref{verbatim,,@code{@@verbatim}}).
+(@address@hidden@@verbatim}}).
 @end itemize
 
 For example,
@@ -8351,7 +8353,7 @@
 paragraph, and the text that continues afterwards should not be
 indented, as in the example above.  The @code{@@noindent} command
 prevents a piece of text from being indented as if it were a new
-paragraph (@pxref{noindent,,@code{@@noindent}}.
+paragraph (@address@hidden@@noindent}}.
 
 If you want to embed code fragments within sentences, instead of
 displaying them, use the @code{@@code} command or its relatives
@@ -8361,8 +8363,10 @@
 normal roman font, you can use the @code{@@r} command (@pxref{Fonts}).
 
 
address@hidden verbatim
address@hidden @code{@@verbatim}
 @section @code{@@verbatim}: Literal Text
+
address@hidden@c old name
 @findex verbatim
 @cindex Verbatim environment
 
@@ -8429,11 +8433,13 @@
 @code{@@verbatim} inside other Texinfo constructs.
 
 
address@hidden verbatiminclude
address@hidden @code{@@verbatiminclude}
 @section @code{@@verbatiminclude} @var{file}: Include a File Verbatim
+
address@hidden@c old name
address@hidden verbatiminclude
 @cindex Verbatim, include file
 @cindex Including a file verbatim
address@hidden verbatiminclude
 
 You can include the exact contents of a file in the document with the
 @code{@@verbatiminclude} command:
@@ -8465,8 +8471,10 @@
 the end of the previous section on @code{@@verbatim}.
 
 
address@hidden lisp
address@hidden @code{@@lisp}
 @section @code{@@lisp}: Marking a Lisp Example
+
address@hidden@c old name
 @findex lisp
 @cindex Lisp example
 
@@ -8489,16 +8497,18 @@
 itself.
 
 
address@hidden small
address@hidden @code{@@address@hidden
 @section @code{@@address@hidden Block Commands
+
address@hidden@c old name
address@hidden smallexample
address@hidden smallformat
address@hidden smalllisp
address@hidden smallquotation
 @cindex Small examples
 @cindex Examples in smaller fonts
 @cindex Quotations in smaller fonts
 @cindex Lisp examples in smaller fonts
address@hidden smallquotation
address@hidden smallexample
address@hidden smallformat
address@hidden smalllisp
 
 In addition to the regular @code{@@example} and similar commands,
 Texinfo has ``small'' example-style commands.  These are
@@ -8544,10 +8554,12 @@
 consistently within a chapter.
 
 
address@hidden display
address@hidden @code{@@display}
 @section @code{@@display}: Examples Using the Text Font
address@hidden Display formatting
+
address@hidden@c old name
 @findex display
address@hidden Display formatting
 
 The @code{@@display} command begins another kind of environment, where
 the font is left unchanged, not switched to typewriter as with
@@ -8562,7 +8574,8 @@
 
 @findex smalldisplay
 Texinfo also provides the environment @code{@@smalldisplay}, which is
-like @code{@@display} but uses a smaller font size.  @xref{small}.
+like @code{@@display} but uses a smaller font size.
address@hidden@code{@@address@hidden
 
 The @code{@@table} command (@pxref{table}) is not supported inside
 @code{@@display}.  Since @code{@@display} is line-oriented, it doesn't
@@ -8571,8 +8584,10 @@
 or @code{@@indentedblock} (@address@hidden@@indentedblock}}).
 
 
address@hidden format
address@hidden @code{@@format}
 @section @code{@@format}: Examples Using the Full Line Width
+
address@hidden@c old name
 @findex format
 
 The @code{@@format} command is similar to @code{@@display}, except it
@@ -8591,10 +8606,12 @@
 like @code{@@format} but uses a smaller font size.  @xref{small}.
 
 
address@hidden exdent
address@hidden @code{@@exdent}
 @section @code{@@exdent}: Undoing a Line's Indentation
address@hidden Indentation undoing
+
address@hidden@c old name
 @findex exdent
address@hidden Indentation undoing
 
 The @code{@@exdent} command removes any indentation a line might have.
 The command is written at the beginning of a line and applies only to
@@ -8634,8 +8651,10 @@
 @code{@@exdent} has no effect in HTML output.
 
 
address@hidden flushleft & flushright
address@hidden @code{@@flushleft @@flushright}
 @section @code{@@flushleft} and @code{@@flushright}
+
address@hidden & address@hidden old name
 @findex flushleft
 @findex flushright
 @cindex Ragged right, without filling
@@ -8696,8 +8715,10 @@
 @end flushright
 
 
address@hidden raggedright
address@hidden @code{@@raggedright}
address@hidden @code{@@raggedright}
address@hidden @code{@@raggedright}: Ragged Right Text 
+
address@hidden@c old name
 @findex raggedright
 @cindex Ragged right, with filling
 
@@ -8737,12 +8758,14 @@
 @end raggedright
 
 
address@hidden noindent
address@hidden @code{@@noindent}
 @section @code{@@noindent}: Omitting Indentation
+
address@hidden@c old name
address@hidden noindent
 @cindex Omitting indentation
 @cindex Suppressing indentation
 @cindex Indentation, omitting
address@hidden noindent
 
 An example or other inclusion can break a paragraph into segments.
 Ordinarily, the formatters indent text that follows an example as a new
@@ -8801,12 +8824,14 @@
 paragraphs (@pxref{Command Syntax}).
 
 
address@hidden indent
address@hidden @code{@@indent}
 @section @code{@@indent}: Forcing Indentation
+
address@hidden@c old name
address@hidden indent
 @cindex Forcing indentation
 @cindex Inserting indentation
 @cindex Indentation, forcing
address@hidden indent
 
 @indent
 To complement the @code{@@noindent} command (see the previous
@@ -8829,9 +8854,10 @@
 paragraphs (@pxref{Command Syntax}).
 
 
address@hidden cartouche
address@hidden @code{@@cartouche}
 @section @code{@@cartouche}: Rounded Rectangles
 
address@hidden@c old name
 @findex cartouche
 @cindex Box with rounded corners
 @cindex Rounded rectangles, around text
@@ -8871,6 +8897,7 @@
 
 @code{@@cartouche} also implies @code{@@group} (@pxref{group}).
 
+
 @node Lists and Tables
 @chapter Lists and Tables
 @cindex Making lists and tables
@@ -14930,9 +14957,9 @@
 @itemize
 @item
 @code{@@verbatim} and macros do not mix; for instance, you can't start
-a verbatim block inside a macro and end it outside (@pxref{verbatim}).
-Starting any environment inside a macro and ending it outside may or
-may not work, for that matter.
+a verbatim block inside a macro and end it outside
+(@address@hidden@@verbatim}}).  Starting any environment inside a macro
+and ending it outside may or may not work, for that matter.
 
 @item
 Macros that completely define macros are ok, but it's not possible to
@@ -15131,10 +15158,10 @@
 
 @vindex CPP_LINE_DIRECTIVES
 The @command{makeinfo} program recognizes these lines by default,
-except within @code{@@verbatim} blocks (@pxref{verbatim,,
address@hidden@@verbatim}}.  Their recognition can be turned off completely
-with @code{CPP_LINE_DIRECTIVES} (@pxref{Other Customization
-Variables}), though there is normally no reason to do so.
+except within @code{@@verbatim} blocks (@address@hidden@@verbatim}}.
+Their recognition can be turned off completely with
address@hidden (@pxref{Other Customization Variables}),
+though there is normally no reason to do so.
 
 For those few programs (M4, CPP, Texinfo) which need to document
 @samp{#line} directives and therefore have examples which would
@@ -19971,7 +19998,7 @@
 @item @@cartouche
 Highlight an example or quotation by drawing a box with rounded
 corners around it.  Pair with @code{@@end cartouche}.  No effect in
-Info.  @xref{cartouche, , Drawing Cartouches Around Examples}.
+Info.  @address@hidden@@cartouche}}.
 
 @item @@center @var{line-of-text}
 Center the line of text following the command.
@@ -20222,7 +20249,7 @@
 @item @@display
 Begin a kind of example.  Like @code{@@example} (indent text, do not
 fill), but do not select a new font.  Pair with @code{@@end display}.
address@hidden, , @code{@@display}}.
address@hidden@code{@@display}}.
 
 @item @@address@hidden@address@hidden
 Format a unit of measure, as in address@hidden  Causes @TeX{} to insert a
@@ -20323,8 +20350,7 @@
 Generate an upside-down exclamation point.  @xref{Inserting Accents}.
 
 @item @@exdent @var{line-of-text}
-Remove any indentation a line might have.  @xref{exdent, ,
-Undoing the Indentation of a Line}.
+Remove any indentation a line might have.  @address@hidden@@exdent}}.
 
 @item @@address@hidden@}
 Indicate the result of a macro expansion to the reader with a special
@@ -20356,9 +20382,8 @@
 @itemx @@flushright
 Do not fill text; left (right) justify every line while leaving the
 right (left) end ragged.  Leave font as is.  Pair with @code{@@end
-flushleft} (@code{@@end flushright}).
address@hidden & flushright, , @code{@@flushleft} and
address@hidden@@flushright}}.
+flushleft} (@code{@@end flushright}).  @address@hidden@@flushleft
+@@flushright}}.
 
 @item @@fonttextsize @var{10-11}
 Change the size of the main body font in the @TeX{} output.
@@ -20509,7 +20534,7 @@
 Read the contents of Texinfo source file @var{filename}.  @xref{Include Files}.
 
 @item @@indent
-Insert paragraph indentation.  @xref{indent,, @code{indent}}.
+Insert paragraph indentation.  @address@hidden@@indent}}.
 
 @item @@indentedblock
 Indent a block of arbitary text on the left.  Pair with @code{@@end
@@ -20586,7 +20611,7 @@
 
 @item @@lisp
 Begin an example of Lisp code.  Indent text, do not fill, and select
-fixed-width font.  Pair with @code{@@end lisp}.  @xref{lisp, , @code{@@lisp}}.
+fixed-width font.  Pair with @code{@@end lisp}.  @address@hidden@@lisp}}.
 
 @item @@listoffloats
 Produce a table-of-contents-like listing of @code{@@float}s.
@@ -20633,7 +20658,7 @@
 
 @item @@noindent
 Prevent text from being indented as if it were a new paragraph.
address@hidden, , @code{@@noindent}}.
address@hidden@code{@@noindent}}.
 
 @item @@novalidate
 Suppress validation of node references and omit creation of auxiliary
@@ -20738,8 +20763,7 @@
 @item @@raggedright
 Fill text; left justify every line while leaving the right end ragged.
 Leave font as is.  Pair with @code{@@end raggedright}.  No effect in
-Info.
address@hidden, , @code{@@raggedright}}.
+Info.  @address@hidden@@raggedright}}.
 
 @item @@raisesections
 Change subsequent sections to chapters, subsections to sections, and so
@@ -21063,11 +21087,11 @@
 
 @item @@verbatim
 Output the text of the environment exactly as is (in the fixed-width
-font).  Pair with @code{@@end verbatim}.  @xref{verbatim,,@code{verbatim}}.
+font).  Pair with @code{@@end verbatim}.  @address@hidden@@verbatim}}.
 
 @item @@verbatiminclude @var{filename}
-Output the contents of @var{filename} exactly as is (in the fixed-width font).
address@hidden,,@code{verbatiminclude}}.
+Output the contents of @var{filename} exactly as is (in the
+fixed-width font).  @address@hidden@@verbatiminclude}}.
 
 @item @@vindex @var{entry}
 Add @var{entry} to the index of variables.  @xref{Index Entries, ,
@@ -21771,7 +21795,7 @@
 as:
 
 @example
-$Id: texinfo.txi,v 1.514 2013/01/07 18:36:39 karl Exp $
+$Id: texinfo.txi,v 1.515 2013/01/08 00:19:18 karl Exp $
 @end example
 
 (This is potentially useful in all sources that use version control,