.TH META-CVS "1" "March 2004" "Meta-CVS version 1.0.13 Copyright 2004 Kaz Kylheku" "User Commands"
.SH NAME
Meta-CVS \- version control system built around CVS
.SH DESCRIPTION
Meta-CVS command syntax:
.IP
mcvs [ global-options ] command [ command-options ] [ command-arguments ]
.PP
Global options:
.TP
\fB\-H\fR \fB\-\-help\fR
Print this help and terminate. If a command is specified,
help specific to that command is printed instead.
.TP
\fB\-Q\fR
Very quiet, generate output only for serious problems. (*)
.TP
\fB\-q\fR
Somewhat quiet, some info messages suppressed. (*)
.TP
\fB\-n\fR
Dry run; do not modify filesystem. (*)
.TP
\fB\-\-debug\fR
Verbose debug output; \fB\-Q\fR and \fB\-q\fR are ignored but still
passed to CVS.
.TP
\fB\-r\fR
Make working files read-only. (@)
.TP
\fB\-w\fR
Make new working files read-write (default). (@)
.TP
\fB\-l\fR
Do not log cvs command in command history, but execute
it anyway. (@)
.TP
\fB\-t\fR
Trace CVS execution. (@)
.TP
\fB\-v\fR \fB\-\-version\fR
Display version information and terminate.
.TP
\fB\-f\fR
CVS not to read ~/.cvsrc file. (@)
.TP
\fB\-i\fR script-name
Load a Lisp file and evaluate its top level forms,
allowing Meta-CVS to behave as an interpreter.
.TP
\fB\-\-meta\fR
Include metafiles such as MCVS/MAP in the set of files
to operate on.
.TP
\fB\-\-metaonly\fR
Operate only on metafiles.
.TP
\fB\-\-nometa\fR
Exclude metafiles from the set of files to operate on.
.TP
\fB\-\-error\-continue\fR
Instead of interactive error handling, automatically
continue all continuable errors.
.TP
\fB\-\-error\-terminate\fR
Terminate with cleanup when an error happens instead
of interactive error handling.
.TP
\fB\-T\fR tempdir
Place temporary files in tempdir. (@)
.TP
\fB\-e\fR editor
Edit messages with editor. (*)
.TP
\fB\-d\fR root
Specify CVSROOT. (@)
.TP
\fB\-z\fR gzip-level
Specify compression level. (@)
.TP
\fB\-\-up\fR N
Escape out of N levels of sandbox nesting before executing
operation.
.IP
Notes: (*) option processed by Meta-CVS and passed to CVS too.
.IP
(@) option merely passed to CVS.
.PP
Commands:
.TP
help
Obtain more detailed help for a specific command.
.TP
create
Create new project from an existing file tree.
.TP
grab
Take a snapshot of an external source tree, such
as a third-party release, and incorporate it into
the working copy. Tries to discover file moves.
.TP
checkout (co)
Retrieve a Meta-CVS project from the repository to
create a working copy.
.TP
export (ex)
Retrieve a Meta-CVS project without creating a
working copy.
.TP
add
Place files (or directories with add \fB\-R\fR) under
version control.
.TP
remove (rm)
Remove files or directories.
.TP
move (mv)
Rename files and directories.
.TP
link (ln)
Create a versioned symbolic link.
.TP
update (up)
Incorporate latest changes from repository into
working copy.
.TP
commit (ci)
Incorporate outstanding changes in the working copy
into the repository.
.TP
diff
Compute differences between files in the working copy
and the repository or between revisions in the repository.
.TP
tag
Associate a symbolic name with file revisions to create
an identifiable baseline.  By default, tags the
revisions that were last synchronized with the
directory. Note: tag \fB\-b\fR creates a CVS branch,
it won't be a Meta-CVS branch with managed merges.
Consider the branch command instead!
.TP
log
Display log information for files.
.TP
status (stat)
Show current status of files.
.TP
annotate
Perform a detailed analysis of files, showing the
version information about every individual line of text.
.TP
filt (fi)
Act as a text filter, which converts Meta-CVS F- file
names to readable paths, according to the current mapping.
.TP
remote-filt (rfi)
Remote version of filt, requires module name.
.TP
branch
Create a managed branch. Meta-CVS managed branches keep
track of what has been merged where, so users don't have
to track merges with tags at all.
.TP
merge
Merge a managed branch to the current branch or trunk.
.TP
remerge
Re-apply the most recent merge without changing any tags.
Useful when a merge goes bad so the local changes have
to be discarded and the merge done over again.
.IP
list-branches (lb) List Meta-CVS managed branches.
switch (sw)        Switch to a branch. With no arguments, switch to
.IP
main trunk.
.TP
remap
Force Meta-CVS to notice and incorporate moves and
deletions that were performed directly on the sandbox.
.TP
purge
Execute a CVS remove on files that have been unmapped
with the remove command.
.TP
restore
Restore files that have been deleted with the remove
command, but not purged. These appear in the lost+found
directory under cryptic names.
.TP
prop
Manipulate properties.
.IP
prop \fB\-\-set\fR <bool-prop-name> [ files ... ]
prop \fB\-\-clear\fR <bool-prop-name> [ files ... ]
prop \fB\-\-value\fR <prop-name> <new-value> [ files ... ]
prop \fB\-\-remove\fR <prop-name> [ files ... ]
.IP
The ``exec'' property represents the execute permission
of a file.  More than one \fB\-\-set\fR, \fB\-\-clear\fR, \fB\-\-value\fR
or \fB\-\-remove\fR may be specified before the files.
.TP
watch
Manipulate per-file CVS watch settings.
.IP
watch \fB\-\-on\fR [ files ... ]
watch \fB\-\-off\fR [ files ... ]
watch \fB\-\-add\fR <action> [ files ... ]
watch \fB\-\-remove\fR <action> [ files ... ]
.TP
watchers
See who is watching files.
.TP
edit
Indicate the intent to edit a watched file.
.TP
unedit
Retract the indication signaled by edit.
.TP
editors
See who is editing files.
.TP
sync-to-cvs
Synchronize tree in the direction of the CVS sandbox.
Useful when extending Meta-CVS with external scripts.
.TP
sync-from-cvs
Synchronize CVS sandbox to the tree.
.TP
convert
Convert a CVS module to a Meta-CVS project.
This requires direct filesystem access to the repository.
Caveat: this is a very blunt instrument.