darcs-fast-export.txt

   1 = darcs-fast-export(1)
   2
   3 == NAME
   4
   5 darcs-fast-export - darcs frontend to git fast-import
   6
   7 == SYNOPSIS
   8
   9 darcs-fast-export [<options>] <darcsrepo>
  10
  11 == DESCRIPTION
  12
  13 darcs-fast-export expects one argument, the path to the source darcs
  14 repository. It will print the git fast-import format on standard output
  15 (stdout).
  16
  17 The script can produce the fast-import stream format from the darcs
  18 repository. It supports incremental conversion as well, via the
  19 --import-marks / --export-marks switches.
  20
  21 Optionally the darcsrepo string may be a HTTP repository, in that case
  22 only the patches are downloaded, not the pristine, speeding up a
  23 one-time import.
  24
  25 == OPTIONS
  26
  27 -h, --help::
  28         Display usage.
  29
  30 --import-marks=<file>::
  31         Import marks from <file>. This is read at the beginning of the
  32         conversion at once. Use it if you want to continue an incremental
  33         conversion.
  34
  35 --export-marks=<file>::
  36         Export marks to <file> at the end of the conversion. It can be the
  37         same as the one for --import-marks as it is written only once at the
  38         end. Use it if you want to be able to incrementally update the target
  39         repository later.
  40
  41 --encoding=<encoding>::
  42         The encoding of the author names and commit messages in the repository.
  43         The default is utf-8. If it is not the default, it will be guessed.
  44         Given that it takes some time, you can explicitly specify it as an
  45         option to make the conversion faster. Content in the output will encoded
  46         as utf-8 and will be written that way to the target repository, unless
  47         the importer re-encodes it again to some other character set.
  48
  49 --working=<directory>::
  50         The conversion is done by applying the patches one by one and recording
  51         the state of the working directory. You can specify the path of this
  52         directory using this option.
  53
  54 --logfile=<logfile>::
  55         The output of external commands are redirected to a log file. You can
  56         specify the path of that file with this parameter.
  57
  58 --git-branch=<branch>::
  59         There is only one branch in one darcs repository, but the fast-import
  60         stream format allows multiple branches, thus the exporter has to name
  61         darcs's branch. The default value is 'refs/heads/master'.
  62
  63 --progress=<n>::
  64         Insert progress statements after every <n> patches, to be shown by the
  65         fast importer during import. The default value is '100'.
  66
  67 --authors-file=<file>::
  68         Read author transformations in old=new format from <file>.