Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 63 lines (44 sloc) 2.312 kb
b5b6497 @nominolo Start a README
nominolo authored
1 darcs-to-git
2 written by Steve Purcell, some improvements by Thomas Schilling
3
4 Converts a Darcs repository into a Git repository. Supports
5 incremental updates, i.e., you can pull new patches from the source
6 repository or import a large repository in steps.
7
8 USAGE
9 =====
10
11 (Use `darcs-to-git --help` to display the latest usage instructions.)
12
13 1. Create an *empty* directory that will become the new git repository
14 2. From inside that directory, run this program, passing the location
15 of the local source darcs repo as a parameter
16
17 The program will git-init the empty directory, and migrate all patches
18 in the source darcs repo into commits in that repository.
19
20 Thereafter, incremental patch conversion from the same source repo is
21 possible by repeating step 2.
22
23 Options
24 -------
25
26 * `--patches N`: only import `N` patches.
27
28 * `--email-address ADDRESS`: `darcs-to-git` tries to reconstruct the
29 email address from the darcs patch. In cases this is not possible,
30 a default will be picked by Git. This is usually the one in
31 `~/.gitconfig`. This option allows you to specify another default
32 (without having to to modify `~/.gitconfig.)
33
34 * `--list-authors`: Outputs a list of authors in the source
35 repository and how they will appear in the git repository and
36 quits. The output will be lines like this:
37
38 Jane@example.com: Jane <Jane@example.com>
39
40 This means that the darcs author "Jane@example.com" will be
41 translated to git-author "Jane" with email address
42 "Jane@example.com". You can use the output of this command as a
43 starting point for the input for `--author-map`.
44
45 * `--author-map FILENAME`: Allows translations from darcs committer
46 name to Git committer name. The input is a YAML map. For an
ca12ee3 @nominolo Remember author substitition map
nominolo authored
47 example see the output of `--author-map`. The author map will be
7c3754f @nominolo Warn about conflict handling issues
nominolo authored
48 stored in the repository and will be re-used for future imports.
49
50
51 KNOWN ISSUES
52 ------------
53
54 When `darcs-to-git` pulls a conflicting patch it will revert the state
55 of the repository to the state before the conflict. *THIS WILL ALSO
56 REMOVE ANY LOCAL CHANGES TO YOUR REPOSITORY, INCLUDING GIT COMMITS!*
57 You should therefore not commit to the branch you import to, but
58 instead work in a different branch. You can rename your master branch
59 after import using:
60
61 $ git branch -m darcs_import
62
Something went wrong with that request. Please try again.