HG(PULL)                                                              HG(PULL)

نام (NAME)
       hg pull - دریافت تغییرات از منبع مشخص‌شده

خلاصه دستور (SYNOPSIS)
       hg pull [-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SOURCE]...

توضیحات (DESCRIPTION)
       دریافت تغییرات از یک مخزن دوردست به یک مخزن محلی.

       این دستور تمامی تغییرات را از مخزن موجود در مسیر یا URL مشخص‌شده یافته و
       آن‌ها را به مخزن محلی اضافه می‌کند (مخزن فعلی، مگر اینکه -R مشخص شده
       باشد). به‌طور پیش‌فرض، این کار نسخهٔ پروژه را در دایرکتوری کاری به‌روزرسانی
       نمی‌کند.

       هنگام شبیه‌سازی (clone) از سرورهایی که از آن پشتیبانی می‌کنند، ممکن است
       Mercurial داده‌های از پیش‌تولیدشده را واکشی کند. در این صورت، قلاب‌هایی
       (hooks) که روی مجموعه‌تغییرات (changesets) و changegroupهای ورودی عمل
       می‌کنند ممکن است بیش از یک‌بار فراخوانی شوند؛ یک‌بار برای هر بستهٔ (bundle)
       از پیش‌تولیدشده و همچنین برای هر دادهٔ باقی‌ماندهٔ اضافی. برای اطلاعات
       بیشتر hg help -e clonebundles را ببینید.

       اگر می‌خواهید ببینید در زمان فراخوانی دستور چه مواردی با دریافت اضافه
       می‌شدند، از hg incoming استفاده کنید. اگر سپس تصمیم گرفتید آن تغییرات را
       به مخزن اضافه کنید، باید از hg pull -r X استفاده کنید که در آن X آخرین
       مجموعه‌تغییر فهرست‌شده توسط hg incoming است.

       اگر SOURCE مشخص نشود، از مسیر 'default' استفاده خواهد شد.  برای اطلاعات
       بیشتر hg help urls را ببینید.

       اگر چندین منبع مشخص شوند، تغییرات آن‌ها به صورت متوالی دریافت خواهد شد،
       گویی دستور چندین بار اجرا شده است. اگر --update مشخص شده باشد، اجرای
       دستور با مواجهه با اولین شکست در --update متوقف خواهد شد.

       مشخص کردن نشانک (bookmark) به صورت . معادل مشخص کردن نام نشانک فعال
       است.

       می‌توان از پرچم --remote-hidden برای دریافت مجموعه‌تغییرات پنهان در سرور
       دوردست استفاده کرد. این پرچم بر پایهٔ «بیشترین تلاش» (best effort) عمل
       می‌کند و تنها زمانی کار خواهد کرد که سرور از این قابلیت پشتیبانی کرده و
       طوری پیکربندی شده باشد که به کاربر اجازهٔ دسترسی به مجموعه‌تغییرات پنهان
       را بدهد. این گزینه آزمایشی است و سازگاری رو به عقب تضمین نمی‌شود.

       در صورت موفقیت مقدار 0، و اگر یک به‌روزرسانی دارای فایل‌های حل‌نشده باشد
       مقدار 1 بازگردانده می‌شود.

گزینه‌ها (OPTIONS)
       -u, --update
              به‌روزرسانی به سرشاخهٔ جدید اگر نوادگان جدیدی دریافت شده باشند

       -f, --force
              اجرا حتی زمانی که مخزن دوردست نامرتبط باشد

       --confirm
              تأیید دریافت پیش از اعمال تغییرات

       -r,--rev <REV[+]>
              یک مجموعه‌تغییر دوردست در نظر گرفته‌شده برای اضافه شدن

       -B,--bookmark <BOOKMARK[+]>
              نشانک مورد نظر برای دریافت

       -b,--branch <BRANCH[+]>
              شاخهٔ مشخصی که می‌خواهید دریافت کنید

       --remote-hidden
              گنجاندن مجموعه‌تغییرات پنهان در مخزن دوردست (آزمایشی)

       -e,--ssh <CMD>
              مشخص کردن دستور ssh مورد استفاده

       --remotecmd <CMD>
              مشخص کردن دستور hg برای اجرا در سمت دوردست

       --insecure
              عدم اعتبارسنجی گواهی سرور (نادیده گرفتن پیکربندی web.cacerts)

              گزینهٔ علامت‌گذاری‌شده با [+] می‌تواند چندین بار مشخص شود

                                                                      HG(PULL)