.TH CVS2GIT "1" "August 2009" "Git" "User Commands"
.SH NAME
cvs2git \- convert a cvs repository into a git repository
.SH SYNOPSIS
.B cvs2git
\fI--options OPTIONFILE\fR
.SH DESCRIPTION
.IP
cvs2git [OPTION...] OUTPUT\-OPTION CVS\-REPOS\-PATH
.PP
Convert a CVS repository into a Subversion repository, including history.
.SH OPTIONS
.IP
Configuration via options file:
.TP
\fB\-\-options\fR=\fIPATH\fR
read the conversion options from PATH.  This method
allows more flexibility than using command\-line
options.  See documentation for info
.IP
Output options:
.TP
\fB\-\-blobfile\fR=\fIPATH\fR
path to which the "blob" data should be written
.TP
\fB\-\-dumpfile\fR=\fIPATH\fR
path to which the revision data should be written
.TP
\fB\-\-dry\-run\fR
do not create any output; just print what would
happen.
.IP
Conversion options:
.TP
\fB\-\-trunk\-only\fR
convert only trunk commits, not tags nor branches
.TP
\fB\-\-encoding\fR=\fIENC\fR
encoding for paths and log messages in CVS repos.  If
option is specified multiple times, encoders are tried
in order until one succeeds.  See
http://docs.python.org/lib/standard\-encodings.html for
a list of standard Python encodings.
.TP
\fB\-\-fallback\-encoding\fR=\fIENC\fR
If all \fB\-\-encodings\fR fail, use lossy encoding with ENC
.TP
\fB\-\-retain\-conflicting\-attic\-files\fR
if a file appears both in and out of the CVS Attic,
then leave the attic version in a SVN directory called
"Attic"
.IP
Symbol handling:
.TP
\fB\-\-symbol\-transform\fR=\fIP\fR:S
transform symbol names from P to S, where P and S use
Python regexp and reference syntax respectively.  P
must match the whole symbol name
.TP
\fB\-\-symbol\-hints\fR=\fIPATH\fR
read symbol conversion hints from PATH
.TP
\fB\-\-symbol\-default\fR=\fIOPT\fR
specify how ambiguous symbols are converted.  OPT is
"heuristic" (default), "strict", "branch", or "tag"
.TP
\fB\-\-force\-branch\fR=\fIREGEXP\fR
force symbols matching REGEXP to be branches
.TP
\fB\-\-force\-tag\fR=\fIREGEXP\fR
force symbols matching REGEXP to be tags
.TP
\fB\-\-exclude\fR=\fIREGEXP\fR
exclude branches and tags matching REGEXP
.TP
\fB\-\-keep\-trivial\-imports\fR
do not exclude branches that were only used for a
single import (usually these are unneeded)
.IP
Subversion properties:
.TP
\fB\-\-username\fR=\fINAME\fR
username for cvs2svn\-synthesized commits
.TP
\fB\-\-auto\-props\fR=\fIFILE\fR
set file properties from the auto\-props section of a
file in svn config format
.TP
\fB\-\-mime\-types\fR=\fIFILE\fR
specify an apache\-style mime.types file for setting
svn:mime\-type
.TP
\fB\-\-eol\-from\-mime\-type\fR
set svn:eol\-style from mime type if known
.TP
\fB\-\-default\-eol\fR=\fISTYLE\fR
default svn:eol\-style for non\-binary files with
undetermined mime types.  STYLE is "binary" (default),
"native", "CRLF", "LF", or "CR"
.TP
\fB\-\-keywords\-off\fR
don't set svn:keywords on any files (by default,
cvs2svn sets svn:keywords on non\-binary files to
"Author Date Id Revision")
.TP
\fB\-\-keep\-cvsignore\fR
keep .cvsignore files (in addition to creating the
analogous svn:ignore properties)
.TP
\fB\-\-cvs\-revnums\fR
record CVS revision numbers as file properties
.IP
Extraction options:
.TP
\fB\-\-use\-cvs\fR
use CVS to extract revision contents (slower than
\fB\-\-use\-rcs\fR but more reliable) (default)
.TP
\fB\-\-use\-rcs\fR
use RCS to extract revision contents (faster than
\fB\-\-use\-cvs\fR but fails in some cases)
.IP
Environment options:
.TP
\fB\-\-tmpdir\fR=\fIPATH\fR
directory to use for temporary data files (default
"cvs2svn\-tmp")
.TP
\fB\-\-co\fR=\fIPATH\fR
path to the "co" program (required if \fB\-\-use\-rcs\fR)
.TP
\fB\-\-cvs\fR=\fIPATH\fR
path to the "cvs" program (required if \fB\-\-use\-cvs\fR)
.TP
\fB\-\-sort\fR=\fIPATH\fR
path to the GNU "sort" program
.IP
Partial conversions:
.TP
\fB\-\-pass\fR=\fIPASS\fR
execute only specified PASS of conversion
.TP
\fB\-p\fR [START]:[END], \fB\-\-passes\fR=\fI[START]\fR:[END]
execute passes START through END, inclusive (PASS,
START, and END can be pass names or numbers)
.IP
Information options:
.TP
\fB\-\-version\fR
print the version number
.TP
\fB\-h\fR, \fB\-\-help\fR
print this usage message and exit with success
.TP
\fB\-\-help\-passes\fR
list the available passes and their numbers
.TP
\fB\-\-man\fR
write the manpage for this program to standard output
.TP
\fB\-v\fR, \fB\-\-verbose\fR
verbose (may be specified twice for debug output)
.TP
\fB\-q\fR, \fB\-\-quiet\fR
quiet (may be specified twice for very quiet)
.TP
\fB\-\-write\-symbol\-info\fR=\fIPATH\fR
write information and statistics about CVS symbols to
PATH.
.TP
\fB\-\-skip\-cleanup\fR
prevent the deletion of intermediate files
.TP
\fB\-\-profile\fR
profile with 'hotshot' (into file cvs2svn.hotshot)
.SH AUTHORS
Manpage was converted for the Debian GNU/Linux system with help2man by
Laszlo 'GCS' Boszormenyi <gcs@debian.hu> (but may be used by others).
.SH SEE ALSO
cvs(1), git(1)