CVS2DARCS(1) darcs CVS2DARCS(1)NAME
cvs2darcs - import a CVS project into Darcs
SYNOPSIS
cvs2darcs [OPTIONS] MODULE
DESCRIPTION
cvs2darcs is a program to import a CVS module/project into a Darcs
repository, preserving all (or as much as possible) of the revision
history, including support for importing branches.
Darcs is a free advanced revision-control program, available from
www.darcs.net, that has many features lacking in CVS (such as the abil‐
ity to have independent branch repositories, arbitrary merging of
repositories, etc.).
cvs2darcs checks out MODULE from the CVS repository into a new direc‐
tory (by default, into the directory MODULE) and converts this direc‐
tory into a Darcs repository. (This will take some time for large
repositories. You may want to copy your CVS repository to a local disk
to speed things up.)
Instead of MODULE, you can also specify an existing CVS project direc‐
tory. This will import the directory into a Darcs repository (preserv‐
ing the CVS information as with -p below). If the directory was
already imported into Darcs, then cvs2darcs will import any new CVS
patches into Darcs (but not vice-versa).
The most important option flags are -d CVSROOT, which specifies the
location of the CVS repository root (exactly as the cvs -d flag); -o
DIR, which specifies an alternate output directory name; and -b BRANCH,
which specifies a CVS branch to import (default is HEAD). Other
options are described below.
The CVS repository is not modified. However, the output directory cre‐
ated by cvs2darcs is not linked to the CVS repository (technically, it
has no CVS/ directories). If you want to preserve the CVS information
in the output directory, you can pass the -p flag; this is the default
if the output directory already exists as a CVS-controlled directory.
OPTIONS-h, --help
Display help on the command-line options and usage.
-V, --version
Print the version number and copyright information.
-o DIR, --output-dir=DIR
Use/create directory DIR as the output Darcs repository, rather
than MODULE (the default).
-b BRANCH, --branch=BRANCH
Import the CVS branch named BRANCH, instead of the current CVS
HEAD (the default).
-p, --preserve-cvs
Preserve the CVS-repository information in the output directory
(default is to remove it). If the output-directory has pre-
existing CVS information, it is preserved by default.
-d CVSROOT
Use CVSROOT as the root directory pathname of the CVS reposi‐
tory, exactly as for the cvs -d flag.
-z GZIP-LEVEL
Use GZIP-LEVEL as the gzip compression level in CVS, exactly as
for the cvs -z flag.
-R As for the cvs -R flag: use read-only CVS repository mode, which
may improve CVS performance.
-x As for the cvs -x flag (used for GSSAPI and Kerberos encryp‐
tion).
BUGS
Send bug reports to the authors: Steven G. Johnson
<stevenj@alum.mit.edu>, Ganesh Sittampalam <ganesh@earth.li>, and David
Roundy <droundy@abridgegame.org>.
AUTHORS
The cvs2darcs script was written by Steven G. Johnson as a wrapper
around Perl scripts written by David Roundy and Ganesh Sittampalam.
Copyright (c) 2004 David Roundy
Copyright (c) 2004 Ganesh Sittampalam
Copyright (c) 2004 Steven G. Johnson
SEE ALSOdarcs(1), cvs(1)darcs November, 2004 CVS2DARCS(1)