.TH HG PULL  "" "" ""
.SH "نام (NAME)"
hg pull \- دریافت تغییرات از منبع مشخص‌شده
.\" Man page generated from reStructuredText.
.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.ft C
hg pull [\-u] [\-f] [\-r REV]... [\-e CMD] [\-\-remotecmd CMD] [SOURCE]...
.ft P
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دریافت تغییرات از یک مخزن دوردست به یک مخزن محلی.
.sp
این دستور تمامی تغییرات را از مخزن موجود در مسیر یا URL مشخص‌شده یافته
و آن‌ها را به مخزن محلی اضافه می‌کند (مخزن فعلی، مگر اینکه
\-R مشخص شده باشد). به‌طور پیش‌فرض، این کار نسخهٔ پروژه را در
دایرکتوری کاری به‌روزرسانی نمی‌کند.
.sp
هنگام شبیه‌سازی (clone) از سرورهایی که از آن پشتیبانی می‌کنند، ممکن است Mercurial
داده‌های از پیش‌تولیدشده را واکشی کند. در این صورت، قلاب‌هایی (hooks) که روی
مجموعه‌تغییرات (changesets) و changegroupهای ورودی عمل می‌کنند ممکن است بیش از یک‌بار فراخوانی شوند؛ یک‌بار برای هر
بستهٔ (bundle) از پیش‌تولیدشده و همچنین برای هر دادهٔ باقی‌ماندهٔ
اضافی. برای اطلاعات بیشتر \%\fBhg help \-e clonebundles\fP\: را ببینید.
.sp
اگر می‌خواهید ببینید در زمان فراخوانی دستور چه مواردی با دریافت اضافه
می‌شدند، از \%\fBhg incoming\fP\: استفاده کنید. اگر سپس تصمیم گرفتید
آن تغییرات را به مخزن اضافه کنید، باید از \%\fBhg pull
\-r X\fP\: استفاده کنید که در آن \fBX\fP آخرین مجموعه‌تغییر فهرست‌شده توسط \%\fBhg incoming\fP\: است.
.sp
اگر SOURCE مشخص نشود، از مسیر \(aqdefault\(aq استفاده خواهد شد.
برای اطلاعات بیشتر \%\fBhg help urls\fP\: را ببینید.
.sp
اگر چندین منبع مشخص شوند، تغییرات آن‌ها به صورت متوالی دریافت خواهد شد، گویی
دستور چندین بار اجرا شده است. اگر \-\-update مشخص شده باشد، اجرای دستور
با مواجهه با اولین شکست در \-\-update متوقف خواهد شد.
.sp
مشخص کردن نشانک (bookmark) به صورت \fB.\fP معادل مشخص کردن نام
نشانک فعال است.
.sp
می‌توان از پرچم \fI\-\-remote\-hidden\fP برای دریافت مجموعه‌تغییرات
پنهان در سرور دوردست استفاده کرد. این پرچم بر پایهٔ «بیشترین تلاش» (best effort) عمل می‌کند و تنها
زمانی کار خواهد کرد که سرور از این قابلیت پشتیبانی کرده و طوری پیکربندی شده باشد که
به کاربر اجازهٔ دسترسی به مجموعه‌تغییرات پنهان را بدهد. این گزینه
آزمایشی است و سازگاری رو به عقب تضمین نمی‌شود.
.sp
در صورت موفقیت مقدار 0، و اگر یک به‌روزرسانی دارای فایل‌های حل‌نشده باشد مقدار 1 بازگردانده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-u,  \-\-update
.
به‌روزرسانی به سرشاخهٔ جدید اگر نوادگان جدیدی دریافت شده باشند
.TP
.B \-f,  \-\-force
.
اجرا حتی زمانی که مخزن دوردست نامرتبط باشد
.TP
.B \-\-confirm
.
تأیید دریافت پیش از اعمال تغییرات
.TP
.BI \-r,  \-\-rev \ <REV[+]>
.
یک مجموعه‌تغییر دوردست در نظر گرفته‌شده برای اضافه شدن
.TP
.BI \-B,  \-\-bookmark \ <BOOKMARK[+]>
.
نشانک مورد نظر برای دریافت
.TP
.BI \-b,  \-\-branch \ <BRANCH[+]>
.
شاخهٔ مشخصی که می‌خواهید دریافت کنید
.TP
.B \-\-remote\-hidden
.
گنجاندن مجموعه‌تغییرات پنهان در مخزن دوردست (آزمایشی)
.TP
.BI \-e,  \-\-ssh \ <CMD>
.
مشخص کردن دستور ssh مورد استفاده
.TP
.BI \-\-remotecmd \ <CMD>
.
مشخص کردن دستور hg برای اجرا در سمت دوردست
.TP
.B \-\-insecure
.
عدم اعتبارسنجی گواهی سرور (نادیده گرفتن پیکربندی web.cacerts)
.UNINDENT
.sp
گزینهٔ علامت‌گذاری‌شده با [+] می‌تواند چندین بار مشخص شود
.\" Generated by docutils manpage writer.
.\" 
.