git-archimport - 將 GNU Arch 倉庫匯入 Git

從一個或多個 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 會找到一個很好的合併基礎，並且很有可能識別出在分支之間非順序交換的補丁。

Git[1] 套件的一部分