]>
Commit | Line | Data |
---|---|---|
1 | git-fast-export(1) | |
2 | ================== | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | git-fast-export - Git data exporter | |
7 | ||
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
11 | 'git-fast-export [options]' | 'git-fast-import' | |
12 | ||
13 | DESCRIPTION | |
14 | ----------- | |
15 | This program dumps the given revisions in a form suitable to be piped | |
16 | into linkgit:git-fast-import[1]. | |
17 | ||
18 | You can use it as a human readable bundle replacement (see | |
19 | linkgit:git-bundle[1]), or as a kind of an interactive | |
20 | linkgit:git-filter-branch[1]. | |
21 | ||
22 | ||
23 | OPTIONS | |
24 | ------- | |
25 | --progress=<n>:: | |
26 | Insert 'progress' statements every <n> objects, to be shown by | |
27 | linkgit:git-fast-import[1] during import. | |
28 | ||
29 | --signed-tags=(verbatim|warn|strip|abort):: | |
30 | Specify how to handle signed tags. Since any transformation | |
31 | after the export can change the tag names (which can also happen | |
32 | when excluding revisions) the signatures will not match. | |
33 | + | |
34 | When asking to 'abort' (which is the default), this program will die | |
35 | when encountering a signed tag. With 'strip', the tags will be made | |
36 | unsigned, with 'verbatim', they will be silently exported | |
37 | and with 'warn', they will be exported, but you will see a warning. | |
38 | ||
39 | ||
40 | EXAMPLES | |
41 | -------- | |
42 | ||
43 | ------------------------------------------------------------------- | |
44 | $ git fast-export --all | (cd /empty/repository && git fast-import) | |
45 | ------------------------------------------------------------------- | |
46 | ||
47 | This will export the whole repository and import it into the existing | |
48 | empty repository. Except for reencoding commits that are not in | |
49 | UTF-8, it would be a one-to-one mirror. | |
50 | ||
51 | ----------------------------------------------------- | |
52 | $ git fast-export master~5..master | | |
53 | sed "s|refs/heads/master|refs/heads/other|" | | |
54 | git fast-import | |
55 | ----------------------------------------------------- | |
56 | ||
57 | This makes a new branch called 'other' from 'master~5..master' | |
58 | (i.e. if 'master' has linear history, it will take the last 5 commits). | |
59 | ||
60 | Note that this assumes that none of the blobs and commit messages | |
61 | referenced by that revision range contains the string | |
62 | 'refs/heads/master'. | |
63 | ||
64 | ||
65 | Limitations | |
66 | ----------- | |
67 | ||
68 | Since linkgit:git-fast-import[1] cannot tag trees, you will not be | |
69 | able to export the linux-2.6.git repository completely, as it contains | |
70 | a tag referencing a tree instead of a commit. | |
71 | ||
72 | ||
73 | Author | |
74 | ------ | |
75 | Written by Johannes E. Schindelin <johannes.schindelin@gmx.de>. | |
76 | ||
77 | Documentation | |
78 | -------------- | |
79 | Documentation by Johannes E. Schindelin <johannes.schindelin@gmx.de>. | |
80 | ||
81 | GIT | |
82 | --- | |
83 | Part of the linkgit:git[7] suite |