aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoakim Verona2013-06-12 23:08:43 +0200
committerJoakim Verona2013-06-12 23:08:43 +0200
commitdd7febaa6c58b6c0163ab0f7344ea70b51614460 (patch)
tree903203174d5b80393703f17acecb9affd6ae5dfe /doc
parent68e305005fbc03f98e7b2e9808d482a3a80146ea (diff)
parent868490bbe111400d4a33e0e4e0ad06e3b096a0ce (diff)
downloademacs-dd7febaa6c58b6c0163ab0f7344ea70b51614460.tar.gz
emacs-dd7febaa6c58b6c0163ab0f7344ea70b51614460.zip
merge upstream
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/ChangeLog5
-rw-r--r--doc/emacs/vc1-xtra.texi49
2 files changed, 33 insertions, 21 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 6f2d9517df7..f56f2f51e07 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -3,6 +3,11 @@
3 * maintaining.texi (VC Directory Commands): Copyedit. 3 * maintaining.texi (VC Directory Commands): Copyedit.
4 (Branches): Put back milder version of pre 2013-06-07 text. 4 (Branches): Put back milder version of pre 2013-06-07 text.
5 5
62013-06-09 Xue Fuqiao <xfq.free@gmail.com>
7
8 * vc1-xtra.texi (Revision Tags): Add a cross reference.
9 (CVS Options): Fix the default value of `vc-cvs-stay-local'.
10
62013-06-07 Xue Fuqiao <xfq.free@gmail.com> 112013-06-07 Xue Fuqiao <xfq.free@gmail.com>
7 12
8 * maintaining.texi (Branches): Remove text copied from other sources. 13 * maintaining.texi (Branches): Remove text copied from other sources.
diff --git a/doc/emacs/vc1-xtra.texi b/doc/emacs/vc1-xtra.texi
index 4e701a580a8..96e171855a5 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,
199and hg) have a native tag facility, and VC uses it where available; 199and hg) have a native tag facility, and VC uses it where available;
200those tags will be visible even when you bypass VC. 200those tags will be visible even when you bypass VC.
201 201
202 In a file-oriented VCS, when you rename a registered file you need 202 In file-based version control systems, when you rename a registered
203to rename its master along with it; the command @code{vc-rename-file} 203file you need to rename its master along with it; the command
204will do this automatically. If you are using SCCS, you must also 204@code{vc-rename-file} will do this automatically
205update the records of the tag, to mention the file by its new name 205@iftex
206(@code{vc-rename-file} does this, too). An old tag that refers to a 206(@pxref{VC Delete/Rename,,,emacs, the Emacs Manual}).
207master file that no longer exists under the recorded name is invalid; 207@end iftex
208VC can no longer retrieve it. It would be beyond the scope of this 208@ifnottex
209manual to explain enough about RCS and SCCS to explain how to update 209(@pxref{VC Delete/Rename}).
210the tags by hand. Using @code{vc-rename-file} makes the tag remain 210@end ifnottex
211valid for retrieval, but it does not solve all problems. For example, 211If you are using SCCS, you must also update the records of the tag, to
212some of the files in your program probably refer to others by name. 212mention the file by its new name (@code{vc-rename-file} does this,
213At the very least, the makefile probably mentions the file that you 213too). An old tag that refers to a master file that no longer exists
214renamed. If you retrieve an old tag, the renamed file is retrieved 214under the recorded name is invalid; VC can no longer retrieve it. It
215under its new name, which is not the name that the makefile expects. 215would be beyond the scope of this manual to explain enough about RCS
216So the program won't really work as retrieved. 216and SCCS to explain how to update the tags by hand. Using
217@code{vc-rename-file} makes the tag remain valid for retrieval, but it
218does not solve all problems. For example, some of the files in your
219program probably refer to others by name. At the very least, the
220makefile probably mentions the file that you renamed. If you retrieve
221an old tag, the renamed file is retrieved under its new name, which is
222not the name that the makefile expects. So the program won't really
223work as retrieved.
217 224
218@node Version Headers 225@node Version Headers
219@subsubsection Inserting Version Control Headers 226@subsubsection Inserting Version Control Headers
@@ -377,12 +384,12 @@ ends that support it, including CVS@. In the following, we will talk
377only about @code{vc-cvs-stay-local}, but everything applies to 384only about @code{vc-cvs-stay-local}, but everything applies to
378@code{vc-stay-local} as well. 385@code{vc-stay-local} as well.
379 386
380 If @code{vc-cvs-stay-local} is @code{t} (the default), VC determines 387 If @code{vc-cvs-stay-local} is @code{only-file} (the default), VC
381the version control status of each file using only the entry in the 388determines the version control status of each file using only the
382local CVS subdirectory and the information returned by previous CVS 389entry in the local CVS subdirectory and the information returned by
383commands. As a consequence, if you have modified a file and somebody 390previous CVS commands. As a consequence, if you have modified a file
384else has checked in other changes, you will not be notified of the 391and somebody else has checked in other changes, you will not be
385conflict until you try to commit. 392notified of the conflict until you try to commit.
386 393
387 If you change @code{vc-cvs-stay-local} to @code{nil}, VC queries the 394 If you change @code{vc-cvs-stay-local} to @code{nil}, VC queries the
388remote repository @emph{before} it decides what to do in 395remote repository @emph{before} it decides what to do in