简体中文 ▾ 主题 ▾ 最新版本 ▾ git-archimport 上次更新于 2.35.0

名称

git-archimport - 将 GNU Arch 仓库导入 Git

概要

git archimport [-h] [-v] [-o] [-a] [-f] [-T] [-D <depth>] [-t <tempdir>]
	       <archive>/<branch>[:<git-branch>]…​

描述

从一个或多个 GNU Arch 仓库导入项目。它将跟随由提供的 <archive>/<branch> 参数定义的命名空间内的分支和仓库。如果找不到远程分支的合并来源，它将仅将其作为普通提交导入。如果找到，它将尽可能标记为合并（请参阅下面的讨论）。

脚本期望您提供关键根目录，以便它可以从初始导入或标签类型的 Arch 提交开始导入。它将跟随并导入提供根目录内的新分支。

它期望只处理一个项目。如果它看到具有不同根目录的分支，它将拒绝运行。在这种情况下，请编辑您的 <archive>/<branch> 参数以清楚地定义导入的范围。

git archimport 在后台广泛使用 tla 来访问 Arch 仓库。请确保在路径中有一个最新版本的 tla。 tla 必须了解您传递给 git archimport 的仓库。

对于初始导入，git archimport 期望在一个空目录中运行。要跟踪使用 Arch 的项目开发，请使用与初始导入相同的参数重新运行 git archimport 以执行增量导入。

虽然 git archimport 会尝试为它导入的仓库创建有意义的分支名称，但也可以手动指定 Git 分支名称。为此，请在每个 <archive>/<branch> 参数后面写一个 Git 分支名称，用冒号分隔。这样，您可以缩短 Arch 分支名称并将 Arch 术语转换为 Git 术语，例如将 "PROJECT--devo--VERSION" 分支映射到 "master"。

可以将多个 Arch 分支关联到一个 Git 分支；仅当在第二个分支创建后，第一个分支没有进行任何提交时，结果才有意义。尽管如此，这对于转换定期轮换的 Arch 仓库很有用。

合并

来自 Arch 的补丁合并数据也用于在 Git 中标记合并。Git 不太关心跟踪补丁，只在分支包含自它们分叉以来的所有提交时才考虑合并。最终结果是 Git 将很好地了解分支的差异程度。因此，导入过程会丢失一些补丁交易元数据。

幸运的是，当您尝试合并从 Arch 导入的分支时，Git 将找到一个好的合并基础，并且很有可能识别出在分支之间乱序交易的补丁。

选项

-h

显示用法。

-v

详细输出。

-T

多标签。将为每个提交创建一个标签，反映 Arch 仓库中的提交名称。

-f

使用快速补丁集导入策略。对于大型树，这可能速度快很多，但无法处理目录重命名或权限更改。默认策略速度慢但安全。

-o

使用此选项可与早期版本的 git archimport 使用过的旧式分支名称兼容。旧式分支名称是 category--branch，而新式分支名称是 archive,category--branch--version。在这两种情况下，命令行上给出的名称将覆盖自动生成的名称。

-D <depth>

跟踪合并祖先并尝试导入已被合并的树。如果补丁日志已被修剪，请指定大于 1 的深度。

-a

尝试在 http://mirrors.sourcecontrol.net 自动注册仓库。这在使用 -D 选项时特别有用。

-t <tmpdir>

覆盖默认的临时目录。

<archive>/<branch>

<archive>/<branch> 标识符，格式为 tla log 可以理解。

GIT

Git[1] 套件的一部分