texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     13/01/14 17:09:00

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (Conditionally Visible Text): @ in node names

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1514&r2=1.1515
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.521&r2=1.522

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1514
retrieving revision 1.1515
diff -u -b -r1.1514 -r1.1515
--- ChangeLog   14 Jan 2013 00:36:32 -0000      1.1514
+++ ChangeLog   14 Jan 2013 17:08:55 -0000      1.1515
@@ -1,3 +1,7 @@
+2013-01-14  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Conditionally Visible Text): node names with @.
+
 2013-01-13  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (Special Insertions, Breaks, deffnx,

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.521
retrieving revision 1.522
diff -u -b -r1.521 -r1.522
--- doc/texinfo.txi     14 Jan 2013 00:36:33 -0000      1.521
+++ doc/texinfo.txi     14 Jan 2013 17:08:58 -0000      1.522
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.521 2013/01/14 00:36:33 karl Exp $
address@hidden $Id: texinfo.txi,v 1.522 2013/01/14 17:08:58 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.
 
@@ -535,14 +535,14 @@
 * Conditional Not Commands::    Text for any format other than a given one.
 * Raw Formatter Commands::      Using raw formatter commands.
 * Inline Conditionals::         Brace-delimited conditional text.
-* set clear value::             Variable tests and substitutions.
+* @code{@@set @@clear @@value}::          Variable tests and substitutions.
 * Conditional Nesting::         Using conditionals inside conditionals.
 
 @code{@@set}, @code{@@clear}, and @code{@@value}
 
-* set value::                   Expand a flag variable to a string.
-* ifset ifclear::               Format a region if a flag is set.
-* value Example::               An easy way to update edition information.
+* @code{@@set @@value}::                 Expand a flag variable to a string.
+* @code{@@ifset @@ifclear}::             Format a region if a flag is set.
+* @code{@@value} Example::              An easy way to update edition 
information.
 
 Defining New Texinfo Commands
 
@@ -4848,7 +4848,8 @@
 sections in the main file would also be lowered.)
 
 If the included file being lowered has an @code{@@top} node, you'll
-need to conditionalize its inclusion with a flag (@pxref{set value}).
+need to conditionalize its inclusion with a flag (@address@hidden@@set
+@@value}}).
 
 Another difficulty can arise with documents that use the (recommended)
 feature of @command{makeinfo} for implicitly determining node
@@ -13786,7 +13787,7 @@
 * Conditional Not Commands::    Text for any format other than a given one.
 * Raw Formatter Commands::      Using raw formatter commands.
 * Inline Conditionals::         Brace-delimited conditional text.
-* set clear value::             Variable tests and substitutions.
+* @code{@@set @@clear @@value}::          Variable tests and substitutions.
 * Testing for Texinfo Commands:: Testing if a Texinfo command is available.
 * Conditional Nesting::         Using conditionals inside conditionals.
 @end menu
@@ -14110,9 +14111,10 @@
 argument separator.)
 
 
address@hidden set clear value
address@hidden @code{@@set @@clear @@value}
 @section @code{@@set}, @code{@@clear}, and @code{@@value}
 
address@hidden clear address@hidden old name
 You can direct the Texinfo formatting commands to format or ignore parts
 of a Texinfo file with the @code{@@set}, @code{@@clear}, @code{@@ifset},
 and @code{@@ifclear} commands.
@@ -14139,14 +14141,16 @@
 @end table
 
 @menu
-* set value::                   Expand a flag variable to a string.
-* ifset ifclear::               Format a region if a flag is set.
-* value Example::               An easy way to update edition information.
+* @code{@@set @@value}::                 Expand a flag variable to a string.
+* @code{@@ifset @@ifclear}::             Format a region if a flag is set.
+* @code{@@value} Example::              An easy way to update edition 
information.
 @end menu
 
 
address@hidden set value
address@hidden @code{@@set @@value}
 @subsection @code{@@set} and @code{@@value}
+
address@hidden address@hidden old name
 @findex set
 @findex value
 @findex clear
@@ -14241,10 +14245,12 @@
 @end example
 
 
address@hidden ifset ifclear
address@hidden @code{@@ifset @@ifclear}
 @subsection @code{@@ifset} and @code{@@ifclear}
 
address@hidden address@hidden old name
 @findex ifset
+
 When a @var{flag} is set, the Texinfo formatting commands format text
 between subsequent pairs of @code{@@ifset @var{flag}} and @code{@@end
 ifset} commands.  When the @var{flag} is cleared, the Texinfo formatting
@@ -14312,9 +14318,11 @@
 @end example
 
 
address@hidden value Example
address@hidden @code{@@value} Example
 @subsection @code{@@value} Example
 
address@hidden address@hidden old name
+
 You can use the @code{@@value} command to minimize the number of
 places you need to change when you record an update to a manual.
 @xref{GNU Sample Texts}, for the full text of an example of using this
@@ -14524,6 +14532,7 @@
 
 @node Defining New Texinfo Commands
 @chapter Defining New Texinfo Commands
+
 @cindex Macros
 @cindex Defining new Texinfo commands
 @cindex New Texinfo commands, defining
@@ -14558,8 +14567,8 @@
 recognize so-called @code{#line} directives for error reporting.
 
 If you want to do simple text substitution, @code{@@set} and
address@hidden@@value} is the simplest approach (@pxref{set clear value,,
address@hidden@@address@hidden @code{@@address@hidden and @code{@@value}}).
address@hidden@@value} is the simplest approach (@address@hidden@@set @@clear
+@@value}}).
 
 @menu
 * Defining Macros::             Defining and undefining new commands.
@@ -15362,8 +15371,8 @@
 @end example
 
 @@-commands are expanded in file names.  The one most likely to be
-useful is @code{@@value} (@pxref{set value}), and even then only in
-complicated situations.
+useful is @code{@@value} (@address@hidden@@set @@value}}), and even then
+only in complicated situations.
 
 An included file should simply be a segment of text that you expect to
 be included as is into the overall or @dfn{outer} Texinfo file; it
@@ -17197,8 +17206,8 @@
 purpose of file name creation.  @xref{HTML Xref 8-bit Character Expansion}.
 
 @item -U @var{var}
-Cause @var{var} to be undefined.  This is equivalent to
address@hidden@@clear @var{var}} in the Texinfo file (@pxref{set clear value}).
+Cause @var{var} to be undefined.  This is equivalent to @code{@@clear
address@hidden in the Texinfo file (@address@hidden@@set @@clear @@value}}).
 
 @item --verbose
 @opindex --verbose
@@ -19618,8 +19627,8 @@
 
 First, comments are removed.
 
-Next, any @code{@@value} commands (@pxref{set value}) and macro
-invocations (@pxref{Invoking Macros}) are fully expanded.
+Next, any @code{@@value} commands (@address@hidden@@set @@value}}) and
+macro invocations (@pxref{Invoking Macros}) are fully expanded.
 
 Then, for the following commands, the command name and braces are removed,
 and the text of the argument is recursively transformed:
@@ -20190,8 +20199,7 @@
 formatting text between subsequent pairs of @code{@@ifset @var{flag}}
 and @code{@@end ifset} commands, and preventing
 @code{@@address@hidden@address@hidden from expanding to the value to which
address@hidden is set.
address@hidden clear value, , @code{@@set} @code{@@clear} @code{@@value}}.
address@hidden is set.  @address@hidden@@set @@clear @@value}}.
 
 @item @@address@hidden@}
 Represent a single ``click'' in a address@hidden  Used within
@@ -20616,8 +20624,8 @@
 
 @item @@ifclear @var{txivar}
 If the Texinfo variable @var{txivar} is not set, format the following
-text.  Pair with @code{@@end ifclear}.  @xref{set clear value, ,
address@hidden@@set} @code{@@clear} @code{@@value}}.
+text.  Pair with @code{@@end ifclear}.  @address@hidden@@set @@clear
+@@value}}.
 
 @item @@ifcommanddefined @var{txicmd}
 @itemx @@ifcommandnotdefined @var{txicmd}
@@ -20655,8 +20663,8 @@
 
 @item @@ifset @var{txivar}
 If the Texinfo variable @var{txivar} is set, format the following
-text.  Pair with @code{@@end ifset}.  @xref{set clear value, ,
address@hidden@@set} @code{@@clear} @code{@@value}}.
+text.  Pair with @code{@@end ifset}.  @address@hidden@@set @@clear
+@@value}}.
 
 @item @@iftex
 Begin text to appear only in the @TeX{} output.  Pair with @code{@@end
@@ -20956,8 +20964,7 @@
 
 @item @@set @var{txivar} address@hidden
 Define the Texinfo variable @var{txivar}, optionally to the value
address@hidden  @xref{set clear value, , @code{@@set} @code{@@clear}
address@hidden@@value}}.
address@hidden  @address@hidden@@set @@clear @@value}}.
 
 @item @@setchapternewpage @var{on-off-odd}
 Specify whether chapters start on new pages, and if so, whether on
@@ -21213,8 +21220,8 @@
 
 @item @@address@hidden@address@hidden
 Insert the value, if any, of the Texinfo variable @var{txivar},
-previously defined by @code{@@set}.  @xref{set clear value, ,
address@hidden@@set} @code{@@clear} @code{@@value}}.
+previously defined by @code{@@set}.  @address@hidden@@set @@clear
+@@value}}.
 
 @item @@address@hidden@address@hidden
 Highlight a metasyntactic variable, which is something that stands for
@@ -21545,8 +21552,8 @@
 output (@pxref{Short Sample}).
 
 It is easiest to handle such version information using @code{@@set}
-and @code{@@value}.  @xref{value Example,, @code{@@value} Example},
-and @ref{GNU Sample Texts}.
+and @code{@@value}.  @address@hidden@@value} Example}, and @ref{GNU
+Sample Texts}.
 
 
 @subsubheading Definition Commands
@@ -21935,7 +21942,7 @@
 as:
 
 @example
-$Id: texinfo.txi,v 1.521 2013/01/14 00:36:33 karl Exp $
+$Id: texinfo.txi,v 1.522 2013/01/14 17:08:58 karl Exp $
 @end example
 
 (This is potentially useful in all sources that use version control,