\input texinfo @c -*-texinfo-*-
-@c "@(#)$Name: $:$Id: pcl-cvs.texi,v 1.16 2002/08/16 06:29:40 eggert Exp $"
@c %**start of header
@setfilename ../info/pcl-cvs
@settitle PCL-CVS --- Emacs Front-End to CVS
@copying
Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
-1999, 2000, 2002 Free Software Foundation, Inc.
+ 1999, 2000, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
@end ifnottex
@menu
-* About PCL-CVS:: Installation, credits, history, @dots{}
+* About PCL-CVS:: Credits, history, @dots{}
* Getting started:: An introduction with a walk-through example.
* Buffer contents:: An explanation of the buffer contents.
About PCL-CVS
* Contributors:: Contributors to PCL-CVS.
-* Installation::
Commands
* Entering PCL-CVS:: Commands to invoke PCL-CVS
* Setting flags:: Setting flags for CVS commands
-* Updating the buffer::
+* Updating the buffer::
* Movement commands:: How to move up and down in the buffer
* Marking files:: How to mark files that other commands
will later operate on.
* Committing changes:: Checking in your modifications to the
- CVS repository.
+ CVS repository.
* Editing files:: Loading files into Emacs.
* Getting info about files:: Display the log and status of files.
* Adding and removing files:: Adding and removing files
Customization
-* Customizing Faces::
+* Customizing Faces::
@end detailmenu
@end menu
Stefan Monnier picked up development again, adding some major new
functionality and taking over the maintenance.
-As of Emacs 21, PCL-CVS is part of the standard Emacs distribution.
-
@menu
* Contributors:: Contributors to PCL-CVS.
-* Installation::
@end menu
-@node Contributors, Installation, About PCL-CVS, About PCL-CVS
+@node Contributors,, About PCL-CVS, About PCL-CVS
@section Contributors to PCL-CVS
@cindex Contributors
@cindex Authors
there would be no new releases of PCL-CVS.
-@node Installation, , Contributors, About PCL-CVS
-@section Installation
-@cindex Installation
-
-As mentioned above, PCL-CVS comes bundled with Emacs version 21.1 and
-later. If you're using Emacs 20, you can download an older version of
-PCL-CVS from @uref{ftp://flint.cs.yale.edu/pub/monnier/pcl-cvs}. That
-version also works on XEmacs.
-
-If you are running XEmacs 21.0 or later, PCL-CVS is available in
-pre-compiled package form. Please refer to the XEmacs manual for
-instructions regarding package selection and installation. Currently,
-that PCL-CVS package also requires you to have installed the
-@file{xemacs-base}, @file{elib}, and @file{dired} packages.
-
-If you have @TeX{} installed at your site, you can make a typeset manual
-from @file{pcl-cvs.texi}.
-
-@enumerate
-@item
-If PCL-CVS came with the Emacs distribution, type @kbd{make pcl-cvs.dvi}
-in the @file{man} subdirectory of the Emacs source tree.
-@item
-Alternatively, run @TeX{} by typing @kbd{texi2dvi pcl-cvs.texi}.
-@item
-Convert the resulting device independent file @file{pcl-cvs.dvi} to a
-form which your printer can output and print it. If you have a
-PostScript printer, there is a program, @code{dvi2ps}, which does. There
-is also a program which comes together with @TeX{}, @code{dvips}, which
-you can use.
-@end enumerate
-
-
@node Getting started, Buffer contents, About PCL-CVS, Top
@chapter Getting started
@cindex Introduction
In this example, your repository is in @file{/usr/CVSroot} and CVS has
been run in the directory @file{/users/ceder/FOO/test}. The three files
-(@file{bar}, @file{file.txt} and
+(@file{bar}, @file{file.txt} and
@file{newer}) that are marked with @samp{Need-Update} have been changed
by someone else in the CVS repository. Two files (@file{namechange}
and @file{sub/ChangeLog}) have been modified locally, and need to be
Many of the commands work on the current set of @dfn{selected} files
which can be either the set of marked files (if any file is marked and
-marks are no ignored) or whichever file or directory the cursor is on.
+marks are not ignored) or whichever file or directory the cursor is on.
If a directory is selected but the command cannot be applied to a
directory, then it will be applied to the set of files under this
@menu
* Entering PCL-CVS:: Commands to invoke PCL-CVS
* Setting flags:: Setting flags for CVS commands
-* Updating the buffer::
+* Updating the buffer::
* Movement commands:: How to move up and down in the buffer
* Marking files:: How to mark files that other commands
will later operate on.
* Committing changes:: Checking in your modifications to the
- CVS repository.
+ CVS repository.
* Editing files:: Loading files into Emacs.
* Getting info about files:: Display the log and status of files.
* Adding and removing files:: Adding and removing files
Most commands in PCL-CVS require that you have a @samp{*cvs*}
buffer. The commands that you use to get one are listed below.
-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
PCL-CVS, and the result will be printed in the @samp{*cvs*} buffer (see
@ref{Buffer contents}, for a description of the buffer's contents).
@table @kbd
@item M-x cvs-update
-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
in which the @samp{cvs update} will be run.
@item M-x cvs-examine
which the @samp{cvs -n update} will be run.
@item M-x cvs-status
-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
in which the @samp{cvs status} will be run.
@item M-x cvs-checkout
@findex cvs-mode-add
@findex cvs-mode-remove-file
-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
and remove them from the CVS repository.
@table @kbd
@kindex =@r{--run @samp{cvs diff}}
@kindex db@r{--diff against base version}
@kindex dh@r{--diff against head of repository}
+@kindex dr@r{--diff between base and head of repository}
@kindex dv@r{--diff against vendor branch}
+@kindex dy@r{--diff against yesterday's head}
@findex cvs-mode-diff
@findex cvs-mode-diff-backup
@findex cvs-mode-diff-head
+@findex cvs-mode-diff-repository
@findex cvs-mode-diff-vendor
+@findex cvs-mode-diff-yesterday
@vindex cvs-invert-ignore-marks@r{ (variable)}
@table @kbd
revision in the repository (the most recent version on the current
branch) (@code{cvs-mode-diff-head}).@refill
+@item d r
+Display a @samp{cvs diff} between the base revision of the selected
+files and the head revision in the repository. This displays the
+changes anyone has committed to the repository since you last executed
+"checkout", "update" or "commit".
+(@code{cvs-mode-diff-repository}).@refill
+
@item d v
Display a @samp{cvs diff} between the selected files and the head
revision of the vendor branch in the repository.
(@code{cvs-mode-diff-vendor}).@refill
+
+@item d y
+Display a @samp{cvs diff} between the selected files and yesterday's
+head revision in the repository.
+(@code{cvs-mode-diff-yesterday}).@refill
@end table
By default, @samp{diff} commands ignore the marks. This can be changed
This command use @code{ediff} (or @code{emerge}, see above) to allow you
to do an interactive 3-way merge.
-@strong{Note:} When the file status is @samp{Conflict},
+@strong{Please note:} when the file status is @samp{Conflict},
CVS has already performed a merge. The resulting file is not used in
any way if you use this command. If you use the @kbd{q} command inside
@samp{ediff} (to successfully terminate a merge) the file that CVS
If you work by writing entries in the @file{ChangeLog}
(@pxref{(emacs)Change Log}) and then commit the change under revision
control, you can generate the Log Edit text from the ChangeLog using
-@kbd{C-a C-a} (@kbd{log-edit-insert-changelog}). This looks for
+@kbd{C-c C-a} (@kbd{log-edit-insert-changelog}). This looks for
entries for the file(s) concerned in the top entry in the ChangeLog
and uses those paragraphs as the log text. This text is only inserted
if the top entry was made under your user name on the current date.
@findex cvs-mode-changelog-commit
@item log-edit-changelog-full-paragraphs
If this variable is non-@code{nil}, include full @file{ChangeLog}
-paragraphs in the CVS log created by @samp{cvs-mode-changelog-commit}.
+paragraphs in the CVS log created by @samp{cvs-mode-changelog-commit}.
This may be set in the local variables section of a @file{ChangeLog}
file, to indicate the policy for that @file{ChangeLog}.
@menu
-* Customizing Faces::
+* Customizing Faces::
@end menu
@node Customizing Faces, , Customization, Customization
used to highlight the status of files which are @samp{Unknown}.
@item cvs-handled-face
-used to highlight the status of files which are handled and
+used to highlight the status of files which are handled and
need no further action.
@item cvs-need-action-face
@summarycontents
@contents
@bye
+
+@ignore
+ arch-tag: 5c7178ce-56fa-40b0-abd7-f4a09758b235
+@end ignore