aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2018-02-16 23:37:38 +0200
committerEli Zaretskii2018-02-16 23:37:38 +0200
commit5906418b5b627245dc79137bbf2b41c59b6ba211 (patch)
treef2c758c28b383c756e3bbd14f6ef831db80ef7be
parenta06a8ed5b66883202ae7182471570dfcabcea973 (diff)
downloademacs-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.texi57
-rw-r--r--doc/emacs/vc1-xtra.texi7
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
61commands work with several different version control systems; 61commands work with several different version control systems;
62currently, it supports Bazaar, CVS, Git, Mercurial, Monotone, RCS, 62currently, it supports Bazaar, CVS, Git, Mercurial, Monotone, RCS,
63SCCS/CSSC, and Subversion. Of these, the GNU project distributes CVS, 63SRC, SCCS/CSSC, and Subversion. Of these, the GNU project distributes
64RCS, and Bazaar. 64CVS, 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
67version control system. To disable VC entirely, set the customizable 67version control system. To disable VC entirely, set the customizable
@@ -80,9 +80,7 @@ current buffer, use the command @code{vc-refresh-state}. This command
80is useful when you perform version control commands outside Emacs 80is 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
82different version control system, or remove it from version control 82different version control system, or remove it from version control
83entirely. A companion command @code{vc-state-refresh} does the same, 83entirely.
84but does not consider switching the version control system or removal
85from 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
188CVS is the free version control system that was, until recently (circa 186CVS is the free version control system that was, until circa 2008,
1892008), used by the majority of free software projects. Nowadays, it 187used by the majority of free software projects. Since then, it has
190is slowly being superseded by newer systems. CVS allows concurrent 188been superseded by newer systems. CVS allows concurrent multi-user
191multi-user development either locally or over the network. Unlike 189development either locally or over the network. Unlike newer systems,
192newer systems, it lacks support for atomic commits and file 190it lacks support for atomic commits and file moving/renaming. VC
193moving/renaming. VC supports all basic editing operations under CVS. 191supports 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
326control operations are @dfn{file-based}: each file has its own comment 324in SRC), version control operations are @dfn{file-based}: each file
327and revision history separate from that of all other files. Newer 325has its own comment and revision history separate from that of all
328systems, beginning with Subversion, are @dfn{changeset-based}: a 326other files. Newer systems, beginning with Subversion, are
329commit may include changes to several files, and the entire set of 327@dfn{changeset-based}: a commit may include changes to several files,
330changes is handled as a unit. Any comment associated with the change 328and the entire set of changes is handled as a unit. Any comment
331does not belong to a single file, but to the changeset itself. 329associated with the change does not belong to a single file, but to
330the 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
347used by all developers. SCCS, RCS, CVS, and Subversion share this 346used by all developers. SCCS, RCS, CVS, Subversion, and SRC share this
348kind of model. One of its drawbacks is that the repository is a choke 347kind of model. One of its drawbacks is that the repository is a choke
349point for reliability and efficiency. 348point 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
526commit. @xref{Log Buffer}. 525commit. @xref{Log Buffer}.
527 526
528If committing to a shared repository, the commit may fail if the 527If committing to a shared repository, the commit may fail if the
529repository that has been changed since your last update. In that 528repository has been changed since your last update. In that
530case, you must perform an update before trying again. On a 529case, you must perform an update before trying again. On a
531decentralized version control system, use @kbd{C-x v +} 530decentralized 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,
609and Emacs fails to detect the correct one. 608and Emacs fails to detect the correct one.
610 609
611@item 610@item
612Otherwise, if using CVS or RCS, you can specify a revision ID. 611Otherwise, if using CVS, RCS or SRC, you can specify a revision ID.
613 612
614If the fileset is modified (or locked), this makes Emacs commit with 613If the fileset is modified (or locked), this makes Emacs commit with
615that revision ID@. You can create a new branch by supplying an 614that 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
972version-controlled directory tree (RCS, SCCS, and CVS do not support 971version-controlled directory tree (RCS, SCCS, CVS, and SRC do not
973this feature). With a prefix argument, the command prompts for the 972support this feature). With a prefix argument, the command prompts
974maximum number of revisions to display. 973for 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
977showing only the first line of each log entry. However, you can type 976showing 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
1048increase the number of revisions shown in an existing 1047increase 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
1050entries} or @samp{Show unlimited entries} buttons at the end of the 1049entries} or @samp{Show unlimited entries} buttons at the end of the
1051buffer. However, RCS, SCCS, and CVS do not support this feature. 1050buffer. 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
1189control (@pxref{Registering}). 1188control (@pxref{Registering}).
1190 1189
1191The @samp{*} characters next to the entries for @file{README} and 1190The @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
1193the current VC fileset 1192the 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
1280files and directories. 1279files and directories.
1281 1280
1282@item x 1281@item x
1283Hide files with @samp{up-to-date} status 1282Hide 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
1285whose state is that of the item at point. 1284whose 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}.
1352context menu invoked by @kbd{mouse-2}. Furthermore, some VC backends 1351context menu invoked by @kbd{mouse-2}. Furthermore, some VC backends
1353use the menu to provide extra backend-specific commands. For example, 1352use the menu to provide extra backend-specific commands. For example,
1354Git and Bazaar allow you to manipulate @dfn{stashes} and @dfn{shelves} 1353Git 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
1356bring them back at a later time). 1355bring them back at a later time).
1357 1356
1358@node Branches 1357@node Branches
@@ -1517,7 +1516,7 @@ is shown in a separate buffer.
1517prompts for a branch ID, or a pair of revision IDs (@pxref{Switching 1516prompts for a branch ID, or a pair of revision IDs (@pxref{Switching
1518Branches}); then it finds the changes from that branch, or the changes 1517Branches}); then it finds the changes from that branch, or the changes
1519between the two revisions you specified, and merges those changes into 1518between the two revisions you specified, and merges those changes into
1520the current VC fileset. If you just type @key{RET}, Emacs simply 1519the current VC fileset. If you just type @kbd{@key{RET}}, Emacs simply
1521merges any changes that were made on the same branch since you checked 1520merges any changes that were made on the same branch since you checked
1522the file out. 1521the 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
113schedule the deletion for committing. 113schedule the deletion for committing.
114 114
115@item M-x vc-rename-file 115@item M-x vc-rename-file
116Prompt for two file names, @var{var} and @var{old}, rename them in the 116Prompt for two file names, @var{old} and @var{new}, rename them in the
117working tree, and schedule the renaming for committing. 117working tree, and schedule the renaming for committing. The @var{old}
118file 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
270control systems VC should handle. The default value is @code{(RCS CVS 271control systems VC should handle. The default value is @code{(RCS CVS
271SVN SCCS Bzr Git Hg Mtn Arch)}, so it contains all the version systems 272SVN SCCS SRC Bzr Git Hg Mtn)}, so it contains all the version systems
272that are currently supported. If you want VC to ignore one or more of 273that are currently supported. If you want VC to ignore one or more of
273these systems, exclude its name from the list. To disable VC 274these systems, exclude its name from the list. To disable VC
274entirely, set this variable to @code{nil}. 275entirely, set this variable to @code{nil}.