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

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

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

これは単一のプロジェクトのみを扱うことを想定しています。異なるルートを持つブランチを検出した場合、実行を拒否します。その場合、インポートの範囲を明確に定義するために<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] スイートの一部