]> git.eshelyaron.com Git - emacs.git/commitdiff
* doc/emacs/vc1-xtra.texi (Revision Tags): Add a cross reference.
authorXue Fuqiao <xfq.free@gmail.com>
Sun, 9 Jun 2013 09:20:49 +0000 (17:20 +0800)
committerXue Fuqiao <xfq.free@gmail.com>
Sun, 9 Jun 2013 09:20:49 +0000 (17:20 +0800)
doc/emacs/ChangeLog
doc/emacs/vc1-xtra.texi

index 079f6f01d9d37ed79dedf5beb0b595bcf5098f5b..31fd58f8048c0f42764d9104525529b1b71db55a 100644 (file)
@@ -1,3 +1,7 @@
+2013-06-09  Xue Fuqiao  <xfq.free@gmail.com>
+
+       * vc1-xtra.texi (Revision Tags): Add a cross reference.
+
 2013-06-07  Xue Fuqiao  <xfq.free@gmail.com>
 
        * maintaining.texi (Branches): Remove text copied from other
index 4e701a580a858c2d6d588050b1f2234cb8b1cf83..0b1096087253689b48aa43153b5f8fb5237b0e3e 100644 (file)
@@ -199,21 +199,28 @@ through VC@.  Most later systems (including CVS, Subversion, bzr, git,
 and hg) have a native tag facility, and VC uses it where available;
 those tags will be visible even when you bypass VC.
 
-  In a file-oriented VCS, when you rename a registered file you need
-to rename its master along with it; the command @code{vc-rename-file}
-will do this automatically.  If you are using SCCS, you must also
-update the records of the tag, to mention the file by its new name
-(@code{vc-rename-file} does this, too).  An old tag that refers to a
-master file that no longer exists under the recorded name is invalid;
-VC can no longer retrieve it.  It would be beyond the scope of this
-manual to explain enough about RCS and SCCS to explain how to update
-the tags by hand.  Using @code{vc-rename-file} makes the tag remain
-valid for retrieval, but it does not solve all problems.  For example,
-some of the files in your program probably refer to others by name.
-At the very least, the makefile probably mentions the file that you
-renamed.  If you retrieve an old tag, the renamed file is retrieved
-under its new name, which is not the name that the makefile expects.
-So the program won't really work as retrieved.
+  In file-based version control systems, when you rename a registered
+file you need to rename its master along with it; the command
+@code{vc-rename-file} will do this automatically
+@iftex
+(@pxref{VC Delete/Rename,,,emacs, the Emacs Manual}).
+@end iftex
+@ifnottex
+(@pxref{VC Delete/Rename}).
+@end ifnottex
+If you are using SCCS, you must also update the records of the tag, to
+mention the file by its new name (@code{vc-rename-file} does this,
+too).  An old tag that refers to a master file that no longer exists
+under the recorded name is invalid; VC can no longer retrieve it.  It
+would be beyond the scope of this manual to explain enough about RCS
+and SCCS to explain how to update the tags by hand.  Using
+@code{vc-rename-file} makes the tag remain valid for retrieval, but it
+does not solve all problems.  For example, some of the files in your
+program probably refer to others by name.  At the very least, the
+makefile probably mentions the file that you renamed.  If you retrieve
+an old tag, the renamed file is retrieved under its new name, which is
+not the name that the makefile expects.  So the program won't really
+work as retrieved.
 
 @node Version Headers
 @subsubsection Inserting Version Control Headers