نام (NAME)

git-archimport - وارد کردن یک مخزن GNU Arch به گیت

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

یک پروژه را از یک یا چند مخزن GNU Arch وارد می‌کند. این دستور شاخه‌ها و مخازن را درون فضاهای نام تعریف‌شده توسط پارامترهای <archive>/<branch> ارائه‌شده دنبال خواهد کرد. اگر نتواند شاخهٔ دوری را که یک ادغام از آن آمده است پیدا کند، آن را صرفاً به عنوان یک کامیت عادی وارد می‌کند. در صورتی که بتواند آن را بیابد، هر زمان که ممکن باشد آن را به عنوان یک ادغام علامت‌گذاری خواهد کرد (توضیحات زیر را ببینید).

این اسکریپت انتظار دارد ریشه‌های کلیدی را مشخص کنید تا بتواند درون‌ریزی را از یک نوع کامیت Arch از نوع initial import یا tag آغاز کند. این ابزار شاخه‌های جدید را درون ریشه‌های ارائه‌شده دنبال کرده و وارد می‌کند.

انتظار می‌رود این ابزار تنها با یک پروژه سروکار داشته باشد. اگر شاخه‌هایی با ریشه‌های متفاوت ببیند، از اجرا خودداری می‌کند. در این حالت، پارامترهای <archive>/<branch> خود را ویرایش کنید تا محدودهٔ درون‌ریزی را به‌طور واضح مشخص سازید.

دستور git archimport در پس‌زمینه به‌طور گسترده از tla برای دسترسی به مخزن Arch استفاده می‌کند. مطمئن شوید که نسخهٔ جدیدی از tla در مسیر اجرایی (PATH) در دسترس باشد. ابزار tla باید مخازنی را که به git archimport منتقل می‌کنید بشناسد.

برای درون‌ریزی اولیه، git archimport انتظار دارد در یک دایرکتوری خالی اجرا شود. برای دنبال کردن روند توسعهٔ پروژه‌ای که از Arch استفاده می‌کند، git archimport را با همان پارامترهای درون‌ریزی اولیه مجدداً اجرا کنید تا درون‌ریزی‌های افزایشی را انجام دهد.

اگرچه git archimport تلاش خواهد کرد نام‌های شاخهٔ معقولی برای آرشیوهایی که وارد می‌کند بسازد، اما تعیین دستی نام‌های شاخهٔ گیت نیز امکان‌پذیر است. برای این منظور، نام شاخهٔ گیت را پس از هر پارامتر <archive>/<branch> بنویسید که با یک علامت دونقطه از هم جدا شده باشند. به این ترتیب می‌توانید نام‌های شاخهٔ Arch را کوتاه کرده و اصطلاحات خاص Arch را به اصطلاحات گیت تبدیل کنید؛ برای مثال نگاشت یک شاخهٔ "PROJECT--devo--VERSION" به "master".

مرتبط کردن چندین شاخهٔ Arch به یک شاخهٔ گیت امکان‌پذیر است؛ نتیجه تنها در صورتی منطقی‌ترین حالت خواهد بود که پس از ایجاد شاخهٔ دوم، هیچ کمیتی در شاخهٔ اول ثبت نشود. با این حال، این کار برای تبدیل مخازن Arch که به‌طور دوره‌ای چرخانده شده‌اند مفید است.

ادغام‌ها (MERGES)

داده‌های ادغام وصله از Arch برای علامت‌گذاری ادغام‌ها در گیت نیز به کار می‌رود. گیت توجه چندانی به ردگیری وصله‌ها ندارد، و تنها زمانی یک ادغام را به حساب می‌آورد که یک شاخه تمام کامیت‌های پس از نقطهٔ انشعاب را دربر داشته باشد. نتیجهٔ نهایی این است که گیت دید خوبی از میزان واگرایی شاخه‌ها از یکدیگر خواهد داشت. بنابراین فرآیند درون‌ریزی بخشی از فراداده‌های تبادل وصله (patch-trading) را از دست می‌دهد.

خوشبختانه، هنگامی که تلاش می‌کنید شاخه‌های واردشده از Arch را ادغام کنید، گیت یک مبنای ادغام مناسب پیدا می‌کند و شانس بالایی برای شناسایی وصله‌هایی خواهد داشت که بدون رعایت ترتیب میان شاخه‌ها تبادل شده‌اند.

گزینه‌ها (OPTIONS)

-h

-v

-T

-f

-o

-D <depth>

-a

-t <tmpdir>

<archive>/<branch>

گیت (GIT)

بخشی از مجموعه git(1)