X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-fast-export.txt;h=277a547a026f69faa0d923ca8a9f191608de7294;hb=e4403d8bd3ccb6bcc3b6569012944d932334f5c4;hp=073ff7f123d633358f57d9995d23da14da81df77;hpb=de4c6011d2d745a3e29b4b0cc94548f34c8855dd;p=git.git diff --git a/Documentation/git-fast-export.txt b/Documentation/git-fast-export.txt index 073ff7f12..277a547a0 100644 --- a/Documentation/git-fast-export.txt +++ b/Documentation/git-fast-export.txt @@ -13,29 +13,49 @@ SYNOPSIS DESCRIPTION ----------- This program dumps the given revisions in a form suitable to be piped -into gitlink:git-fast-import[1]. +into linkgit:git-fast-import[1]. You can use it as a human readable bundle replacement (see -gitlink:git-bundle[1]), or as a kind of an interactive -gitlink:git-filter-branch[1]. +linkgit:git-bundle[1]), or as a kind of an interactive +linkgit:git-filter-branch[1]. OPTIONS ------- --progress=:: Insert 'progress' statements every objects, to be shown by - gitlink:git-fast-import[1] during import. + linkgit:git-fast-import[1] during import. ---signed-tags=(ignore|warn|strip|abort):: +--signed-tags=(verbatim|warn|strip|abort):: Specify how to handle signed tags. Since any transformation after the export can change the tag names (which can also happen when excluding revisions) the signatures will not match. + When asking to 'abort' (which is the default), this program will die when encountering a signed tag. With 'strip', the tags will be made -unsigned, with 'ignore', they will be silently ignored (i.e. not exported) +unsigned, with 'verbatim', they will be silently exported and with 'warn', they will be exported, but you will see a warning. +--export-marks=:: + Dumps the internal marks table to when complete. + Marks are written one per line as `:markid SHA-1`. Only marks + for revisions are dumped; marks for blobs are ignored. + Backends can use this file to validate imports after they + have been completed, or to save the marks table across + incremental runs. As is only opened and truncated + at completion, the same path can also be safely given to + \--import-marks. + +--import-marks=:: + Before processing any input, load the marks specified in + . The input file must exist, must be readable, and + must use the same format as produced by \--export-marks. ++ +Any commits that have already been marked will not be exported again. +If the backend uses a similar \--import-marks file, this allows for +incremental bidirectional exporting of the repository by keeping the +marks the same across runs. + EXAMPLES -------- @@ -65,7 +85,7 @@ referenced by that revision range contains the string Limitations ----------- -Since gitlink:git-fast-import[1] cannot tag trees, you will not be +Since linkgit:git-fast-import[1] cannot tag trees, you will not be able to export the linux-2.6.git repository completely, as it contains a tag referencing a tree instead of a commit. @@ -80,4 +100,4 @@ Documentation by Johannes E. Schindelin . GIT --- -Part of the gitlink:git[7] suite +Part of the linkgit:git[1] suite