diff options
| author | Luc Teirlinck | 2005-03-27 02:17:27 +0000 |
|---|---|---|
| committer | Luc Teirlinck | 2005-03-27 02:17:27 +0000 |
| commit | a0554a40e2efd9352e185fbb3af48811a8e4044c (patch) | |
| tree | d50fdee431e942a779e99f129256624273b0ffa0 | |
| parent | 99a5658144bce7733e48d9c1877b2795afc1aa9d (diff) | |
| download | emacs-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.texi | 59 |
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 | |||
| 238 | of prompting for the file name in the minibuffer. On Unix and | 238 | of prompting for the file name in the minibuffer. On Unix and |
| 239 | GNU/Linux platforms, Emacs does that when built with GTK, LessTif, and | 239 | GNU/Linux platforms, Emacs does that when built with GTK, LessTif, and |
| 240 | Motif toolkits; on MS-Windows, the GUI version does that by default. | 240 | Motif toolkits; on MS-Windows, the GUI version does that by default. |
| 241 | For information on how to customize this, see @xref{Dialog Boxes}. | 241 | For 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 |
| 244 | window system. Dropping a file into an ordinary Emacs window visits | 244 | window 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 | |||
| 1272 | SCCS only if for some reason you cannot use RCS, or one of the | 1272 | SCCS only if for some reason you cannot use RCS, or one of the |
| 1273 | higher-level systems such as CVS or GNU Arch. | 1273 | higher-level systems such as CVS or GNU Arch. |
| 1274 | 1274 | ||
| 1275 | In the following, we discuss mainly RCS, SCCS and CVS. Nearly | ||
| 1276 | everything said about CVS applies to Gnu Arch, Subversion and Meta-CVS | ||
| 1277 | as 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 | |||
| 1472 | since you began editing it, and when this happens, his changes will be | 1476 | since you began editing it, and when this happens, his changes will be |
| 1473 | effectively removed when you check in your version (though they will | 1477 | effectively removed when you check in your version (though they will |
| 1474 | remain in the master file, so they will not be entirely lost). You must | 1478 | remain in the master file, so they will not be entirely lost). You must |
| 1475 | therefore verify the current version is unchanged, before you check in your | 1479 | therefore verify that the current version is unchanged, before you |
| 1476 | changes. We hope to eliminate this risk and provide automatic merging | 1480 | check in your changes. We hope to eliminate this risk and provide |
| 1477 | with RCS in a future Emacs version. | 1481 | automatic 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 |
| 1480 | it is not required; @kbd{C-x v v} with an unmodified file locks the | 1484 | it 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 | |||
| 1698 | that appears first in @code{vc-handled-backends} (@pxref{Customizing VC}). | 1702 | that appears first in @code{vc-handled-backends} (@pxref{Customizing VC}). |
| 1699 | On the other hand, if there are no files already registered, | 1703 | On the other hand, if there are no files already registered, |
| 1700 | Emacs uses the first system from @code{vc-handled-backends} that could | 1704 | Emacs uses the first system from @code{vc-handled-backends} that could |
| 1701 | register the file---for example, you cannot register a file under CVS if | 1705 | register the file (for example, you cannot register a file under CVS if |
| 1702 | its directory is not already part of a CVS tree. | 1706 | its directory is not already part of a CVS tree); with the default |
| 1703 | 1707 | value of @code{vc-handled-backends}, this means that Emacs uses RCS in | |
| 1704 | With the default value of @code{vc-handled-backends}, this means | 1708 | this situation. |
| 1705 | that Emacs uses RCS if there are any files under RCS control, CVS if | ||
| 1706 | there are any files under CVS, SCCS if any files are under SCCS, or | ||
| 1707 | RCS 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 |
| 1710 | read-only. Type @kbd{C-x v v} if you wish to start editing it. After | 1711 | read-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. | |||
| 1892 | If it operates on more than one file, it handles each file according to | 1893 | If it operates on more than one file, it handles each file according to |
| 1893 | its current state; thus, it might lock one file, but check in another | 1894 | its current state; thus, it might lock one file, but check in another |
| 1894 | file. This could be confusing; it is up to you to avoid confusing | 1895 | file. This could be confusing; it is up to you to avoid confusing |
| 1895 | behavior by marking a set of files that are in a similar state. | 1896 | behavior by marking a set of files that are in a similar state. If no |
| 1897 | files 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, |
| 1898 | then uses it for all the files being checked in. This is convenient for | 1900 | then 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 | |||
| 1920 | features. Each such independent line of development is called a | 1922 | features. 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 |
| 1922 | different branches, and merge changes from one branch to another. | 1924 | different branches, and merge changes from one branch to another. |
| 1923 | Please note, however, that branches are only supported for RCS at the | 1925 | Please note, however, that branches are not supported for SCCS. |
| 1924 | moment. | ||
| 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}. |
| 1927 | The versions on the trunk are normally numbered 1.1, 1.2, 1.3, etc. At | 1928 | The 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 | |||
| 2264 | correspond to those of CVS. Technically, this is not a problem, but | 2265 | correspond to those of CVS. Technically, this is not a problem, but |
| 2265 | it can become difficult to keep track of what is in the CVS repository | 2266 | it can become difficult to keep track of what is in the CVS repository |
| 2266 | and what is not. So we suggest that you return from time to time to | 2267 | and what is not. So we suggest that you return from time to time to |
| 2267 | CVS-only operation, using @kbd{C-u C-x v v cvs @key{RET}}. | 2268 | CVS-only operation, by committing your local changes back to the |
| 2269 | repository 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. | |||
| 2552 | Insert headers in a file for use with your version-control system. | 2554 | Insert 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 |
| 2558 | setting the variable @code{vc-header-alist}. Its value is a list of | 2560 | setting the variables @code{vc-@var{backend}-header} where |
| 2559 | elements 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 | ||
| 2561 | string 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 |
| 2564 | each string in the list is inserted as a separate header on a line of | 2564 | each 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 |
| 2587 | of the header. A header line is inserted for each element that matches | 2587 | of the header. A header line is inserted for each element that matches |
| 2588 | the buffer name, and for each string specified by | 2588 | the 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 |
| 2590 | string from @code{vc-header-alist} with the format taken from the | 2590 | string from @code{vc-@var{backend}-header} with the format taken from the |
| 2591 | element. The default value for @code{vc-static-header-alist} is as follows: | 2591 | element. 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 |
| 2625 | The variable @code{vc-handled-backends} determines which version | 2625 | The variable @code{vc-handled-backends} determines which version |
| 2626 | control systems VC should handle. The default value is @code{(RCS CVS | 2626 | control systems VC should handle. The default value is @code{(RCS CVS |
| 2627 | SCCS)}, so it contains all three version systems that are currently | 2627 | SVN SCCS Arch MCVS)}, so it contains all six version systems that are |
| 2628 | supported. If you want VC to ignore one or more of these systems, | 2628 | currently supported. If you want VC to ignore one or more of these |
| 2629 | exclude its name from the list. To disable VC entirely, set this | 2629 | systems, exclude its name from the list. To disable VC entirely, set |
| 2630 | variable to @code{nil}. | 2630 | this variable to @code{nil}. |
| 2631 | 2631 | ||
| 2632 | The order of systems in the list is significant: when you visit a file | 2632 | The order of systems in the list is significant: when you visit a file |
| 2633 | registered in more than one system (@pxref{Local Version Control}), | 2633 | registered 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}, |
| 2784 | specifying switches to pass to CVS for all CVS operations. | 2784 | should be a string specifying switches to pass to CVS for all CVS |
| 2785 | operations. | ||
| 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 |
| 2787 | version backups, so that simple diff and revert operations are | 2788 | version 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 |
| 2901 | whitespace. If the variable @code{compare-ignore-case} is | 2902 | whitespace. If the variable @code{compare-ignore-case} is |
| 2902 | non-@code{nil}, the comparison ignores differences in case as well. | 2903 | non-@code{nil}, the comparison ignores differences in case as well. |
| 2903 | If the variable @code{compare-ignore-whitespace} is non-nil, | 2904 | If 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 |
| 2905 | prefix argument turns that off. | 2906 | prefix argument turns that off. |
| 2906 | 2907 | ||