texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     13/01/13 23:23:16

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (Breaks): @ in node names

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1512&r2=1.1513
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.519&r2=1.520

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1512
retrieving revision 1.1513
diff -u -b -r1.1512 -r1.1513
--- ChangeLog   13 Jan 2013 19:13:18 -0000      1.1512
+++ ChangeLog   13 Jan 2013 23:23:16 -0000      1.1513
@@ -1,6 +1,6 @@
 2013-01-13  Karl Berry  <address@hidden>
 
-       * doc/texinfo.txi (Special Insertions): node names with @,
+       * doc/texinfo.txi (Special Insertions, Breaks): node names with @,
        restructure.
 
        * po_document/LINGUAS (ja, es.us-ascii): remove.

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.519
retrieving revision 1.520
diff -u -b -r1.519 -r1.520
--- doc/texinfo.txi     13 Jan 2013 19:13:19 -0000      1.519
+++ doc/texinfo.txi     13 Jan 2013 23:23:16 -0000      1.520
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.519 2013/01/13 19:13:19 karl Exp $
address@hidden $Id: texinfo.txi,v 1.520 2013/01/13 23:23:16 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.
 
@@ -491,14 +491,14 @@
 
 * Break Commands::              Summary of break-related commands.
 * Line Breaks::                 Forcing line breaks.
-* - and hyphenation::           Helping @TeX{} with hyphenation points.
-* allowcodebreaks::             Controlling line breaks within @@code text.
-* w::                           Preventing unwanted line breaks in text.
-* tie::                         Inserting an unbreakable but varying space.
-* sp::                          Inserting blank lines.
-* page::                        Forcing the start of a new page.
-* group::                       Preventing unwanted page breaks.
-* need::                        Another way to prevent unwanted page breaks.
+* @code{@@-  @@hyphenation}::         Helping @TeX{} with hyphenation points.
+* @code{@@allowcodebreaks}::            Controlling line breaks within @@code 
text.
+* @code{@@w}::                          Preventing unwanted line breaks in 
text.
+* @code{@@tie}::                        Inserting an unbreakable but varying 
space.
+* @code{@@sp}::                         Inserting blank lines.
+* @code{@@page}::                       Forcing the start of a new page.
+* @code{@@group}::                      Preventing unwanted page breaks.
+* @code{@@need}::                       Another way to prevent unwanted page 
breaks.
 
 Definition Commands
 
@@ -3393,8 +3393,8 @@
 @end example
 
 @noindent
-This inserts two blank lines on the printed page.  (@xref{sp, ,
address@hidden@@sp}}, for more information about the @code{@@sp}
+This inserts two blank lines on the printed page.
+(@address@hidden@@sp}}, for more information about the @code{@@sp}
 command.)
 
 A template for this method looks like this:
@@ -7189,10 +7189,9 @@
 By default, @TeX{} will consider breaking lines at @samp{-} and
 @samp{_} characters within @code{@@code} and related commands.  This
 can be controlled with @code{@@allowcodebreaks}
-(@pxref{allowcodebreaks,,@code{@@allowcodebreaks}}).  The HTML output
-attempts to respect this for @samp{-}, but ultimately it is up to the
-browser's behavior.  For Info, it seems better never to make such
-breaks.
+(@address@hidden@@allowcodebreaks}}).  The HTML output attempts to
+respect this for @samp{-}, but ultimately it is up to the browser's
+behavior.  For Info, it seems better never to make such breaks.
 
 For Info, the quotes are omitted in the output of the @code{@@code}
 command and related commands (e.g., @code{@@kbd}, @code{@@command}),
@@ -8877,7 +8876,7 @@
 @end example
 @end cartouche
 
address@hidden@@cartouche} also implies @code{@@group} (@pxref{group}).
address@hidden@@cartouche} also implies @code{@@group} 
(@address@hidden@@group}}).
 
 
 @node Lists and Tables
@@ -9561,7 +9560,7 @@
 formats.)  In the present version of Texinfo, however, this floating
 is unfortunately not yet implemented.  Instead, the floating material
 is simply output at the current location, more or less as if it were
-an @code{@@group} (@pxref{group,,@code{@@group}}).
+an @code{@@group} (@address@hidden@@group}}).
 
 @menu
 * @code{@@float}::                       Producing floating material.
@@ -9846,7 +9845,7 @@
 processed as Texinfo text, so special characters such as @samp{"} and
 @samp{<} and @samp{&} are escaped in the HTML output; also, you can
 get an empty @code{alt} string with @code{@@-} (a command that
-produces no output; @pxref{- and hyphenation}).
+produces no output; @address@hidden@@- @@hyphenation}}).
 
 For Info output, the @code{alt} string is also processed as Texinfo
 text and output.  In this case, @samp{\} is escaped as @samp{\\} and
@@ -10837,7 +10836,7 @@
 
 Do not follow any of these commands with braces.
 
-To produce a non-breakable space, see @ref{tie, @code{@@tie}}.
+To produce a non-breakable space, see @address@hidden@@tie}}.
 
 
 @node Not Ending a Sentence
@@ -11033,12 +11032,12 @@
 
 Not everyone uses this style.  Some people prefer address@hidden'@: or
 address@hidden'.  In these cases, however, you need to use
address@hidden@@tie} (@pxref{tie,,@code{@@tie}}) or @code{@@w}
-(@pxref{w,,@code{@@w}}) so that no line break can occur between the
-number and the dimension.  Also, if you write a period after an
-abbreviation within a sentence (as with the `in.'@: above), you should
-write @samp{@@:} after the period to prevent @TeX{} from inserting
-extra whitespace, as shown here.  @xref{Not Ending a Sentence}.
address@hidden@@tie} (@address@hidden@@tie}}) or @code{@@w} 
(@address@hidden@@w}})
+so that no line break can occur between the number and the dimension.
+Also, if you write a period after an abbreviation within a sentence
+(as with the `in.'@: above), you should write @samp{@@:} after the
+period to prevent @TeX{} from inserting extra whitespace, as shown
+here.  @xref{Not Ending a Sentence}.
 
 
 @node Inserting Accents
@@ -11439,6 +11438,11 @@
 @cindex Glyphs for text
 @cindex Textual glyphs
 
+Texinfo has support for a few additional glyphs that are commonly used
+in printed text but not available in ASCII.  Of course, there are many
+thousands more.  It is possible to use Unicode characters as-is as far
+as @code{makeinfo} is concerned, but @TeX{} is not so lucky.
+
 @menu
 * @code{@@TeX @@LaTeX}::          The @TeX{} logos.
 * @code{@@copyright}::            The copyright symbol (c in a circle).
@@ -12066,14 +12070,14 @@
 @menu
 * Break Commands::              Summary of break-related commands.
 * Line Breaks::                 Forcing line breaks.
-* - and hyphenation::           Helping @TeX{} with hyphenation points.
-* allowcodebreaks::             Controlling line breaks within @@code text.
-* w::                           Preventing unwanted line breaks in text.
-* tie::                         Inserting an unbreakable but varying space.
-* sp::                          Inserting blank lines.
-* page::                        Forcing the start of a new page.
-* group::                       Preventing unwanted page breaks.
-* need::                        Another way to prevent unwanted page breaks.
+* @code{@@-  @@hyphenation}::         Helping @TeX{} with hyphenation points.
+* @code{@@allowcodebreaks}::            Controlling line breaks within @@code 
text.
+* @code{@@w}::                          Preventing unwanted line breaks in 
text.
+* @code{@@tie}::                        Inserting an unbreakable but varying 
space.
+* @code{@@sp}::                         Inserting blank lines.
+* @code{@@page}::                       Forcing the start of a new page.
+* @code{@@group}::                      Preventing unwanted page breaks.
+* @code{@@need}::                       Another way to prevent unwanted page 
breaks.
 @end menu
 
 
@@ -12123,6 +12127,7 @@
 
 @node Line Breaks
 @section @code{@@*} and @code{@@/}: Generate and Allow Line Breaks
+
 @findex * @r{(force line break)}
 @findex / @r{(allow line break)}
 @cindex Line breaks, controlling
@@ -12169,9 +12174,10 @@
 break the url.  @code{@@/} has no effect in other output formats.
 
 
address@hidden - and hyphenation
address@hidden @code{@@- @@hyphenation}
 @section @code{@@-} and @code{@@hyphenation}: Helping @TeX{} Hyphenate
 
address@hidden and address@hidden old name
 @findex - @r{(discretionary hyphen)}
 @findex hyphenation
 @cindex Hyphenation, helping @TeX{} do
@@ -12205,9 +12211,10 @@
 these commands have any effect there.
 
 
address@hidden allowcodebreaks
address@hidden @code{@@allowcodebreaks}
 @section @code{@@allowcodebreaks}: Control Line Breaks in @code{@@code}
 
address@hidden@c old name
 @findex allowcodebreaks
 @cindex Breaks, within @code{@@code}
 @cindex -, breakpoint within @code{@@code}
@@ -12245,9 +12252,10 @@
 This command has no effect except in HTML and @TeX{} output.
 
 
address@hidden w
address@hidden @code{@@w}
 @section @code{@@address@hidden@address@hidden: Prevent Line Breaks
 
address@hidden@c old name
 @findex w @r{(prevent line break)}
 @cindex Line breaks, preventing
 
@@ -12290,8 +12298,10 @@
 in Info or plain text output, though.
 
 
address@hidden tie
address@hidden @code{@@tie}
 @section @code{@@address@hidden@}}: Inserting an Unbreakable Space
+
address@hidden@c old name
 @findex tie @r{(unbreakable interword space)}
 @cindex Tied space
 @cindex Non-breakable space, variable
@@ -12329,8 +12339,10 @@
 @end itemize
 
 
address@hidden sp
address@hidden @code{@@sp}
 @section @code{@@sp} @var{n}: Insert Blank Lines
+
address@hidden@c old name
 @findex sp @r{(line spacing)}
 @cindex Space, inserting vertical
 @cindex Blank lines
@@ -12351,10 +12363,12 @@
 The @code{@@sp} command is most often used in the title page.
 
 
address@hidden page
address@hidden @code{@@page}
 @section @code{@@page}: Start a New Page
address@hidden Page breaks, forcing
+
address@hidden@c old name
 @findex page
address@hidden Page breaks, forcing
 
 A line containing only @code{@@page} starts a new page in a printed
 manual.  In other formats, without the concept of pages, it starts a
@@ -12363,12 +12377,14 @@
 page.
 
 
address@hidden group
address@hidden @code{@@group}
 @section @code{@@group}: Prevent Page Breaks
+
address@hidden@c old name
address@hidden group
 @cindex Group (hold text together vertically)
 @cindex Holding text together vertically
 @cindex Vertically holding text together
address@hidden group
 
 The @code{@@group} command (on a line by itself) is used inside an
 @code{@@example} or similar construct to begin an unsplittable vertical
@@ -12420,9 +12436,10 @@
 @TeX{}.
 
 
address@hidden need
address@hidden @code{@@need}
 @section @code{@@need @var{mils}}: Prevent Page Breaks
 
address@hidden@c old name
 @findex need
 @cindex Need space at page bottom
 @cindex Mils, argument to @code{@@need}
@@ -19992,7 +20009,7 @@
 Accents}.
 
 @item @@-
-Insert a discretionary hyphenation point.  @xref{- and hyphenation}.
+Insert a discretionary hyphenation point.  @address@hidden@@- @@hyphenation}}.
 
 @item @@.
 Produce a period that ends a sentence (usually after an
@@ -20074,7 +20091,7 @@
 
 @item @@allowcodebreaks @var{true-false}
 Control breaking at @samp{-} and @samp{_} in @TeX{}.
address@hidden,, @code{@@allowcodebreaks}}.
address@hidden@code{@@allowcodebreaks}}.
 
 @item @@address@hidden@address@hidden
 Define @var{name} as the current location for use as a cross reference
@@ -20556,7 +20573,7 @@
 
 @item @@group
 Disallow page breaks within following text.  Pair with @code{@@end
-group}.  Ignored in Info.  @xref{group, , @code{@@group}}.
+group}.  Ignored in Info.  @address@hidden@@group}}.
 
 @item @@address@hidden@}
 @itemx @@address@hidden@}
@@ -20600,8 +20617,7 @@
 Formatter Commands}.
 
 @item @@address@hidden@var{hy-phen-a-ted address@hidden
-Explicitly define hyphenation points.  @xref{- and hyphenation,,
address@hidden@@-} and @code{@@hyphenation}}.
+Explicitly define hyphenation points.  @address@hidden@@- @@hyphenation}}.
 
 @item @@address@hidden@address@hidden
 Set @var{text} in an @i{italic} font.  No effect in Info.  @xref{Fonts}.
@@ -20785,8 +20801,8 @@
 
 @item @@need @var{n}
 Start a new page in a printed manual if fewer than @var{n} mils
-(thousandths of an inch) remain on the current page.  @xref{need, ,
address@hidden@@need}}.
+(thousandths of an inch) remain on the current page.
address@hidden@code{@@need}}.
 
 @item @@node @var{name}, @var{next}, @var{previous}, @var{up}
 Begin a new node.  @address@hidden@@node}}.
@@ -20831,7 +20847,7 @@
 
 @item @@page
 Start a new page in a printed manual.  No effect in Info.
address@hidden, , @code{@@page}}.
address@hidden@code{@@page}}.
 
 @item @@pagesizes address@hidden, @var{height}]
 Change page dimensions.  @xref{pagesizes}.
@@ -21022,7 +21038,7 @@
 Pair with @code{@@end smallquotation}.  @xref{small}.
 
 @item @@sp @var{n}
-Skip @var{n} blank lines.  @xref{sp, , @code{@@sp}}.
+Skip @var{n} blank lines.  @address@hidden@@sp}}.
 
 @item @@address@hidden@}
 Generate the German sharp-S es-zet letter, @ss{}.  @xref{Inserting Accents}.
@@ -21117,8 +21133,8 @@
 @TH{}, @th{}.  @xref{Inserting Accents}.
 
 @item @@address@hidden@}
-Generate a normal interword space at which a line break is not allowed.
address@hidden,, @code{@@address@hidden@}}}.
+Generate a normal interword space at which a line break is not
+allowed.  @address@hidden@@tie}}.
 
 @item @@address@hidden@address@hidden
 Generate a tie-after accent over the next two characters @var{cc}, as in
@@ -21244,7 +21260,7 @@
 @code{@@table}, except for indexing.  @address@hidden@@ftable @@vtable}}.
 
 @item @@address@hidden@address@hidden
-Disallow line breaks within @var{text}.  @xref{w, , @code{@@w}}.
+Disallow line breaks within @var{text}.  @address@hidden@@w}}.
 
 @item @@xml
 Enter XML completely.  Pair with @code{@@end xml}.  @xref{Raw
@@ -21927,7 +21943,7 @@
 as:
 
 @example
-$Id: texinfo.txi,v 1.519 2013/01/13 19:13:19 karl Exp $
+$Id: texinfo.txi,v 1.520 2013/01/13 23:23:16 karl Exp $
 @end example
 
 (This is potentially useful in all sources that use version control,