man1/git-archimport.1

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "GIT-ARCHIMPORT" 1 "" "" ""
  21 .SH NAME
  22 git-archimport \- Import an Arch repository into git
  23 .SH "SYNOPSIS"
  24
  25
  26 git\-archimport [ \-h ] [ \-v ] [ \-o ] [ \-a ] [ \-f ] [ \-T ] [ \-D depth ] [ \-t tempdir ] <archive/branch> [ <archive/branch> ]
  27
  28 .SH "DESCRIPTION"
  29
  30
  31 Imports a project from one or more Arch repositories\&. It will follow branches and repositories within the namespaces defined by the <archive/branch> parameters suppplied\&. If it cannot find the remote branch a merge comes from it will just import it as a regular commit\&. If it can find it, it will mark it as a merge whenever possible (see discussion below)\&.
  32
  33
  34 The script expects you to provide the key roots where it can start the import from an initial import or tag type of Arch commit\&. It will follow and import new branches within the provided roots\&.
  35
  36
  37 It expects to be dealing with one project only\&. If it sees branches that have different roots, it will refuse to run\&. In that case, edit your <archive/branch> parameters to define clearly the scope of the import\&.
  38
  39
  40 git\-archimport uses tla extensively in the background to access the Arch repository\&. Make sure you have a recent version of tla available in the path\&. tla must know about the repositories you pass to git\-archimport\&.
  41
  42
  43 For the initial import git\-archimport expects to find itself in an empty directory\&. To follow the development of a project that uses Arch, rerun git\-archimport with the same parameters as the initial import to perform incremental imports\&.
  44
  45 .SH "MERGES"
  46
  47
  48 Patch merge data from Arch is used to mark merges in git as well\&. git does not care much about tracking patches, and only considers a merge when a branch incorporates all the commits since the point they forked\&. The end result is that git will have a good idea of how far branches have diverged\&. So the import process does lose some patch\-trading metadata\&.
  49
  50
  51 Fortunately, when you try and merge branches imported from Arch, git will find a good merge base, and it has a good chance of identifying patches that have been traded out\-of\-sequence between the branches\&.
  52
  53 .SH "OPTIONS"
  54
  55 .TP
  56 \-h
  57 Display usage\&.
  58
  59 .TP
  60 \-v
  61 Verbose output\&.
  62
  63 .TP
  64 \-T
  65 Many tags\&. Will create a tag for every commit, reflecting the commit name in the Arch repository\&.
  66
  67 .TP
  68 \-f
  69 Use the fast patchset import strategy\&. This can be significantly faster for large trees, but cannot handle directory renames or permissions changes\&. The default strategy is slow and safe\&.
  70
  71 .TP
  72 \-o
  73 Use this for compatibility with old\-style branch names used by earlier versions of git\-archimport\&. Old\-style branch names were category\-\-branch, whereas new\-style branch names are archive,category\-\-branch\-\-version\&.
  74
  75 .TP
  76 \-D <depth>
  77 Follow merge ancestry and attempt to import trees that have been merged from\&. Specify a depth greater than 1 if patch logs have been pruned\&.
  78
  79 .TP
  80 \-a
  81 Attempt to auto\-register archives at http://mirrors\&.sourcecontrol\&.net This is particularly useful with the \-D option\&.
  82
  83 .TP
  84 \-t <tmpdir>
  85 Override the default tempdir\&.
  86
  87 .TP
  88 <archive/branch>
  89 Archive/branch identifier in a format that tla log understands\&.
  90
  91 .SH "AUTHOR"
  92
  93
  94 Written by Martin Langhoff <martin@catalyst\&.net\&.nz>\&.
  95
  96 .SH "DOCUMENTATION"
  97
  98
  99 Documentation by Junio C Hamano, Martin Langhoff and the git\-list <git@vger\&.kernel\&.org>\&.
 100
 101 .SH "GIT"
 102
 103
 104 Part of the \fBgit\fR(7) suite
 105