CVS2GITDUMP(1)

NAME
cvs2gitdump - imports a cvs tree into a git repository

SYNOPSIS
cvs2gitdump [-ah] [-z fuzz] [-e email_domain] [-E log_encodings] [-k rcs_keywords] [-b branch] [-m module] [-l last_revision] cvsroot [git_dir]

DESCRIPTION
cvs2gitdump is a small python script which imports a cvs tree into a git repository. cvs2gitdump has a small footprint, supports incremental imports and converts tags to HEAD. It's very fast because the conversion is done in memory.

Options:

-a  By default, the script will only use commits 10 minutes older than the most recent commit because recent commits are not stable if the repository is changing. This option will change this behavior. It will use all the commits.

-b branch
    The git branch which is used for incremental import.

-h  Show the usage.

-z fuzz
    When the script collects changesets from the CVS repository, commits by the same author, using the same log message and within fuzz seconds are collected into the same changeset. 300 (seconds) is used as default.

-e email_domain
    Append the email domain to the author field.

-E log_encodings
    Specify the character encodings used for decoding CVS logs. Multiple encodings can be specified by separating with ','. Specified encodings are used in order for decoding the log. Default is 'utf-8,iso-8859-1'

-k rcs_keywords
    Add an extra RCS keyword which are used by CVS. The script substitutes the RCS keyword by the same way as $Id$.

-m module
    Specify the target module name in the target cvsroot. The script will dump only the directory specified by this option.

-l last_revision
    Specify the last SHA-1 revision which is used for finding the last change set in the CVS tree.

cvsroot
    The target cvsroot or the sub directory of the cvsroot. The script treats this directory as the root directory.

git_dir
    The git repository. Specify this for incremental import.

EXAMPLES
First import:

    $ git init --bare /git/openbsd.git
    $ cvs2gitdump -k OpenBSD -e openbsd.org \
        /cvs/openbsd/src > openbsd.dump
    $ git --git-dir /git/openbsd.git fast-import < openbsd.dump

Periodic import:

    $ cvsync
    $ cvs2gitdump -k OpenBSD -e openbsd.org /cvs/openbsd/src \
        /git/openbsd.git > openbsd2.dump
    $ git --git-dir /git/openbsd.git fast-import < openbsd2.dump

AUTHORS
YASUOKA Masahiko.

CAVEATS
cvs2gitdump doesn't convert branches.