Mercurial > hg > hg-fastimport

comparison README.rst @ 90:f58882dce2d7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Move README.txt to README.rst and tidy up Now reflects no dependencies, how to install using pip and how to use it. All other information has been discarded and can be found by looking in other files.
author Roy Marples <roy@marples.name>
date Tue, 19 Jan 2021 23:05:11 +0000
parents README.txt@a739b8dc8e6f
children
comparison
equal deleted inserted replaced
89:e6602cc471d5 90:f58882dce2d7
1 =============
2 hg-fastimport
3 =============
4
5 WARNING: this extension is incomplete and lightly tested. It is
6 currently intended for Mercurial developers or particularly daring
7 users.
8
9 hg-fastimport is a Mercurial extension for importing Git's fast-import
10 dumps into Mercurial. fast-import is a file format for representing the
11 entire history of a version control repository.
12
13 This file format was designed to make it easier to write tools which
14 convert from foreign (non-Git) VCS repository formats into Git; such
15 tools exist for CVS, Mercurial, Darcs, and Perforce.
16
17 ==============
18 How to Install
19 ==============
20
21 Using Pip
22 ---------
23
24 You can install the latest released version using pip::
25
26 $ pip install --user hg-fastimport
27
28 Then enable it in yourn hgrc::
29
30 [extensions]
31 fastimport =
32
33 From Source
34 -----------
35
36 To install a local version from source::
37
38 $ hg clone https://roy.marples.name/hg/hg-fastimport/
39 $ cd hg-fastimport
40 $ pip install --user .
41
42 Then enable it in your hgrc::
43
44 [extensions]
45 fastimport =
46
47 ==========
48 How to Use
49 ==========
50
51 To import into a brand-new Mercurial repository::
52
53 $ hg init new
54 $ cd new
55 $ hg fastimport --datesort FILE...
56
57 where FILE... is a list of one or more fast-import dumps.