HG(PULL) HG(PULL)

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

hg pull [-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SOURCE]...

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

این دستور تمامی تغییرات را از مخزن موجود در مسیر یا 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 بازگردانده می‌شود.

به‌روزرسانی به سرشاخهٔ جدید اگر نوادگان جدیدی دریافت شده باشند
اجرا حتی زمانی که مخزن دوردست نامرتبط باشد
تأیید دریافت پیش از اعمال تغییرات
یک مجموعه‌تغییر دوردست در نظر گرفته‌شده برای اضافه شدن
نشانک مورد نظر برای دریافت
شاخهٔ مشخصی که می‌خواهید دریافت کنید
گنجاندن مجموعه‌تغییرات پنهان در مخزن دوردست (آزمایشی)
مشخص کردن دستور ssh مورد استفاده
مشخص کردن دستور hg برای اجرا در سمت دوردست
عدم اعتبارسنجی گواهی سرور (نادیده گرفتن پیکربندی web.cacerts)

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