1 |
\input texinfo @c -*-texinfo-*- |
\input texinfo @c -*-texinfo-*- |
|
|
|
2 |
@c "@(#)$Name$:$Id$" |
@c "@(#)$Name$:$Id$" |
|
|
|
|
@c Documentation for the GNU Emacs CVS mode. |
|
|
@c Copyright (C) 1991,92,93,94,95,96,97,98,99,2000, 2001 Free Software Foundation, Inc. |
|
|
|
|
|
@c This file is part of GNU Emacs |
|
|
|
|
|
@c GNU Emacs is free software; you can redistribute it and/or modify |
|
|
@c it under the terms of the GNU General Public License as published by |
|
|
@c the Free Software Foundation; either version 2 of the License, |
|
|
@c or (at your option) any later version. |
|
|
|
|
|
@c GNU Emacs is distributed in the hope that it will be useful, |
|
|
@c but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
|
@c MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
|
@c GNU General Public License for more details. |
|
|
|
|
|
@c You should have received a copy of the GNU General Public License |
|
|
@c along with pcl-cvs; see the file COPYING. If not, write to |
|
|
@c the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. |
|
|
|
|
3 |
@c %**start of header |
@c %**start of header |
4 |
@setfilename ../info/pcl-cvs |
@setfilename ../info/pcl-cvs |
5 |
@settitle PCL-CVS --- Emacs Front-End to CVS |
@settitle PCL-CVS --- Emacs Front-End to CVS |
6 |
|
@syncodeindex vr fn |
7 |
@c %**end of header |
@c %**end of header |
8 |
|
|
9 |
@c |
@copying |
10 |
|
Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, |
11 |
@dircategory Emacs |
1999, 2000, 2002 Free Software Foundation, Inc. |
|
@direntry |
|
|
* PCL-CVS: (pcl-cvs). Emacs front-end to CVS. |
|
|
@end direntry |
|
|
@setchapternewpage on |
|
|
|
|
|
@ifinfo |
|
|
Copyright @copyright{} 1991,92,93,94,95,96,97,98,99,2000 Free Software Foundation, Inc. |
|
12 |
|
|
13 |
|
@quotation |
14 |
Permission is granted to copy, distribute and/or modify this document |
Permission is granted to copy, distribute and/or modify this document |
15 |
under the terms of the GNU Free Documentation License, Version 1.1 or |
under the terms of the GNU Free Documentation License, Version 1.1 or |
16 |
any later version published by the Free Software Foundation; with the |
any later version published by the Free Software Foundation; with the |
28 |
(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify |
(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify |
29 |
this GNU Manual, like GNU software. Copies published by the Free |
this GNU Manual, like GNU software. Copies published by the Free |
30 |
Software Foundation raise funds for GNU development.'' |
Software Foundation raise funds for GNU development.'' |
31 |
@end ifinfo |
@end quotation |
32 |
|
@end copying |
33 |
|
|
34 |
|
@dircategory Emacs |
35 |
|
@direntry |
36 |
|
* PCL-CVS: (pcl-cvs). Emacs front-end to CVS. |
37 |
|
@end direntry |
38 |
|
|
|
@syncodeindex vr fn |
|
39 |
@c The titlepage section does not appear in the Info file. |
@c The titlepage section does not appear in the Info file. |
40 |
@titlepage |
@titlepage |
41 |
@sp 4 |
@sp 4 |
59 |
@c for the printed manual. This will not appear in the Info file. |
@c for the printed manual. This will not appear in the Info file. |
60 |
@page |
@page |
61 |
@vskip 0pt plus 1filll |
@vskip 0pt plus 1filll |
62 |
Copyright @copyright{} 1991,92,93,94,95,96,97,98,99,2000 Free Software Foundation, Inc. |
@insertcopying |
|
|
|
|
Permission is granted to copy, distribute and/or modify this document |
|
|
under the terms of the GNU Free Documentation License, Version 1.1 or |
|
|
any later version published by the Free Software Foundation; with the |
|
|
Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and |
|
|
``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU |
|
|
Manual'', and with the Back-Cover Texts as in (a) below. A copy of the |
|
|
license is included in the section entitled ``GNU Free Documentation |
|
|
License'' in the Emacs manual. |
|
|
|
|
|
This document is part of a collection distributed under the GNU Free |
|
|
Documentation License. If you want to distribute this document |
|
|
separately from the collection, you can do so by adding a copy of the |
|
|
license to the document, as described in section 6 of the license. |
|
|
|
|
|
(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify |
|
|
this GNU Manual, like GNU software. Copies published by the Free |
|
|
Software Foundation raise funds for GNU development.'' |
|
63 |
@end titlepage |
@end titlepage |
64 |
|
|
65 |
@c ================================================================ |
@c ================================================================ |
67 |
@c ================================================================ |
@c ================================================================ |
68 |
|
|
69 |
@node Top, About PCL-CVS, (dir), (dir) |
@node Top, About PCL-CVS, (dir), (dir) |
70 |
@ifinfo |
@ifnottex |
71 |
@top PCL-CVS |
@top PCL-CVS |
72 |
|
|
73 |
This manual describes PCL-CVS, the GNU Emacs front-end to CVS. It |
This manual describes PCL-CVS, the GNU Emacs front-end to CVS. It |
75 |
customize-group RET pcl-cvs @key{RET}} and to look at the documentation strings |
customize-group RET pcl-cvs @key{RET}} and to look at the documentation strings |
76 |
of the various commands and major modes for further information. |
of the various commands and major modes for further information. |
77 |
@c This manual is updated to release 2.5 of PCL-CVS. |
@c This manual is updated to release 2.5 of PCL-CVS. |
78 |
@end ifinfo |
@end ifnottex |
79 |
|
|
80 |
@menu |
@menu |
81 |
* About PCL-CVS:: Installation, credits, history, @dots{} |
* About PCL-CVS:: Installation, credits, history, @dots{} |
101 |
About PCL-CVS |
About PCL-CVS |
102 |
|
|
103 |
* Contributors:: Contributors to PCL-CVS. |
* Contributors:: Contributors to PCL-CVS. |
104 |
* Installation:: |
* Installation:: |
105 |
|
|
106 |
Commands |
Commands |
107 |
|
|
108 |
* Entering PCL-CVS:: Commands to invoke PCL-CVS |
* Entering PCL-CVS:: Commands to invoke PCL-CVS |
109 |
* Setting flags:: Setting flags for CVS commands |
* Setting flags:: Setting flags for CVS commands |
110 |
* Updating the buffer:: |
* Updating the buffer:: |
111 |
* Movement commands:: How to move up and down in the buffer |
* Movement commands:: How to move up and down in the buffer |
112 |
* Marking files:: How to mark files that other commands |
* Marking files:: How to mark files that other commands |
113 |
will later operate on. |
will later operate on. |
114 |
* Committing changes:: Checking in your modifications to the |
* Committing changes:: Checking in your modifications to the |
115 |
CVS repository. |
CVS repository. |
116 |
* Editing files:: Loading files into Emacs. |
* Editing files:: Loading files into Emacs. |
117 |
* Getting info about files:: Display the log and status of files. |
* Getting info about files:: Display the log and status of files. |
118 |
* Adding and removing files:: Adding and removing files |
* Adding and removing files:: Adding and removing files |
127 |
|
|
128 |
Customization |
Customization |
129 |
|
|
130 |
* Customizing Faces:: |
* Customizing Faces:: |
131 |
|
|
132 |
@end detailmenu |
@end detailmenu |
133 |
@end menu |
@end menu |
157 |
|
|
158 |
@menu |
@menu |
159 |
* Contributors:: Contributors to PCL-CVS. |
* Contributors:: Contributors to PCL-CVS. |
160 |
* Installation:: |
* Installation:: |
161 |
@end menu |
@end menu |
162 |
|
|
163 |
@node Contributors, Installation, About PCL-CVS, About PCL-CVS |
@node Contributors, Installation, About PCL-CVS, About PCL-CVS |
196 |
@file{pcl-cvs-xemacs.el}.@refill |
@file{pcl-cvs-xemacs.el}.@refill |
197 |
|
|
198 |
@item |
@item |
199 |
Leif Lonnblad contributed RCVS support (since superceded by the new |
Leif Lonnblad contributed RCVS support (since superseded by the new |
200 |
remote CVS support). |
remote CVS support). |
201 |
|
|
202 |
@item |
@item |
250 |
pre-compiled package form. Please refer to the XEmacs manual for |
pre-compiled package form. Please refer to the XEmacs manual for |
251 |
instructions regarding package selection and installation. Currently, |
instructions regarding package selection and installation. Currently, |
252 |
that PCL-CVS package also requires you to have installed the |
that PCL-CVS package also requires you to have installed the |
253 |
@file{xemacs-base}, @file{elib}, and @file{dired} packages. |
@file{xemacs-base}, @file{elib}, and @file{dired} packages. |
254 |
|
|
255 |
If you have @TeX{} installed at your site, you can make a typeset manual |
If you have @TeX{} installed at your site, you can make a typeset manual |
256 |
from @file{pcl-cvs.texi}. |
from @file{pcl-cvs.texi}. |
318 |
|
|
319 |
In this example, your repository is in @file{/usr/CVSroot} and CVS has |
In this example, your repository is in @file{/usr/CVSroot} and CVS has |
320 |
been run in the directory @file{/users/ceder/FOO/test}. The three files |
been run in the directory @file{/users/ceder/FOO/test}. The three files |
321 |
(@file{bar}, @file{file.txt} and |
(@file{bar}, @file{file.txt} and |
322 |
@file{newer}) that are marked with @samp{Need-Update} have been changed |
@file{newer}) that are marked with @samp{Need-Update} have been changed |
323 |
by someone else in the CVS repository. Two files (@file{namechange} |
by someone else in the CVS repository. Two files (@file{namechange} |
324 |
and @file{sub/ChangeLog}) have been modified locally, and need to be |
and @file{sub/ChangeLog}) have been modified locally, and need to be |
523 |
@menu |
@menu |
524 |
* Entering PCL-CVS:: Commands to invoke PCL-CVS |
* Entering PCL-CVS:: Commands to invoke PCL-CVS |
525 |
* Setting flags:: Setting flags for CVS commands |
* Setting flags:: Setting flags for CVS commands |
526 |
* Updating the buffer:: |
* Updating the buffer:: |
527 |
* Movement commands:: How to move up and down in the buffer |
* Movement commands:: How to move up and down in the buffer |
528 |
* Marking files:: How to mark files that other commands |
* Marking files:: How to mark files that other commands |
529 |
will later operate on. |
will later operate on. |
530 |
* Committing changes:: Checking in your modifications to the |
* Committing changes:: Checking in your modifications to the |
531 |
CVS repository. |
CVS repository. |
532 |
* Editing files:: Loading files into Emacs. |
* Editing files:: Loading files into Emacs. |
533 |
* Getting info about files:: Display the log and status of files. |
* Getting info about files:: Display the log and status of files. |
534 |
* Adding and removing files:: Adding and removing files |
* Adding and removing files:: Adding and removing files |
554 |
|
|
555 |
Most commands in PCL-CVS require that you have a @samp{*cvs*} |
Most commands in PCL-CVS require that you have a @samp{*cvs*} |
556 |
buffer. The commands that you use to get one are listed below. |
buffer. The commands that you use to get one are listed below. |
557 |
For each, a @samp{cvs} process will be run, the output will be parsed by |
For each, a @samp{cvs} process will be run, the output will be parsed by |
558 |
PCL-CVS, and the result will be printed in the @samp{*cvs*} buffer (see |
PCL-CVS, and the result will be printed in the @samp{*cvs*} buffer (see |
559 |
@ref{Buffer contents}, for a description of the buffer's contents). |
@ref{Buffer contents}, for a description of the buffer's contents). |
560 |
|
|
561 |
@table @kbd |
@table @kbd |
562 |
@item M-x cvs-update |
@item M-x cvs-update |
563 |
Run a @samp{cvs update} command. You will be asked for the directory |
Run a @samp{cvs update} command. You will be asked for the directory |
564 |
in which the @samp{cvs update} will be run. |
in which the @samp{cvs update} will be run. |
565 |
|
|
566 |
@item M-x cvs-examine |
@item M-x cvs-examine |
570 |
which the @samp{cvs -n update} will be run. |
which the @samp{cvs -n update} will be run. |
571 |
|
|
572 |
@item M-x cvs-status |
@item M-x cvs-status |
573 |
Run a @samp{cvs status} command. You will be asked for the directory |
Run a @samp{cvs status} command. You will be asked for the directory |
574 |
in which the @samp{cvs status} will be run. |
in which the @samp{cvs status} will be run. |
575 |
|
|
576 |
@item M-x cvs-checkout |
@item M-x cvs-checkout |
921 |
@findex cvs-mode-add |
@findex cvs-mode-add |
922 |
@findex cvs-mode-remove-file |
@findex cvs-mode-remove-file |
923 |
|
|
924 |
The following commands are available to make it easy to add fuiles to |
The following commands are available to make it easy to add files to |
925 |
and remove them from the CVS repository. |
and remove them from the CVS repository. |
926 |
|
|
927 |
@table @kbd |
@table @kbd |
1307 |
@findex cvs-mode-changelog-commit |
@findex cvs-mode-changelog-commit |
1308 |
@item log-edit-changelog-full-paragraphs |
@item log-edit-changelog-full-paragraphs |
1309 |
If this variable is non-@code{nil}, include full @file{ChangeLog} |
If this variable is non-@code{nil}, include full @file{ChangeLog} |
1310 |
paragraphs in the CVS log created by @samp{cvs-mode-changelog-commit}. |
paragraphs in the CVS log created by @samp{cvs-mode-changelog-commit}. |
1311 |
This may be set in the local variables section of a @file{ChangeLog} |
This may be set in the local variables section of a @file{ChangeLog} |
1312 |
file, to indicate the policy for that @file{ChangeLog}. |
file, to indicate the policy for that @file{ChangeLog}. |
1313 |
|
|
1338 |
|
|
1339 |
|
|
1340 |
@menu |
@menu |
1341 |
* Customizing Faces:: |
* Customizing Faces:: |
1342 |
@end menu |
@end menu |
1343 |
|
|
1344 |
@node Customizing Faces, , Customization, Customization |
@node Customizing Faces, , Customization, Customization |
1365 |
used to highlight the status of files which are @samp{Unknown}. |
used to highlight the status of files which are @samp{Unknown}. |
1366 |
|
|
1367 |
@item cvs-handled-face |
@item cvs-handled-face |
1368 |
used to highlight the status of files which are handled and |
used to highlight the status of files which are handled and |
1369 |
need no further action. |
need no further action. |
1370 |
|
|
1371 |
@item cvs-need-action-face |
@item cvs-need-action-face |