Diff for "ConvertExtension"

Convert extension

This extension is distributed with Mercurial.

Author: several people

1. Overview

The convert extension converts repositories from other SCMs (or even Mercurial itself) into Mercurial repositories, with options for filtering and renaming. It currently supports the following repository types:

• CVS
• Darcs
• Git
• Mercurial
• Subversion

It supports branches and incremental or ongoing conversion, as well as some features for tidying up new repositories, such as pruning parts of the tree and rewriting author names.

2. Configuration

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
hgext.convert=

3. Usage

hg convert source [destination]

If destination is not provided, it will be created as source-hg.

Convert can optionally stop importing at a given revision, if the --rev option is provided. The argument should be given in terms the source understands (e.g. a revision number for Subversion sources, or a hash for git sources).

Convert can also remap author names during conversion, if the --authors option is provided. The argument should be a simple text file maps each source commit author to a destination commit author. It is handy for source SCMs that use unix logins to identify authors (eg: CVS). One line per author mapping and the line format is:

srcauthor=whatever string you want

Convert can also filter or rename files during conversion, when you supply it a mapping via the --filemap option. The filemap is a file that allows filtering and remapping of files and directories. Comment lines start with #. Each line can contain one of the following directives:

• include path/to/file

• exclude path/to/file

• rename from/file to/file

The include directive causes a file, or all files under a directory, to be included in the destination repository. The exclude directive causes files or directories to be omitted. The rename directive renames a file or directory. To rename from a subdirectory into the root of the repository, use . as the path to rename to.

Normally convert will import revisions in an order that produces the fewest jumps between branches in the commit log. If you want to make the revision order in the destination more closely match that of the parent, use the --datesort flag.

4. Converting from CVS

[http://www.cobite.com/cvsps/ cvsps] is a prerequisite. On Windows, cvsps requires cygwin.

5. Converting from Darcs

The converter does not currently handle patch conflicts very well. For more detail, see the notes in [http://selenic.com/repo/hg/file/tip/tests/test-convert-darcs tests/test-convert-darcs]. If you encounter this problem, try using the deprecated contrib/darcs2hg.py script instead.

6. Converting from Subversion

Subversion's Python bindings are a prerequisite. The converter works best with local repositories (file://...), so you may want to use svnsync to create one if your access method is remote (especially if it is via http). The source may be a URL or a path to a repository or working directory. The converter supports a few Subversion-specific options:

svn.trunk

Relative path to the trunk (default: "trunk")

svn.branches

Relative path to tree of branches (default: "branches")

svn.tags

Relative path to tree of tags (default: "tags")

Set these under [convert] in a hgrc, or on the command line as follows:

hg convert --config convert.svn.trunk=wackoname [...]

7. Converting to Mercurial

The Mercurial back end supports the following configuration options:

hg.usebranchnames

Use named branches to record source branches (default: true)

hg.clonebranches

Create branches as clones of their parent branches. All branches will be created as subdirectories of the convert destination. (default: false)

hg.tagsbranch

Put tags on the given branch (default: default)

CategoryExtension