نام (NAME)

hg incoming - نمایش مجموعه‌تغییرات جدید موجود در منبع

خلاصه دستور (SYNOPSIS)

hg incoming [-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SOURCE]

توضیحات (DESCRIPTION)

نمایش مجموعه‌تغییرات جدید یافت‌شده در مسیر/URL مشخص‌شده یا مکان پیش‌فرض دریافت (pull). این‌ها مجموعه‌تغییراتی هستند که اگر در زمان اجرای این دستور، دستور hg pull را صادر می‌کردید، دریافت می‌شدند.

برای جزئیات قالب‌های معتبر منبع، دستور pull را ببینید.

با گزینهٔ -B/--bookmarks، نتیجهٔ مقایسهٔ نشانک‌ها بین مخازن محلی و دوردست نمایش داده می‌شود. با -v/--verbose، وضعیت هر نشانک نیز به صورت زیر نمایش داده می‌شود:

BM1               01234567890a added
BM2               1234567890ab advanced
BM3               234567890abc diverged
BM4               34567890abcd changed

عملی که هنگام دریافت (pull) به صورت محلی انجام می‌شود به وضعیت هر نشانک بستگی دارد:

added

دستور pull آن را ایجاد می‌کند

advanced

دستور pull آن را به‌روزرسانی می‌کند

diverged

دستور pull یک نشانک واگرا ایجاد می‌کند

changed

نتیجه به مجموعه‌تغییرات دوردست بستگی دارد

از نظر رفتار دریافت (pull)، نشانک‌هایی که تنها در مخزن دوردست وجود دارند، حتی اگر در واقع به صورت محلی حذف شده باشند، به عنوان added در نظر گرفته می‌شوند.

برای مخزن دوردست، استفاده از --bundle مانع از دانلود دوبارهٔ مجموعه‌تغییرات در صورتی می‌شود که پس از incoming دستور pull اجرا شود.

مثال‌ها:

نمایش تغییرات ورودی به همراه وصله‌ها و توضیحات کامل:
```
hg incoming -vp
```
نمایش تغییرات ورودی بدون ادغام‌ها، و ذخیره در یک بسته (bundle):
```
hg in -vpM --bundle incoming.hg
hg pull incoming.hg
```
فهرست‌کردن مختصر تغییرات درون یک بسته (bundle):
```
hg in changes.hg -T "{desc|firstline}\n"
```
اگر تغییرات ورودی وجود داشته باشد مقدار 0 و در غیر این صورت مقدار 1 را بازمی‌گرداند.

گزینه‌ها (OPTIONS)

-f, --force: اجرا حتی در صورتی که مخزن دوردست نامرتبط باشد
-n, --newest-first: نمایش جدیدترین رکورد در ابتدا
--bundle <FILE>: فایل برای ذخیرهٔ بسته‌ها (bundles) در آن
-r,--rev <REV[+]>: مجموعه‌تغییر دوردستی که قصد اضافه کردن آن وجود دارد
-B, --bookmarks: مقایسهٔ نشانک‌ها
-b,--branch <BRANCH[+]>: یک شاخهٔ خاص که مایل به دریافت (pull) آن هستید
--remote-hidden: شامل کردن مجموعه‌تغییرات پنهان در مخزن دوردست (آزمایشی)
-p, --patch: نمایش وصله (patch)
-g, --git: استفاده از قالب تفاضلی گسترش‌یافتهٔ گیت (git extended diff)
-l,--limit <NUM>: محدود کردن تعداد تغییرات نمایش‌داده‌شده
-M, --no-merges: عدم نمایش ادغام‌ها
--stat: خروجی خلاصهٔ تغییرات به سبک diffstat
-G, --graph: نمایش گراف جهت‌دار بدون دور (DAG) بازبینی‌ها
--style <STYLE>: نمایش با استفاده از فایل نگاشت الگو (منسوخ‌شده)
-T,--template <TEMPLATE>: نمایش همراه با الگو
-e,--ssh <CMD>: مشخص کردن دستور ssh جهت استفاده
--remotecmd <CMD>: مشخص کردن دستور hg برای اجرا در سمت دوردست
--insecure: عدم اعتبارسنجی گواهی سرور (نادیده گرفتن پیکربندی web.cacerts)
-S, --subrepos: پیمایش بازگشتی در زیرمخازن
گزینه‌های علامت‌گذاری‌شده با [+] را می‌توان چندین بار مشخص کرد

نام‌های مستعار (ALIASES)

in