aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLuc Teirlinck2005-03-27 02:17:27 +0000
committerLuc Teirlinck2005-03-27 02:17:27 +0000
commita0554a40e2efd9352e185fbb3af48811a8e4044c (patch)
treed50fdee431e942a779e99f129256624273b0ffa0
parent99a5658144bce7733e48d9c1877b2795afc1aa9d (diff)
downloademacs-a0554a40e2efd9352e185fbb3af48811a8e4044c.tar.gz
emacs-a0554a40e2efd9352e185fbb3af48811a8e4044c.zip
Several small changes in addition to:
(Visiting): Change xref for Dialog Boxes to ref. (Version Headers): Replace references to obsolete var `vc-header-alist' with `vc-BACKEND-header'. (Customizing VC): Update value of `vc-handled-backends'.
-rw-r--r--man/files.texi59
1 files changed, 30 insertions, 29 deletions
diff --git a/man/files.texi b/man/files.texi
index 1e40651a4ce..8f5bf596238 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -238,7 +238,7 @@ or tool bar) use the toolkit's standard File Selection dialog instead
238of prompting for the file name in the minibuffer. On Unix and 238of prompting for the file name in the minibuffer. On Unix and
239GNU/Linux platforms, Emacs does that when built with GTK, LessTif, and 239GNU/Linux platforms, Emacs does that when built with GTK, LessTif, and
240Motif toolkits; on MS-Windows, the GUI version does that by default. 240Motif toolkits; on MS-Windows, the GUI version does that by default.
241For information on how to customize this, see @xref{Dialog Boxes}. 241For information on how to customize this, see @ref{Dialog Boxes}.
242 242
243 Secondly, Emacs supports the ``drag and drop'' protocol on the X 243 Secondly, Emacs supports the ``drag and drop'' protocol on the X
244window system. Dropping a file into an ordinary Emacs window visits 244window system. Dropping a file into an ordinary Emacs window visits
@@ -1272,6 +1272,10 @@ as multiple branches, are not available with SCCS. You should use
1272SCCS only if for some reason you cannot use RCS, or one of the 1272SCCS only if for some reason you cannot use RCS, or one of the
1273higher-level systems such as CVS or GNU Arch. 1273higher-level systems such as CVS or GNU Arch.
1274 1274
1275In the following, we discuss mainly RCS, SCCS and CVS. Nearly
1276everything said about CVS applies to Gnu Arch, Subversion and Meta-CVS
1277as well.
1278
1275@node VC Concepts 1279@node VC Concepts
1276@subsubsection Concepts of Version Control 1280@subsubsection Concepts of Version Control
1277 1281
@@ -1472,9 +1476,9 @@ informs you if another user has checked in changes in the same file
1472since you began editing it, and when this happens, his changes will be 1476since you began editing it, and when this happens, his changes will be
1473effectively removed when you check in your version (though they will 1477effectively removed when you check in your version (though they will
1474remain in the master file, so they will not be entirely lost). You must 1478remain in the master file, so they will not be entirely lost). You must
1475therefore verify the current version is unchanged, before you check in your 1479therefore verify that the current version is unchanged, before you
1476changes. We hope to eliminate this risk and provide automatic merging 1480check in your changes. We hope to eliminate this risk and provide
1477with RCS in a future Emacs version. 1481automatic merging with RCS in a future Emacs version.
1478 1482
1479 In addition, locking is possible with RCS even in this mode, although 1483 In addition, locking is possible with RCS even in this mode, although
1480it is not required; @kbd{C-x v v} with an unmodified file locks the 1484it is not required; @kbd{C-x v v} with an unmodified file locks the
@@ -1698,13 +1702,10 @@ there is more than one system in use for a directory, Emacs uses the one
1698that appears first in @code{vc-handled-backends} (@pxref{Customizing VC}). 1702that appears first in @code{vc-handled-backends} (@pxref{Customizing VC}).
1699On the other hand, if there are no files already registered, 1703On the other hand, if there are no files already registered,
1700Emacs uses the first system from @code{vc-handled-backends} that could 1704Emacs uses the first system from @code{vc-handled-backends} that could
1701register the file---for example, you cannot register a file under CVS if 1705register the file (for example, you cannot register a file under CVS if
1702its directory is not already part of a CVS tree. 1706its directory is not already part of a CVS tree); with the default
1703 1707value of @code{vc-handled-backends}, this means that Emacs uses RCS in
1704 With the default value of @code{vc-handled-backends}, this means 1708this situation.
1705that Emacs uses RCS if there are any files under RCS control, CVS if
1706there are any files under CVS, SCCS if any files are under SCCS, or
1707RCS as the ultimate default.
1708 1709
1709 If locking is in use, @kbd{C-x v i} leaves the file unlocked and 1710 If locking is in use, @kbd{C-x v i} leaves the file unlocked and
1710read-only. Type @kbd{C-x v v} if you wish to start editing it. After 1711read-only. Type @kbd{C-x v v} if you wish to start editing it. After
@@ -1892,7 +1893,8 @@ marked files, so that you can lock or check in several files at once.
1892If it operates on more than one file, it handles each file according to 1893If it operates on more than one file, it handles each file according to
1893its current state; thus, it might lock one file, but check in another 1894its current state; thus, it might lock one file, but check in another
1894file. This could be confusing; it is up to you to avoid confusing 1895file. This could be confusing; it is up to you to avoid confusing
1895behavior by marking a set of files that are in a similar state. 1896behavior by marking a set of files that are in a similar state. If no
1897files are marked, @kbd{v v} operates on the file in the current line.
1896 1898
1897 If any files call for check-in, @kbd{v v} reads a single log entry, 1899 If any files call for check-in, @kbd{v v} reads a single log entry,
1898then uses it for all the files being checked in. This is convenient for 1900then uses it for all the files being checked in. This is convenient for
@@ -1920,8 +1922,7 @@ program in which you are gradually adding various unfinished new
1920features. Each such independent line of development is called a 1922features. Each such independent line of development is called a
1921@dfn{branch}. VC allows you to create branches, switch between 1923@dfn{branch}. VC allows you to create branches, switch between
1922different branches, and merge changes from one branch to another. 1924different branches, and merge changes from one branch to another.
1923Please note, however, that branches are only supported for RCS at the 1925Please note, however, that branches are not supported for SCCS.
1924moment.
1925 1926
1926 A file's main line of development is usually called the @dfn{trunk}. 1927 A file's main line of development is usually called the @dfn{trunk}.
1927The versions on the trunk are normally numbered 1.1, 1.2, 1.3, etc. At 1928The versions on the trunk are normally numbered 1.1, 1.2, 1.3, etc. At
@@ -2264,7 +2265,8 @@ But if you do this, the revision numbers in the RCS master no longer
2264correspond to those of CVS. Technically, this is not a problem, but 2265correspond to those of CVS. Technically, this is not a problem, but
2265it can become difficult to keep track of what is in the CVS repository 2266it can become difficult to keep track of what is in the CVS repository
2266and what is not. So we suggest that you return from time to time to 2267and what is not. So we suggest that you return from time to time to
2267CVS-only operation, using @kbd{C-u C-x v v cvs @key{RET}}. 2268CVS-only operation, by committing your local changes back to the
2269repository using @kbd{C-u C-x v v cvs @key{RET}}.
2268 2270
2269@node Snapshots 2271@node Snapshots
2270@subsection Snapshots 2272@subsection Snapshots
@@ -2552,13 +2554,11 @@ insert a suitable header string.
2552Insert headers in a file for use with your version-control system. 2554Insert headers in a file for use with your version-control system.
2553@end table 2555@end table
2554 2556
2555@vindex vc-header-alist 2557@vindex vc-@var{backend}-header
2556 The default header string is @samp{@w{$}Id$} for RCS and 2558 The default header string is @samp{@w{$}Id$} for RCS and
2557@samp{@w{%}W%} for SCCS. You can specify other headers to insert by 2559@samp{@w{%}W%} for SCCS. You can specify other headers to insert by
2558setting the variable @code{vc-header-alist}. Its value is a list of 2560setting the variables @code{vc-@var{backend}-header} where
2559elements of the form @code{(@var{program} . @var{string})} where 2561@var{backend} is @code{rcs} or @code{sccs}.
2560@var{program} is @code{RCS} or @code{SCCS} and @var{string} is the
2561string to use.
2562 2562
2563 Instead of a single string, you can specify a list of strings; then 2563 Instead of a single string, you can specify a list of strings; then
2564each string in the list is inserted as a separate header on a line of 2564each string in the list is inserted as a separate header on a line of
@@ -2586,8 +2586,8 @@ elements of the form @code{(@var{regexp} . @var{format})}. Whenever
2586@var{regexp} matches the buffer name, @var{format} is inserted as part 2586@var{regexp} matches the buffer name, @var{format} is inserted as part
2587of the header. A header line is inserted for each element that matches 2587of the header. A header line is inserted for each element that matches
2588the buffer name, and for each string specified by 2588the buffer name, and for each string specified by
2589@code{vc-header-alist}. The header line is made by processing the 2589@code{vc-@var{backend}-header}. The header line is made by processing the
2590string from @code{vc-header-alist} with the format taken from the 2590string from @code{vc-@var{backend}-header} with the format taken from the
2591element. The default value for @code{vc-static-header-alist} is as follows: 2591element. The default value for @code{vc-static-header-alist} is as follows:
2592 2592
2593@example 2593@example
@@ -2624,10 +2624,10 @@ headers.
2624@vindex vc-handled-backends 2624@vindex vc-handled-backends
2625The variable @code{vc-handled-backends} determines which version 2625The variable @code{vc-handled-backends} determines which version
2626control systems VC should handle. The default value is @code{(RCS CVS 2626control systems VC should handle. The default value is @code{(RCS CVS
2627SCCS)}, so it contains all three version systems that are currently 2627SVN SCCS Arch MCVS)}, so it contains all six version systems that are
2628supported. If you want VC to ignore one or more of these systems, 2628currently supported. If you want VC to ignore one or more of these
2629exclude its name from the list. To disable VC entirely, set this 2629systems, exclude its name from the list. To disable VC entirely, set
2630variable to @code{nil}. 2630this variable to @code{nil}.
2631 2631
2632The order of systems in the list is significant: when you visit a file 2632The order of systems in the list is significant: when you visit a file
2633registered in more than one system (@pxref{Local Version Control}), 2633registered in more than one system (@pxref{Local Version Control}),
@@ -2780,8 +2780,9 @@ pick up any recent changes from the repository first, using @kbd{C-x v m
2780@key{RET}}, @pxref{Merging}). 2780@key{RET}}, @pxref{Merging}).
2781 2781
2782@vindex vc-cvs-global-switches 2782@vindex vc-cvs-global-switches
2783 The variable @code{vc-cvs-global-switches} should be a string 2783 The variable @code{vc-cvs-global-switches}, if non-@code{nil},
2784specifying switches to pass to CVS for all CVS operations. 2784should be a string specifying switches to pass to CVS for all CVS
2785operations.
2785 2786
2786 When @code{vc-cvs-stay-local} is @code{t}, VC also makes local 2787 When @code{vc-cvs-stay-local} is @code{t}, VC also makes local
2787version backups, so that simple diff and revert operations are 2788version backups, so that simple diff and revert operations are
@@ -2900,7 +2901,7 @@ the command is finished. For more information about windows in Emacs,
2900 With a numeric argument, @code{compare-windows} ignores changes in 2901 With a numeric argument, @code{compare-windows} ignores changes in
2901whitespace. If the variable @code{compare-ignore-case} is 2902whitespace. If the variable @code{compare-ignore-case} is
2902non-@code{nil}, the comparison ignores differences in case as well. 2903non-@code{nil}, the comparison ignores differences in case as well.
2903If the variable @code{compare-ignore-whitespace} is non-nil, 2904If the variable @code{compare-ignore-whitespace} is non-@code{nil},
2904@code{compare-windows} normally ignores changes in whitespace, and a 2905@code{compare-windows} normally ignores changes in whitespace, and a
2905prefix argument turns that off. 2906prefix argument turns that off.
2906 2907