NAME¶
cvs2git - convert a cvs repository into a git repository
SYNOPSIS¶
cvs2git --options OPTIONFILE
DESCRIPTION¶
- cvs2git [OPTION...] OUTPUT-OPTION CVS-REPOS-PATH
Convert a CVS repository into a Subversion repository, including history.
OPTIONS¶
- Configuration via options file:
- --options=PATH
- read the conversion options from PATH. This method allows
more flexibility than using command-line options. See documentation for
info
- Output options:
- --blobfile=PATH
- path to which the "blob" data should be
written
- --dumpfile=PATH
- path to which the revision data should be written
- --dry-run
- do not create any output; just print what would
happen.
- Conversion options:
- --trunk-only
- convert only trunk commits, not tags nor branches
- --encoding=ENC
- 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.
- --fallback-encoding=ENC
- If all --encodings fail, use lossy encoding with
ENC
- --retain-conflicting-attic-files
- if a file appears both in and out of the CVS Attic, then
leave the attic version in a SVN directory called "Attic"
- Symbol handling:
- --symbol-transform=P: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
- --symbol-hints=PATH
- read symbol conversion hints from PATH
- --symbol-default=OPT
- specify how ambiguous symbols are converted. OPT is
"heuristic" (default), "strict", "branch",
or "tag"
- --force-branch=REGEXP
- force symbols matching REGEXP to be branches
- --force-tag=REGEXP
- force symbols matching REGEXP to be tags
- --exclude=REGEXP
- exclude branches and tags matching REGEXP
- --keep-trivial-imports
- do not exclude branches that were only used for a single
import (usually these are unneeded)
- Subversion properties:
- --username=NAME
- username for cvs2svn-synthesized commits
- --auto-props=FILE
- set file properties from the auto-props section of a file
in svn config format
- --mime-types=FILE
- specify an apache-style mime.types file for setting
svn:mime-type
- --eol-from-mime-type
- set svn:eol-style from mime type if known
- --default-eol=STYLE
- default svn:eol-style for non-binary files with
undetermined mime types. STYLE is "binary" (default),
"native", "CRLF", "LF", or
"CR"
- --keywords-off
- don't set svn:keywords on any files (by default, cvs2svn
sets svn:keywords on non-binary files to "Author Date Id
Revision")
- --keep-cvsignore
- keep .cvsignore files (in addition to creating the
analogous svn:ignore properties)
- --cvs-revnums
- record CVS revision numbers as file properties
- Extraction options:
- --use-cvs
- use CVS to extract revision contents (slower than
--use-rcs but more reliable) (default)
- --use-rcs
- use RCS to extract revision contents (faster than
--use-cvs but fails in some cases)
- Environment options:
- --tmpdir=PATH
- directory to use for temporary data files (default
"cvs2svn-tmp")
- --co=PATH
- path to the "co" program (required if
--use-rcs)
- --cvs=PATH
- path to the "cvs" program (required if
--use-cvs)
- --sort=PATH
- path to the GNU "sort" program
- Partial conversions:
- --pass=PASS
- execute only specified PASS of conversion
- -p [START]:[END],
--passes=[START]:[END]
- execute passes START through END, inclusive (PASS, START,
and END can be pass names or numbers)
- Information options:
- --version
- print the version number
- -h, --help
- print this usage message and exit with success
- --help-passes
- list the available passes and their numbers
- --man
- write the manpage for this program to standard output
- -v, --verbose
- verbose (may be specified twice for debug output)
- -q, --quiet
- quiet (may be specified twice for very quiet)
- --write-symbol-info=PATH
- write information and statistics about CVS symbols to
PATH.
- --skip-cleanup
- prevent the deletion of intermediate files
- --profile
- profile with 'hotshot' (into file cvs2svn.hotshot)
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).
SEE ALSO¶
cvs(1),
git(1)