diff options
author | Xue Fuqiao <xfq.free@gmail.com> | 2013-06-09 17:20:49 +0800 |
---|---|---|
committer | Xue Fuqiao <xfq.free@gmail.com> | 2013-06-09 17:20:49 +0800 |
commit | 2bc4a7255ddd60597033cffe9f9cfe93b7523373 (patch) | |
tree | e9a22fe8f4fe7a5b71e512f202afda100ac8e9f7 /doc/emacs/vc1-xtra.texi | |
parent | 04fcf1b047a388b2fb995dbedf635238faca7a58 (diff) | |
download | emacs-2bc4a7255ddd60597033cffe9f9cfe93b7523373.tar.gz |
* doc/emacs/vc1-xtra.texi (Revision Tags): Add a cross reference.
Diffstat (limited to 'doc/emacs/vc1-xtra.texi')
-rw-r--r-- | doc/emacs/vc1-xtra.texi | 37 |
1 files changed, 22 insertions, 15 deletions
diff --git a/doc/emacs/vc1-xtra.texi b/doc/emacs/vc1-xtra.texi index 4e701a580a8..0b109608725 100644 --- a/doc/emacs/vc1-xtra.texi +++ b/doc/emacs/vc1-xtra.texi @@ -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 |