git-archimport - GNU ArchリポジトリをGitにインポートする

1つ以上のGNU Archリポジトリからプロジェクトをインポートします。 提供された <archive>/<branch> パラメータで定義された名前空間内のブランチとリポジトリをフォローします。 マージ元のリモートブランチが見つからない場合は、通常のコミットとしてインポートします。 見つかった場合は、可能な限りマージとしてマークします（以下の説明を参照）。

このスクリプトは、Archの *初期インポート* または *タグ* タイプのコミットからインポートを開始できる主要なルートを提供することを想定しています。 提供されたルート内で新しいブランチをフォローしてインポートします。

1つのプロジェクトのみを扱うことを想定しています。 ルートが異なるブランチが見つかった場合は、実行を拒否します。 その場合は、<archive>/<branch> パラメータを編集して、インポートの範囲を明確に定義してください。

*git archimport* は、Archリポジトリにアクセスするためにバックグラウンドで *tla* を広範囲に使用します。 パスに *tla* の最新バージョンがあることを確認してください。 *tla* は、 *git archimport* に渡すリポジトリについて知っている必要があります。

初期インポートの場合、 *git archimport* は空のディレクトリにいることを想定しています。 Archを使用するプロジェクトの開発を追跡するには、初期インポートと同じパラメータを使用して *git archimport* を再実行して、増分インポートを実行します。

*git archimport* は、インポートするアーカイブに対して適切なブランチ名を作成しようとしますが、Gitブランチ名を手動で指定することもできます。 これを行うには、各 <archive>/<branch> パラメータの後に、コロンで区切ってGitブランチ名を記述します。 この方法で、Archブランチ名を短縮し、Archの専門用語をGitの専門用語に変換できます。たとえば、「PROJECT--devo--VERSION」ブランチを「master」にマッピングできます。

複数のArchブランチを1つのGitブランチに関連付けることができます。 2番目のブランチが作成された後、最初のブランチにコミットが行われない場合にのみ、結果は最も理にかなっています。それでも、これは定期的にローテーションされていたArchリポジトリを変換するのに役立ちます。

Archのパッチマージデータを使用して、Gitのマージもマークします。 Gitはパッチの追跡にあまり関心がなく、ブランチが分岐した時点からのすべてのコミットを組み込んだ場合にのみマージを考慮します。 最終結果は、Gitがブランチの分岐の程度をよく理解できるようになることです。そのため、インポートプロセスでは、パッチ交換メタデータがいくらか失われます。

さいわい、Archからインポートされたブランチをマージしようとすると、Gitは適切なマージベースを見つけ、ブランチ間で順序どおりに交換されていないパッチを識別できる可能性が高くなります。

git[1] スイートの一部