.TH git-annex-pull 1
.SH "نام (NAME)"
git-annex-pull \- دریافت محتوا از مخازن دوردست
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex pull \fB[remote ...]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
این دستور محتوا را از مخازن دوردست (remotes) دریافت می‌کند. این دستور هم محتوای مخزن گیت و هم محتوای فایل‌های ضمیمه‌شده را بارگیری می‌کند. مانند
.BR "git pull" ،
تغییرات را در شاخه فعلی ادغام می‌کند.
.PP
می‌توانید از
.B git pull
و
.B git-annex get
به صورت دستی برای انجام کاری مشابه این دستور استفاده کنید، اما این دستور جزئیات مختلفی را مدیریت می‌کند، از جمله اطمینان از این‌که شاخه git-annex از مخزن دوردست واکشی (fetch) می‌شود.
.PP
برخی از مخازن دوردست ویژه (special remotes) حاوی درختی از فایل‌ها هستند که می‌توان آن‌ها را وارد (import) کرد، و این دستور می‌تواند برای دریافت از آن مخازن دوردست و همچنین مخازن دوردست معمولی گیت استفاده شود. برای جزئیات درباره نحوه کار آن مخازن دوردست ویژه، به
.BR git-annex\-import (1)
مراجعه کنید. برای این‌که این دستور بتواند از یک مخزن دوردست ویژه وارد کند، باید
.B remote.<name>.annex\-tracking\-branch
نیز پیکربندی شده باشد و مقداری یکسان با شاخه فعلیِ چک‌اوت‌شده داشته باشد.
.PP
هنگامی که از
.BR git-annex\-adjust (1)
برای چک‌اوت کردن یک شاخه تنظیم‌شده (adjusted branch) استفاده شده باشد، این دستور تغییرات را از شاخه والد نیز دریافت خواهد کرد.
.PP
هنگامی که از
.BR git-annex\-view (1)
برای چک‌اوت کردن یک شاخه نما (view branch) استفاده شده باشد، این دستور شاخه نما را برای اعمال هرگونه تغییر در شاخه والد یا متاداده به‌روزرسانی می‌کند.
.PP
هنگامی که از
.BR git-annex\-migrate (1)
در سایر مخازن استفاده شده باشد، این دستور محتوا را در مخزن محلی برای آن مهاجرت‌ها نیز به‌روزرسانی می‌کند.
.PP
به‌طور معمول این دستور تلاش می‌کند محتوای هر فایل ضمیمه‌شده را از هر مخزن دوردستی که در حال دریافت از آن است و کپی آن را دارد، دانلود کند. برای کنترل این‌که کدام فایل‌ها دانلود شوند، محتوای ترجیحی (preferred content) مخزن محلی را پیکربندی کنید. این دستور همچنین فایل‌هایی را از یک مخزن دوردست که جزء محتوای ترجیحی آن مخزن دوردست نیستند رها (drop) می‌کند. به
.BR git-annex\-preferred\-content (1)
مراجعه کنید.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB[remote]\fP"
.IP
به‌طور پیش‌فرض این دستور از تمام مخازن دوردست موجود دریافت می‌کند، مگر مخازنی که
.B remote.<name>.annex\-pull
(یا
.BR remote.<name>.annex\-sync )
در آن‌ها روی false تنظیم شده باشد.
.IP
با مشخص کردن نام‌های مخازن دوردست (یا گروه‌های مخزن دوردست)، می‌توانید تعیین کنید که از کدام‌یک دریافت انجام شود.
.IP
.IP "\fB\-\-fast\fP"
تنها از مخازن دوردستی که کمترین مقدار annex\-cost برای آن‌ها پیکربندی شده است دریافت می‌کند.
.IP
هنگامی که فهرستی از مخازن دوردست (یا گروه‌های مخزن دوردست) ارائه شده باشد، از میان آن‌ها انتخاب می‌کند؛ در غیر این صورت از میان تمام مخازن دوردست انتخاب می‌کند.
.IP
.IP "\fB\-\-only\-annex\fP \fB\-a\fP, \fB\-\-not\-only\-annex\fP"
تنها شاخه git-annex و محتوای ضمیمه‌شده را از مخازن دوردست دریافت می‌کند، نه سایر شاخه‌های گیت را.
.IP
پیکربندی
.B annex.synconlyannex
را می‌توان روی true تنظیم کرد تا این رفتار پیش‌فرض شود. برای لغو چنین تنظیمی، از
.B \-\-not\-only\-annex
استفاده کنید.
.IP
هنگامی که این گزینه با
.B \-\-no\-content
ترکیب شود، تنها شاخه git-annex دریافت خواهد شد.
.IP
.IP "\fB\-\-no\-content\fP, \fB\-g\fP, \fB\-\-content\fP"
از
.B \-\-no\-content
یا
.B \-g
برای جلوگیری از دانلود (و رها کردن) محتوای فایل‌های ضمیمه‌شده، و همچنین جلوگیری از انجام هرگونه مهاجرت محتوا استفاده کنید.
.IP
اگر اغلب از
.B \-\-no\-content
استفاده می‌کنید، می‌توانید پیکربندی
.B annex.synccontent
را روی false قرار دهید تا از دانلود محتوا به‌طور پیش‌فرض جلوگیری شود. گزینه
.B \-\-content
آن پیکربندی را لغو می‌کند.
.IP
تنها برای جلوگیری از مهاجرت‌های محتوا، می‌توانید پیکربندی
.B annex.syncmigrations
را روی false قرار دهید. گزینه
.B \-\-content
این پیکربندی را نیز لغو می‌کند.
.IP
.IP "\fB\-\-content\-of=path\fP \fB\-C path\fP"
تنها فایل‌های ضمیمه‌شده در مسیر داده‌شده را دانلود (و رها) می‌کند.
.IP
این گزینه می‌تواند چندین بار با مسیرهای مختلف تکرار شود.
.IP
.IP "\fB\-\-all\fP \fB\-A\fP"
معمولاً این دستور روی فایل‌های ضمیمه‌شده در شاخه فعلی عمل می‌کند. این گزینه باعث می‌شود که روی تمام نسخه‌های موجود از تمام فایل‌های ضمیمه‌شده عمل کند (در صورتی که تنظیمات محتوای ترجیحی اجازه دهد).
.IP
توجه داشته باشید تنظیمات محتوای ترجیحی که از
.B include=
یا
.B exclude=
استفاده می‌کنند، فقط با نسخه فایل‌هایی که در حال حاضر در درخت کاری هستند مطابقت خواهند داشت، نه با نسخه‌های گذشته فایل‌ها.
.IP
.IP "\fB\-\-jobs=N\fP \fB\-JN\fP"
دریافت هم‌روند و موازی را با حداکثر تعداد کارهای مشخص‌شده که همزمان اجرا می‌شوند فعال می‌کند. برای مثال:
.B \-J10
.IP
تنظیم این مقدار به "cpus" یک کار را به ازای هر هسته پردازنده (CPU) اجرا می‌کند.
.IP
(توجه داشته باشید که pullهای گیت به صورت موازی انجام نمی‌شوند زیرا کارایی کمتری دارند.)
.IP
.IP "\fB\-\-allow\-unrelated\-histories\fP, \fB\-\-no\-allow\-unrelated\-histories\fP"
به
.B git merge
ارسال می‌شود تا تعیین کند که آیا تاریخچه‌هایی که جد مشترک ندارند ادغام شوند یا خیر.
.IP
.IP "\fB\-\-resolvemerge\fP, \fB\-\-no\-resolvemerge\fP"
به‌طور پیش‌فرض، تداخل‌های ادغام به صورت خودکار توسط این دستور مدیریت می‌شوند. هنگامی که دو نسخه متداخل از یک فایل کامیت شده باشند، هر دو با نام‌های مختلف به درخت اضافه می‌شوند. برای مثال، فایل "foo" با "foo.variant\-A" و "foo.variant\-B" جایگزین خواهد شد. (برای جزئیات به
.BR git-annex\-resolvemerge (1)
مراجعه کنید.)
.IP
از
.B \-\-no\-resolvemerge
برای غیرفعال کردن این حل خودکار تداخل ادغام استفاده کنید. همچنین می‌توان آن را با تنظیم
.B annex.resolvemerge
روی false غیرفعال کرد.
.IP
.IP "\fB\-\-backend\fP"
مشخص می‌کند که هنگام وارد کردن از یک مخزن دوردست ویژه، از کدام بک‌اند کلید\-مقدار استفاده شود.
.IP
.IP
همچنین می‌توان از گزینه‌های
.BR git-annex\-common\-options (1)
استفاده کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.PP
.BR git-annex\-push (1)
.PP
.BR git-annex\-sync (1)
.PP
.BR git-annex\-preferred\-content (1)
.PP
.BR git-annex\-satisfy (1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>