Diff for "ConvertExtension"

Convert extension

This extension is distributed with Mercurial.

Author: several people

1. Overview

The convert extension converts repositories from other SCMs into mercurial repositories. It currently supports the following repository types:

• CVS
• Subversion
• git

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

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 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")

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

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

5. 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)

CategoryExtension