texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       11/02/16 17:41:14

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (anchor, HTML Xref Link Preservation): two approaches to preserving 
links to deleted/renamed nodes

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1211&r2=1.1212
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.367&r2=1.368

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1211
retrieving revision 1.1212
diff -u -b -r1.1211 -r1.1212
--- ChangeLog   14 Feb 2011 19:13:41 -0000      1.1211
+++ ChangeLog   16 Feb 2011 17:41:11 -0000      1.1212
@@ -1,3 +1,8 @@
+2011-02-16  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (anchor, HTML Xref Link Preservation): two
+       approaches to preserving links to deleted/renamed nodes.
+
 2011-02-14  Karl Berry  <address@hidden>
 
        * doc/texinfo.tex (\sectionheading): check that we are not in an

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.367
retrieving revision 1.368
diff -u -b -r1.367 -r1.368
--- doc/texinfo.txi     14 Feb 2011 19:20:19 -0000      1.367
+++ doc/texinfo.txi     16 Feb 2011 17:41:13 -0000      1.368
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.367 2011/02/14 19:20:19 karl Exp $
address@hidden $Id: texinfo.txi,v 1.368 2011/02/16 17:41:13 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.
 
@@ -5442,6 +5442,15 @@
 Also like node names, anchor names cannot include some characters
 (@pxref{Node Line Requirements}).
 
address@hidden Nodes, deleting or renaming
+Because of this duality, when you delete or rename a node, it can be
+useful to retain an @code{@@anchor} with the old name.  That way, any
+links to the old node, whether from other Texinfo manuals or general
+web pages, will still work.  You can also do this with the
address@hidden feature of @command{makeinfo} (@pxref{HTML
+Xref Link Preservation}).  There is no effective difference between
+the two approaches.
+
 
 @node Menus
 @chapter Menus
@@ -18741,6 +18750,9 @@
 indicated with an @samp{@@c} at the beginning of a line, optionally
 preceded by whitespace.
 
+Another approach to preserving links to deleted or renamed nodes is to
+use anchors (@pxref{anchor,, @code{anchor}}).  There is no effective
+difference between the two approaches.
 
 @node texi2any Output Customization
 @chapter @command{texi2any} Output Customization
@@ -23082,7 +23094,7 @@
 (@url{http://www.gnu.org/software/rcs}) version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.367 2011/02/14 19:20:19 karl Exp $
+$Id: texinfo.txi,v 1.368 2011/02/16 17:41:13 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}
@@ -23161,7 +23173,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.367 2011/02/14 19:20:19 karl Exp $
address@hidden $Id: texinfo.txi,v 1.368 2011/02/16 17:41:13 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi