'\" t
.\"     Title: git-archimport
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-ARCHIMPORT" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-archimport \- وارد کردن یک مخزن GNU Arch به گیت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit archimport\fR [\-h] [\-v] [\-o] [\-a] [\-f] [\-T] [\-D <depth>] [\-t <tempdir>]
               <archive>/<branch>[:<git\-branch>]\&...
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
یک پروژه را از یک یا چند مخزن GNU Arch وارد می‌کند\&. این دستور شاخه‌ها و مخازن را درون فضاهای نام تعریف‌شده توسط پارامترهای <archive>/<branch> ارائه‌شده دنبال خواهد کرد\&. اگر نتواند شاخهٔ دوری را که یک ادغام از آن آمده است پیدا کند، آن را صرفاً به عنوان یک کامیت عادی وارد می‌کند\&. در صورتی که بتواند آن را بیابد، هر زمان که ممکن باشد آن را به عنوان یک ادغام علامت‌گذاری خواهد کرد (توضیحات زیر را ببینید)\&.
.sp
این اسکریپت انتظار دارد ریشه‌های کلیدی را مشخص کنید تا بتواند درون‌ریزی را از یک نوع کامیت Arch از نوع \fIinitial import\fR یا \fItag\fR آغاز کند\&. این ابزار شاخه‌های جدید را درون ریشه‌های ارائه‌شده دنبال کرده و وارد می‌کند\&.
.sp
انتظار می‌رود این ابزار تنها با یک پروژه سروکار داشته باشد\&. اگر شاخه‌هایی با ریشه‌های متفاوت ببیند، از اجرا خودداری می‌کند\&. در این حالت، پارامترهای <archive>/<branch> خود را ویرایش کنید تا محدودهٔ درون‌ریزی را به‌طور واضح مشخص سازید\&.
.sp
دستور \fIgit archimport\fR در پس‌زمینه به‌طور گسترده از \fBtla\fR برای دسترسی به مخزن Arch استفاده می‌کند\&. مطمئن شوید که نسخهٔ جدیدی از \fBtla\fR در مسیر اجرایی (PATH) در دسترس باشد\&. ابزار \fBtla\fR باید مخازنی را که به \fIgit archimport\fR منتقل می‌کنید بشناسد\&.
.sp
برای درون‌ریزی اولیه، \fIgit archimport\fR انتظار دارد در یک دایرکتوری خالی اجرا شود\&. برای دنبال کردن روند توسعهٔ پروژه‌ای که از Arch استفاده می‌کند، \fIgit archimport\fR را با همان پارامترهای درون‌ریزی اولیه مجدداً اجرا کنید تا درون‌ریزی‌های افزایشی را انجام دهد\&.
.sp
اگرچه \fIgit archimport\fR تلاش خواهد کرد نام‌های شاخهٔ معقولی برای آرشیوهایی که وارد می‌کند بسازد، اما تعیین دستی نام‌های شاخهٔ گیت نیز امکان‌پذیر است\&. برای این منظور، نام شاخهٔ گیت را پس از هر پارامتر <archive>/<branch> بنویسید که با یک علامت دونقطه از هم جدا شده باشند\&. به این ترتیب می‌توانید نام‌های شاخهٔ Arch را کوتاه کرده و اصطلاحات خاص Arch را به اصطلاحات گیت تبدیل کنید؛ برای مثال نگاشت یک شاخهٔ "PROJECT\-\-devo\-\-VERSION" به "master"\&.
.sp
مرتبط کردن چندین شاخهٔ Arch به یک شاخهٔ گیت امکان‌پذیر است؛ نتیجه تنها در صورتی منطقی‌ترین حالت خواهد بود که پس از ایجاد شاخهٔ دوم، هیچ کمیتی در شاخهٔ اول ثبت نشود\&. با این حال، این کار برای تبدیل مخازن Arch که به‌طور دوره‌ای چرخانده شده‌اند مفید است\&.
.SH "ادغام‌ها (MERGES)"
.sp
داده‌های ادغام وصله از Arch برای علامت‌گذاری ادغام‌ها در گیت نیز به کار می‌رود\&. گیت توجه چندانی به ردگیری وصله‌ها ندارد، و تنها زمانی یک ادغام را به حساب می‌آورد که یک شاخه تمام کامیت‌های پس از نقطهٔ انشعاب را دربر داشته باشد\&. نتیجهٔ نهایی این است که گیت دید خوبی از میزان واگرایی شاخه‌ها از یکدیگر خواهد داشت\&. بنابراین فرآیند درون‌ریزی بخشی از فراداده‌های تبادل وصله (patch\-trading) را از دست می‌دهد\&.
.sp
خوشبختانه، هنگامی که تلاش می‌کنید شاخه‌های واردشده از Arch را ادغام کنید، گیت یک مبنای ادغام مناسب پیدا می‌کند و شانس بالایی برای شناسایی وصله‌هایی خواهد داشت که بدون رعایت ترتیب میان شاخه‌ها تبادل شده‌اند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-h
.RS 4
نمایش راهنمای نحوهٔ استفاده\&.
.RE
.PP
\-v
.RS 4
خروجی با جزئیات کامل (verbose)\&.
.RE
.PP
\-T
.RS 4
برچسب‌های پرتعداد\&. برای هر کامیت یک برچسب ایجاد می‌کند که بازتاب‌دهندهٔ نام کامیت در مخزن Arch است\&.
.RE
.PP
\-f
.RS 4
استفاده از راهبرد درون‌ریزی سریع مجموعه وصله‌ها (patchset)\&. این می‌تواند برای درخت‌های بزرگ بسیار سریع‌تر باشد، اما تغییر نام دایرکتوری‌ها یا تغییرات دسترسی‌ها را پشتیبانی نمی‌کند\&. راهبرد پیش‌فرض کند و ایمن است\&.
.RE
.PP
\-o
.RS 4
استفاده جهت سازگاری با نام‌های شاخه به سبک قدیمی که توسط نسخه‌های پیشین
\fIgit archimport\fR
استفاده می‌شدند\&. نام‌های شاخه به سبک قدیم به‌صورت category\-\-branch بودند، در حالی که نام‌های شاخه به سبک جدید به‌صورت archive,category\-\-branch\-\-version هستند\&. در هر دو حالت، نام‌های ارائه‌شده در خط فرمان بر نام‌های ایجادشده به‌طور خودکار اولویت دارند\&.
.RE
.PP
\-D <depth>
.RS 4
دنبال کردن تبار ادغام و تلاش برای درون‌ریزی درخت‌هایی که از آن‌ها ادغام انجام شده است\&. در صورتی که گزارش‌های وصله هرس (prune) شده باشند، عمقی بزرگ‌تر از ۱ تعیین کنید\&.
.RE
.PP
\-a
.RS 4
تلاش برای ثبت خودکار آرشیوها در
\fBhttp://mirrors\&.sourcecontrol\&.net\fR
این گزینه به‌ویژه همراه با گزینهٔ \-D مفید است\&.
.RE
.PP
\-t <tmpdir>
.RS 4
بازنویسی دایرکتوری موقت (tempdir) پیش‌فرض\&.
.RE
.PP
<archive>/<branch>
.RS 4
شناسهٔ <archive>/<branch> در قالبی که برای
\fBtla\fR
\fBlog\fR
قابل درک باشد\&.
.RE
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)