diff options
| author | Joakim Verona | 2013-06-12 23:08:43 +0200 |
|---|---|---|
| committer | Joakim Verona | 2013-06-12 23:08:43 +0200 |
| commit | dd7febaa6c58b6c0163ab0f7344ea70b51614460 (patch) | |
| tree | 903203174d5b80393703f17acecb9affd6ae5dfe /doc | |
| parent | 68e305005fbc03f98e7b2e9808d482a3a80146ea (diff) | |
| parent | 868490bbe111400d4a33e0e4e0ad06e3b096a0ce (diff) | |
| download | emacs-dd7febaa6c58b6c0163ab0f7344ea70b51614460.tar.gz emacs-dd7febaa6c58b6c0163ab0f7344ea70b51614460.zip | |
merge upstream
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/emacs/vc1-xtra.texi | 49 |
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 | ||
| 6 | 2013-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 | |||
| 6 | 2013-06-07 Xue Fuqiao <xfq.free@gmail.com> | 11 | 2013-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, | |||
| 199 | and hg) have a native tag facility, and VC uses it where available; | 199 | and hg) have a native tag facility, and VC uses it where available; |
| 200 | those tags will be visible even when you bypass VC. | 200 | those 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 |
| 203 | to rename its master along with it; the command @code{vc-rename-file} | 203 | file you need to rename its master along with it; the command |
| 204 | will do this automatically. If you are using SCCS, you must also | 204 | @code{vc-rename-file} will do this automatically |
| 205 | update 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}). |
| 207 | master file that no longer exists under the recorded name is invalid; | 207 | @end iftex |
| 208 | VC can no longer retrieve it. It would be beyond the scope of this | 208 | @ifnottex |
| 209 | manual to explain enough about RCS and SCCS to explain how to update | 209 | (@pxref{VC Delete/Rename}). |
| 210 | the tags by hand. Using @code{vc-rename-file} makes the tag remain | 210 | @end ifnottex |
| 211 | valid for retrieval, but it does not solve all problems. For example, | 211 | If you are using SCCS, you must also update the records of the tag, to |
| 212 | some of the files in your program probably refer to others by name. | 212 | mention the file by its new name (@code{vc-rename-file} does this, |
| 213 | At the very least, the makefile probably mentions the file that you | 213 | too). An old tag that refers to a master file that no longer exists |
| 214 | renamed. If you retrieve an old tag, the renamed file is retrieved | 214 | under the recorded name is invalid; VC can no longer retrieve it. It |
| 215 | under its new name, which is not the name that the makefile expects. | 215 | would be beyond the scope of this manual to explain enough about RCS |
| 216 | So the program won't really work as retrieved. | 216 | and 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 | ||
| 218 | does not solve all problems. For example, some of the files in your | ||
| 219 | program probably refer to others by name. At the very least, the | ||
| 220 | makefile probably mentions the file that you renamed. If you retrieve | ||
| 221 | an old tag, the renamed file is retrieved under its new name, which is | ||
| 222 | not the name that the makefile expects. So the program won't really | ||
| 223 | work 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 | |||
| 377 | only about @code{vc-cvs-stay-local}, but everything applies to | 384 | only 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 |
| 381 | the version control status of each file using only the entry in the | 388 | determines the version control status of each file using only the |
| 382 | local CVS subdirectory and the information returned by previous CVS | 389 | entry in the local CVS subdirectory and the information returned by |
| 383 | commands. As a consequence, if you have modified a file and somebody | 390 | previous CVS commands. As a consequence, if you have modified a file |
| 384 | else has checked in other changes, you will not be notified of the | 391 | and somebody else has checked in other changes, you will not be |
| 385 | conflict until you try to commit. | 392 | notified 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 |
| 388 | remote repository @emph{before} it decides what to do in | 395 | remote repository @emph{before} it decides what to do in |