projects / thirdparty / git.git / blame
| Commit | Line | Data |
|---|---|---|
| f2dc849e JS |
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 | |
| 5162e697 | 16 | into linkgit:git-fast-import[1]. |
| f2dc849e JS |
17 | |
| 18 | You can use it as a human readable bundle replacement (see | |
| 5162e697 DM |
19 | linkgit:git-bundle[1]), or as a kind of an interactive |
| 20 | linkgit:git-filter-branch[1]. | |
| f2dc849e JS |
21 | |
| 22 | ||
| 23 | OPTIONS | |
| 24 | ------- | |
| 25 | --progress=<n>:: | |
| 26 | Insert 'progress' statements every <n> objects, to be shown by | |
| 5162e697 | 27 | linkgit:git-fast-import[1] during import. |
| f2dc849e | 28 | |
| ee4bc371 | 29 | --signed-tags=(verbatim|warn|strip|abort):: |
| f2dc849e JS |
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 | |
| ee4bc371 | 36 | unsigned, with 'verbatim', they will be silently exported |
| f2dc849e JS |
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 | ||
| 5162e697 | 68 | Since linkgit:git-fast-import[1] cannot tag trees, you will not be |
| f2dc849e JS |
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 | --- | |
| 5162e697 | 83 | Part of the linkgit:git[7] suite |