diff options
| author | Eli Zaretskii | 2018-02-16 23:37:38 +0200 |
|---|---|---|
| committer | Eli Zaretskii | 2018-02-16 23:37:38 +0200 |
| commit | 5906418b5b627245dc79137bbf2b41c59b6ba211 (patch) | |
| tree | f2c758c28b383c756e3bbd14f6ef831db80ef7be | |
| parent | a06a8ed5b66883202ae7182471570dfcabcea973 (diff) | |
| download | emacs-5906418b5b627245dc79137bbf2b41c59b6ba211.tar.gz emacs-5906418b5b627245dc79137bbf2b41c59b6ba211.zip | |
More fixes for the Emacs manual
* doc/emacs/vc1-xtra.texi (Customizing VC): Update the list of
backends.
* doc/emacs/maintaining.texi (Version Control): Add SRC to the
list of VCS. Remove the description of vc-state-refresh.
(Version Control Systems): Update the description of CVS.
(VC Change Log): Amend the list of VCS that don't support
vc0print-root-log.
(VCS Changesets, VCS Repositories, Advanced C-x v v)
(VC Change Log): Mention SRC with RCS where appropriate.
(VC Directory Commands): More accurate description of
vc-dir-hide-up-to-date. Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
| -rw-r--r-- | doc/emacs/maintaining.texi | 57 | ||||
| -rw-r--r-- | doc/emacs/vc1-xtra.texi | 7 |
2 files changed, 32 insertions, 32 deletions
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi index 1234db84b2f..e806b270f69 100644 --- a/doc/emacs/maintaining.texi +++ b/doc/emacs/maintaining.texi | |||
| @@ -60,8 +60,8 @@ changed. | |||
| 60 | The Emacs version control interface is called @dfn{VC}@. VC | 60 | The Emacs version control interface is called @dfn{VC}@. VC |
| 61 | commands work with several different version control systems; | 61 | commands work with several different version control systems; |
| 62 | currently, it supports Bazaar, CVS, Git, Mercurial, Monotone, RCS, | 62 | currently, it supports Bazaar, CVS, Git, Mercurial, Monotone, RCS, |
| 63 | SCCS/CSSC, and Subversion. Of these, the GNU project distributes CVS, | 63 | SRC, SCCS/CSSC, and Subversion. Of these, the GNU project distributes |
| 64 | RCS, and Bazaar. | 64 | CVS, RCS, and Bazaar. |
| 65 | 65 | ||
| 66 | VC is enabled automatically whenever you visit a file governed by a | 66 | VC is enabled automatically whenever you visit a file governed by a |
| 67 | version control system. To disable VC entirely, set the customizable | 67 | version control system. To disable VC entirely, set the customizable |
| @@ -80,9 +80,7 @@ current buffer, use the command @code{vc-refresh-state}. This command | |||
| 80 | is useful when you perform version control commands outside Emacs | 80 | is useful when you perform version control commands outside Emacs |
| 81 | (e.g., from the shell prompt), or if you put the buffer's file under a | 81 | (e.g., from the shell prompt), or if you put the buffer's file under a |
| 82 | different version control system, or remove it from version control | 82 | different version control system, or remove it from version control |
| 83 | entirely. A companion command @code{vc-state-refresh} does the same, | 83 | entirely. |
| 84 | but does not consider switching the version control system or removal | ||
| 85 | from VC. | ||
| 86 | 84 | ||
| 87 | @menu | 85 | @menu |
| 88 | * Introduction to VC:: How version control works in general. | 86 | * Introduction to VC:: How version control works in general. |
| @@ -185,12 +183,12 @@ everything you can do with RCS can be done through VC. | |||
| 185 | 183 | ||
| 186 | @cindex CVS | 184 | @cindex CVS |
| 187 | @item | 185 | @item |
| 188 | CVS is the free version control system that was, until recently (circa | 186 | CVS is the free version control system that was, until circa 2008, |
| 189 | 2008), used by the majority of free software projects. Nowadays, it | 187 | used by the majority of free software projects. Since then, it has |
| 190 | is slowly being superseded by newer systems. CVS allows concurrent | 188 | been superseded by newer systems. CVS allows concurrent multi-user |
| 191 | multi-user development either locally or over the network. Unlike | 189 | development either locally or over the network. Unlike newer systems, |
| 192 | newer systems, it lacks support for atomic commits and file | 190 | it lacks support for atomic commits and file moving/renaming. VC |
| 193 | moving/renaming. VC supports all basic editing operations under CVS. | 191 | supports all basic editing operations under CVS. |
| 194 | 192 | ||
| 195 | @cindex SVN | 193 | @cindex SVN |
| 196 | @cindex Subversion | 194 | @cindex Subversion |
| @@ -322,13 +320,14 @@ possible. | |||
| 322 | @subsubsection Changeset-based vs File-based Version Control | 320 | @subsubsection Changeset-based vs File-based Version Control |
| 323 | 321 | ||
| 324 | @cindex file-based version control | 322 | @cindex file-based version control |
| 325 | On SCCS, RCS, CVS, and other early version control systems, version | 323 | On SCCS, RCS, CVS, and other early version control systems (and also |
| 326 | control operations are @dfn{file-based}: each file has its own comment | 324 | in SRC), version control operations are @dfn{file-based}: each file |
| 327 | and revision history separate from that of all other files. Newer | 325 | has its own comment and revision history separate from that of all |
| 328 | systems, beginning with Subversion, are @dfn{changeset-based}: a | 326 | other files. Newer systems, beginning with Subversion, are |
| 329 | commit may include changes to several files, and the entire set of | 327 | @dfn{changeset-based}: a commit may include changes to several files, |
| 330 | changes is handled as a unit. Any comment associated with the change | 328 | and the entire set of changes is handled as a unit. Any comment |
| 331 | does not belong to a single file, but to the changeset itself. | 329 | associated with the change does not belong to a single file, but to |
| 330 | the changeset itself. | ||
| 332 | 331 | ||
| 333 | @cindex changeset-based version control | 332 | @cindex changeset-based version control |
| 334 | Changeset-based version control is more flexible and powerful than | 333 | Changeset-based version control is more flexible and powerful than |
| @@ -344,7 +343,7 @@ all of it. | |||
| 344 | @cindex distributed version control | 343 | @cindex distributed version control |
| 345 | Early version control systems were designed around a | 344 | Early version control systems were designed around a |
| 346 | @dfn{centralized} model in which each project has only one repository | 345 | @dfn{centralized} model in which each project has only one repository |
| 347 | used by all developers. SCCS, RCS, CVS, and Subversion share this | 346 | used by all developers. SCCS, RCS, CVS, Subversion, and SRC share this |
| 348 | kind of model. One of its drawbacks is that the repository is a choke | 347 | kind of model. One of its drawbacks is that the repository is a choke |
| 349 | point for reliability and efficiency. | 348 | point for reliability and efficiency. |
| 350 | 349 | ||
| @@ -526,7 +525,7 @@ desired log entry for the new revision, followed by @kbd{C-c C-c} to | |||
| 526 | commit. @xref{Log Buffer}. | 525 | commit. @xref{Log Buffer}. |
| 527 | 526 | ||
| 528 | If committing to a shared repository, the commit may fail if the | 527 | If committing to a shared repository, the commit may fail if the |
| 529 | repository that has been changed since your last update. In that | 528 | repository has been changed since your last update. In that |
| 530 | case, you must perform an update before trying again. On a | 529 | case, you must perform an update before trying again. On a |
| 531 | decentralized version control system, use @kbd{C-x v +} | 530 | decentralized version control system, use @kbd{C-x v +} |
| 532 | (@pxref{Pulling / Pushing}) or @kbd{C-x v m} (@pxref{Merging}). | 531 | (@pxref{Pulling / Pushing}) or @kbd{C-x v m} (@pxref{Merging}). |
| @@ -609,7 +608,7 @@ if the fileset can be managed by more than one version control system, | |||
| 609 | and Emacs fails to detect the correct one. | 608 | and Emacs fails to detect the correct one. |
| 610 | 609 | ||
| 611 | @item | 610 | @item |
| 612 | Otherwise, if using CVS or RCS, you can specify a revision ID. | 611 | Otherwise, if using CVS, RCS or SRC, you can specify a revision ID. |
| 613 | 612 | ||
| 614 | If the fileset is modified (or locked), this makes Emacs commit with | 613 | If the fileset is modified (or locked), this makes Emacs commit with |
| 615 | that revision ID@. You can create a new branch by supplying an | 614 | that revision ID@. You can create a new branch by supplying an |
| @@ -969,9 +968,9 @@ file listed on the current line. | |||
| 969 | @findex log-view-toggle-entry-display | 968 | @findex log-view-toggle-entry-display |
| 970 | @kbd{C-x v L} (@code{vc-print-root-log}) displays a | 969 | @kbd{C-x v L} (@code{vc-print-root-log}) displays a |
| 971 | @file{*vc-change-log*} buffer showing the history of the entire | 970 | @file{*vc-change-log*} buffer showing the history of the entire |
| 972 | version-controlled directory tree (RCS, SCCS, and CVS do not support | 971 | version-controlled directory tree (RCS, SCCS, CVS, and SRC do not |
| 973 | this feature). With a prefix argument, the command prompts for the | 972 | support this feature). With a prefix argument, the command prompts |
| 974 | maximum number of revisions to display. | 973 | for the maximum number of revisions to display. |
| 975 | 974 | ||
| 976 | The @kbd{C-x v L} history is shown in a compact form, usually | 975 | The @kbd{C-x v L} history is shown in a compact form, usually |
| 977 | showing only the first line of each log entry. However, you can type | 976 | showing only the first line of each log entry. However, you can type |
| @@ -1048,7 +1047,7 @@ if you set the value to zero, that removes the limit. You can also | |||
| 1048 | increase the number of revisions shown in an existing | 1047 | increase the number of revisions shown in an existing |
| 1049 | @file{*vc-change-log*} buffer by clicking on the @samp{Show 2X | 1048 | @file{*vc-change-log*} buffer by clicking on the @samp{Show 2X |
| 1050 | entries} or @samp{Show unlimited entries} buttons at the end of the | 1049 | entries} or @samp{Show unlimited entries} buttons at the end of the |
| 1051 | buffer. However, RCS, SCCS, and CVS do not support this feature. | 1050 | buffer. However, RCS, SCCS, CVS, and SRC do not support this feature. |
| 1052 | 1051 | ||
| 1053 | @kindex C-x v h | 1052 | @kindex C-x v h |
| 1054 | @findex vc-region-history | 1053 | @findex vc-region-history |
| @@ -1189,7 +1188,7 @@ but is not yet committed, while @file{temp.txt} is not under version | |||
| 1189 | control (@pxref{Registering}). | 1188 | control (@pxref{Registering}). |
| 1190 | 1189 | ||
| 1191 | The @samp{*} characters next to the entries for @file{README} and | 1190 | The @samp{*} characters next to the entries for @file{README} and |
| 1192 | @file{src/main.c} indicate that the user has marked out these files as | 1191 | @file{src/main.c} indicate that the user has marked these files as |
| 1193 | the current VC fileset | 1192 | the current VC fileset |
| 1194 | @iftex | 1193 | @iftex |
| 1195 | (see below). | 1194 | (see below). |
| @@ -1280,7 +1279,7 @@ point is on a directory entry, unmark all files in that directory tree | |||
| 1280 | files and directories. | 1279 | files and directories. |
| 1281 | 1280 | ||
| 1282 | @item x | 1281 | @item x |
| 1283 | Hide files with @samp{up-to-date} status | 1282 | Hide files with @samp{up-to-date} or @samp{ignored} status |
| 1284 | (@code{vc-dir-hide-up-to-date}). With a prefix argument, hide items | 1283 | (@code{vc-dir-hide-up-to-date}). With a prefix argument, hide items |
| 1285 | whose state is that of the item at point. | 1284 | whose state is that of the item at point. |
| 1286 | @end table | 1285 | @end table |
| @@ -1352,7 +1351,7 @@ Switch to a branch (@code{vc-retrieve-tag}). @xref{Switching Branches}. | |||
| 1352 | context menu invoked by @kbd{mouse-2}. Furthermore, some VC backends | 1351 | context menu invoked by @kbd{mouse-2}. Furthermore, some VC backends |
| 1353 | use the menu to provide extra backend-specific commands. For example, | 1352 | use the menu to provide extra backend-specific commands. For example, |
| 1354 | Git and Bazaar allow you to manipulate @dfn{stashes} and @dfn{shelves} | 1353 | Git and Bazaar allow you to manipulate @dfn{stashes} and @dfn{shelves} |
| 1355 | (where are a way to temporarily put aside uncommitted changes, and | 1354 | (which are a way to temporarily put aside uncommitted changes, and |
| 1356 | bring them back at a later time). | 1355 | bring them back at a later time). |
| 1357 | 1356 | ||
| 1358 | @node Branches | 1357 | @node Branches |
| @@ -1517,7 +1516,7 @@ is shown in a separate buffer. | |||
| 1517 | prompts for a branch ID, or a pair of revision IDs (@pxref{Switching | 1516 | prompts for a branch ID, or a pair of revision IDs (@pxref{Switching |
| 1518 | Branches}); then it finds the changes from that branch, or the changes | 1517 | Branches}); then it finds the changes from that branch, or the changes |
| 1519 | between the two revisions you specified, and merges those changes into | 1518 | between the two revisions you specified, and merges those changes into |
| 1520 | the current VC fileset. If you just type @key{RET}, Emacs simply | 1519 | the current VC fileset. If you just type @kbd{@key{RET}}, Emacs simply |
| 1521 | merges any changes that were made on the same branch since you checked | 1520 | merges any changes that were made on the same branch since you checked |
| 1522 | the file out. | 1521 | the file out. |
| 1523 | 1522 | ||
diff --git a/doc/emacs/vc1-xtra.texi b/doc/emacs/vc1-xtra.texi index 7a4b8e47019..35dd6d1235a 100644 --- a/doc/emacs/vc1-xtra.texi +++ b/doc/emacs/vc1-xtra.texi | |||
| @@ -113,8 +113,9 @@ Prompt for a file name, delete the file from the working tree, and | |||
| 113 | schedule the deletion for committing. | 113 | schedule the deletion for committing. |
| 114 | 114 | ||
| 115 | @item M-x vc-rename-file | 115 | @item M-x vc-rename-file |
| 116 | Prompt for two file names, @var{var} and @var{old}, rename them in the | 116 | Prompt for two file names, @var{old} and @var{new}, rename them in the |
| 117 | working tree, and schedule the renaming for committing. | 117 | working tree, and schedule the renaming for committing. The @var{old} |
| 118 | file defaults to the current buffer's file name if it is under VC. | ||
| 118 | @end table | 119 | @end table |
| 119 | 120 | ||
| 120 | @findex vc-delete-file | 121 | @findex vc-delete-file |
| @@ -268,7 +269,7 @@ with the file's version control type. | |||
| 268 | @vindex vc-handled-backends | 269 | @vindex vc-handled-backends |
| 269 | The variable @code{vc-handled-backends} determines which version | 270 | The variable @code{vc-handled-backends} determines which version |
| 270 | control systems VC should handle. The default value is @code{(RCS CVS | 271 | control systems VC should handle. The default value is @code{(RCS CVS |
| 271 | SVN SCCS Bzr Git Hg Mtn Arch)}, so it contains all the version systems | 272 | SVN SCCS SRC Bzr Git Hg Mtn)}, so it contains all the version systems |
| 272 | that are currently supported. If you want VC to ignore one or more of | 273 | that are currently supported. If you want VC to ignore one or more of |
| 273 | these systems, exclude its name from the list. To disable VC | 274 | these systems, exclude its name from the list. To disable VC |
| 274 | entirely, set this variable to @code{nil}. | 275 | entirely, set this variable to @code{nil}. |