git-archimport — Імпорт репозиторію GNU Arch у Git

Імпортує проєкт з одного або декількох репозиторіїв GNU Arch. Буде слідувати гілкам та репозиторіям у просторах імен, визначених за допомогою наданих параметрів <archive>/<branch>. Якщо не вдасться знайти віддалену гілку, з якої походить злиття, проєкт просто імпортується як звичайний коміт. Якщо ж гілку вдасться знайти, вона буде позначена як злиття, коли це можливо (див. пояснення нижче).

Скрипт очікує, що ви вкажете кореневі теки, з яких він зможе розпочати імпорт з коміту Arch типу «initial import» або «tag». Він буде відстежувати та імпортувати нові гілки в межах вказаних коренів.

Інструмент розрахований на роботу лише з одним проєктом. Якщо він виявить гілки з різними коренями, він відмовиться працювати. У такому випадку відредагуйте параметри <archive>/<branch>, щоб чітко визначити область імпорту.

git archimport активно використовує tla у фоновому режимі для доступу до репозиторію Arch. Переконайтеся, що у вас є остання версія tla, доступна у шляху. tla повинен знати про репозиторії, які ви передаєте до git archimport.

Під час початкового імпорту команда «git archimport» очікує, що вона знаходиться в порожній теці. Щоб стежити за розвитком проєкту, який використовує Arch, запустіть команду «git archimport» знову з тими самими параметрами, що й під час початкового імпорту, щоб виконати інкрементний імпорт.

Хоча «git archimport» намагатиметься створити зрозумілі назви гілок для архівів, які він імпортує, також можна вказати назви гілок Git вручну. Для цього вкажіть назву гілки Git після кожного параметра <archive>/<branch>, відділивши її двокрапкою. Таким чином, ви можете скоротити назви гілок Arch та перетворити жаргон Arch на жаргон Git, наприклад, зіставивши гілку "PROJECT--devo--VERSION" з "master".

Можна пов’язати кілька гілок Arch з однією гілкою Git; такий підхід буде доцільним лише в тому випадку, якщо після створення другої гілки в першу гілку не буде внесено жодних комітів. Проте це корисно для перетворення репозиторіїв Arch, які періодично оновлювалися.

Дані про злиття латок з Arch використовуються також для позначення злиття в Git. Git не приділяє великої уваги відстеженню латок і вважає злиттям лише той випадок, коли гілка включає всі коміти, зроблені з моменту її відгалуження. У результаті Git отримує чітке уявлення про те, наскільки гілки розійшлися. Отже, під час імпортування втрачається частина метаданих про обмін латками.

На щастя, коли ви намагаєтеся об’єднати гілки, імпортовані з Arch, Git знайде оптимальну базу для злиття і, швидше за все, виявить латки, які були перенесені між гілками у неправильній послідовності.

Частина набору git[1]