comparison man/pcl-cvs.texi @ 83530:46b1096093f5

Merged from [e-mail]. Patches applied: * [e-mail]/emacs--devo--0--patch-294 Update from CVS * [e-mail]/emacs--devo--0--patch-295 Merge from gnus--rel--5.10 * [e-mail]/emacs--devo--0--patch-296 Update from CVS: admin/FOR-RELEASE: Update refcard section. * [e-mail]/emacs--devo--0--patch-297 Update from CVS * [e-mail]/emacs--devo--0--patch-298 Update from CVS * [e-mail]/emacs--devo--0--patch-299 Update from CVS * [e-mail]/emacs--devo--0--patch-300 Update from CVS * [e-mail]/emacs--devo--0--patch-301 Update from CVS * [e-mail]/emacs--devo--0--patch-302 Update from CVS * [e-mail]/emacs--devo--0--patch-303 Update from CVS * [e-mail]/emacs--devo--0--patch-304 Update from CVS * [e-mail]/gnus--rel--5.10--patch-103 Update from CVS * [e-mail]/gnus--rel--5.10--patch-104 Update from CVS git-archimport-id: [e-mail]--2004/emacs--multi-tty--0--patch-570

83529:0d9e16eab053

You can mark and unmark files with these commands:

@table @kbd
@item m
This marks the file that the cursor is positioned on.  If the cursor is
positioned on a directory all files in that directory are marked.
(@code{cvs-mode-mark}).@refill

@item u
Unmark the file that the cursor is positioned on. If the cursor is on a
directory, all files in that directory are unmarked.
(@code{cvs-mode-unmark}).@refill

@item M
Mark @emph{all} files in the buffer (@code{cvs-mode-mark-all-files}).

Mark all files matching a regular expression
(@code{cvs-mode-mark-matching-files}).

@item S
Mark all files in a particular state, such as ``Modified'' or
``Removed''.  (@code{cvs-mode-mark-on-state}).

@item T
Toggle use of marks for the next command (@code{cvs-mode-toggle-marks}).
@end table

If you are editing the files in your Emacs, an automatic
@samp{revert-buffer} will be performed.  (If the file contains
@samp{$@asis{Id}$} keywords, @samp{cvs commit} will write a new file with
the new values substituted.  The auto-revert makes sure that you get
them into your buffer).  The revert will not occur if you have modified
your buffer, or if @samp{cvs-auto-revert} is set to
@samp{nil}.


@node Editing files, Getting info about files, Committing changes, Commands

@item A
Invoke @samp{add-change-log-entry-other-window} to edit a
@file{ChangeLog} file.  The @file{ChangeLog} file will be found in the
directory of the file the cursor points to, or in a parent of that
directory.  (@code{cvs-mode-add-change-log-entry-other-window}).@refill
@end table


@node Getting info about files, Adding and removing files, Editing files, Commands
@section Getting info about files

@table @kbd
@item U
If you have modified a file, and for some reason decide that you don't
want to keep the changes, you can undo them with this command.  It works
by removing your working copy of the file and then getting the latest
version from the repository (@code{cvs-mode-undo-local-changes}.
@end table


@node Removing handled entries, Ignoring files, Undoing changes, Commands
@section Removing handled entries

@table @kbd
@item =
@itemx d =
Display a @samp{cvs diff} between the selected files and the version
that they are based on. (@code{cvs-mode-diff}).@refill

@item d b
If CVS finds a conflict while merging two versions of a file (during a
@samp{cvs update}, @pxref{Updating the buffer}) it will save the
original file in a file called @file{.#@var{file}.@var{version}} where

With the @kbd{d b} command you can run a @samp{diff} on the files
@file{.#@var{file}.@var{version}} and @file{@var{file}}.@refill

@item d h
Display a @samp{cvs diff} between the selected files and the head
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
with @code{cvs-invert-ignore-marks}.

@kindex O@r{--update files}

@table @kbd
@item O
Update all selected files with status @samp{Need-update} by running
@samp{cvs update} on them.  (@code{cvs-mode-update}).
@end table


@node Tagging files, Miscellaneous commands, Updating files, Commands
@section Tagging files

@cindex @file{.cvsignore} file, sorting
@cindex Automatically sorting @file{.cvsignore}
@cindex @samp{CVSROOT}, overriding

If you have an idea about any customization that would be handy but
isn't present in this list, please tell me!
For info on how to reach me, see @ref{Bugs}.@refill

@table @samp
@item cvs-auto-remove-handled
If this variable is set to any non-@code{nil} value,
@samp{cvs-mode-remove-handled} will be called every time you check in

83530:46b1096093f5

You can mark and unmark files with these commands:

@table @kbd
@item m
This marks the file that the cursor is positioned on.  If the cursor is
positioned on a directory all files in that directory are marked
(@code{cvs-mode-mark}).@refill

@item u
Unmark the file that the cursor is positioned on. If the cursor is on a
directory, all files in that directory are unmarked
(@code{cvs-mode-unmark}).@refill

@item M
Mark @emph{all} files in the buffer (@code{cvs-mode-mark-all-files}).

Mark all files matching a regular expression
(@code{cvs-mode-mark-matching-files}).

@item S
Mark all files in a particular state, such as ``Modified'' or
``Removed'' (@code{cvs-mode-mark-on-state}).

@item T
Toggle use of marks for the next command (@code{cvs-mode-toggle-marks}).
@end table

If you are editing the files in your Emacs, an automatic
@samp{revert-buffer} will be performed.  (If the file contains
@samp{$@asis{Id}$} keywords, @samp{cvs commit} will write a new file with
the new values substituted.  The auto-revert makes sure that you get
them into your buffer.)  The revert will not occur if you have modified
your buffer, or if @samp{cvs-auto-revert} is set to
@samp{nil}.


@node Editing files, Getting info about files, Committing changes, Commands

@item A
Invoke @samp{add-change-log-entry-other-window} to edit a
@file{ChangeLog} file.  The @file{ChangeLog} file will be found in the
directory of the file the cursor points to, or in a parent of that
directory (@code{cvs-mode-add-change-log-entry-other-window}).@refill
@end table


@node Getting info about files, Adding and removing files, Editing files, Commands
@section Getting info about files

@table @kbd
@item U
If you have modified a file, and for some reason decide that you don't
want to keep the changes, you can undo them with this command.  It works
by removing your working copy of the file and then getting the latest
version from the repository (@code{cvs-mode-undo-local-changes}).
@end table


@node Removing handled entries, Ignoring files, Undoing changes, Commands
@section Removing handled entries

@table @kbd
@item =
@itemx d =
Display a @samp{cvs diff} between the selected files and the version
that they are based on (@code{cvs-mode-diff}).@refill

@item d b
If CVS finds a conflict while merging two versions of a file (during a
@samp{cvs update}, @pxref{Updating the buffer}) it will save the
original file in a file called @file{.#@var{file}.@var{version}} where

With the @kbd{d b} command you can run a @samp{diff} on the files
@file{.#@var{file}.@var{version}} and @file{@var{file}}.@refill

@item d h
Display a @samp{cvs diff} between the selected files and the head
revision (the most recent version on the current
branch) in the repository (@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
with @code{cvs-invert-ignore-marks}.

@kindex O@r{--update files}

@table @kbd
@item O
Update all selected files with status @samp{Need-update} by running
@samp{cvs update} on them (@code{cvs-mode-update}).
@end table


@node Tagging files, Miscellaneous commands, Updating files, Commands
@section Tagging files

@cindex @file{.cvsignore} file, sorting
@cindex Automatically sorting @file{.cvsignore}
@cindex @samp{CVSROOT}, overriding

If you have an idea about any customization that would be handy but
isn't present in this list, please tell us!
For info on how to reach us, see @ref{Bugs}.@refill

@table @samp
@item cvs-auto-remove-handled
If this variable is set to any non-@code{nil} value,
@samp{cvs-mode-remove-handled} will be called every time you check in