hg - آنلاین در ابر

برنامه:

نام

hg - سیستم مدیریت کد منبع Mercurial

خلاصه

hg فرمان [انتخاب]... [استدلال] ...

شرح

La hg فرمان یک رابط خط فرمان را برای سیستم Mercurial فراهم می کند.

COMMAND عناصر

فایل ها...
یک یا چند نام فایل یا نام فایل مسیر نسبی را نشان می دهد. الگوهای نام فایل را ببینید
برای اطلاعات در مورد تطبیق الگو

مسیر مسیری را در ماشین محلی نشان می دهد

تجدید نظر
یک مجموعه تغییرات را نشان می دهد که می تواند به عنوان یک شماره ویرایش مجموعه تغییرات، یک برچسب،
یا یک زیر رشته منحصر به فرد از مقدار هش تغییرات مجموعه

مخزن مسیر
نام مسیر یک مخزن محلی یا URI یک مخزن راه دور.

OPTIONS

-ر،-- مخزن
دایرکتوری ریشه مخزن یا نام فایل بسته همپوشانی

--cwd
دایرکتوری کاری را تغییر دهید

-y، --غیر تعاملی
درخواست نکنید، به طور خودکار اولین گزینه را برای همه درخواست ها انتخاب کنید

-q، --ساکت
خروجی را سرکوب کنید

-v، -- پرحرف
خروجی اضافی را فعال کنید

- پیکربندی
گزینه پیکربندی set/override (از «section.name=value» استفاده کنید)

- رفع اشکال
فعال کردن خروجی اشکال زدایی

-- اشکال زدا
دیباگر را شروع کنید

- رمزگذاری
رمزگذاری مجموعه حروف را تنظیم کنید (پیش‌فرض: UTF-8)

- حالت رمزگذاری
حالت رمزگذاری مجموعه نویسه را تنظیم کنید (پیش فرض: سخت)

--ردیابی
همیشه یک ردیابی بر روی استثنا چاپ کنید

--زمان زمان چقدر طول می کشد دستور

--مشخصات
نمایه اجرای دستور چاپ

- نسخه
اطلاعات نسخه خروجی و خروج

-h، --کمک
نمایش راهنما و خروج

-- پنهان
تغییرات پنهان را در نظر بگیرید

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

دستورات

اضافه کردن
فایل های مشخص شده را در commit بعدی اضافه کنید:

hg افزودن [OPTION]... [FILE]...

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

فایل ها در commit بعدی به مخزن اضافه می شوند. برای واگرد یک اضافه قبل از آن،
دیدن hg فراموش کردن.

اگر نامی داده نشد، همه فایل ها را به مخزن اضافه کنید (به جز فایل های مطابقت .hgignore).

مثال:

· فایل های جدید (ناشناخته) به طور خودکار توسط اضافه می شوند hg اضافه کردن:

ls دلار
foo.c
وضعیت دلار جیوه
? foo.c
دلار جیوه اضافه کنید
افزودن foo.c
وضعیت دلار جیوه
یک foo.c

فایل های خاصی که باید اضافه شوند را می توان مشخص کرد:

ls دلار
bar.c foo.c
وضعیت دلار جیوه
? bar.c
? foo.c
$ hg اضافه کردن bar.c
وضعیت دلار جیوه
یک نوار.c
? foo.c

اگر همه فایل ها با موفقیت اضافه شوند، 0 را برمی گرداند.

گزینه های ارسال:

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-S، -- subrepos
بازگشت به مخازن فرعی

-n، -- خشک اجرا شود
اقدامات را انجام ندهید، فقط خروجی را چاپ کنید

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

اضافه کردن حذف
همه فایل‌های جدید را اضافه کنید، همه فایل‌های گمشده را حذف کنید:

hg adremove [OPTION]... [FILE]...

همه فایل های جدید را اضافه کنید و تمام فایل های گم شده را از مخزن حذف کنید.

فایل های جدید در صورتی که با هر یک از الگوهای موجود مطابقت داشته باشند نادیده گرفته می شوند، مگر اینکه نام ذکر شود
.hgignore. همانند add، این تغییرات در commit بعدی اعمال می شوند.

برای شناسایی فایل های تغییر نام یافته از گزینه -s/--similarity استفاده کنید. این گزینه درصد می گیرد
بین 0 (غیرفعال) و 100 (فایل ها باید یکسان باشند) به عنوان پارامتر آن. با یک پارامتر
بزرگتر از 0، هر فایل حذف شده را با هر فایل اضافه شده مقایسه می کند و آنها را ثبت می کند
به اندازه کافی شبیه به تغییر نام. شناسایی فایل های تغییر نام یافته از این طریق می تواند گران باشد. پس از استفاده
این گزینه، hg وضعیت -C می تواند برای بررسی اینکه کدام فایل ها به عنوان جابجا شده یا شناسایی شده اند استفاده شود
تغییر نام داد. اگر مشخص نشده باشد، -s/--similarity پیش‌فرض 100 است و فقط نام‌های یکسان را تغییر می‌دهد.
فایل ها شناسایی می شوند.

مثال:

· تعدادی از فایل ها (bar.c و foo.c) جدید هستند، در حالی که foobar.c حذف شده است (بدون
با استفاده از hg برداشتن) از مخزن:

ls دلار
bar.c foo.c
وضعیت دلار جیوه
! foobar.c
? bar.c
? foo.c
$ hg adremove
اضافه کردن bar.c
افزودن foo.c
حذف foobar.c
وضعیت دلار جیوه
یک نوار.c
یک foo.c
R foobar.c

· یک فایل foobar.c بدون استفاده به foo.c منتقل شد hg تغییر نام دهید. پس از آن، شد
کمی ویرایش شد:

ls دلار
foo.c
وضعیت دلار جیوه
! foobar.c
? foo.c
$ hg addremove --similarity 90
حذف foobar.c
افزودن foo.c
ضبط حذف foobar.c به عنوان تغییر نام به foo.c (94٪ مشابه)
وضعیت $hg -C
یک foo.c
foobar.c
R foobar.c

اگر همه فایل ها با موفقیت اضافه شوند، 0 را برمی گرداند.

گزینه های ارسال:

-s ،-- شباهت
حدس زدن نام فایل ها بر اساس شباهت (0<=s<=100)

-S، -- subrepos
بازگشت به مخازن فرعی

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-n، -- خشک اجرا شود
اقدامات را انجام ندهید، فقط خروجی را چاپ کنید

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

حاشیه نویسی
نمایش اطلاعات تغییرات به صورت خطی برای هر فایل:

hg حاشیه نویسی [-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] فایل...

فهرست تغییرات در فایل ها، نشان دادن شناسه بازبینی مسئول هر خط.

این دستور برای کشف اینکه چه زمانی و توسط چه کسی تغییر ایجاد شده است مفید است.

اگر --file، --user، یا --date را وارد کنید، شماره ویرایش حذف می شود مگر اینکه شما
همچنین شامل --number باشد.

بدون گزینه -a/--text، annotate از پردازش فایل‌هایی که به‌عنوان باینری تشخیص می‌دهد اجتناب می‌کند.
با -a، annotate به هر حال فایل را حاشیه نویسی می کند، اگرچه نتایج احتمالاً خواهد بود
نه مفید و نه مطلوب

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
بازبینی مشخص شده را حاشیه نویسی کنید

--دنبال کردن
کپی ها/تغییر نام ها را دنبال کنید و نام فایل را فهرست کنید (منسوخ شده)

-- بدون دنبال کردن
کپی ها و تغییر نام ها را دنبال نکنید

-آ، --متن
تمام فایل ها را به عنوان متن در نظر بگیرید

-u، --کاربر
نویسنده را فهرست کنید (طولانی با -v)

-f، --فایل
نام فایل را لیست کنید

-د، --تاریخ
تاریخ را فهرست کنید (کوتاه با -q)

-n، --عدد
فهرست شماره ویرایش (پیش‌فرض)

-c، --تغییر مجموعه
مجموعه تغییرات را لیست کنید

-ل، --شماره خط
نمایش شماره خط در اولین ظاهر

-w، - نادیده گرفتن همه فضا
هنگام مقایسه خطوط، فضای سفید را نادیده بگیرید

-ب، - نادیده گرفتن-فضا-تغییر
تغییرات در مقدار فضای سفید را نادیده بگیرید

-ب، -نادیده گرفتن-خطوط خالی
تغییراتی را که همه خطوط آن خالی است نادیده بگیرید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-T،--قالب
نمایش با الگو (تجربی)

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

نام مستعار: سرزنش

بایگانی
یک آرشیو بدون نسخه از یک ویرایش مخزن ایجاد کنید:

بایگانی hg [OPTION]... DEST

به طور پیش فرض، ویرایش مورد استفاده، والد دایرکتوری کاری است. از -r/--rev به استفاده کنید
یک ویرایش متفاوت را مشخص کنید.

نوع آرشیو به طور خودکار بر اساس پسوند فایل شناسایی می شود (برای لغو، استفاده کنید
-t/--type).

مثال:

یک فایل فشرده حاوی نسخه 1.0 ایجاد کنید:

hg archive -r 1.0 project-1.0.zip

یک تاربال به استثنای فایل های hg ایجاد کنید:

hg archive project.tar.gz -X ".hg*"

انواع معتبر عبارتند از:

فایل ها

دایرکتوری پر از فایل (پیش فرض)

قیر

آرشیو تار، فشرده نشده

tbz2

آرشیو tar، با استفاده از bzip2 فشرده شده است

tgz

بایگانی tar، با استفاده از gzip فشرده شده است

اوزیپ

بایگانی فشرده، غیر فشرده

زیپ

بایگانی فشرده، با استفاده از deflate فشرده شده است

نام دقیق آرشیو یا دایرکتوری مقصد با استفاده از رشته فرمت داده می شود. دیدن
hg کمک صادرات برای جزئیات بیشتر.

هر عضوی که به یک فایل بایگانی اضافه می شود یک پیشوند دایرکتوری از قبل اضافه شده دارد. از پیشوند -p/-- به استفاده کنید
یک رشته فرمت برای پیشوند مشخص کنید. پیش‌فرض نام پایه آرشیو با
پسوندها حذف شدند

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-- بدون رمزگشایی
فایل ها را از طریق رمزگشاها عبور ندهید

-پ،-- پیشوند
پیشوند دایرکتوری برای فایل های موجود در آرشیو

-r،-- برگشت
تجدید نظر برای توزیع

-t،--نوع
نوع توزیع برای ایجاد

-S، -- subrepos
بازگشت به مخازن فرعی

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

عقب نشینی
اثر معکوس تغییرات قبلی:

hg backout [OPTION]... [-r] REV

یک تغییرات جدید با اثر REV unone در فهرست کاری فعلی آماده کنید. اگر
هیچ درگیری رخ نداده است، بلافاصله انجام خواهد شد.

اگر REV والد دایرکتوری کاری باشد، این تغییرات جدید متعهد شده است
به طور خودکار (مگر اینکه --no-commit مشخص شده باشد).

توجه داشته باشید hg عقب نشینی نمی توان برای رفع ادغام ناخواسته یا نادرست استفاده کرد.

مثال:

· اثر والد دایرکتوری کاری را معکوس کنید. این عقب نشینی خواهد بود
بلافاصله متعهد شد:

hg backout -r .

· اثر بازبینی بد قبلی 23 را معکوس کنید:

hg backout -r 23

· اثر بازنگری بد قبلی 23 را معکوس کنید و تغییرات را بدون تعهد رها کنید:

hg backout -r 23 --no-commit
hg commit -m "Backout revision 23"

به‌طور پیش‌فرض، مجموعه تغییرات معلق دارای یک والد است که تاریخچه خطی را حفظ می‌کند. با
- ادغام، مجموعه تغییرات معلق در عوض دارای دو والد خواهد بود: والد قدیمی the
دایرکتوری کاری و فرزند جدید REV که به سادگی REV را لغو می کند.

قبل از نسخه 1.7، رفتار بدون --merge معادل تعیین --merge بود
و پس از آن hg به روز رسانی --تمیز . برای لغو ادغام و رها کردن فرزند REV به عنوان رئیس
جداگانه ادغام شود

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

دیدن hg کمک برگرداندن راهی برای بازگرداندن فایل‌ها به حالت ویرایش دیگری.

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

گزینه های ارسال:

--ادغام
پس از پشتیبان گیری با والد قدیمی dirstate ادغام شود

--مرتکب شدن
در صورت عدم وجود تضاد، انجام دهید (منسوخ شده)

--عدم تعهد
متعهد نشو

--والدین
انتخاب والد هنگام خروج از ادغام (منسوخ شده)

-r،-- برگشت
بازبینی به پشتیبان

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-t،--ابزار
ابزار ادغام را مشخص کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

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

بیتکت
جستجوی زیربخش تغییرات مجموعه:

hg دو نیم بخش [-gbsr] [-U] [-c CMD] [REV]

این دستور به یافتن تغییراتی که مشکلاتی را ایجاد می کنند کمک می کند. برای استفاده، اولین مورد را علامت بزنید
تغییراتی که می‌دانید مشکل را بد نشان می‌دهد، سپس آخرین تغییرات را که هست علامت بزنید
بدون مشکل به عنوان خوب. Bisect فهرست کاری شما را به یک ویرایش برای به روز می کند
تست کردن (مگر اینکه گزینه -U/--noupdate مشخص شده باشد). پس از انجام آزمایشات،
دایرکتوری کار را به عنوان خوب یا بد علامت گذاری کنید، و bisect یا به دیگری به روز می شود
کاندید تغییر تنظیم می کند یا اعلام می کند که ویرایش بدی را پیدا کرده است.

به‌عنوان میان‌بر، می‌توانید از آرگومان بازبینی برای علامت‌گذاری یک ویرایش به عنوان خوب یا بد استفاده کنید
بدون اینکه ابتدا آن را بررسی کنید

اگر دستوری را ارائه کنید، برای دوبخشی خودکار استفاده خواهد شد. محیط زیست
متغیر HG_NODE حاوی شناسه مجموعه تغییرات در حال آزمایش است. وضعیت خروج از
از دستور برای علامت‌گذاری ویرایش‌ها به عنوان خوب یا بد استفاده می‌شود: وضعیت 0 به معنای خوب، 125 به معنای به
از بازبینی صرفنظر کنید، 127 (فرمان یافت نشد) تقسیم‌بندی را لغو می‌کند، و هر مورد دیگری
وضعیت خروج غیر صفر به این معنی است که ویرایش بد است.

بعضی مثالها:

یک دو بخش را با بازبینی بد شناخته شده 34 و ویرایش خوب 12 شروع کنید:

hg bisect --bad 34
hg bisect -- خوب 12

· با علامت گذاری نسخه فعلی به عنوان خوب یا بد، دوبخش فعلی را پیش ببرید:

hg bisect -- خوب
hg bisect --بد

· بازبینی فعلی یا یک بازبینی شناخته شده را علامت بزنید تا نادیده گرفته شود (مثلاً اگر آن بازبینی وجود دارد
به دلیل مشکل دیگری قابل استفاده نیست):

hg bisect --پرش
hg bisect -- 23 را پرش کنید

از تمام ویرایش هایی که دایرکتوری ها را لمس نمی کنند صرف نظر کنید فو or بار:

hg bisect --skip "!( file('path:foo') & file ('path:bar') )"

· تقسیم فعلی را فراموش کنید:

hg bisect --تنظیم مجدد

· برای یافتن خودکار اولین ویرایش شکسته، از «ساخت و& ساخت تست» استفاده کنید:

hg bisect --تنظیم مجدد
hg bisect --bad 34
hg bisect -- خوب 12
hg bisect --command "make && make tests"

· مشاهده همه مجموعه‌های تغییراتی که حالت‌های آن‌ها قبلاً در نیم‌بخش فعلی شناخته شده است:

hg log -r "bisect(pruned)"

· تغییراتی که در حال حاضر در حال تقسیم شدن هستند را ببینید (مخصوصاً اگر با آن اجرا شود مفید است
-U/--noupdate):

hg log -r "bisect(current)"

· مشاهده تمام مجموعه های تغییراتی که در دوبخش فعلی شرکت داشتند:

hg log -r "bisect(range)"

· حتی می توانید یک نمودار خوب دریافت کنید:

hg log --graph -r "bisect(range)"

دیدن hg کمک دوباره تنظیم می کند برای اطلاعات بیشتر در مورد bisect() کلمه کلیدی.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-r، -- تنظیم مجدد
تنظیم مجدد حالت دو گانه

-g، -- خوب
علامت تغییرات خوب

-ب، -- بد
تغییرات را بد علامت گذاری کنید

-s ، -- پرش
رد شدن از مجموعه تغییرات تست

-ه ، --توسعه دادن، گسترش
دامنه دوجداره را گسترش دهید

-c،-- فرمان
از دستور برای بررسی وضعیت تغییرات استفاده کنید

-U، -- به روز رسانی
به هدف به روز رسانی نکنید

بوک مارک ها
یک نشانک جدید ایجاد کنید یا نشانک های موجود را فهرست کنید:

نشانک‌های hg [OPTIONS]... [NAME]...

نشانک‌ها برچسب‌هایی روی مجموعه‌های تغییرات هستند تا به ردیابی خطوط توسعه کمک کنند. نشانک ها هستند
unversioned و قابل جابجایی، تغییر نام و حذف است. حذف یا جابجایی نشانک وجود ندارد
اثر بر روی مجموعه تغییرات مرتبط

ایجاد یا به روز رسانی یک نشانک باعث می شود که به عنوان "فعال" علامت گذاری شود. فعال
نشانک با "*" نشان داده شده است. هنگامی که یک تعهد انجام می شود، نشانک فعال جلو می رود
به تعهد جدید یک هواپیما hg به روز رسانی همچنین در صورت امکان، یک نشانک فعال را پیش می برد.
به‌روزرسانی دور از نشانک باعث غیرفعال شدن آن می‌شود.

نشانک ها را می توان بین مخازن فشار داد و کشید (نگاه کنید به hg کمک فشار و hg کمک کشیدن
). اگر یک نشانک مشترک از هم جدا شده باشد، یک "نشانک واگرا" جدید به شکل "name@path"
ایجاد خواهد شد. استفاده كردن hg ادغام کردن اختلاف را حل خواهد کرد.

یک نشانک به نام '@' دارای ویژگی خاصی است که hg کلون کردن آن را به طور پیش فرض بررسی می کند
اگر وجود داشته باشد

مثال:

یک نشانک فعال برای خط توسعه جدید ایجاد کنید:

کتاب hg با ویژگی جدید

یک نشانک غیرفعال به عنوان نشانگر مکان ایجاد کنید:

کتاب hg - من بررسی کردم

یک نشانک غیرفعال در مجموعه تغییرات دیگری ایجاد کنید:

hg book -r .^ تست شده

· تغییر نام نشانک بوقلمون به شام:

hg book -m شام بوقلمون

· نشانک '@' را از شاخه دیگری منتقل کنید:

کتاب hg -f @

گزینه های ارسال:

-f، --زور
مجبور

-r،-- برگشت
بازبینی برای اقدام نشانک

-د، --حذف
یک نشانک داده شده را حذف کنید

-m،-- تغییر نام
تغییر نام نشانک داده شده

-من، --غیر فعال
نشانک را غیرفعال علامت گذاری کنید

-T،--قالب
نمایش با الگو (تجربی)

نام مستعار: نشانک

شاخه
نام شعبه فعلی را تنظیم یا نمایش دهید:

شاخه hg [-fC] [NAME]

توجه داشته باشید نام شعب دائمی و جهانی است. استفاده کنید hg چوب الف برای ایجاد وزن سبک
در عوض نشانک بزنید. دیدن hg کمک واژه نامه برای اطلاعات بیشتر در مورد شاخه های نامگذاری شده
و نشانک ها

بدون آرگومان، نام شعبه فعلی را نشان دهید. با یک آرگومان، کار را تنظیم کنید
نام شاخه دایرکتوری (شاخه تا commit بعدی در مخزن وجود نخواهد داشت).
رویه استاندارد توصیه می‌کند که توسعه اولیه در شاخه «پیش‌فرض» انجام شود.

مگر اینکه -f/--force مشخص شده باشد، شاخه به شما اجازه نمی دهد نام شعبه را قبلاً تنظیم کنید
وجود دارد

از -C/--clean برای بازنشانی شاخه دایرکتوری کاری به شاخه والد کار استفاده کنید
دایرکتوری، نفی تغییر شاخه قبلی.

از دستور استفاده کنید hg به روز رسانی برای تغییر به یک شعبه موجود استفاده کنید hg مرتکب شدن -- نزدیک شعبه به
این سر شاخه را بسته علامت بزنید. وقتی تمام سرهای یک شعبه بسته می شود، شعبه بسته می شود
بسته در نظر گرفته شود.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-f، --زور
نام شاخه را تنظیم کنید حتی اگر یک شاخه موجود را تحت الشعاع قرار دهد

-C ، --تمیز
نام شعبه را به نام شعبه والد بازنشانی کنید

شاخه ها
فهرست مخزن با نام شاخه ها:

شاخه های جیوه [-c]

شاخه های نامگذاری شده مخزن را فهرست کنید و مشخص کنید که کدام یک غیرفعال هستند. اگر -c/-- بسته شود
مشخص شده است، همچنین شاخه هایی را که بسته شده اند فهرست کنید (نگاه کنید به hg مرتکب شدن
-- نزدیک شعبه).

از دستور استفاده کنید hg به روز رسانی برای تغییر به یک شعبه موجود

0 را برمی گرداند.

گزینه های ارسال:

-آ، --فعال
فقط شاخه هایی را نشان دهید که سرهای ادغام نشده دارند (منسوخ شده)

-c، -- بسته
شاخه های معمولی و بسته را نشان می دهد

-T،--قالب
نمایش با الگو (تجربی)

بسته
یک فایل تغییر گروه ایجاد کنید:

بسته hg [-f] [-t TYPE] [-a] [-r REV]... [--base REV]... FILE [DEST]

یک فایل تغییر گروه ایجاد کنید که مجموعه‌های تغییرات را جمع‌آوری می‌کند تا به یک مخزن اضافه شود.

برای ایجاد یک بسته حاوی تمام تغییرات، از -a/--all (یا -base null) استفاده کنید. در غیر این صورت، hg
فرض می کند مقصد دارای تمام گره هایی است که شما با پارامترهای ---base مشخص کرده اید.
در غیر این صورت، hg فرض می کند که مخزن تمام گره ها را در مقصد یا
پیش‌فرض فشار/پیش‌فرض اگر مقصدی مشخص نشده باشد.

با گزینه -t/--type می توانید فرمت بسته را تغییر دهید. شما می توانید فشرده سازی را مشخص کنید، a
نسخه بسته نرم افزاری یا هر دو با استفاده از خط تیره (نسخه فشرده). روش های فشرده سازی موجود عبارتند از:
none، bzip2 و gzip (به طور پیش فرض، بسته ها با استفاده از bzip2 فشرده می شوند). موجود
فرمت ها عبارتند از: v1، v2 (پیش فرض تا مناسب ترین).

سپس فایل بسته را می توان با استفاده از ابزارهای معمولی منتقل کرد و به دیگری اعمال کرد
مخزن با دستور unbundle یا pull. این زمانی مفید است که فشار و کشش مستقیم باشد
در دسترس نیست یا زمانی که صادرات کل یک مخزن نامطلوب است.

استفاده از بسته‌ها همه محتویات مجموعه تغییرات از جمله مجوزها، کپی/تغییر نام را حفظ می‌کند
اطلاعات و تاریخچه تجدید نظر

در صورت موفقیت 0، اگر هیچ تغییری پیدا نشد، 1 را برمی گرداند.

گزینه های ارسال:

-f، --زور
اجرا کنید حتی زمانی که مقصد نامرتبط است

-r،-- برگشت
مجموعه تغییراتی که قرار است به مقصد اضافه شود

-ب،--شاخه
شاخه خاصی که می خواهید بسته بندی کنید

--پایه
یک مجموعه تغییرات پایه فرض می شود که در مقصد موجود است

-آ، --همه
بسته تمام تغییرات در مخزن

-t،--نوع
نوع فشرده سازی بسته نرم افزاری برای استفاده (پیش فرض: bzip2)

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

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

گربه
خروجی ویرایش فعلی یا داده شده فایل ها:

hg cat [گزینه]... فایل...

فایل های مشخص شده را همانطور که در ویرایش داده شده بودند چاپ کنید. اگر هیچ تجدیدنظری داده نشود،
والد دایرکتوری کاری استفاده می شود.

خروجی ممکن است به یک فایل باشد، در این صورت نام فایل با استفاده از فرمت داده می شود
رشته قوانین قالب بندی به شرح زیر است:

%%

کاراکتر تحت اللفظی "%".

%s

نام پایه فایل در حال چاپ

%d

dirname فایل در حال چاپ یا '.' اگر در ریشه مخزن باشد

%p

نام مسیر نسبی ریشه فایل در حال چاپ

%H

تغییرات هش (40 رقم هگزادسیمال)

%R

تغییرات مجموعه شماره ویرایش

%h

هش تغییرات با فرم کوتاه (12 رقم هگزادسیمال)

%r

شماره ویرایش مجموعه تغییرات با صفحه صفر

%b

نام پایه مخزن صادرکننده

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-و ،-- خروجی
خروجی چاپ به فایل با نام فرمت شده

-r،-- برگشت
ویرایش داده شده را چاپ کنید

-- رمزگشایی
هر فیلتر رمزگشایی منطبق را اعمال کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

کلون کردن
یک کپی از یک مخزن موجود تهیه کنید:

کلون hg [OPTION]... منبع [DEST]

یک کپی از یک مخزن موجود در یک فهرست جدید ایجاد کنید.

اگر هیچ نام دایرکتوری مقصد مشخص نشده باشد، به طور پیش‌فرض روی نام پایه منبع قرار می‌گیرد.

مکان منبع به مخزن جدید اضافه می شود .hg/hgrc فایل، به عنوان پیش فرض
برای کشش های آینده استفاده شود.

فقط مسیرهای محلی و ssh:// URL ها به عنوان مقصد پشتیبانی می شوند. برای ssh:// مقصد ،
بدون دایرکتوری کار یا .hg/hgrc در سمت راه دور ایجاد خواهد شد.

اگر مخزن منبع دارای نشانکی به نام «@» باشد، آن نسخه بررسی می‌شود
به طور پیش فرض در مخزن جدید.

برای بررسی یک نسخه خاص، از -u/--update یا -U/--noupdate برای ایجاد یک کلون استفاده کنید.
بدون پوشه کاری

برای کشیدن تنها زیرمجموعه‌ای از مجموعه‌های تغییرات، یک یا چند شناسه بازبینی را با آن مشخص کنید
-r/--rev یا شاخه هایی با -b/--branch. کلون حاصل فقط شامل موارد مشخص شده خواهد بود
تغییرات و اجداد آنها این گزینه ها (یا 'clone src#rev dest') دلالت بر --pull, even دارند
برای مخازن منبع محلی

توجه: تعیین یک برچسب شامل مجموعه تغییرات برچسب‌گذاری شده است، اما شامل مجموعه تغییراتی نمی‌شود
برچسب.

برای کارایی، هر زمان که منبع و مقصد روشن باشد، از هاردلینک ها برای شبیه سازی استفاده می شود
همان فایل سیستم (توجه داشته باشید که این فقط در مورد داده های مخزن صدق می کند، نه برای کار
فهرست راهنما). برخی از سیستم های فایل، مانند AFS، هاردلینک را به اشتباه پیاده سازی می کنند، اما این کار را نمی کنند
گزارش خطاها در این موارد از گزینه --pull برای جلوگیری از هاردلینک استفاده کنید.

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

$ cp -al REPO REPOCLONE

این سریعترین راه برای شبیه سازی است، اما همیشه ایمن نیست. عملیات اتمی نیست
(مطمئن شدن از اینکه REPO در طول عملیات اصلاح نشود به عهده شماست) و باید انجام دهید
مطمئن شوید که ویرایشگر شما پیوندهای سخت را می شکند (Emacs و اکثر ابزارهای هسته لینوکس این کار را انجام می دهند). همچنین، این است
با برنامه های افزودنی خاصی که ابرداده های خود را در دایرکتوری .hg قرار می دهند سازگار نیست،
مانند mq.

Mercurial دایرکتوری کاری را به اولین نسخه قابل اجرا از این به روز می کند
لیست:

آ. اگر -U یا مخزن منبع هیچ تغییری نداشته باشد، تهی است

ب اگر شما . و مخزن منبع محلی است، اولین والد مخزن منبع
دایرکتوری کار

ج مجموعه تغییرات با -u مشخص شده است (اگر نام یک شاخه باشد، این به معنای آخرین سر آن است
شاخه)

د تغییراتی که با -r مشخص شده است

ه. نوک ترین سر مشخص شده با -b

f. نوک ترین سر مشخص شده با نحو منبع url#branch

g در صورت وجود، ویرایش با نشانک "@" مشخص شده است

ساعت نوک ترین سر شاخه پیش فرض

من. نکته

هنگام شبیه‌سازی از سرورهایی که از آن پشتیبانی می‌کنند، Mercurial ممکن است داده‌های از پیش تولید شده را از a واکشی کند
URL تبلیغ شده توسط سرور هنگامی که این کار انجام می شود، قلاب ها بر روی تغییرات ورودی و
گروه های تغییر ممکن است دو بار فعال شوند، یک بار برای بسته دریافتی از URL و دیگری برای هر کدام
داده های اضافی از این URL واکشی نشده است. علاوه بر این، اگر خطایی رخ دهد، مخزن
ممکن است به یک کلون جزئی برگردانده شود. این رفتار ممکن است در نسخه های بعدی تغییر کند. دیدن hg
کمک -e کلون باندل ها برای اطلاعات بیشتر.

مثال:

یک مخزن راه دور را در یک فهرست جدید به نام hg/ شبیه سازی کنید:

کلون hg http://selenic.com/hg

یک کلون محلی سبک ایجاد کنید:

پروژه کلون hg/ پروژه-ویژگی/

کلون کردن از یک مسیر مطلق در سرور ssh (توجه داشته باشید دوبار اسلش):

hg clone ssh://user@server//home/projects/alpha/

· در حین بررسی نسخه مشخص شده، یک کلون پرسرعت از طریق شبکه LAN انجام دهید:

کلون hg -- فشرده نشده http://server/repo -u 1.5

· پس از یک ویرایش خاص، یک مخزن بدون تغییرات ایجاد کنید:

hg clone -r 04e544 تجربی/ خوب/

· شبیه سازی (و ردیابی) یک شاخه با نام خاص:

کلون hg http://selenic.com/hg#پایدار

دیدن hg کمک URL ها برای جزئیات در مورد تعیین URL.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-U، -- به روز رسانی
کلون شامل یک فهرست کاری خالی (فقط یک مخزن) خواهد بود.

-u،-- به روز رسانی
تجدید نظر، برچسب یا شعبه برای بررسی

-r،-- برگشت
شامل مجموعه تغییرات مشخص شده است

-ب،--شاخه
فقط شاخه مشخص شده را شبیه سازی کنید

--کشیدن از پروتکل pull برای کپی متادیتا استفاده کنید

-- فشرده نشده
استفاده از انتقال غیر فشرده (سریع از طریق LAN)

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

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

مرتکب شدن
فایل های مشخص شده یا همه تغییرات برجسته را انجام دهید:

hg commit [OPTION]... [FILE]...

تغییرات را در فایل های داده شده در مخزن انجام دهید. برخلاف یک SCM متمرکز، این
عملیات یک عملیات محلی است. دیدن hg فشار راهی برای توزیع فعال تغییرات شما.

اگر لیستی از فایل ها حذف شود، همه تغییرات توسط hg وضعیت متعهد خواهد شد.

اگر نتیجه ادغام را انجام می دهید، هیچ نام فایل یا -I/-X را ارائه نکنید
فیلترها

اگر پیام commit مشخص نشده باشد، Mercurial ویرایشگر پیکربندی شده شما را در جایی که می توانید راه اندازی می کند
یک پیام وارد کنید در صورتی که commit شما با شکست مواجه شود، یک نسخه پشتیبان از پیام خود را در آن پیدا خواهید کرد
hg/last-message.txt.

پرچم --close-branch را می توان برای علامت گذاری سر شاخه فعلی بسته استفاده کرد. وقتی همه سرها
یک شعبه بسته هستند، شعبه بسته شده در نظر گرفته می شود و دیگر در لیست نیست.

پرچم --amend را می توان برای اصلاح والد دایرکتوری کاری با یک علامت جدید استفاده کرد
commit که شامل تغییرات در والد علاوه بر تغییراتی است که در حال حاضر توسط آن گزارش شده است
hg وضعیت، در صورت وجود commit قدیمی در یک بسته پشتیبان ذخیره می شود
hg/strip-backup (نگاه کنید به hg کمک بسته و hg کمک جدا کردن نحوه بازیابی آن).

پیام، کاربر و تاریخ از commit اصلاح شده گرفته می شود مگر اینکه مشخص شده باشد. وقتی یک پیام
در خط فرمان مشخص نشده است، ویرایشگر با پیام اصلاح شده باز می شود
مرتکب شدن.

امکان اصلاح مجموعه تغییرات عمومی وجود ندارد (نگاه کنید به hg کمک فاز) یا تغییراتی که دارند
کودکان.

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

در صورت موفقیت 0، اگر چیزی تغییر نکرده باشد، 1 را برمی گرداند.

مثال:

· تمام فایل هایی که به .py ختم می شوند را commit کنید:

hg commit --شامل "set:**.py"

· تمام فایل های غیر باینری را commit کنید:

hg commit --exclude "set:binary()"

· commit فعلی را اصلاح کنید و تاریخ را به اکنون تنظیم کنید:

hg commit --amend --date now

گزینه های ارسال:

-آ، --اضافه کردن حذف
قبل از انجام، فایل‌های جدید/از دست رفته را به‌عنوان اضافه/حذف شده علامت‌گذاری کنید

-- نزدیک شعبه
یک سر شاخه را بسته علامت بزنید

--اصلاح
والد دایرکتوری کاری را اصلاح کنید

-s ، --راز
از مرحله مخفی برای ارتکاب استفاده کنید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-من، --در ارتباط بودن
از حالت تعاملی استفاده کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

-S، -- subrepos
بازگشت به مخازن فرعی

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

نام مستعار: ci

پیکربندی
نمایش تنظیمات پیکربندی ترکیبی از همه فایل‌های hgrc:

پیکربندی hg [-u] [NAME]...

بدون هیچ آرگومان، نام و مقادیر همه موارد پیکربندی را چاپ کنید.

با یک آرگومان فرم section.name، فقط مقدار آن آیتم پیکربندی را چاپ کنید.

با چندین آرگومان، نام و مقادیر همه موارد پیکربندی را با بخش منطبق چاپ کنید
نامها

با -edit، یک ویرایشگر را در فایل پیکربندی سطح کاربر شروع کنید. با --global، آن را ویرایش کنید
فایل پیکربندی کل سیستم با --local، فایل پیکربندی سطح مخزن را ویرایش کنید.

با --debug، منبع (نام فایل و شماره خط) برای هر آیتم پیکربندی چاپ می شود.

دیدن hg کمک پیکربندی برای اطلاعات بیشتر در مورد فایل های پیکربندی

در صورت موفقیت 0، اگر NAME وجود نداشته باشد، 1 را برمی گرداند.

گزینه های ارسال:

-u، -- غیر قابل اعتماد
نمایش گزینه های پیکربندی نامعتبر

-ه ، -- ویرایش
تنظیمات کاربر را ویرایش کنید

-ل، -- محلی
ویرایش پیکربندی مخزن

-g، -- جهانی
پیکربندی جهانی را ویرایش کنید

نام مستعار: showconfig debugconfig

کپی کنید
علامت گذاری فایل ها به عنوان کپی شده برای commit بعدی:

hg copy [OPTION]... [منبع]... DEST

dest را به عنوان دارای کپی از فایل های منبع علامت گذاری کنید. اگر dest یک دایرکتوری است، کپی ها در آن قرار می گیرند
فهرست راهنما. اگر dest یک فایل است، منبع باید یک فایل باشد.

به طور پیش فرض، این دستور محتویات فایل ها را همانطور که در کار وجود دارد کپی می کند
فهرست راهنما. اگر با -A/--after فراخوانی شود، عملیات ضبط می شود، اما هیچ کپی برداری انجام نمی شود
انجام.

این دستور با commit بعدی اعمال می شود. برای لغو یک کپی قبل از آن، ببینید hg برگرداندن.

در صورت موفقیت 0، در صورت بروز خطا، 1 را برمی گرداند.

گزینه های ارسال:

-آ، --بعد از
یک کپی که قبلاً رخ داده است را ضبط کنید

-f، --زور
کپی اجباری روی یک فایل مدیریت شده موجود

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-n، -- خشک اجرا شود
اقدامات را انجام ندهید، فقط خروجی را چاپ کنید

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

نام مستعار: cp

تفاوت
مخزن تفاوت (یا فایل های انتخاب شده):

hg diff [OPTION]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...

نشان دادن تفاوت بین ویرایش‌ها برای فایل‌های مشخص‌شده.

تفاوت بین فایل ها با استفاده از فرمت تفاوت یکپارچه نشان داده می شود.

توجه داشته باشید hg تفاوت ممکن است نتایج غیرمنتظره ای برای ادغام ایجاد کند، زیرا به طور پیش فرض مقایسه می شود
در صورت عدم ویرایش، در برابر اولین مجموعه تغییرات والد دایرکتوری کاری
مشخص شده.

هنگامی که دو آرگومان تجدید نظر داده می شود، تغییرات بین آن تجدید نظرها نشان داده می شود. اگر
فقط یک ویرایش مشخص شده است، سپس آن ویرایش با فهرست کار مقایسه می شود،
و زمانی که هیچ ویرایشی مشخص نشده باشد، فایل های دایرکتوری کاری با آن مقایسه می شوند
والد اول

یا می توانید -c/--change را با یک ویرایش مشخص کنید تا تغییرات آن را ببینید
تغییرات نسبت به والد اول آن.

بدون گزینه -a/--text، diff از ایجاد تفاوت در فایل‌هایی که به عنوان تشخیص می‌دهد جلوگیری می‌کند.
دودویی. با -a، diff به هر حال یک تفاوت ایجاد می کند، احتمالاً با نتایج نامطلوب.

از گزینه -g/--git برای ایجاد تفاوت در فرمت git extended diff استفاده کنید. برای بیشتر
اطلاعات، خواندن hg کمک متفاوت است.

مثال:

یک فایل را در دایرکتوری کاری فعلی با والد آن مقایسه کنید:

hg diff foo.c

دو نسخه تاریخی یک فهرست را با اطلاعات تغییر نام مقایسه کنید:

hg diff --git -r 1.0:1.2 lib/

· دریافت آمار تغییر نسبت به آخرین تغییر در برخی از تاریخ ها:

hg diff --stat -r "تاریخ('2 می')"

· همه فایل های تازه اضافه شده که حاوی کلمه کلیدی هستند را متفاوت کنید:

hg diff "set:added() و grep(GNU)"

· یک ویرایش و والدین آن را مقایسه کنید:

hg diff -c 9353 # مقایسه با والد اول
hg diff -r 9353^:9353 # همان با استفاده از نحو revset
hg diff -r 9353^2:9353 # با والد دوم مقایسه کنید

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
تجدید نظر

-c،--تغییر دادن
تغییر ایجاد شده توسط تجدید نظر

-آ، --متن
تمام فایل ها را به عنوان متن در نظر بگیرید

-g، --git
از فرمت git extended diff استفاده کنید

-- گره ها
تاریخ ها را از سرصفحه های متفاوت حذف کنید

-- بدون پیشوند
پیشوندهای a/ و b/ را از نام فایل حذف کنید

-پ، --نمایش عملکرد
نشان دهید که هر تغییر در کدام تابع است

--معکوس
یک تفاوت تولید می کند که تغییرات را خنثی می کند

-w، - نادیده گرفتن همه فضا
هنگام مقایسه خطوط، فضای سفید را نادیده بگیرید

-ب، - نادیده گرفتن-فضا-تغییر
تغییرات در مقدار فضای سفید را نادیده بگیرید

-ب، -نادیده گرفتن-خطوط خالی
تغییراتی را که همه خطوط آن خالی است نادیده بگیرید

-U،-- متحد
تعداد خطوط زمینه برای نشان دادن

--stat خلاصه تغییرات به سبک diffstat خروجی

-- ریشه
تفاوت هایی را نسبت به زیر شاخه تولید می کند

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-S، -- subrepos
بازگشت به مخازن فرعی

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

صادرات
هدر را حذف کنید و برای یک یا چند مجموعه تغییرات متفاوت است:

صادرات hg [OPTION]... [-o OUTFILESPEC] [-r] [REV]...

هدر تغییرات و تفاوت های یک یا چند ویرایش را چاپ کنید. اگر بازنگری صورت نگیرد،
والد دایرکتوری کاری استفاده می شود.

اطلاعات نشان داده شده در هدر تغییرات عبارتند از: نویسنده، تاریخ، نام شعبه (اگر
غیر پیش‌فرض)، هش را تنظیم کنید، والد(ها) را تغییر دهید و نظر را commit کنید.

توجه داشته باشید hg صادرات ممکن است خروجی تفاوت غیرمنتظره برای مجموعه تغییرات ادغام ایجاد کند، همانطور که می شود
تغییرات ادغام را فقط با والد اول آن مقایسه کنید.

خروجی ممکن است به یک فایل باشد، در این صورت نام فایل با استفاده از فرمت داده می شود
رشته قوانین قالب بندی به شرح زیر است:

%%

کاراکتر تحت اللفظی "%".

%H

تغییرات هش (40 رقم هگزادسیمال)

%N

تعداد وصله های در حال تولید

%R

تغییرات مجموعه شماره ویرایش

%b

نام پایه مخزن صادرکننده

%h

هش تغییرات با فرم کوتاه (12 رقم هگزادسیمال)

%m

خط اول پیام commit (فقط کاراکترهای الفبایی)

%n

شماره دنباله‌ای با لایه صفر، که از 1 شروع می‌شود

%r

شماره ویرایش مجموعه تغییرات با صفحه صفر

بدون گزینه -a/--text، صادرات از ایجاد تفاوت در فایل‌هایی که تشخیص می‌دهد جلوگیری می‌کند
دودویی. با -a، صادرات به هر حال یک تفاوت ایجاد می کند، احتمالاً با نتایج نامطلوب.

از گزینه -g/--git برای ایجاد تفاوت در فرمت git extended diff استفاده کنید. دیدن hg کمک
متفاوت است برای اطلاعات بیشتر.

با گزینه --switch-parent، تفاوت در مقابل والد دوم خواهد بود. میتونه باشه
برای بررسی ادغام مفید است.

مثال:

· از صادرات و واردات برای پیوند یک رفع اشکال به شعبه فعلی استفاده کنید:

hg export -r 9353 | واردات hg -

· تمام تغییرات بین دو ویرایش را به یک فایل با اطلاعات تغییر نام صادر کنید:

hg export --git -r 123:150 > change.txt

· تغییرات خروجی را به یک سری وصله با نام های توصیفی تقسیم کنید:

hg export -r "outgoing()" -o "%n-%m.patch"

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-و ،-- خروجی
خروجی چاپ به فایل با نام فرمت شده

--switch-parent
تفاوت در برابر والد دوم

-r،-- برگشت
تجدید نظر در صادرات

-آ، --متن
تمام فایل ها را به عنوان متن در نظر بگیرید

-g، --git
از فرمت git extended diff استفاده کنید

-- گره ها
تاریخ ها را از سرصفحه های متفاوت حذف کنید

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

فایل ها
لیست فایل های پیگیری شده:

فایل های hg [OPTION]... [PATTERN]...

فایل های تحت کنترل Mercurial را در فهرست کاری یا ویرایش مشخص شده چاپ کنید
نام ها با الگوهای داده شده مطابقت دارند (به استثنای فایل های حذف شده).

اگر هیچ الگوی برای مطابقت داده نشود، این دستور نام همه فایل‌ها را در زیر چاپ می‌کند
کنترل جیوه در فهرست کاری.

مثال:

· لیست تمام فایل ها در فهرست فعلی:

فایل های hg

· اندازه ها و پرچم ها را برای بازبینی فعلی نشان می دهد:

فایل های hg -vr .

· لیست تمام فایل هایی با نام README:

فایل های hg -I "**/README"

· لیست تمام فایل های باینری:

فایل های hg "set:binary()"

فایل های حاوی یک عبارت منظم را پیدا کنید:

فایل های hg "set:grep('bob')"

· محتویات فایل ردیابی شده را با xargs و grep جستجو کنید:

فایل های hg -0 | xargs -0 grep foo

دیدن hg کمک الگوهای و hg کمک مجموعه فایل ها برای اطلاعات بیشتر در مورد مشخص کردن فایل
الگوهای.

اگر مطابقت پیدا شود 0، در غیر این صورت 1 را برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
مخزن را همانطور که در REV هست جستجو کنید

-0، -- چاپ 0
پایان نام فایل ها با NUL، برای استفاده با xargs

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-T،--قالب
نمایش با الگو (تجربی)

-S، -- subrepos
بازگشت به مخازن فرعی

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

فراموش کردن
فایل های مشخص شده را در commit بعدی فراموش کنید:

hg فراموش کنید [OPTION]... FILE...

فایل های مشخص شده را علامت گذاری کنید تا پس از commit بعدی دیگر ردیابی نشوند.

این فقط فایل ها را از شاخه فعلی حذف می کند، نه از کل تاریخچه پروژه، و
آنها را از پوشه کاری حذف نمی کند.

برای حذف فایل از دایرکتوری کاری، نگاه کنید hg برداشتن.

برای لغو فراموشی قبل از ارتکاب بعدی، ببینید hg اضافه کردن.

مثال:

· فایل های باینری جدید اضافه شده را فراموش کنید:

hg "set:added() و باینری()" را فراموش کنید

· فراموش کردن فایل هایی که توسط .hgignore حذف می شوند:

hg فراموش کنید "set:hgignore()"

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

پیوند
تغییرات را از شاخه های دیگر در شاخه فعلی کپی کنید:

پیوند جیوه [OPTION]... [-r REV]... REV...

این دستور از منطق ادغام Mercurial برای کپی کردن تغییرات فردی از شاخه های دیگر استفاده می کند
بدون ادغام شاخه ها در نمودار تاریخ. این گاهی اوقات به عنوان 'backporting' یا شناخته می شود
'چیدن گیلاس'. به طور پیش فرض، گرافت کاربر، تاریخ و توضیحات را از منبع کپی می کند
را تغییر می دهد.

مجموعه‌های تغییراتی که اجداد تجدیدنظر فعلی هستند، که قبلاً پیوند شده‌اند، یا
که از ادغام ها صرفنظر می شود.

اگر --log مشخص شده باشد، پیام های log یک نظر به فرم اضافه می شود:

(پیوند شده از CHANGESETHASH)

اگر --force مشخص شده باشد، تجدید نظرها حتی اگر از قبل اجداد آن باشند پیوند زده می شود
یا به مقصد پیوند زده شده اند. این زمانی مفید است که تجدید نظرها از آن زمان انجام شده باشد
عقب نشینی شده است.

اگر ادغام پیوند منجر به درگیری شود، روند پیوند قطع می شود به طوری که
ادغام فعلی را می توان به صورت دستی حل کرد. هنگامی که تمام تعارضات برطرف شد، پیوند
فرآیند را می توان با گزینه -c/--continue ادامه داد.

توجه داشته باشید گزینه -c/--continue گزینه های قبلی را دوباره اعمال نمی کند، به جز -force.

مثال:

یک تغییر واحد را در شاخه پایدار کپی کنید و توضیحات آن را ویرایش کنید:

آپدیت hg پایدار است
پیوند hg -- ویرایش 9393

· پیوند مجموعه ای از تغییرات با یک استثنا، به روز رسانی تاریخ ها:

hg graft -D "2085::2093 و نه 2091"

· پس از حل تعارضات پیوند را ادامه دهید:

پیوند جیوه -ج

· نشان دادن منبع تغییرات پیوندی:

hg log --debug -r .

· نمایش بازنگری ها مرتب شده بر اساس تاریخ:

hg log -r 'sort(all(), date)'

دیدن hg کمک تجدید نظر و hg کمک دوباره تنظیم می کند برای اطلاعات بیشتر در مورد تعیین تجدید نظر.

با تکمیل موفقیت آمیز 0 برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
تجدید نظر در پیوند

-c، --ادامه هید
از سرگیری پیوند قطع شده

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-- ثبت نام افزودن اطلاعات پیوند به گزارش پیام

-f، --زور
پیوند نیرو

-دی، --تاریخ فعلی
تاریخ فعلی را به عنوان تاریخ تعهد ثبت کنید

-U، --کاربر فعلی
کاربر فعلی را به عنوان committer ثبت کنید

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

-t،--ابزار
ابزار ادغام را مشخص کنید

-n، -- خشک اجرا شود
اقدامات را انجام ندهید، فقط خروجی را چاپ کنید

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

grep استفاده
یک الگو را در فایل ها و ویرایش های مشخص شده جستجو کنید:

hg grep [OPTION]... PATTERN [FILE]...

بازبینی فایل‌ها را برای یک عبارت منظم جستجو کنید.

این دستور رفتار متفاوتی با Unix grep دارد. فقط رجیکس های Python/Perl را می پذیرد. آی تی
تاریخچه مخزن را جستجو می کند، نه دایرکتوری کاری. همیشه ویرایش را چاپ می کند
شماره ای که در آن یک مسابقه ظاهر می شود.

به طور پیش فرض، grep تنها خروجی را برای اولین ویرایش فایلی که در آن a را پیدا می کند چاپ می کند
همخوانی داشتن. برای اینکه آن را برای چاپ هر ویرایشی که حاوی تغییر در وضعیت مطابقت است ("-" برای a
منطبق که به یک غیر منطبق تبدیل می شود، یا "+" برای غیر منطبق که تبدیل به یک می شود)، از
-- همه پرچم

اگر مطابقت پیدا شود 0، در غیر این صورت 1 را برمی گرداند.

گزینه های ارسال:

-0، -- چاپ 0
پایان فیلدها با NUL

--همه چاپ تمام نسخه های مطابقت

-آ، --متن
تمام فایل ها را به عنوان متن در نظر بگیرید

-f، --دنبال کردن
تاریخچه تغییرات مجموعه یا تاریخچه فایل را در بین کپی ها و تغییر نام ها دنبال کنید

-من، --نادیده گرفتن مورد
نادیده گرفتن حروف کوچک هنگام تطبیق

-ل، --فایلها-با-مطابقات
فقط نام فایل ها و نسخه های مطابقت را چاپ کنید

-n، --شماره خط
چاپ شماره خطوط منطبق

-r،-- برگشت
فقط فایل های جستجو در محدوده بازبینی تغییر کردند

-u، --کاربر
نویسنده را فهرست کنید (طولانی با -v)

-د، --تاریخ
تاریخ را فهرست کنید (کوتاه با -q)

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

سر
نمایش سر شاخه ها:

سرهای hg [-ct] [-r STARTREV] [REV]...

بدون هیچ آرگومان، تمام سر شاخه های باز را در مخزن نشان دهید. رؤسای شعب هستند
تغییراتی که هیچ نسلی در یک شاخه ندارند. آنها جایی که توسعه هستند
به طور کلی انجام می شود و اهداف معمول برای عملیات به روز رسانی و ادغام هستند.

اگر یک یا چند REV داده شود، فقط سر شاخه ها را روی شاخه های مرتبط با آن باز کنید
تغییرات مشخص شده نشان داده شده است. این بدان معنی است که شما می توانید استفاده کنید hg سر . برای دیدن سرها
شعبه ای که در حال حاضر تحویل داده شده است.

اگر -c/--closed مشخص شده است، سر شاخه‌های بسته را نیز نشان دهید (نگاه کنید به hg مرتکب شدن
-- نزدیک شعبه).

اگر STARTREV مشخص شده باشد، تنها سرهایی که از فرزندان STARTREV هستند، خواهند بود.
نمایش داده.

اگر -t/--topo مشخص شده باشد، مکانیک شاخه های نامگذاری شده نادیده گرفته می شود و فقط توپولوژیکی است.
سرها (تغییرها بدون فرزند) نشان داده خواهد شد.

در صورت یافتن سرهای منطبق 0، در غیر این صورت 1 را برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
فقط سرهایی را نشان دهید که از نوادگان STARTREV هستند

-t، --توپو
فقط سرهای توپولوژیکی را نشان می دهد

-آ، --فعال
فقط سرشاخه های فعال را نشان دهد (منسوخ شده)

-c، -- بسته
سر شاخه های معمولی و بسته را نشان می دهد

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

کمک
نشان دادن کمک برای یک موضوع معین یا یک نمای کلی راهنما:

hg help [-ecks] [TOPIC]

بدون هیچ آرگومان، فهرستی از دستورات را با پیام های راهنمای کوتاه چاپ کنید.

با توجه به عنوان، پسوند یا نام فرمان، راهنمای آن موضوع را چاپ کنید.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-ه ، --افزونه
فقط راهنما برای برنامه های افزودنی نشان داده شود

-c، -- فرمان
فقط راهنمایی برای دستورات نشان داده شود

-k، --کلمه کلیدی
نمایش موضوعات مطابق با کلمه کلیدی

-s ،--سیستم
نشان دادن کمک برای پلتفرم(های) خاص

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

شناسایی
فهرست کاری یا ویرایش مشخص شده را شناسایی کنید:

hg شناسایی [-nibtB] [-r REV] [منبع]

خلاصه ای را چاپ کنید که وضعیت مخزن در REV را با استفاده از یک یا دو هش والد شناسایی می کند
شناسه‌ها و به دنبال آن یک "+" در صورتی که دایرکتوری کاری تغییرات غیرمتعهد داشته باشد،
نام شعبه (اگر پیش فرض نباشد)، لیستی از برچسب ها، و لیستی از نشانک ها.

وقتی REV داده نمی شود، خلاصه ای از وضعیت فعلی مخزن را چاپ کنید.

تعیین یک مسیر به ریشه مخزن یا بسته نرم افزاری Mercurial باعث می شود تا جستجو در آن عمل کند
آن مخزن/بسته.

مثال:

یک شناسه ساخت برای دایرکتوری کاری ایجاد کنید:

hg id --id > build-id.dat

· بازبینی مربوط به یک برچسب را پیدا کنید:

hg id -n -r 1.3

· آخرین ویرایش یک مخزن راه دور را بررسی کنید:

hg id -r نکته http://selenic.com/hg/

دیدن hg ورود به سیستم برای ایجاد اطلاعات بیشتر در مورد ویرایش های خاص، از جمله هش کامل
شناسه ها

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
بازبینی مشخص شده را شناسایی کنید

-n، -- تعداد
نمایش شماره ویرایش محلی

-من، --شناسه
نمایش شناسه بازبینی جهانی

-ب، --شاخه
نشان دادن شاخه

-t، -- برچسب ها
نشان دادن برچسب ها

-ب، -- نشانک ها
نشانک ها را نشان دهید

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

نام مستعار: id

واردات
یک مجموعه سفارشی از پچ ها را وارد کنید:

واردات hg [گزینه]... پچ...

لیستی از وصله ها را وارد کنید و آنها را به صورت جداگانه انجام دهید (مگر اینکه --no-commit مشخص شده باشد).

برای خواندن یک وصله از ورودی استاندارد، از "-" به عنوان نام وصله استفاده کنید. اگر URL مشخص شده باشد،
پچ از آنجا دانلود خواهد شد.

Import ابتدا تغییرات را در پوشه کاری اعمال می کند (مگر اینکه --bypass مشخص شده باشد)،
در صورت ایجاد تغییرات برجسته، واردات متوقف می شود.

از --bypass برای اعمال و ارسال وصله ها به طور مستقیم به مخزن استفاده کنید، بدون اینکه بر روی مخزن تأثیر بگذارد
دایرکتوری کار بدون --exact، وصله ها در بالای کار اعمال خواهند شد
بازبینی والد دایرکتوری

می‌توانید یک پچ را مستقیماً از یک پیام ایمیل وارد کنید. حتی وصله ها به عنوان پیوست کار می کنند (به
از قسمت بدن استفاده کنید، باید نوع text/plain یا text/x-patch داشته باشد. از و سرصفحه موضوع
از پیام ایمیل به عنوان committer و پیام commit پیش فرض استفاده می شود. تمام متن/بدن ساده
قطعات قبل از اولین تفاوت به پیام commit اضافه می شوند.

اگر پچ وارد شده توسط hg صادرات، کاربر و توضیحات از بازنویسی پچ
مقادیر از سرصفحه و متن پیام مقادیر داده شده در خط فرمان با -m/--message و
-u/--کاربر اینها را نادیده می گیرد.

اگر --exact مشخص شده باشد، import دایرکتوری کاری را روی والد هر پچ تنظیم می کند
قبل از اعمال آن، و اگر مجموعه تغییرات ایجاد شده دارای شناسه متفاوتی با شناسه باشد، لغو خواهد شد
یکی در پچ ثبت شده است. این ممکن است به دلیل مشکلات مجموعه شخصیت یا موارد دیگر رخ دهد
نقص در قالب وصله متنی

از --partial استفاده کنید تا مطمئن شوید که یک تغییرات از پچ ایجاد می شود، حتی اگر برخی از هانک ها شکست بخورند
بکار گرفتن. هنگ هایی که درخواست نمی کنند به a نوشته می شوند فایل رج. درگیری ها
سپس می توان با دست قبل از حل شود hg مرتکب شدن --اصلاح برای به روز رسانی ایجاد شده اجرا می شود
تغییرات مجموعه این پرچم وجود دارد تا به افراد اجازه دهد وصله‌هایی را وارد کنند که تا حدی بدون آن اعمال می‌شوند
از دست دادن ابرداده مرتبط (نویسنده، تاریخ، توضیحات، ...).

توجه داشته باشید زمانی که هیچ پوسته ای تمیز اعمال نمی شود، hg واردات --جزئي یک تغییرات خالی ایجاد خواهد کرد،
وارد کردن تنها متادیتا پچ.

با شباهت -s/--، hg تلاش می کند تا تغییر نام ها و کپی ها را در پچ در
به همان روشی که hg اضافه کردن حذف.

امکان استفاده از برنامه های پچ خارجی برای انجام پچ با تنظیم ui.patch
گزینه پیکربندی برای ابزار داخلی پیش‌فرض، fuzz را نیز می‌توان از طریق پیکربندی کرد
patch.fuzzاست. دیدن hg کمک پیکربندی برای اطلاعات بیشتر در مورد فایل های پیکربندی و نحوه انجام
از این گزینه ها استفاده کنید

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

مثال:

· یک پچ سنتی را از یک وب سایت وارد کنید و تغییر نام ها را شناسایی کنید:

hg import -s 80 http://example.com/bugfix.patch

· وارد کردن تغییرات از سرور hgweb:

واردات hg http://www.selenic.com/hg/rev/5ca8c111e9aa

· تمام وصله ها را در mbox به سبک یونیکس وارد کنید:

hg import incoming-patches.mbox

· سعی کنید دقیقاً یک تغییرات صادراتی را بازیابی کنید (همیشه امکان پذیر نیست):

واردات hg --exact proposed-fix.patch

از یک ابزار خارجی برای اعمال وصله ای استفاده کنید که برای ابزار داخلی پیش فرض خیلی مبهم است.

hg import --config ui.patch="patch --merge" fuzzy.patch

· fuzzing پیش فرض را از 2 به 7 کمتر دقیق تغییر دهید

hg import --config ui.fuzz=7 fuzz.patch

0 به موفقیت، 1 در موفقیت جزئی (نگاه کنید به --جزئی).

گزینه های ارسال:

-پ،-- نوار
گزینه نوار فهرست برای پچ. این همان معنای متناظر را دارد
گزینه پچ (پیش‌فرض: 1)

-ب،--پایه
مسیر پایه (منسوخ شده)

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-f، --زور
رد شدن از بررسی تغییرات غیرمتعهد برجسته (منسوخ شده)

--عدم تعهد
متعهد نشوید، فقط دایرکتوری کاری را به روز کنید

--میان بر
پچ را بدون دست زدن به دایرکتوری کاری اعمال کنید

--جزئي
مرتکب شوید حتی اگر برخی از کارها شکست بخورند

--دقیقا
پچ را به گره هایی که از آنها تولید شده است اعمال کنید

-- پیشوند
پچ را به زیر شاخه اعمال کنید

--واردات-شعبه
استفاده از هر گونه اطلاعات شاخه در پچ (مطمئن با --exact)

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

-s ،-- شباهت
حدس زدن نام فایل ها بر اساس شباهت (0<=s<=100)

نام مستعار: پچ

وارد شونده
نمایش تغییرات جدید یافت شده در منبع:

hg ورودی [-p] [-n] [-M] [-f] [-r REV]... [--Bundle FILENAME] [منبع]

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

برای جزئیات فرمت منبع معتبر به کش مراجعه کنید.

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

BM1 01234567890a اضافه شد
BM2 1234567890ab پیشرفته
BM3 234567890abc واگرا شد
BM4 34567890abcd تغییر کرد

اقدامی که هنگام کشیدن به صورت محلی انجام می شود به وضعیت هر نشانک بستگی دارد:

اضافه

pull آن را ایجاد خواهد کرد

پیشرفته

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

واگرا

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

تغییر

نتیجه بستگی به تنظیمات از راه دور دارد

از نقطه نظر رفتار کشیدن، نشانک فقط در کنترل از راه دور وجود دارد
مخزن به عنوان اضافه، حتی اگر در واقع به صورت محلی حذف شده باشد.

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

مثال:

· نمایش تغییرات دریافتی با پچ ها و توضیحات کامل:

hg ورودی -vp

· نمایش تغییرات ورودی به استثنای ادغام، ذخیره یک بسته:

hg در -vpM --bundle incoming.hg
hg pull incoming.hg

· به طور خلاصه تغییرات داخل یک بسته را فهرست کنید:

hg در تغییرات.hg -T "{desc|firstline}\n"

اگر تغییرات ورودی وجود داشته باشد 0، در غیر این صورت 1 را برمی گرداند.

گزینه های ارسال:

-f، --زور
اجرا شود حتی اگر مخزن راه دور نامرتبط باشد

-n، --جدیدترین-اول
نمایش جدیدترین رکورد ابتدا

--دسته
فایل برای ذخیره بسته ها در

-r،-- برگشت
یک مجموعه تغییرات از راه دور که قرار است اضافه شود

-ب، -- نشانک ها
مقایسه بوک مارک ها

-ب،--شاخه
شاخه خاصی که دوست دارید بکشید

-پ، -- پچ
نشان دادن پچ

-g، --git
از فرمت git extended diff استفاده کنید

-ل،--حد
محدود کردن تعداد تغییرات نمایش داده شده

-M، -----ادغام نمی شود
ادغام ها را نشان ندهید

--stat خلاصه تغییرات به سبک diffstat خروجی

-G، -- نمودار
بازبینی DAG را نشان دهید

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

-S، -- subrepos
بازگشت به مخازن فرعی

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

نام مستعار: در

init انجام
یک مخزن جدید در دایرکتوری داده شده ایجاد کنید:

hg init [-e CMD] [--remotecmd CMD] [DEST]

یک مخزن جدید در دایرکتوری داده شده راه اندازی کنید. اگر دایرکتوری داده شده وجود نداشته باشد،
ایجاد خواهد شد.

اگر دایرکتوری داده نشود، دایرکتوری فعلی استفاده می شود.

امکان تعیین یک ssh:// URL به عنوان مقصد. دیدن hg کمک URL ها برای اطلاعات بیشتر
اطلاعات.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

قرار دادن
یافتن فایل های مطابق با الگوهای خاص (منسوخ شده):

hg مکان یابی [OPTION]... [PATTERN]...

فایل هایی را تحت کنترل Mercurial در فهرست کاری چاپ کنید که نام آنها با داده شده مطابقت دارد
الگوهای.

به طور پیش فرض، این دستور همه دایرکتوری های موجود در فهرست کاری را جستجو می کند. فقط برای جستجو
دایرکتوری فعلی و زیر شاخه های آن، از "--include ." استفاده کنید.

اگر هیچ الگوی برای مطابقت داده نشود، این دستور نام همه فایل‌ها را در زیر چاپ می‌کند
کنترل جیوه در فهرست کاری.

اگر می خواهید خروجی این دستور را به دستور "xargs" وارد کنید، از گزینه -0 استفاده کنید
هم به این دستور و هم به "xargs". با این کار از مشکل درمان مجردی "xargs" جلوگیری می شود
نام فایل هایی که حاوی فضای خالی به عنوان چندین نام فایل هستند.

دیدن hg کمک فایل ها برای دستور همه کاره تر

اگر مطابقت پیدا شود 0، در غیر این صورت 1 را برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
مخزن را همانطور که در REV هست جستجو کنید

-0، -- چاپ 0
پایان نام فایل ها با NUL، برای استفاده با xargs

-f، --مسیر کامل
مسیرهای کامل را از ریشه سیستم فایل چاپ کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

ورود به سیستم
نمایش تاریخچه بازبینی کل مخزن یا فایل ها:

hg log [OPTION]... [FILE]

تاریخچه ویرایش فایل های مشخص شده یا کل پروژه را چاپ کنید.

اگر محدوده بازبینی مشخص نشده باشد، پیش‌فرض است نکته: 0 مگر اینکه --follow تنظیم شده باشد که در آن
در حالتی که والد دایرکتوری کاری به عنوان ویرایش اولیه استفاده می شود.

تاریخچه فایل بدون تغییر نام یا تاریخچه کپی فایل ها نشان داده می شود. از -f/--follow استفاده کنید
با نام فایل برای دنبال کردن تاریخچه در تغییر نام ها و کپی ها. - بدون نام فایل دنبال کنید
فقط اجداد یا نوادگان نسخه اولیه را نشان می دهد.

به‌طور پیش‌فرض این دستور شماره ویرایش و شناسه تغییرات، تگ‌ها، غیرچشم‌گیری را چاپ می‌کند
والدین، کاربر، تاریخ و زمان، و خلاصه ای برای هر commit. هنگامی که -v/--کلمه سوئیچ
استفاده می شود، لیست فایل های تغییر یافته و پیام commit کامل نشان داده می شود.

با نمودار -- ویرایش ها به عنوان یک هنر ASCII DAG با آخرین تغییرات در نشان داده شده است
بالاترین. 'o' یک مجموعه تغییرات است، '@' یک والد دایرکتوری فعال، 'x' منسوخ است و '+'
انشعابی را نشان می دهد که در آن تغییرات از خطوط زیر یک والد ادغام 'o' است
همان خط

توجه داشته باشید hg ورود به سیستم -- پچ ممکن است خروجی تفاوت غیرمنتظره برای مجموعه تغییرات ادغام ایجاد کند، همانطور که می شود
فقط مجموعه تغییرات ادغام را با والد اول آن مقایسه کنید. همچنین فقط فایل ها
متفاوت از BOTH پدر و مادر در فایل ها ظاهر می شود:.

توجه به دلایل عملکرد، hg ورود به سیستم فایل ممکن است تغییرات تکراری ایجاد شده در شاخه ها را حذف کند
و حذف یا تغییر حالت را نشان نخواهد داد. برای مشاهده همه این تغییرات، از
سوئیچ حذف شده

بعضی مثالها:

· تغییرات با توضیحات کامل و لیست فایل:

hg log -v

· اجداد را به دایرکتوری کاری تغییر می دهد:

hg log -f

· 10 تعهد آخر در شاخه فعلی:

hg log -l 10 -b .

· مجموعه تغییراتی که تمام تغییرات یک فایل، از جمله حذف ها را نشان می دهد:

hg log --file.c. حذف شد

· همه تغییراتی که دایرکتوری را لمس می کنند، با تفاوت ها، به استثنای ادغام ها:

hg log -Mp lib/

· همه اعداد ویرایشی که با یک کلمه کلیدی مطابقت دارند:

hg log -k bug --template "{rev}\n"

· شناسه هش کامل والد دایرکتوری کاری:

hg log -r . --قالب "{node}\n"

· فهرست الگوهای گزارش موجود:

لیست hg log -T

بررسی کنید که آیا مجموعه تغییرات داده شده در نسخه برچسب گذاری شده گنجانده شده است:

hg log -r "a21ccf and ancestor(1.9)"

· یافتن همه تغییرات توسط برخی از کاربران در یک محدوده تاریخ:

hg log -k alice -d "مه 2008 تا ژوئیه 2008"

· خلاصه تمام تغییرات پس از آخرین برچسب:

hg log -r "last(tagged())::" --template "{desc|firstline}\n"

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

دیدن hg کمک تجدید نظر و hg کمک دوباره تنظیم می کند برای اطلاعات بیشتر در مورد تعیین و سفارش
تجدید نظرها

دیدن hg کمک قالب برای اطلاعات بیشتر در مورد سبک های از پیش بسته بندی شده و مشخص کردن قالب های سفارشی.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-f، --دنبال کردن
تاریخچه تغییرات مجموعه یا تاریخچه فایل را در بین کپی ها و تغییر نام ها دنبال کنید

--پیگیری-اول
فقط اولین والد ادغام تغییرات را دنبال کنید (منسوخ شده)

-د،--تاریخ
نمایش نسخه های مطابق با مشخصات تاریخ

-C ، -- کپی ها
نمایش فایل های کپی شده

-k،--کلمه کلیدی
جستجوی بدون حروف بزرگ برای یک متن داده شده انجام دهید

-r،-- برگشت
بازبینی یا تنظیم مجدد مشخص شده را نشان دهید

--حذف شده
شامل ویرایش هایی که در آن فایل ها حذف شده اند

-m، --only-ادغام می شود
نمایش فقط ادغام ها (منسوخ شده)

-u،--کاربر
تجدید نظرهای انجام شده توسط کاربر

--فقط شعبه
فقط تغییرات را در شاخه نامگذاری شده نشان دهید (منسوخ شده)

-ب،--شاخه
تغییرات را در شاخه نامگذاری شده نشان دهید

-پ،-- هرس کنید
ویرایش یا هیچ یک از اجداد آن را نمایش ندهید

-پ، -- پچ
نشان دادن پچ

-g، --git
از فرمت git extended diff استفاده کنید

-ل،--حد
محدود کردن تعداد تغییرات نمایش داده شده

-M، -----ادغام نمی شود
ادغام ها را نشان ندهید

--stat خلاصه تغییرات به سبک diffstat خروجی

-G، -- نمودار
بازبینی DAG را نشان دهید

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

نام مستعار: تاریخ

ظاهر
خروجی بازبینی فعلی یا داده شده مانیفست پروژه:

مانیفست hg [-r REV]

فهرستی از فایل‌های کنترل‌شده نسخه را برای ویرایش داده شده چاپ کنید. اگر بازنگری صورت نگیرد،
از اولین والد دایرکتوری کاری استفاده می شود، یا در صورت عدم وجود ویرایش، از نسخه تهی استفاده می شود
بررسی شد.

با -v، مجوزهای فایل چاپ، سیملینک و بیت های اجرایی. با --debug، فایل را چاپ کنید
هش های بازبینی

اگر گزینه --all مشخص شده باشد، لیست تمام فایل ها از تمام ویرایش ها چاپ می شود. این
شامل فایل های حذف شده و تغییر نام یافته است.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
ویرایش برای نمایش

--همه لیست فایل ها از تمام ویرایش ها

-T،--قالب
نمایش با الگو (تجربی)

ادغام کردن
ویرایش دیگری را در پوشه کاری ادغام کنید:

hg ادغام [-P] [[-r] REV]

فهرست کاری فعلی با تمام تغییرات ایجاد شده در ویرایش درخواستی به روز می شود
از آخرین تجدید نظر قبلی رایج.

فایل هایی که بین هر یک از والدین تغییر کرده اند برای commit بعدی و a تغییر یافته علامت گذاری می شوند
commit باید قبل از مجاز شدن به‌روزرسانی‌های بیشتر در مخزن انجام شود. در
ارتکاب بعدی دو والدین خواهد داشت.

--ابزار می توان برای تعیین ابزار ادغام مورد استفاده برای ادغام فایل ها استفاده کرد. آن را نادیده می گیرد
متغیر محیطی HGMERGE و فایل های پیکربندی شما. دیدن hg کمک ابزارهای ادغام برای
گزینه.

اگر هیچ ویرایشی مشخص نشده باشد، والد دایرکتوری کاری یک ویرایش سر است و
شاخه فعلی دقیقاً شامل یک سر دیگر است، سر دیگر به طور پیش فرض با ادغام شده است.
در غیر این صورت، باید یک بازبینی صریح برای ادغام با آن ارائه شود.

دیدن hg کمک تصمیم برای اطلاعات در مورد رسیدگی به تضاد فایل.

برای لغو یک ادغام غیرمتعهد، استفاده کنید hg به روز رسانی --تمیز . که یک کپی تمیز از
والد ادغام اصلی، تمام تغییرات را از دست می دهد.

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

گزینه های ارسال:

-f، --زور
مجبور به ادغام از جمله تغییرات برجسته (منسوخ شده)

-r،-- برگشت
تجدید نظر برای ادغام

-پ، --پیش نمایش
بررسی اصلاحات برای ادغام (هیچ ادغامی انجام نمی شود)

-t،--ابزار
ابزار ادغام را مشخص کنید

برونگرا
نمایش تغییراتی که در مقصد یافت نشد:

hg خروجی [-M] [-p] [-n] [-f] [-r REV]... [DEST]

نمایش تغییراتی که در مخزن مقصد مشخص شده یا فشار پیش‌فرض یافت نشده است
محل. اینها مجموعه تغییراتی هستند که در صورت درخواست فشار اعمال می شوند.

برای جزئیات بیشتر قالب‌های مقصد معتبر، به pull مراجعه کنید.

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

BM1 01234567890a اضافه شد
BM2 حذف شد
BM3 234567890abc پیشرفته
BM4 34567890abcd واگرا شد
BM5 4567890abcde تغییر کرد

اقدامی که هنگام فشار دادن انجام می شود به وضعیت هر نشانک بستگی دارد:

اضافه

فشار دادن با -B آن را ایجاد خواهد کرد

حذف

فشار دادن با -B آن را حذف خواهد کرد

پیشرفته

فشار آن را به روز می کند

واگرا

فشار دادن با -B آن را به روز خواهد کرد

تغییر

فشار دادن با -B آن را به روز خواهد کرد

از نقطه نظر رفتار هل دادن، نشانک‌ها فقط در کنترل از راه دور وجود دارند
مخزن به عنوان حذف، حتی اگر در واقع از راه دور اضافه شده باشد.

اگر تغییرات خروجی وجود داشته باشد 0، در غیر این صورت 1 را برمی گرداند.

گزینه های ارسال:

-f، --زور
اجرا کنید حتی زمانی که مقصد نامرتبط است

-r،-- برگشت
مجموعه تغییراتی که قرار است در مقصد گنجانده شود

-n، --جدیدترین-اول
نمایش جدیدترین رکورد ابتدا

-ب، -- نشانک ها
مقایسه بوک مارک ها

-ب،--شاخه
شاخه خاصی که می خواهید فشار دهید

-پ، -- پچ
نشان دادن پچ

-g، --git
از فرمت git extended diff استفاده کنید

-ل،--حد
محدود کردن تعداد تغییرات نمایش داده شده

-M، -----ادغام نمی شود
ادغام ها را نشان ندهید

--stat خلاصه تغییرات به سبک diffstat خروجی

-G، -- نمودار
بازبینی DAG را نشان دهید

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

-S، -- subrepos
بازگشت به مخازن فرعی

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

نام مستعار: خارج

پدر و مادر
نشان دادن والدین فهرست کاری یا ویرایش (منسوخ شده):

والدین hg [-r REV] [FILE]

نسخه های والد فهرست کاری را چاپ کنید. اگر بازبینی از طریق -r/--rev انجام شود،
والد آن ویرایش چاپ خواهد شد. اگر آرگومان فایل داده شود، بازبینی در
که فایل آخرین بار تغییر کرده است (قبل از ویرایش دایرکتوری کاری یا آرگومان به
--rev در صورت داده شدن) چاپ می شود.

این دستور معادل است با:

hg log -r "p1()+p2()" یا
hg log -r "p1(REV)+p2(REV)" یا
hg log -r "max(::p1() and file(FILE))+max(::p2() and file(FILE))" یا
hg log -r "max(::p1(REV) and file(FILE))+max(::p2(REV) and file(FILE))"

دیدن hg خلاصه و hg کمک دوباره تنظیم می کند برای اطلاعات مرتبط

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
نمایش والدین بازبینی مشخص شده

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

راه ها
نمایش نام مستعار برای مخازن راه دور:

مسیرهای hg [NAME]

نمایش تعریف نام مسیر نمادین NAME. اگر نامی داده نشده است، تعریف همه را نشان دهید
نام های موجود

گزینه -q/--quiet تمام خروجی ها را هنگام جستجوی NAME سرکوب می کند و فقط مسیر را نشان می دهد.
نام ها هنگام فهرست کردن همه تعاریف.

نام مسیرها در بخش [paths] فایل پیکربندی شما تعریف شده است
/etc/mercurial/hgrc. اگر در داخل یک مخزن اجرا شود، .hg/hgrc نیز استفاده می شود

نام مسیرها به طور پیش فرض و پیش فرض فشار معنای خاصی دارند هنگام انجام فشار یا
عملیات کشش، در صورتی که هیچ مکانی روی آن مشخص نشده باشد، به عنوان بازگشتی استفاده می شوند
خط فرمان. چه زمانی پیش فرض فشار تنظیم شده است، برای فشار و استفاده خواهد شد به طور پیش فرض استفاده خواهد شد
برای کشش؛ در غیر این صورت به طور پیش فرض به عنوان بازگشتی برای هر دو استفاده می شود. هنگام شبیه سازی یک مخزن،
منبع کلون به صورت نوشته شده است به طور پیش فرض in .hg/hgrc.

توجه داشته باشید به طور پیش فرض و پیش فرض فشار برای همه ورودی ها اعمال شود (مثلا hg وارد شونده) و خروجی
(به عنوان مثال hg برونگرا, hg پست الکترونیک و hg بسته) عملیات

دیدن hg کمک URL ها برای اطلاعات بیشتر.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-T،--قالب
نمایش با الگو (تجربی)

فاز
تنظیم یا نمایش نام فاز فعلی:

فاز hg [-p|-d|-s] [-f] [-r] [REV...]

بدون آرگومان، نام فاز ویرایش(های) فعلی را نشان دهید.

با یکی از -p/--public، -d/--draft یا -s/--secret، مقدار فاز را تغییر دهید.
بازنگری های مشخص شده

مگر اینکه -f/--force مشخص شده باشد، hg فاز تغییرات را از یک فاز پایین تر به یک منتقل نمی کند
فاز بالاتر مراحل به شرح زیر مرتب می شوند:

عمومی < پیش نویس < راز

در صورت موفقیت، 0 را برمی‌گرداند، اگر برخی از مراحل را نتوان تغییر داد، 1 را برمی‌گرداند.

(برای اطلاعات بیشتر در مورد مفهوم فازها، رجوع کنید به hg کمک فاز.)

گزینه های ارسال:

-پ، --عمومی
مرحله تغییرات را روی عمومی تنظیم کنید

-د، --پیش نویس
مرحله تغییرات را به پیش نویس تنظیم کنید

-s ، --راز
فاز تغییرات را به مخفی تنظیم کنید

-f، --زور
اجازه می دهد تا مرز به عقب حرکت کند

-r،-- برگشت
بازبینی هدف

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

کشیدن
تغییرات را از منبع مشخص شده بکشید:

hg pull [-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [منبع]

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

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

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

اگر SOURCE حذف شود، مسیر "پیش فرض" استفاده خواهد شد. دیدن hg کمک URL ها برای اطلاعات بیشتر
اطلاعات.

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

گزینه های ارسال:

-u، --به روز رسانی
در صورت اعمال تغییرات به سر شاخه جدید به روز رسانی کنید

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

-r،-- برگشت
یک مجموعه تغییرات از راه دور که قرار است اضافه شود

-ب،-- نشانک
نشانک برای کشیدن

-ب،--شاخه
شاخه خاصی که دوست دارید بکشید

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

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

فشار
فشار دادن تغییرات به مقصد مشخص شده:

فشار hg [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]

تغییرات را از مخزن محلی به مقصد مشخص شده فشار دهید.

این عملیات برای کشیدن متقارن است: با کشش در مقصد یکسان است
مخزن از مخزن فعلی

به‌طور پیش‌فرض، فشار اجازه ایجاد هدهای جدید در مقصد را نمی‌دهد، زیرا چندگانه است
هدها مشخص نمی کند که از کدام سر استفاده شود. در این شرایط توصیه می شود
قبل از فشار دادن بکشید و ادغام کنید.

اگر می‌خواهید به فشار اجازه دهید تا شاخه‌ای با نام جدید ایجاد کنید، از --new-branch استفاده کنید
حاضر در مقصد این به شما امکان می دهد فقط یک شاخه جدید بدون اجبار ایجاد کنید
تغییرات دیگر

توجه بیشتر باید با گزینه -f/--force، که همه موارد جدید را فشار می دهد، دقت بیشتری کرد
سرها در همه شاخه ها، عملی که تقریباً همیشه باعث سردرگمی برای آنها می شود
همکاران

اگر -r/--rev استفاده شود، ویرایش مشخص شده و تمام اجداد آن به سمت
مخزن از راه دور

اگر نشانک -B/-- استفاده شود، بازبینی نشانک شده مشخص شده، اجداد آن و
نشانک به مخزن راه دور منتقل می شود.

لطفا hg کمک URL ها برای جزئیات مهم در مورد ssh:// URL ها اگر DESTINATION است
حذف، یک مسیر پیش فرض استفاده خواهد شد.

اگر فشار موفقیت آمیز بود، 0 را برمی‌گرداند، اگر فشاری وجود نداشته باشد، 1 را برمی‌گرداند.

گزینه های ارسال:

-f، --زور
فشار زور

-r،-- برگشت
مجموعه تغییراتی که قرار است در مقصد گنجانده شود

-ب،-- نشانک
نشانک برای فشار دادن

-ب،--شاخه
شاخه خاصی که می خواهید فشار دهید

-- شعبه جدید
اجازه هل دادن یک شاخه جدید را می دهد

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

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

بهبود پیدا کن
بازگرداندن تراکنش قطع شده:

جیوه بهبود می یابند

پس از یک کامیت یا کشش قطع شده، بازیابی کنید.

این دستور سعی می کند وضعیت مخزن را پس از یک عملیات قطع شده برطرف کند. باید
فقط زمانی لازم است که مرکوریال آن را پیشنهاد کند.

در صورت موفقیت آمیز بودن 0، اگر چیزی برای بازیابی یا تأیید نشد، 1 را برمی گرداند.

برداشتن
فایل های مشخص شده را در commit بعدی حذف کنید:

hg remove [OPTION]... FILE...

فایل های مشخص شده را برای حذف از شاخه فعلی برنامه ریزی کنید.

این دستور فایل هایی را که باید در commit بعدی حذف شوند، برنامه ریزی می کند. برای لغو حذف
قبل از آن، ببینید hg برگرداندن. برای واگرد فایل های اضافه شده، رجوع کنید hg فراموش کردن.

-A/--after می تواند فقط برای حذف فایل هایی که قبلاً حذف شده اند استفاده شود، -f/--force می تواند
برای حذف اجباری استفاده می شود و -Af می تواند برای حذف فایل ها از ویرایش بعدی استفاده شود
بدون حذف آنها از پوشه کاری.

جدول زیر رفتار حذف را برای حالت های مختلف فایل (ستون ها) و
ترکیب گزینه ها (ردیف ها). حالت های فایل اضافه شده [A]، Clean [C]، Modified [M] و
گم شده [!] (همانطور که توسط hg وضعیت). اقدامات هشدار، حذف (از شاخه) و
حذف (از دیسک):

┌──────────┬───┬────┬-
│انتخاب / حالت │ A │ C │ M │ ! │
├──────────┼───┼────┼──
│ هیچ │ W │ RD │ W │ R │
├──────────┼───┼────┼──
│-f │ R │ RD │ RD │ R │
├──────────┼───┼────┼──
│-A │ W │ W │ W │ R │
├──────────┼───┼────┼──
│-Af │ R │ R │ R │ R │
└──────────┴───┴────┴

توجه داشته باشید hg برداشتن هرگز فایل هایی را در حالت اضافه شده [A] از فهرست کار حذف نمی کند، نه
حتی اگر --زور مشخص شده است.

در صورت موفقیت 0، در صورت مشاهده هر گونه هشدار، 1 را برمی گرداند.

گزینه های ارسال:

-آ، --بعد از
رکورد حذف برای فایل های از دست رفته

-f، --زور
حذف (و حذف) فایل حتی اگر اضافه یا اصلاح شده باشد

-S، -- subrepos
بازگشت به مخازن فرعی

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

نام مستعار: rm

تغییر نام دهید
تغییر نام فایل ها؛ معادل کپی + حذف:

hg تغییر نام [OPTION]... منبع... DEST

علامت گذاری dest به عنوان کپی از منابع. علامت گذاری منابع برای حذف اگر dest یک دایرکتوری است، کپی کنید
در آن دایرکتوری قرار می گیرند. اگر dest یک فایل باشد، فقط یک منبع می تواند وجود داشته باشد.

به طور پیش فرض، این دستور محتویات فایل ها را همانطور که در کار وجود دارد کپی می کند
فهرست راهنما. اگر با -A/--after فراخوانی شود، عملیات ضبط می شود، اما هیچ کپی برداری انجام نمی شود
انجام.

این دستور در commit بعدی اعمال می شود. برای لغو نام قبل از آن، ببینید hg برگرداندن.

در صورت موفقیت 0، در صورت بروز خطا، 1 را برمی گرداند.

گزینه های ارسال:

-آ، --بعد از
تغییر نامی را که قبلاً رخ داده است را ثبت کنید

-f، --زور
کپی اجباری روی یک فایل مدیریت شده موجود

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-n، -- خشک اجرا شود
اقدامات را انجام ندهید، فقط خروجی را چاپ کنید

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

نام مستعار: move mv

تصمیم
ادغام ها را دوباره انجام دهید یا وضعیت ادغام فایل ها را تنظیم/مشاهده کنید:

حل و فصل hg [OPTION]... [FILE]...

ادغام با درگیری های حل نشده اغلب نتیجه ادغام غیر تعاملی با استفاده از
داخلی: ادغام تنظیمات پیکربندی یا یک ابزار ادغام خط فرمان مانند تفاوت 3. عزم
دستور برای مدیریت فایل های درگیر در یک ادغام، پس از آن استفاده می شود hg ادغام کردن اجرا شده است و
قبل از hg مرتکب شدن اجرا می شود (یعنی دایرکتوری کاری باید دو والد داشته باشد). دیدن hg کمک
ابزارهای ادغام برای اطلاعات در مورد پیکربندی ابزارهای ادغام.

دستور Reso را می توان به روش های زیر استفاده کرد:

· hg تصمیم [--ابزار ابزار] فایل...: تلاش برای ادغام مجدد فایل های مشخص شده، دور انداختن
هرگونه تلاش قبلی برای ادغام ادغام مجدد برای فایل هایی که قبلاً به عنوان علامت گذاری شده اند انجام نمی شود
حل شد. استفاده کنید --همه/-a برای انتخاب همه فایل های حل نشده --ابزار را می توان برای مشخص کردن استفاده کرد
ابزار ادغام مورد استفاده برای فایل های داده شده. این متغیر محیطی HGMERGE را لغو می کند و
فایل های پیکربندی شما محتویات فایل قبلی با یک ذخیره می شود منشاء پسوند.

· hg تصمیم -m [فایل]: یک فایل را به عنوان حل شده علامت گذاری کنید (به عنوان مثال پس از داشتن دستی
فایل ها را اصلاح کنید). پیش فرض این است که تمام فایل های حل نشده را علامت گذاری کنید.

· hg تصمیم -u [فایل]...: یک فایل را به عنوان حل نشده علامت گذاری کنید. به طور پیش فرض علامت گذاری همه حل شده است
فایل های.

· hg تصمیم -l: لیستی از فایل هایی که دارای تداخل هستند یا هنوز دارند. در لیست چاپی، U =
حل نشده و R = حل شد

توجه داشته باشید Mercurial به شما اجازه نمی دهد فایل هایی با تضادهای ادغام حل نشده را ارسال کنید. شما باید
استفاده کنید hg تصمیم -m ... قبل از اینکه بتوانید پس از ادغام متناقض commit کنید.

در صورت موفقیت، 0 را برمی‌گرداند، در صورت عدم موفقیت فایل‌ها، 1.

گزینه های ارسال:

-آ، --همه
تمام فایل های حل نشده را انتخاب کنید

-ل، -- لیست
لیست وضعیت فایل هایی که نیاز به ادغام دارند

-m، --علامت
علامت گذاری فایل ها به عنوان حل شده

-u، -- علامت گذاری را بردارید
علامت گذاری فایل ها به عنوان حل نشده

-n، --هیچ وضعیت
پنهان کردن پیشوند وضعیت

-t،--ابزار
ابزار ادغام را مشخص کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-T،--قالب
نمایش با الگو (تجربی)

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

برگرداندن
بازگرداندن فایل ها به حالت پرداخت آنها:

hg revert [OPTION]... [-r REV] [NAME]...

توجه برای بررسی نسخه های قبلی، باید از آن استفاده کنید hg به روز رسانی REV. برای لغو یک
ادغام غیرمتعهد (و از دست دادن تغییرات خود)، استفاده کنید hg به روز رسانی --تمیز ..

بدون بازبینی مشخص شده، فایل ها یا دایرکتوری های مشخص شده را به محتویات آنها برگردانید
در والد دایرکتوری کاری وجود داشت. این محتویات فایل ها را به یک بازیابی می کند
حالت تغییر نیافته و برنامه‌ریزی نشده اضافه، حذف، کپی و تغییر نام می‌دهد. اگر کار می کند
دایرکتوری دارای دو والد است، شما باید به صراحت یک ویرایش را مشخص کنید.

با استفاده از گزینه های -r/--rev یا -d/--date، فایل ها یا دایرکتوری های داده شده را به آنها برگردانید.
ایالات به عنوان یک تجدید نظر خاص. زیرا revert دایرکتوری کاری را تغییر نمی دهد
والدین، این باعث می شود که این فایل ها اصلاح شده به نظر برسند. این می تواند برای "عقب نشینی" مفید باشد
برخی یا همه تغییرات قبلی دیدن hg عقب نشینی برای یک روش مرتبط

فایل های اصلاح شده قبل از بازگرداندن با پسوند .orig ذخیره می شوند. برای غیرفعال کردن این نسخه های پشتیبان،
از --no-backup استفاده کنید.

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

دیدن hg کمک عقب نشینی برای راهی برای معکوس کردن اثر تغییرات قبلی.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-آ، --همه
در صورت عدم ارائه آرگومان، همه تغییرات را برگردانید

-د،--تاریخ
مهم ترین تاریخ تطبیق تجدید نظر

-r،-- برگشت
به بازبینی مشخص شده برگردید

-C ، --بدون پشتیبان
کپی های پشتیبان فایل ها را ذخیره نکنید

-من، --در ارتباط بودن
به صورت تعاملی تغییرات را انتخاب کنید (EXPERIMENTAL)

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-n، -- خشک اجرا شود
اقدامات را انجام ندهید، فقط خروجی را چاپ کنید

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

عقبگرد
برگرداندن آخرین تراکنش (خطرناک) (منسوخ شده):

hg برگشت

خواهش می کنم استفاده کنید hg مرتکب شدن --اصلاح به جای بازگشت به عقب برای تصحیح اشتباهات در آخرین کامیت.

این دستور باید با دقت استفاده شود. تنها یک سطح بازگشت وجود دارد و وجود دارد
هیچ راهی برای لغو بازگشت وجود ندارد. همچنین وضعیت بد را در زمان آخرین بازیابی می کند
تراکنش، از دست دادن هرگونه تغییر وضعیتی از آن زمان. این دستور تغییری در آن ایجاد نمی کند
دایرکتوری کار

تراکنش ها برای کپسوله کردن اثرات تمام دستوراتی که جدید ایجاد می کنند استفاده می شود
تغییر می دهد یا تغییرات موجود را در یک مخزن منتشر می کند.

به عنوان مثال، دستورات زیر تراکنشی هستند و می توان اثرات آنها را رول کرد
بازگشت:

· مرتکب شدن

· وارد كردن

· کشیدن

· فشار (با این مخزن به عنوان مقصد)

· باز کردن

برای جلوگیری از از دست رفتن دائمی داده‌ها، در صورتی که یک تراکنش commit انجام شود، بازگشت به عقب از بازگرداندن آن خودداری می‌کند
بررسی نشده است برای نادیده گرفتن این حفاظت از --force استفاده کنید.

این دستور برای استفاده در مخازن عمومی در نظر گرفته نشده است. هنگامی که تغییرات برای قابل مشاهده است
توسط سایر کاربران، بازگرداندن یک تراکنش به صورت محلی بی اثر است (کس دیگری ممکن است
قبلاً تغییرات را انجام داده اند). علاوه بر این، یک مسابقه با خوانندگان ممکن است
مخزن؛ به عنوان مثال، یک برداشت در حال انجام از مخزن ممکن است شکست بخورد اگر عقبگرد باشد
انجام.

در صورت موفقیت 0، در صورت عدم دسترسی به داده های برگشتی، 1 را برمی گرداند.

گزینه های ارسال:

-n، -- خشک اجرا شود
اقدامات را انجام ندهید، فقط خروجی را چاپ کنید

-f، --زور
اقدامات ایمنی را نادیده بگیرید

ریشه
ریشه (بالای) دایرکتوری فعلی را چاپ کنید:

ریشه جیوه

دایرکتوری ریشه مخزن فعلی را چاپ کنید.

در صورت موفقیت 0 برمی گرداند.

خدمت
راه اندازی وب سرور مستقل:

سرو hg [OPTION]...

یک مرورگر مخزن HTTP محلی راه اندازی کنید و سرور را بکشید. می توانید از این برای اشتراک گذاری موقت استفاده کنید
و مرور مخازن توصیه می شود از یک وب سرور واقعی برای سرویس دهی استفاده کنید
مخزن برای مدت زمان طولانی تر

لطفا توجه داشته باشید که سرور کنترل دسترسی را اجرا نمی کند. این بدان معنی است که، توسط
به طور پیش فرض، هر کسی می تواند از سرور بخواند و هیچ کس نمی تواند به طور پیش فرض روی آن بنویسد. تنظیم کنید
web.allow_push گزینه ای برای * به همه اجازه می دهد تا به سرور فشار بیاورند. شما باید از یک واقعی استفاده کنید
سرور وب اگر نیاز به احراز هویت کاربران دارید.

به طور پیش فرض، سرور به stdout و خطاها به stderr دسترسی دارد. استفاده کنید
گزینه های -A/--accesslog و -E/--errorlog برای ورود به فایل ها.

برای اینکه سرور یک شماره پورت رایگان برای گوش دادن انتخاب کند، شماره پورت 0 را مشخص کنید. که در
در این صورت سرور شماره پورتی را که استفاده می کند چاپ می کند.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-آ،-- Accesslog
نام فایل گزارش دسترسی برای نوشتن

-د، --اهریمن، دیو
سرور را در پس زمینه اجرا کنید

--daemon-pipefds
به صورت داخلی توسط حالت دیمون استفاده می شود

-E،--errorlog
نام فایل گزارش خطا برای نوشتن

-پ،--بندر
پورت برای گوش دادن (پیش‌فرض: 8000)

-آ،--نشانی
آدرس برای گوش دادن (پیش‌فرض: همه رابط‌ها)

-- پیشوند
مسیر پیشوند برای ارائه از (پیش‌فرض: ریشه سرور)

-n،--نام
نام برای نمایش در صفحات وب (پیش‌فرض: فهرست کار)

--web-conf
نام فایل پیکربندی hgweb (به "hg help hgweb" مراجعه کنید)

--webdir-conf
نام فایل پیکربندی hgweb (منسوخ شده)

--pid-file
نام فایل برای نوشتن شناسه فرآیند

--stdio
برای مشتریان از راه دور

--cmdserver
برای مشتریان از راه دور

-t،--قالب ها
قالب های وب برای استفاده

--سبک
سبک قالب برای استفاده

-6، --ipv6
علاوه بر IPv6 از IPv4 استفاده کنید

--گواهینامه
فایل گواهی SSL

وضعیت
نمایش فایل های تغییر یافته در دایرکتوری کاری:

وضعیت hg [گزینه]... [فایل]...

نمایش وضعیت فایل ها در مخزن. اگر نام داده شود، فقط فایل هایی که مطابقت دارند هستند
نشان داده شده. فایل‌هایی که پاک هستند یا نادیده گرفته می‌شوند یا منبع عملیات کپی/انتقال هستند، چنین نیستند
لیست شده مگر اینکه -c/--clean، -i/--نادیده گرفته شود، -C/--کپی یا -A/--همه داده شده باشد. مگر اینکه گزینه ها
توصیف شده با "فقط نمایش ..." داده شده است، گزینه های -mardu استفاده می شود.

گزینه -q/--quiet فایل های ردیابی نشده (ناشناخته و نادیده گرفته شده) را پنهان می کند مگر اینکه صریحاً درخواست شده باشد
با -u/--ناشناخته یا -i/-- نادیده گرفته شده است.

توجه داشته باشید hg وضعیت اگر مجوزها تغییر کرده باشند یا ادغام شده باشند، ممکن است با تفاوت مخالف به نظر برسد
اتفاق افتاده. قالب استاندارد diff تغییرات مجوز و تفاوت را گزارش نمی کند
فقط تغییرات مربوط به یک والد ادغام شده را گزارش می کند.

اگر یک ویرایش داده شود، از آن به عنوان تجدید نظر پایه استفاده می شود. اگر دو تجدید نظر داده شود،
تفاوت بین آنها نشان داده شده است. از گزینه --change می توان به عنوان میانبر نیز استفاده کرد
برای فهرست کردن فایل های تغییر یافته یک ویرایش از والد اول آن.

کدهای مورد استفاده برای نمایش وضعیت فایل ها عبارتند از:

M = اصلاح شده
A = اضافه شده است
R = حذف شده است
C = تمیز
! = گم شده (با دستور غیر hg حذف شد، اما همچنان ردیابی می شود)
? = ردیابی نشد
من = نادیده گرفته شدم
= مبدا فایل قبلی (با --کپی)

مثال:

· نمایش تغییرات در دایرکتوری کاری نسبت به یک تغییرات:

وضعیت hg --rev 9353

· نمایش تغییرات در دایرکتوری کاری نسبت به دایرکتوری فعلی (نگاه کنید به hg کمک
الگوهای برای اطلاعات بیشتر):

وضعیت hg پاسخ:

· نمایش تمام تغییرات از جمله کپی ها در مجموعه تغییرات موجود:

وضعیت hg -- کپی -- تغییر 9353

یک لیست جدا شده NUL از فایل های اضافه شده، مناسب برای xargs دریافت کنید:

وضعیت hg -an0

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-آ، --همه
نمایش وضعیت همه فایل ها

-m، --اصلاح شده
فقط فایل های اصلاح شده را نشان می دهد

-آ، --اضافه
فقط فایل های اضافه شده را نشان می دهد

-r، --حذف شده
نمایش فقط فایل های حذف شده

-د، --حذف شده
فقط فایل های حذف شده (اما ردیابی شده) را نشان می دهد

-c، --تمیز
فقط فایل ها را بدون تغییر نمایش دهید

-u، --ناشناس
فقط فایل های ناشناخته (ردیابی نشده) را نشان می دهد

-من، -- نادیده گرفته شد
فقط فایل های نادیده گرفته شده را نشان می دهد

-n، --هیچ وضعیت
پنهان کردن پیشوند وضعیت

-C ، -- کپی ها
نشان دادن منبع فایل های کپی شده

-0، -- چاپ 0
پایان نام فایل ها با NUL، برای استفاده با xargs

-- برگشت
تفاوت را با تجدید نظر نشان می دهد

--تغییر دادن
فایل های تغییر یافته یک ویرایش را لیست کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-S، -- subrepos
بازگشت به مخازن فرعی

-T،--قالب
نمایش با الگو (تجربی)

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

نام مستعار: st

خلاصه
حالت فهرست کار را خلاصه کنید:

خلاصه hg [--Remote]

این یک خلاصه مختصر از وضعیت دایرکتوری کاری، از جمله والدین، شعبه،
وضعیت، مرحله و به روز رسانی های موجود را انجام دهید.

با گزینه --remote، مسیرهای پیش فرض ورودی و خروجی را بررسی می کند
تغییر می کند. این می تواند زمان بر باشد.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

--از راه دور
فشار و کشیدن را بررسی کنید

نام مستعار: مجموع

برچسب
یک یا چند تگ برای ویرایش فعلی یا داده شده اضافه کنید:

برچسب hg [-f] [-l] [-m TEXT] [-d DATE] [-u USER] [-r REV] NAME...

با استفاده از یک ویرایش خاص نام ببرید .

برچسب‌ها برای نام‌گذاری ویرایش‌های خاص مخزن استفاده می‌شوند و برای آن بسیار مفید هستند
نسخه های مختلف را مقایسه کنید تا به نسخه های مهم قبلی برگردید یا شاخه را علامت بزنید
امتیاز به عنوان نسخه منتشر شده و غیره. تغییر یک برچسب موجود معمولاً مجاز نیست. استفاده از -f/--force
نادیده گرفتن.

اگر بازبینی انجام نشود، از والد دایرکتوری کاری استفاده می شود.

برای تسهیل کنترل نسخه، توزیع و ادغام برچسب ها، آنها به عنوان یک ذخیره می شوند
فایلی با نام ".hgtags" که مشابه سایر فایل های پروژه مدیریت می شود و می تواند
در صورت لزوم به صورت دستی ویرایش شود. این همچنین به این معنی است که تگ کردن یک commit جدید ایجاد می کند. پرونده
".hg/localtags" برای برچسب های محلی استفاده می شود (در بین مخازن به اشتراک گذاشته نمی شود).

تگ commit معمولا در راس یک شعبه انجام می شود. اگر والد کار
دایرکتوری یک سر شاخه نیست، hg برچسب سقط می کند از -f/--force برای وادار کردن برچسب متعهد به آن استفاده کنید
بر اساس یک مجموعه تغییرات بدون سر باشد.

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

از آنجایی که نام تگ ها در هنگام جستجوی تجدید نظر، با استفاده از یک موجود، بر نام شاخه ها اولویت دارند
نام شعبه به عنوان نام تگ ممنوع است.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-f، --زور
برچسب نیرو

-ل، -- محلی
تگ را محلی کنید

-r،-- برگشت
تجدید نظر در برچسب

--برداشتن
یک برچسب را حذف کنید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

برچسب ها
برچسب های مخزن لیست:

تگ های hg

این هم تگ های معمولی و هم محلی را فهرست می کند. هنگامی که سوئیچ -v/--verbose استفاده می شود، یک سوم
ستون "local" برای برچسب های محلی چاپ می شود. هنگامی که سوئیچ -q/--سکوت استفاده می شود، فقط از
نام برچسب چاپ شده است.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-T،--قالب
نمایش با الگو (تجربی)

نوک
نمایش بازبینی نکته (منسوخ شده):

نکته hg [-p] [-g]

بازنگری نوک (معمولاً فقط نوک نامیده می شود) مجموعه تغییراتی است که اخیراً به آن اضافه شده است
مخزن (و بنابراین آخرین هد تغییر یافته).

اگر به تازگی یک commit انجام داده اید، آن commit نکته اصلی خواهد بود. اگر تازه کشیده اید
از یک مخزن دیگر تغییر می کند، نوک آن مخزن به نوک فعلی تبدیل می شود. در
تگ "tip" خاص است و نمی توان آن را تغییر نام داد یا به مجموعه تغییرات دیگری اختصاص داد.

این دستور منسوخ شده است، لطفا استفاده کنید hg سر به جای آن.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-پ، -- پچ
نشان دادن پچ

-g، --git
از فرمت git extended diff استفاده کنید

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

جدا کردن
اعمال یک یا چند فایل تغییر گروه:

hg unbundle [-u] FILE...

یک یا چند فایل تغییر گروه فشرده تولید شده توسط دستور bundle را اعمال کنید.

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

گزینه های ارسال:

-u، --به روز رسانی
در صورت جداسازی مجموعه‌ها، به سر شاخه جدید به‌روزرسانی کنید

به روز رسانی
به روز رسانی فهرست کار (یا تغییر نسخه ها):

به‌روزرسانی hg [-c] [-C] [-d DATE] [[-r] REV]

دایرکتوری کاری مخزن را به تغییرات مشخص شده به روز کنید. اگر هیچ تغییری وجود ندارد
مشخص شده، به نوک شاخه نامگذاری شده فعلی به روز رسانی کنید و نشانک فعال را جابجا کنید (نگاه کنید به
hg کمک بوک مارک ها).

به‌روزرسانی، ویرایش والد فهرست کاری را روی مجموعه تغییرات مشخص شده تنظیم می‌کند (نگاه کنید به hg
کمک پدر و مادر).

اگر مجموعه تغییرات از نسل یا اجداد والد دایرکتوری کاری نباشد،
به روز رسانی لغو شده است. با گزینه -c/--check، دایرکتوری کاری بررسی می شود
تغییرات غیرمتعهد؛ اگر هیچ کدام یافت نشد، دایرکتوری کاری به قسمت مشخص شده به روز می شود
تغییرات مجموعه

زمانی که دایرکتوری کاری حاوی تغییرات غیرمتعهد باشد، قوانین زیر اعمال می شود:

1. اگر نه -c/--check و نه -C/--clean مشخص نشده باشد، و اگر مجموعه تغییرات درخواستی یک
اجداد یا نوادگان والد دایرکتوری کاری، تغییرات غیرمتعهد هستند
در مجموعه تغییرات درخواستی ادغام می شود و نتیجه ادغام شده بدون تعهد باقی می ماند. اگر
تغییرات درخواستی اجداد یا نوادگان نیست (یعنی روی دیگری است
شعبه)، به روز رسانی لغو می شود و تغییرات غیرمتعهد حفظ می شوند.

2. با گزینه -c/--check، آپدیت لغو می شود و تغییرات غیرمتعهد انجام می شود.
حفظ شده

3. با گزینه -C/--clean، تغییرات غیرمتعهد حذف شده و دایرکتوری کار می شود
به مجموعه تغییرات درخواستی به روز می شود.

برای لغو یک ادغام غیرمتعهد (و از دست دادن تغییرات خود)، استفاده کنید hg به روز رسانی --تمیز ..

از null به عنوان مجموعه تغییرات برای حذف پوشه کاری استفاده کنید (مانند hg کلون کردن -U).

اگر می‌خواهید فقط یک فایل را به نسخه قدیمی‌تر برگردانید، از آن استفاده کنید hg برگرداندن [-r REV] نام.

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

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

گزینه های ارسال:

-C ، --تمیز
حذف تغییرات غیرمتعهد (بدون پشتیبان)

-c، --بررسی
در صورت عدم وجود تغییرات غیرمتعهد در شعب به روز رسانی کنید

-د،--تاریخ
مهم ترین تاریخ تطبیق تجدید نظر

-r،-- برگشت
تجدید نظر

-t،--ابزار
ابزار ادغام را مشخص کنید

نام مستعار: up checkout co

بررسی
یکپارچگی مخزن را تأیید کنید:

hg تایید کنید

یکپارچگی مخزن فعلی را بررسی کنید.

این یک بررسی گسترده ای از یکپارچگی مخزن انجام می دهد و هش ها را تأیید می کند
و چک جمع های هر ورودی در تغییرات، مانیفست، و فایل های ردیابی شده، و همچنین
یکپارچگی پیوندهای عرضی و شاخص های آنها.

لطفاً برای اطلاعات بیشتر در مورد https://mercurial-scm.org/wiki/RepositoryCorruption مراجعه کنید
بهبودی از فساد مخزن

در صورت موفقیت 0، در صورت بروز خطا، 1 را برمی گرداند.

نسخه
نسخه خروجی و اطلاعات حق چاپ:

نسخه hg

نسخه خروجی و اطلاعات حق چاپ

تاریخ فرمها

برخی از دستورات به کاربر اجازه می دهد تاریخ را مشخص کند، به عنوان مثال:

· backout, commit, import, tag: تاریخ commit را مشخص کنید.

· ورود، برگرداندن، به روز رسانی: ویرایش(های) را بر اساس تاریخ انتخاب کنید.

بسیاری از قالب‌های تاریخ معتبر هستند. در اینجا چند نمونه آورده شده است:

· بحباله نکاح در اوردن دسامبر 6 13:18:29 2006 (منطقه زمانی محلی فرض شده است)

· دسامبر 6 13:18 -0600 (سال فرض شده، جبران زمان ارائه شده است)

· دسامبر 6 13:18 ساعت محلی UTC تنظیم شده اند (UTC و GMT نام مستعار +0000 هستند)

· دسامبر 6 (نیمه شب)

· 13:18 (به فرض امروز)

· 3:39 (3:39 صبح فرض شده)

· 3: 39pm (15: 39)

· 2006-12-06 13:18:29 (فرمت ISO 8601)

· 2006-12-6 13:18

· 2006-12-6

· 12-6

· 12/6

· 12/6/6 (6 دسامبر 2006)

· امروز (نیمه شب)

· دیروز (نیمه شب)

· اکنون - همین الان

در نهایت، قالب داخلی Mercurial وجود دارد:

· 1165411109 0 (چهارشنبه 6 دسامبر 13:18:29 2006 UTC)

این قالب نمایش داخلی برای تاریخ ها است. عدد اول تعداد است
ثانیه از زمان (1970-01-01 00:00 UTC). دومی افست محلی است
منطقه زمانی، در ثانیه در غرب UTC (منفی اگر منطقه زمانی شرق UTC باشد).

دستور log محدوده تاریخ را نیز می پذیرد:

· <DATE - در تاریخ/زمان معین یا قبل از آن

· > DATE - در تاریخ/زمان معین یا بعد از آن

· تاریخ به تاریخ - محدوده تاریخ، شامل

· -روزها - در چند روز معین از امروز

متفاوت فرمها

فرمت پیش فرض Mercurial برای نمایش تغییرات بین دو نسخه از یک فایل است
سازگار با فرمت یکپارچه تفاوت گنو، که می تواند توسط پچ گنو و بسیاری از آنها استفاده شود
سایر ابزارهای استاندارد

در حالی که این قالب استاندارد اغلب کافی است، اطلاعات زیر را رمزگذاری نمی کند:

· وضعیت اجرایی و بیت های مجوز دیگر

· کپی یا تغییر نام اطلاعات

· تغییرات در فایل های باینری

· ایجاد یا حذف فایل های خالی

Mercurial همچنین از فرمت تفاوت توسعه یافته از git VCS پشتیبانی می کند که به این موارد می پردازد
محدودیت ها. فرمت git diff به دلیل چند ابزار گسترده به طور پیش فرض تولید نمی شود
هنوز این قالب را درک نمی کنم.

این بدان معناست که هنگام تولید تفاوت‌ها از مخزن مرکوریال (مثلاً با hg صادرات),
شما باید مراقب مواردی مانند کپی کردن فایل ها و تغییر نام یا سایر موارد ذکر شده باشید
در بالا، زیرا هنگام اعمال یک تفاوت استاندارد در یک مخزن دیگر، این اضافی است
اطلاعات از بین می رود عملیات داخلی مرکوریال (مانند فشار و کشیدن) تحت تأثیر قرار نمی گیرد
با این کار، زیرا آنها از یک فرمت باینری داخلی برای انتقال تغییرات استفاده می کنند.

برای اینکه Mercurial فرمت git extended diff را تولید کند، از گزینه --git موجود برای استفاده کنید
بسیاری از دستورات، یا "git = True" را در بخش [diff] فایل پیکربندی خود تنظیم کنید. شما
هنگام وارد کردن تفاوت ها در این فرمت یا استفاده از آنها در mq، نیازی به تنظیم این گزینه نیست
افزونه.

محیط زیست متغیرها

HG مسیری به فایل اجرایی «hg» که به‌طور خودکار هنگام اجرای قلاب‌ها، برنامه‌های افزودنی یا
ابزارهای خارجی اگر تنظیم نشده یا خالی باشد، این نام فایل اجرایی hg است اگر ثابت باشد،
یا یک فایل اجرایی به نام «hg» (با %PATHEXT% [پیش‌فرض COM/EXE/BAT/CMD]
برنامه های افزودنی در ویندوز) جستجو می شود.

HGEDITOR
این نام ویرایشگری است که باید هنگام commit کردن اجرا شود. EDITOR را ببینید.

(منسوخ شده، از فایل پیکربندی استفاده کنید)

HGENCODING
این تنظیمات محلی پیش‌فرض شناسایی‌شده توسط Mercurial را لغو می‌کند. این تنظیم است
برای تبدیل داده ها از جمله نام های کاربری، توضیحات مجموعه تغییرات، نام تگ ها و
شاخه ها. این تنظیم را می توان با گزینه --encoding خط فرمان لغو کرد.

HGENCODINGMODE
این رفتار مرکوریال را برای مدیریت کاراکترهای ناشناخته در هنگام رمزگذاری تنظیم می کند
ورودی کاربر. پیش فرض "سخت" است، که باعث می شود Mercurial در صورت عدم توانایی، سقط شود
نقشه یک شخصیت تنظیمات دیگر عبارتند از "replace" که جایگزین ناشناخته می شود
شخصیت ها، و "نادیده گرفتن"، که آنها را رها می کند. این تنظیم را می توان با
گزینه -encodingmode خط فرمان.

HGENCODING مبهم
این رفتار مرکوریال را برای مدیریت کاراکترهایی با عرض های «مبهم» تنظیم می کند
حروف لاتین برجسته با فونت های آسیای شرقی. به طور پیش فرض، مرکوریال فرض می کند
کاراکترهای مبهم باریک هستند، اگر چنین نویسه هایی این متغیر را روی "wide" تنظیم کنید
باعث ایجاد مشکل در قالب بندی

HGMERGE
یک فایل اجرایی برای حل و فصل تضادهای ادغام. برنامه اجرا خواهد شد
با سه آرگومان: فایل محلی، فایل راه دور، فایل اجداد.

(منسوخ شده، از فایل پیکربندی استفاده کنید)

HGRCPATH
فهرستی از فایل ها یا فهرست ها برای جستجوی فایل های پیکربندی. جداکننده اقلام است
":" در یونیکس، ";" روی ویندوز اگر HGRCPATH تنظیم نشده باشد، مسیر جستجوی پیش‌فرض پلتفرم
استفاده می شود. اگر خالی باشد، فقط hg/hgrc. از مخزن فعلی خوانده می شود.

برای هر عنصر در HGRCPATH:

· اگر دایرکتوری باشد، تمام فایل هایی که با .rc ختم می شوند اضافه می شوند

· در غیر این صورت خود فایل اضافه خواهد شد

HGPLAIN
وقتی تنظیم شود، این تنظیمات تنظیمات پیکربندی را که ممکن است مرکوریال را تغییر دهد غیرفعال می کند
خروجی پیش فرض این شامل کدگذاری، پیش فرض ها، حالت پرحرف، حالت اشکال زدایی، بی صدا می شود
حالت، ردیابی، و محلی سازی. این می تواند هنگام اسکریپت نویسی در مقابل مفید باشد
مرکوریال در مواجهه با پیکربندی کاربر موجود.

گزینه های معادل تنظیم شده از طریق پرچم های خط فرمان یا متغیرهای محیطی وجود ندارد
لغو شد.

HGPLAINEXCEPT
این فهرستی از ویژگی‌هایی است که با کاما از هم جدا شده‌اند تا زمانی که HGPLAIN فعال است حفظ شود.
در حال حاضر مقادیر زیر پشتیبانی می شوند:

نام مستعار

نام مستعار را حذف نکنید

i18n

حفظ بین المللی شدن

revsetalias

نام مستعار revset را حذف نکنید.

تنظیم HGPLAINEXCEPT روی هر چیزی (حتی یک رشته خالی) حالت ساده را فعال می کند.

HGUSER این رشته ای است که به عنوان نویسنده یک commit استفاده می شود. اگر تنظیم نشد، مقادیر موجود
به این ترتیب در نظر گرفته می شود:

· HGUSER (منسوخ شده)

· فایل های پیکربندی از HGRCPATH

· پست الکترونیک

· اعلان تعاملی

· LOGNAME (با @hostname پیوست)

(منسوخ شده، از فایل پیکربندی استفاده کنید)

EMAIL ممکن است به عنوان نویسنده یک تعهد استفاده شود. HGUSER را ببینید.

LOGNAME
ممکن است به عنوان نویسنده یک تعهد استفاده شود. HGUSER را ببینید.

دیداری این نام ویرایشگری است که باید هنگام commit کردن استفاده کنید. EDITOR را ببینید.

تدوین گاهی اوقات مرکوریال باید یک فایل متنی را در یک ویرایشگر باز کند تا کاربر آن را تغییر دهد.
به عنوان مثال هنگام نوشتن پیام های commit. ویرایشگری که استفاده می کند توسط آن تعیین می شود
به این ترتیب به متغیرهای محیطی HGEDITOR، VISUAL و EDITOR نگاه کنید.
اولین غیر خالی انتخاب می شود. اگر همه آنها خالی باشند، ویرایشگر به طور پیش فرض روی آن قرار می گیرد
«ویرایشگر معقول».

PYTHONPATH
این توسط پایتون برای یافتن ماژول های وارد شده استفاده می شود و ممکن است نیاز به تنظیم داشته باشد
اگر این مرکوریال در سراسر سیستم نصب نشده باشد، مناسب است.

استفاده كردن اضافی ویژگی‌ها

Mercurial این قابلیت را دارد که از طریق استفاده از افزونه ها ویژگی های جدیدی را اضافه کند. برنامه های افزودنی
ممکن است دستورات جدید اضافه کند، گزینه هایی را به دستورات موجود اضافه کند، رفتار پیش فرض را تغییر دهد
دستورات، یا پیاده سازی قلاب.

برای فعال کردن پسوند "foo"، یا با Mercurial یا در مسیر جستجوی Python ارسال شده است،
یک ورودی برای آن در فایل پیکربندی خود ایجاد کنید، مانند این:

[افزونه ها]
فو =

همچنین می توانید مسیر کامل یک پسوند را مشخص کنید:

[افزونه ها]
ویژگی من = ~/.hgext/myfeature.py

دیدن hg کمک پیکربندی برای اطلاعات بیشتر در مورد فایل های پیکربندی

برنامه های افزودنی به دلایل مختلف به طور پیش فرض بارگیری نمی شوند: آنها می توانند راه اندازی را افزایش دهند
در بالای سر؛ آنها ممکن است فقط برای استفاده پیشرفته در نظر گرفته شوند. آنها ممکن است به طور بالقوه ارائه دهند
توانایی های خطرناک (مانند اجازه دادن به شما برای تخریب یا تغییر تاریخ)؛ آنها ممکن است نباشند
آماده برای ساعات پربیننده؛ یا ممکن است برخی از رفتارهای معمول سهام مرکوریال را تغییر دهند. این است
بنابراین کاربر می تواند برنامه های افزودنی را در صورت نیاز فعال کند.

برای غیرفعال کردن صریح یک پسوند فعال در یک فایل پیکربندی با دامنه وسیع‌تر،
مسیر خود را با !:

[افزونه ها]
# غیرفعال کردن نوار افزونه موجود در /path/to/extension/bar.py
bar = !/path/to/extension/bar.py
# همینطور، اما هیچ مسیری برای توسعه باز ارائه نشد
باز = !

پسوندهای غیرفعال:

لیگ قهرمانان آسیا قلاب هایی برای کنترل دسترسی به مخزن

جعبه سیاه
رویدادهای مخزن را برای اشکال زدایی در یک جعبه سیاه ثبت کنید

بوگزیلا
قلاب هایی برای ادغام با ردیاب اشکال Bugzilla

سانسورچی پاک کردن محتوای فایل در یک ویرایش داده شده

تعویض دستور نمایش آمار تاریخچه مخزن

کلون باندل ها
بسته های از پیش تولید شده را برای کلون های بذر تبلیغ کنید

رنگ رنگی کردن خروجی از برخی دستورات

تبدیل
بازبینی‌ها را از مخازن VCS خارجی به Mercurial وارد کنید

خنده دار به طور خودکار خطوط جدید را در فایل های مخزن مدیریت کنید

extdiff
دستوری که به برنامه های خارجی اجازه می دهد تا ویرایش ها را با هم مقایسه کنند

واقعیت
احراز هویت http با فکتوتوم

gpg دستورات امضا و تأیید تغییرات

hgcia قلاب هایی برای ادغام با سرویس اعلان CIA.vc

hgk مخزن را به صورت گرافیکی مرور کنید

برجسته
برجسته سازی نحو برای hgweb (نیاز به Pygments)

هیستیدیت
ویرایش تعاملی تاریخ

کلمه کلیدی
گسترش کلمات کلیدی در فایل های ردیابی شده

فایل های بزرگ
ردیابی فایل های باینری بزرگ

mq دسته ای از وصله ها را مدیریت کنید

مطلع ساختن قلاب هایی برای ارسال اعلان های فشار ایمیل

صفحه خروجی فرمان را با پیجر خارجی مرور کنید

بمب پچ
دستور برای ارسال تغییرات به عنوان (یک سری از) ایمیل های وصله

پالایش دستور حذف فایل های ردیابی نشده از دایرکتوری کاری

تخفیف دستور انتقال مجموعه‌ای از بازبینی‌ها به یک جد متفاوت

رکورد دستورات برای انتخاب تعاملی تغییرات برای commit/qrefresh

پیوند مجدد پیوندهای سخت بین کلون های مخزن را دوباره ایجاد می کند

طرح ها
طرح ها را با میانبرها به گروه های مخزن گسترش دهید

سهم یک تاریخچه مشترک بین چندین فهرست کاری به اشتراک بگذارید

قفسه تغییرات را در پوشه کاری ذخیره و بازیابی کنید

نوار تغییر مجموعه ها و فرزندان آنها را از تاریخ حذف کنید

پیوند
دستور پیوند تغییرات از شاخه دیگر

win32mbcs
اجازه استفاده از مسیرهای MBCS با رمزگذاری های مشکل ساز را می دهد

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

مشخص کردن فایل SETS

Mercurial از یک زبان کاربردی برای انتخاب مجموعه ای از فایل ها پشتیبانی می کند.

مانند سایر الگوهای فایل، این نوع الگو با پیشوند "set:" نشان داده می شود. زبان
تعدادی از گزاره ها را پشتیبانی می کند که توسط عملگرهای infix به آن ها می پیوندند. پرانتز می تواند باشد
برای گروه بندی استفاده می شود

شناسه‌هایی مانند نام فایل‌ها یا الگوها باید با گیومه‌های تک یا دوگانه نقل‌قول شوند
آنها حاوی شخصیت های خارج از [.*{}[]?/\_a-zA-Z0-9\x80-\xff] یا اگر با یکی از آنها مطابقت دارند
محمول های از پیش تعریف شده این به طور کلی برای الگوهای فایل به غیر از glob و
استدلال برای محمولات

نویسه های ویژه را می توان در شناسه های نقل قول شده با فرار از آنها استفاده کرد، به عنوان مثال، \n is
به عنوان یک خط جدید تفسیر می شود. برای جلوگیری از تفسیر آنها، رشته ها را می توان پیشوند گذاشت
با r، به عنوان مثال r'...'.

یک عملگر پیشوندی وجود دارد:

نه x

فایل هایی که در x نیستند. فرم کوتاه است ! x.

اینها اپراتورهای infix پشتیبانی شده هستند:

x و y

تقاطع فایل ها در x و y. فرم کوتاه است x & y.

x or y

اتحاد فایل ها در x و y. دو فرم کوتاه جایگزین وجود دارد: x | y و x +
y.

x - y

فایل ها در x اما نه در y.

محمول های زیر پشتیبانی می شوند:

اضافه()

فایلی که بر اساس آن اضافه شده است hg وضعیت.

دودویی()

فایلی که به نظر می رسد باینری است (حاوی بایت های NUL).

تمیز()

فایلی که طبق آن تمیز باشد hg وضعیت.

کپی شده()

فایلی که به عنوان کپی ثبت شده است.

حذف شده()

نام مستعار برای گم شده().

رمزگذاری (نام)

فایل را می توان با موفقیت رمزگشایی با رمزگذاری کاراکتر داده شده است. ممکن است نباشد
برای رمزگذاری های غیر از ASCII و UTF-8 مفید است.

eol (سبک)

فایل حاوی خطوط جدید از سبک داده شده (dos، unix، mac) است. فایل های باینری هستند
حذف، فایل‌هایی با انتهای خط مختلط با چندین سبک مطابقت دارند.

exec()

فایلی که به عنوان اجرایی علامت گذاری شده است.

grep (regex)

فایل حاوی عبارت منظم داده شده است.

hgignore()

فایلی که با الگوی فعال .hgignore مطابقت دارد.

نادیده گرفته شد()

فایلی که مطابق با نادیده گرفته می شود hg وضعیت. این فایل ها فقط در صورتی که
این محمول استفاده می شود.

گم شده()

فایلی که مطابق با hg وضعیت.

اصلاح شده()

فایلی که بر اساس آن اصلاح شده است hg وضعیت.

قابل حمل ()

فایلی که نام قابل حمل دارد. (این شامل نام فایل با حروف بزرگ نمی شود
برخوردها.)

حذف شده()

فایلی که طبق آن حذف می شود hg وضعیت.

حل شد()

فایلی که علامت گذاری شده بر اساس حل شد hg تصمیم -l.

اندازه (بیان)

اندازه فایل با عبارت داده شده مطابقت دارد. مثال ها:

· 1k (فایل ها از 1024 تا 2047 بایت)

· < 20k (فایل های کمتر از 20480 بایت)

· >= .5 مگابایت (فایل ها حداقل 524288 بایت)

· 4k - 1MB (فایل ها از 4096 بایت تا 1048576 بایت)

subrepo ([الگو])

مخازن فرعی که مسیرهای آنها با الگوی داده شده مطابقت دارد.

symlink()

فایلی که به عنوان پیوند علامت گذاری شده است.

ناشناس()

فایلی که طبق آن ناشناخته است hg وضعیت. این فایل ها فقط در صورتی که
این محمول استفاده می شود.

حل نشده ()

فایلی که طبق آن به صورت حل نشده علامت گذاری شده است hg تصمیم -l.

چند نمونه پرس و جو:

· نمایش وضعیت فایل هایی که به نظر می رسد در فهرست کار باینری هستند:

وضعیت hg -A "set:binary()"

· فایل هایی را که در .hgignore هستند اما قبلا ردیابی شده اند فراموش کنید:

hg فراموش کنید "set:hgignore() and not ignored()"

· فایل های متنی حاوی یک رشته را پیدا کنید:

فایل های hg "set:grep استفاده(جادو) و نه باینری()"

یافتن فایل های C در یک رمزگذاری غیر استاندارد:

فایل های hg "set:**.c and not encoding('UTF-8')"

· کپی فایل های باینری بزرگ را برگردانید:

hg برگرداندن "set:copied() و باینری() and size('>1M')"

· فایل های فهرست شده در foo.lst که حاوی حرف a یا b هستند را حذف کنید:

hg حذف "set: 'listfile:foo.lst' and (**a* or **b*)"

همچنین مشاهده کنید hg کمک الگوهای.

واژه نامه

اجداد
هر تغییر مجموعه ای که می تواند توسط یک زنجیره ناگسستنی از تغییرات والد به دست آید، از a
مجموعه تغییرات داده شده به طور دقیق تر، اجداد یک تغییرات را می توان با دو تعریف کرد
خواص: والد یک تغییرات یک اجداد است و والد یک اجداد است
یک اجداد همچنین نگاه کنید به: "فرزند".

چوب الف
نشانک‌ها نشان‌دهنده‌ای به تعهدات خاصی هستند که هنگام ارتکاب حرکت می‌کنند. آن ها هستند
مشابه برچسب ها از این جهت که امکان استفاده از نام نشانک ها در همه مکان ها وجود دارد
Mercurial انتظار دارد یک شناسه تغییرات، به عنوان مثال، با hg به روز رسانی. برخلاف برچسب ها، نشانک ها حرکت می کنند
همراه با زمانی که شما تعهد می دهید.

نشانک ها را می توان تغییر نام داد، کپی کرد و حذف کرد. نشانک ها محلی هستند، مگر اینکه باشند
به صراحت بین مخازن فشار داده یا کشیده می شود. فشار دادن و کشیدن نشانک ها
به شما این امکان را می دهد که بدون ایجاد شاخه ای با نام با دیگران در یک شعبه همکاری کنید.

شاخه (اسم) تغییر مجموعه فرزند که از والدینی که سر نیست ایجاد شده است.
اینها به عنوان شاخه های توپولوژیکی شناخته می شوند، به "شاخه، توپولوژیک" مراجعه کنید. اگر یک
شاخه توپولوژیکی نامگذاری می شود، تبدیل به یک شاخه نام می شود. اگر یک شاخه توپولوژیکی باشد
نامگذاری نشده است، به یک شاخه ناشناس تبدیل می شود. به "شعبه، ناشناس" و "شعبه" مراجعه کنید،
تحت عنوان'.

هنگامی که تغییرات از یک کنترل از راه دور خارج می شوند یا به آن فشار می آورند، ممکن است شاخه ها ایجاد شوند
مخزن، زیرا ممکن است هدهای جدیدی توسط این عملیات ایجاد شود. توجه داشته باشید که اصطلاح
شاخه همچنین می تواند به طور غیررسمی برای توصیف فرآیند توسعه استفاده شود که در آن
توسعه معین مستقل از توسعه دیگر انجام می شود. این گاهی اوقات است
به صراحت با یک شاخه نامگذاری شده انجام می شود، اما می توان آن را به صورت محلی نیز با استفاده از
نشانک ها یا کلون ها و شاخه های ناشناس.

مثال: "شاخه تجربی."

(فعل) عمل ایجاد یک فرزند تغییر مجموعه که منجر به داشتن والد آن می شود
بیش از یک کودک

مثال: "من در X شعبه خواهم داشت."

شاخه، بی نام
هر بار که یک تغییر مجموعه فرزند جدید از یک والدین ایجاد می شود که سر و
نام شعبه تغییر نمی کند، یک شعبه ناشناس جدید ایجاد می شود.

شاخه، بسته
شعبه ای به نام که سر شعبه های آن همه بسته شده اند.

شاخه، به طور پیش فرض
شاخه ای که به یک تغییرات تخصیص داده می شود زمانی که هیچ نامی قبلاً اختصاص داده نشده است.

شاخه سر
به "سر، شاخه" مراجعه کنید.

شاخه، غیر فعال
اگر یک شاخه نامگذاری شده فاقد سر توپولوژیکی باشد، غیر فعال در نظر گرفته می شود. به عنوان یک
به عنوان مثال، یک شاخه ویژگی زمانی غیرفعال می شود که در حالت پیش فرض ادغام شود
شاخه. در hg شاخه ها دستور به طور پیش فرض شاخه های غیرفعال را نشان می دهد، اگرچه می توانند
پنهان شود با hg شاخه ها --فعال.

توجه: این مفهوم منسوخ شده است زیرا بیش از حد ضمنی است. شعبه باید در حال حاضر
به صراحت با استفاده از بسته شود hg مرتکب شدن -- نزدیک شعبه وقتی دیگر نیازی به آنها نباشد

شاخه، تحت عنوان
مجموعه ای از تغییرات که نام شعبه یکسانی دارند. به طور پیش فرض، فرزندان از
یک تغییرات در یک شاخه با نام متعلق به همان شاخه با نام است. یک کودک می تواند باشد
به صراحت به شعبه دیگری اختصاص داده شده است. دیدن hg کمک شاخه, hg کمک شاخه ها و
hg مرتکب شدن -- نزدیک شعبه برای اطلاعات بیشتر در مورد مدیریت شعب

شاخه های نامگذاری شده را می توان به عنوان نوعی فضای نام در نظر گرفت که مجموعه ای را تقسیم می کند
تغییراتی که مخزن را به مجموعه ای از زیرمجموعه های مجزا تشکیل می دهد. آ
شاخه نامگذاری شده لزوماً یک شاخه توپولوژیکی نیست. اگر یک شاخه جدید با نام است
ایجاد شده از سر شاخه دیگری با نام، یا شاخه پیش فرض، اما نه
تغییرات بیشتری به آن شاخه قبلی و سپس آن شاخه قبلی اضافه می شود
فقط به نام شعبه خواهد بود.

شاخه نوک
به "نکته، شاخه" مراجعه کنید.

شاخه، توپولوژیکی
هر بار که یک تغییر مجموعه فرزند جدید از والدینی ایجاد می‌شود که سرپرست نیست، یک جدید است
شاخه توپولوژیکی ایجاد می شود. اگر یک شاخه توپولوژیکی نامگذاری شود، به یک نام تبدیل می شود
شاخه. اگر یک شاخه توپولوژیکی نامگذاری نشود، به شاخه ای ناشناس تبدیل می شود
شاخه فعلی، احتمالاً پیش فرض.

تغییرات
رکوردی از تغییرات مجموعه به ترتیب اضافه شدن آنها به مخزن.
این شامل جزئیاتی مانند شناسه تغییرات، نویسنده، پیام ارتکاب، تاریخ و فهرست است
از فایل های تغییر یافته

تغییر مجموعه
یک عکس فوری از وضعیت مخزن مورد استفاده برای ثبت یک تغییر.

تغییر مجموعه، کودک
برعکس تغییرات والد: اگر P والد C باشد، C فرزند P است.
هیچ محدودیتی برای تعداد فرزندانی که ممکن است مجموعه تغییرات داشته باشد وجود ندارد.

تغییر مجموعه id
یک هش SHA-1 که به طور منحصربه‌فرد مجموعه تغییرات را شناسایی می‌کند. ممکن است به صورت یکی نشان داده شود
یک رشته 40 رقمی "بلند" یا یک رشته 12 رقمی "کوتاه" هگزادسیمال.

تغییر مجموعه، ادغام کردن
مجموعه ای با دو والدین. این زمانی اتفاق می افتد که یک ادغام انجام شود.

تغییر مجموعه، پدر یا مادر
تجدیدنظری که بر اساس آن تغییر مجموعه فرزند انجام می شود. به طور خاص، یک تغییر مجموعه والدین
از یک تغییرات C تغییراتی است که گره آن بلافاصله قبل از C در DAG قرار می گیرد.
Changeset ها حداکثر دو والدین دارند.

وارسی
(اسم) فهرست کاری در حال به روز رسانی به یک ویرایش خاص. این استفاده باید
احتمالاً در صورت امکان اجتناب شود، زیرا تغییرات تنظیم بسیار مناسب تر از آن است
پرداخت در این زمینه

مثال: "من از Checkout X استفاده می کنم."

(فعل) به روز رسانی فهرست کار به یک مجموعه تغییرات خاص. دیدن hg کمک به روز رسانی.

مثال: "من قصد دارم تغییرات X را بررسی کنم."

کودک رویدادنگاری
به "تغییر تنظیم، فرزند" مراجعه کنید.

نزدیک رویدادنگاری
به "سر، شاخه بسته" مراجعه کنید.

تعطیل شاخه
به "شعبه، بسته" مراجعه کنید.

کلون (اسم) نسخه کامل یا جزئی از یک مخزن. کلون جزئی باید در
شکل یک تجدید نظر و اجداد آن

مثال: "آیا کلون شما به روز است؟"

(فعل) فرآیند ایجاد یک کلون، با استفاده از hg کلون کردن.

مثال: "من قصد دارم مخزن را شبیه سازی کنم."

تعطیل شاخه سر
به "سر، شاخه بسته" مراجعه کنید.

مرتکب (اسم) مترادف تغییرات مجموعه.

مثال: "آیا اشکال در commit اخیر شما برطرف شده است؟"

(فعل) عمل ضبط به یک مخزن تغییر می کند. هنگامی که فایل ها در یک
پوشه کاری، Mercurial تفاوت بین فایل های متعهد و
تغییرات والد آنها، ایجاد یک تغییرات جدید در مخزن.

به عنوان مثال: "شما باید آن تغییرات را اکنون انجام دهید."

Cset مخفف رایج عبارت changeet.

DAG مخزن تغییرات یک سیستم کنترل نسخه توزیع شده (DVCS) می تواند باشد
به عنوان یک گراف غیر چرخه ای جهت دار (DAG)، که از گره ها و لبه ها تشکیل شده است، توصیف می شود
گره ها مربوط به تغییرات هستند و یال ها دلالت بر یک رابطه والد -> فرزند دارند. این
نمودار را می توان با ابزارهای گرافیکی مانند hg ورود به سیستم -- نمودار. در مرکوریال،
DAG با الزام فرزندان به داشتن حداکثر دو والدین محدود شده است.

منسوخ
ویژگی از اسناد حذف شد، اما برای حذف برنامه ریزی نشده است.

به طور پیش فرض شاخه
به "شعبه، پیش فرض" مراجعه کنید.

نسل
هر تغییر مجموعه ای که می تواند توسط زنجیره ای از فرزند به دست آید از یک داده تغییر می کند
تغییرات مجموعه به طور دقیق تر، فرزندان یک تغییرات را می توان با دو تعریف کرد
خواص: فرزند یک تغیرات یک نسل است و فرزند یک تبار
از نوادگان است همچنین نگاه کنید به: "اجداد".

تفاوت (اسم) تفاوت محتویات و صفات فایل در دو
تغییرات یا تغییرات و دایرکتوری کاری فعلی. تفاوت این است
معمولاً در یک فرم استاندارد به نام "تفاوت" یا "پچ" نمایش داده می شود. "تفاوت git"
فرمت زمانی استفاده می شود که تغییرات شامل کپی، تغییر نام یا تغییرات در فایل باشد
ویژگی‌هایی که هیچ‌یک از آنها را نمی‌توان با «تفاوت» و «وصله» کلاسیک نشان داد/ مدیریت کرد.

مثال: "آیا تصحیح من را در تفاوت دیدید؟"

(فعل) تفاوت دو تغییر مجموعه عمل ایجاد یک تفاوت یا پچ است.

مثال: "اگر با تغییرات X تفاوت داشته باشید، منظور من را خواهید دید."

فهرست راهنما، کارگر
دایرکتوری کاری نشان دهنده وضعیت فایل های ردیابی شده توسط Mercurial است
در کامیت بعدی ثبت خواهد شد. دایرکتوری کار در ابتدا با
عکس فوری در یک مجموعه تغییرات موجود که به عنوان والد کار شناخته می شود
فهرست راهنما. به "والد، فهرست کار" مراجعه کنید. وضعیت ممکن است با تغییراتی در آن تغییر یابد
فایل هایی که به صورت دستی یا با ادغام معرفی شده اند. ابرداده مخزن در موجود است
دایرکتوری hg در داخل دایرکتوری کاری.

پیش نویس تغییرات در مرحله پیش نویس با مخازن انتشار و انتشار به اشتراک گذاشته نشده است
بنابراین ممکن است به‌طور ایمن توسط افزونه‌های اصلاح‌کننده تاریخ تغییر کند. دیدن hg کمک فاز.

تجربی
قابلیتی که ممکن است در تاریخ بعدی تغییر کند یا حذف شود.

گراف DAG و را ببینید hg ورود به سیستم -- نمودار.

سر اصطلاح "سر" ممکن است برای اشاره به سر شاخه یا سر مخزن استفاده شود.
بسته به زمینه برای جزئیات بیشتر به «سر، شاخه» و «سر، مخزن» مراجعه کنید
تعاریف

سرها جایی هستند که توسعه به طور کلی انجام می شود و اهداف معمولی هستند
عملیات به روز رسانی و ادغام

سر، شاخه
تغییراتی که هیچ نسلی در شاخه ای با نام مشابه ندارد.

سر، بسته شاخه
مجموعه تغییراتی که سر را به عنوان دیگر جالب نشان نمی‌دهد. سر بسته است نه
طولانی تر فهرست شده توسط hg سر. یک شاخه زمانی بسته در نظر گرفته می شود که تمام سرهای آن بسته باشد
بسته شده و در نتیجه توسط فهرست نشده است hg شاخه ها.

هدهای بسته را می‌توان با انجام تغییرات جدید به عنوان فرزند، دوباره باز کرد
تغییراتی که یک سر را به عنوان بسته مشخص می کند.

سر، مخزن
هد توپولوژیکی که بسته نشده است.

سر، توپولوژیکی
تغییرات بدون فرزند در مخزن.

تاریخ، تغییر ناپذیر
پس از انجام، تنظیمات تغییرات قابل تغییر نیستند. برنامه های افزودنی که به نظر می رسد تغییر می کنند
تاریخ در واقع تغییرات جدیدی را ایجاد می کند که جایگزین تغییرات موجود می شود و سپس نابود می شود
تغییرات قدیمی انجام این کار در مخازن عمومی می تواند منجر به تغییرات قدیمی شود
در حال معرفی مجدد به مخزن

تاریخ، بازنویسی
تغییرات موجود در یک مخزن تغییر ناپذیر است. با این حال، پسوندهای مرکوریال می توانند
برای تغییر مخزن، معمولاً به گونه ای که تغییرات مجموعه را حفظ می کند، استفاده شود
فهرست.

تغییر ناپذیر تاریخ
به "تاریخ، تغییر ناپذیر" مراجعه کنید.

ادغام کردن رویدادنگاری
به "تغییر تنظیم، ادغام" مراجعه کنید.

آشکار
هر مجموعه تغییرات دارای یک مانیفست است، که لیستی از فایل هایی است که توسط آن ردیابی می شوند
تغییرات مجموعه

ادغام کردن برای گرد هم آوردن شاخه های کاری متفاوت استفاده می شود. وقتی به یک تغییرات به روز می کنید
و سپس تغییرات دیگری را ادغام کنید، تاریخچه تغییرات اخیر را می آورید
به دایرکتوری کاری شما هنگامی که تضادها حل شدند (و علامت گذاری شدند)، این ادغام می شود
ممکن است به عنوان یک مجموعه تغییرات ادغام، دو شاخه را در DAG به هم متصل کند.

تحت عنوان شاخه
به "شعبه، با نام" مراجعه کنید.

تهی رویدادنگاری
مجموعه تغییرات خالی این وضعیت اصلی مخازن تازه راه‌اندازی‌شده و
مخازن بدون بازبینی بررسی شده بنابراین والد تغییرات root است
و جد مؤثر هنگام ادغام مجموعه‌های تغییرات نامرتبط. را می توان مشخص کرد
نام مستعار 'null' یا با شناسه تغییرات '000000000000'.

پدر یا مادر به "تغییر تنظیم، والدین" مراجعه کنید.

پدر یا مادر رویدادنگاری
به "تغییر تنظیم، والدین" مراجعه کنید.

والدین، کارگر فهرست راهنما
والد دایرکتوری کاری یک ویرایش مجازی را منعکس می کند که فرزند آن است
تغییرات (یا دو مجموعه تغییرات با ادغام غیرمتعهد) نشان داده شده توسط hg پدر و مادر. این
با تغییر می کند hg به روز رسانی. سایر دستورات برای دیدن والد دایرکتوری کاری هستند
hg خلاصه و hg id. می توان با نام مستعار "." مشخص کرد.

وصله (اسم) حاصلضرب عمل diff.

مثال: "من برای شما پچ خود را فرستادم."

(فعل) فرآیند استفاده از یک فایل پچ برای تبدیل یک تغییرات به دیگری.

مثال: "شما باید آن نسخه را اصلاح کنید."

فاز وضعیتی که در هر مجموعه تغییر می کند که چگونه مجموعه تغییرات به اشتراک گذاشته شده یا باید به اشتراک گذاشته شود. دیدن
hg کمک فاز.

عمومی تغییرات در مرحله عمومی با مخازن انتشارات به اشتراک گذاشته شده است
بنابراین غیر قابل تغییر در نظر گرفته می شوند. دیدن hg کمک فاز.

کشیدن عملیاتی که در آن تغییرات در یک مخزن راه دور که در محلی نیستند تغییر می کند
مخزن به مخزن محلی آورده می شود. توجه داشته باشید که این عملیات بدون
آرگومان های خاص فقط مخزن را به روز می کند، فایل های موجود در آن را به روز نمی کند
دایرکتوری کار دیدن hg کمک کشیدن.

فشار عملیاتی که در آن در یک مخزن محلی که در یک ریموت نیست تغییر می کند
مخزن به مخزن راه دور ارسال می شود. توجه داشته باشید که این عملیات فقط اضافه می کند
تغییراتی که به صورت محلی به مخزن راه دور متعهد شده اند. بی تعهد
تغییرات ارسال نمی شود دیدن hg کمک فشار.

مخزن
فراداده ای که تمام حالت های ضبط شده مجموعه ای از فایل ها را توصیف می کند. هرکدام ثبت شد
state با یک تغییرات نمایش داده می شود. یک مخزن معمولا (اما نه همیشه) یافت می شود
در .HG زیر شاخه یک فهرست کاری هر حالت ثبت شده را می توان دوباره ایجاد کرد
با "به روز رسانی" یک فهرست کاری به یک مجموعه تغییرات خاص.

مخزن سر
به "سر، مخزن" مراجعه کنید.

تجدید نظر
وضعیتی از مخزن در نقطه ای از زمان. ویرایش های قبلی را می توان به روز کرد
به با استفاده از hg به روز رسانی. همچنین به "شماره ویرایش" مراجعه کنید. همچنین به "تغییر تنظیم" مراجعه کنید.

تجدید نظر عدد
این عدد صحیح به طور منحصربه‌فرد یک مجموعه تغییرات را در یک مخزن خاص شناسایی می‌کند. آی تی
نشان‌دهنده ترتیبی است که مجموعه‌های تغییرات به یک مخزن اضافه می‌شوند، با شروع
شماره ویرایش 0. توجه داشته باشید که شماره ویرایش ممکن است در هر کلون متفاوت باشد
یک مخزن برای شناسایی تغییرات منحصر به فرد بین کلون های مختلف، نگاه کنید به
'تغییر شناسه تنظیم'.

Revlog مکانیسم ذخیره‌سازی تاریخ که توسط مرکوریال استفاده می‌شود. این یک شکل از رمزگذاری دلتا است، با
بازبینی کامل گاه به گاه داده ها و به دنبال آن دلتای هر بازبینی متوالی. آی تی
شامل داده ها و شاخصی است که به داده ها اشاره می کند.

بازنویسی تاریخ
به "تاریخ، بازنویسی" مراجعه کنید.

ریشه تغییراتی که فقط تغییرات null را به عنوان والد خود دارد. اکثر مخازن دارند
تنها یک تغییر ریشه

راز تغییرات در فاز مخفی ممکن است از طریق فشار، کشش یا شبیه سازی به اشتراک گذاشته نشود. دیدن hg
کمک فاز.

برچسب نام جایگزین داده شده به یک مجموعه تغییرات. برچسب ها را می توان در همه مکان ها استفاده کرد
Mercurial انتظار دارد یک شناسه تغییرات، به عنوان مثال، با hg به روز رسانی. ایجاد یک برچسب است
در تاریخچه ذخیره می شود و بنابراین به طور خودکار با استفاده از فشار با دیگران به اشتراک گذاشته می شود
و بکشید.

نوک مجموعه تغییرات با بالاترین تعداد بازبینی. این تغییرات اخیر است
در یک مخزن اضافه شده است.

نکته، شاخه
رئیس یک شعبه معین با بالاترین تعداد تجدید نظر. وقتی نام یک شعبه است
به عنوان شناسه تجدید نظر استفاده می شود، به نوک شاخه اشاره دارد. همچنین به "شعبه" مراجعه کنید،
سر'. توجه داشته باشید که چون اعداد ویرایش ممکن است در مخزن های مختلف متفاوت باشد
کلون ها، نوک شاخه ممکن است در مخازن مختلف شبیه سازی شده متفاوت باشد.

بروزرسانی (اسم) مترادف دیگر تغییرات ست.

مثال: "من یک به روز رسانی را انجام دادم."

(فعل) این اصطلاح معمولاً برای توصیف به روز رسانی وضعیت کار استفاده می شود
دایرکتوری به یک مجموعه تغییرات خاص. دیدن hg کمک به روز رسانی.

مثال: "شما باید به روز رسانی کنید."

کارگر فهرست راهنما
به "دایرکتوری، در حال کار" مراجعه کنید.

کارگر فهرست راهنما پدر یا مادر
به "والد، فهرست کار" مراجعه کنید.

نحو برای دمدمی مزاج چشم پوشی فایل ها

خلاصه
سیستم مرکوریال از فایلی به نام استفاده می کند .hgignore در دایرکتوری ریشه یک مخزن به
رفتار آن را هنگام جستجوی فایل هایی که در حال حاضر ردیابی نمی کند، کنترل کنید.

توضیحات:
دایرکتوری کاری یک مخزن Mercurial اغلب حاوی فایل هایی است که نباید
توسط مرکوریال ردیابی شود. اینها شامل فایل های پشتیبان ایجاد شده توسط ویرایشگرها و محصولات بیلد می شود
ایجاد شده توسط کامپایلرها این فایل ها را می توان با فهرست کردن آنها در یک نادیده گرفت .hgignore فایل در
ریشه دایرکتوری کاری در .hgignore فایل باید به صورت دستی ایجاد شود. این است
معمولاً تحت کنترل نسخه قرار می گیرد، به طوری که تنظیمات به دیگران منتقل می شود
مخازن با فشار و کشش.

یک فایل ردیابی نشده در صورتی که مسیر آن نسبت به دایرکتوری ریشه مخزن یا هر کدام باشد نادیده گرفته می شود
مسیر پیشوند آن مسیر، با هر الگوی در مطابقت دارد .hgignore.

به عنوان مثال، بگویید ما یک فایل ردیابی نشده داریم، file.c، در a/b/file.c داخل مخزن ما
مرکوریال نادیده می گیرد file.c اگر هر الگوی در .hgignore کبریت a/b/file.c, A / B or a.

علاوه بر این، یک فایل پیکربندی Mercurial می‌تواند به مجموعه‌ای از هر کاربر یا سراسری ارجاع دهد
نادیده گرفتن فایل ها را ببینید چشم پوشی از کلید پیکربندی روی [UI] بخش از hg کمک پیکربندی برای
جزئیات نحوه پیکربندی این فایل ها

برای کنترل مدیریت مرکوریال با فایل‌هایی که مدیریت می‌کند، دستورات زیادی از آن پشتیبانی می‌کنند -I و
-X گزینه ها؛ دیدن hg کمک و hg کمک الگوهای برای جزئیات بیشتر.

فایل هایی که قبلاً ردیابی شده اند تحت تأثیر hgignore. قرار نمی گیرند، حتی اگر در آنها ظاهر شوند
.hgignore. یک فایل ردیابی نشده X را می توان به صراحت با آن اضافه کرد hg اضافه کردن X، حتی اگر X باشد
توسط الگویی در .hgignore حذف شده است.

نحو
فایل نادیده گرفتن یک فایل متنی ساده است که از فهرستی از الگوها با یک الگو در هر تشکیل شده است
خط خطوط خالی نادیده گرفته می شوند. در # شخصیت به عنوان یک کاراکتر نظر در نظر گرفته می شود و
\ شخصیت به عنوان یک شخصیت فرار در نظر گرفته می شود.

Mercurial از چندین نحو الگو پشتیبانی می کند. نحو پیش‌فرض مورد استفاده Python/Perl-style است
عبارات با قاعده.

برای تغییر نحو استفاده شده، از یک خط به شکل زیر استفاده کنید:

نحو: NAME

جایی که نام یکی از موارد زیر است:

regexp

عبارت منظم، نحو Python/Perl.

کره

کره به سبک پوسته.

نحو انتخاب شده در هنگام تجزیه همه الگوهای بعدی، تا زمانی که الگوهای دیگری انجام می‌شود، به قوت خود باقی می‌ماند
نحو انتخاب شده است.

نه الگوهای glob و نه regexp روت نشده اند. یک الگوی دستوری کروی از فرم *.c اراده
مطابقت با یک فایل که به .c در هر دایرکتوری، و یک الگوی regexp از فرم \.c$ انجام خواهد داد
همان برای روت کردن یک الگوی regexp، آن را با آن شروع کنید ^.

زیر شاخه ها می توانند تنظیمات .hgignore خود را با افزودن داشته باشند
subinclude:path/to/subdir/.hgignore تا ریشه .hgignoreاست. دیدن hg کمک الگوهای برای
جزئیات در فرعی شامل: و عبارتند از:.

توجه داشته باشید الگوهای مشخص شده در غیر از .hgignore همیشه روت هستند لطفا ببینید hg کمک
الگوهای برای جزئیات بیشتر.

مثال
در اینجا یک نمونه فایل نادیده گرفته شده است.

# از نحو glob استفاده کنید.
نحو: glob

*. elc
*.pyc
*~

# به نحو regexp تغییر دهید.
نحو: regexp
^\.pc/

پیکربندی HGWEB

وب سرور داخلی Mercurial، hgweb، می تواند یک مخزن واحد یا درختی از
مخازن در حالت دوم، مسیرهای مخزن و گزینه های سراسری را می توان با استفاده از آن تعریف کرد
یک فایل پیکربندی اختصاصی مشترک برای hg خدمت, hgweb.wsgi, hgweb.cgi و hgweb.fcgi.

این فایل از نحوی مشابه با سایر فایل های پیکربندی Mercurial استفاده می کند اما فقط شناسایی می کند
بخش های زیر:

· وب

· راه ها

· مجموعه ها

La وب گزینه ها به طور کامل در hg کمک پیکربندی.

La راه ها بخش مسیرهای URL به مسیرهای مخازن در سیستم فایل را ترسیم می کند. hgweb خواهد شد
فایل سیستم را مستقیماً در معرض نمایش قرار ندهید - فقط مخازن Mercurial می توانند منتشر شوند و فقط
با توجه به پیکربندی

سمت چپ مسیر در URL است. توجه داشته باشید که hgweb مسیرهای فرعی مانند احیای or
پرونده، سعی کنید از نام های مختلف برای مخازن تو در تو استفاده کنید تا از اثرات گیج کننده جلوگیری کنید.

سمت راست مسیر در سیستم فایل است. اگر مسیر مشخص شده به پایان می رسد * or **
فایل سیستم به صورت بازگشتی برای مخازن زیر آن نقطه جستجو می شود. با * it
در مخازنی که پیدا می کند (به جز .hg/patch) با ** آن خواهد شد
همچنین در دایرکتوری های کاری مخزن جستجو کنید و احتمالاً مخازن فرعی را پیدا کنید.

در این مثال:

[راه ها]
/projects/a = /srv/tmprepos/a
/projects/b = c:/repos/b
/ = /srv/repos/*
/user/bob = /home/bob/repos/**

· دو ورودی اول باعث می شوند که دو مخزن در دایرکتوری های مختلف در زیر ظاهر شوند
همان دایرکتوری در رابط وب

· مدخل سوم هر مخزن Mercurial را که در آن یافت می شود منتشر می کند /srv/repos/، برای
به عنوان مثال مخزن /srv/repos/quux/ ظاهر خواهد شد http://server/quux/

· مدخل چهارم هر دو را منتشر خواهد کرد http://server/user/bob/quux/ و
http://server/user/bob/quux/testsubrepo/

La مجموعه بخش منسوخ شده و جایگزین شده است راه ها.

آدرس ها و مشترک استدلال
URL های زیر هر مخزن دارای فرم هستند /{command}[/{Arguments}] جایی که {فرمان}
نشان دهنده نام یک فرمان یا کنترل کننده و {استدلال} نشان دهنده هر تعداد از
پارامترهای URL اضافی به آن دستور.

وب سرور دارای یک سبک پیش فرض مرتبط با آن است. سبک ها به مجموعه ای از نامگذاری شده نگاشت
قالب ها هر الگو برای ارائه یک قطعه خاص از داده ها، مانند تغییرات مجموعه استفاده می شود
یا تفاوت

سبک درخواست فعلی را می توان به دو روش بازنویسی کرد. اول، اگر {فرمان}
حاوی خط فاصله (-)، متن قبل از خط فاصله استایل را مشخص می کند. مثلا،
/atom-log را ارائه خواهد کرد ورود به سیستم کنترل کننده فرمان با اتم سبک. راه دوم برای تنظیم
سبک با سبک آرگومان رشته پرس و جو مثلا، /log?style=atom.
پارامتر URL خط تیره ترجیح داده می شود.

همه قالب ها برای همه سبک ها در دسترس نیستند. تلاش برای استفاده از سبکی که اینطور نیست
همه الگوها تعریف شده باشد ممکن است منجر به خطا در رندر صفحه شود.

بسیاری از دستورات الف را می گیرند {بازبینی} پارامتر URL این تغییرات مجموعه ای را که باید روی آن کار کرد را مشخص می کند.
این معمولاً به عنوان مخفف کوتاه 12 رقمی هگزادسیمال برای 40 کامل مشخص می شود.
شناسه بازبینی منحصر به فرد شخصیت با این حال، هر مقداری که توسط hg کمک تجدید نظر
به طور معمول کار می کند.

دستورات و آدرس ها
دستورات وب زیر و URL های آنها در دسترس هستند:

/annotate/{revision}/{path}
نمایش اطلاعات تغییرات برای هر خط در یک فایل.

La فایل یادداشت کنید الگو ارائه شده است.

/archive/{revision}.{format}[/{path}]
یک آرشیو از محتوای مخزن به دست آورید.

محتوا و نوع آرشیو با پارامتر مسیر URL تعریف می شود. قالب هست
پسوند فایل از نوع بایگانی که باید ایجاد شود. به عنوان مثال زیپ or tar.bz2. نه همه بایگانی
انواع ممکن است توسط پیکربندی سرور شما مجاز باشد.

اختیاری مسیر پارامتر URL محتوا را برای گنجاندن در بایگانی کنترل می کند. در صورت حذف،
هر فایل در ویرایش مشخص شده در آرشیو موجود است. اگر شامل شود، فقط
فایل مشخص شده یا محتویات دایرکتوری مشخص شده در آرشیو گنجانده می شود.

هیچ قالبی برای این کنترلر استفاده نشده است. محتوای خام و باینری تولید می شود.

/ نشانک ها
نمایش اطلاعات مربوط به نشانک ها

هیچ استدلالی پذیرفته نمی شود.

La بوک مارک ها الگو ارائه شده است.

/شاخه ها
نمایش اطلاعات در مورد شعب

تمام شاخه های شناخته شده در خروجی وجود دارد، حتی شاخه های بسته.

هیچ استدلالی پذیرفته نمی شود.

La شاخه ها الگو ارائه شده است.

/changelog[/{بازبینی}]
نمایش اطلاعات در مورد چندین تغییر.

اگر اختیاری است تجدید نظر آرگومان URL وجود ندارد، اطلاعات مربوط به همه مجموعه‌های تغییرات شروع می‌شود
at نوک ارائه خواهد شد. اگر تجدید نظر آرگومان موجود است، تغییرات مجموعه نشان داده خواهد شد
از بازبینی مشخص شده شروع می شود.

If تجدید نظر غایب است، احیای آرگومان رشته کوئری ممکن است تعریف شود. این یک را انجام خواهد داد
جستجو برای تغییرات.

استدلال برای احیای می تواند یک ویرایش واحد، یک مجموعه بازبینی یا یک کلمه کلیدی تحت اللفظی باشد
جستجو در داده های تغییرات (معادل hg ورود به سیستم -k).

La شمارش مجدد آرگومان رشته کوئری حداکثر تعداد تغییرات مجموعه را برای ارائه تعریف می کند.

برای غیر جستجو، تغییرات قالب ارائه خواهد شد.

/changeset[/{بازبینی}]
اطلاعات مربوط به یک مجموعه تغییرات را نشان دهید.

آرگومان مسیر URL، شناسه تغییرات مجموعه است که باید نشان داده شود. دیدن hg کمک تجدید نظر برای
مقادیر ممکن اگر تعریف نشده باشد، نوک تغییرات مجموعه نشان داده خواهد شد.

La رویدادنگاری الگو ارائه شده است. محتویات تگ تغییرات, تغییر نشانک,
filenodelink, filenolink، و بسیاری از الگوهای مربوط به تفاوت ها ممکن است برای همه استفاده شوند
خروجی را تولید کند.

‎/comparison/{revision}/{مسیر}
نمایش مقایسه بین نسخه های قدیمی و جدید یک فایل از تغییرات ایجاد شده در a
تجدید نظر خاص

این شبیه به تفاوت کنترل کننده با این حال، این فرم دارای یک تقسیم یا کنار هم است
تفاوت به جای تفاوت یکپارچه.

La زمینه آرگومان رشته پرس و جو می تواند برای کنترل خطوط زمینه در تفاوت استفاده شود.

La مقایسه فایل الگو ارائه شده است.

/diff/{revision}/{مسیر}
نحوه تغییر یک فایل در یک commit خاص را نشان دهید.

La filediff الگو ارائه شده است.

این کنترل کننده تحت هر دو مورد ثبت شده است /تفاوت و /filediff راه ها. /تفاوت در مورد استفاده می شود
کد مدرن

/file/{revision}[/{path}]
نمایش اطلاعات مربوط به دایرکتوری یا فایل موجود در مخزن.

اطلاعات در مورد مسیر به عنوان یک پارامتر URL ارائه می شود.

If مسیر یک دایرکتوری است، اطلاعات مربوط به ورودی های آن دایرکتوری ارائه می شود.
این فرم معادل است ظاهر دستیار

If مسیر یک فایل است، اطلاعات مربوط به آن فایل از طریق نشان داده می شود ویرایش فایل
قالب.

If مسیر تعریف نشده است، اطلاعات مربوط به دایرکتوری ریشه ارائه خواهد شد.

/diff/{revision}/{مسیر}
نحوه تغییر یک فایل در یک commit خاص را نشان دهید.

La filediff الگو ارائه شده است.

این کنترل کننده تحت هر دو مورد ثبت شده است /تفاوت و /filediff راه ها. /تفاوت در مورد استفاده می شود
کد مدرن

/filelog/{revision}/{path}
نمایش اطلاعات مربوط به تاریخچه یک فایل در مخزن.

La شمارش مجدد آرگومان رشته پرس و جو را می توان برای کنترل حداکثر تعداد ورودی ها تعریف کرد
نمایش دادن.

La filelog قالب ارائه خواهد شد.

/graph[/{بازبینی}]
نمایش اطلاعات در مورد توپولوژی گرافیکی مخزن.

اطلاعات ارائه شده توسط این کنترل کننده می تواند برای ایجاد نمایش های بصری استفاده شود
توپولوژی مخزن

La تجدید نظر پارامتر URL مجموعه تغییرات شروع را کنترل می کند.

La شمارش مجدد آرگومان رشته پرس و جو می تواند تعداد تغییرات مجموعه را برای نمایش اطلاعات تعریف کند
برای.

این کنترل کننده، را رندر می کند گراف قالب.

/help[/{topic}]
ارائه مستندات راهنما

این دستور وب تقریباً معادل است hg کمک. اگر یک موضوع تعریف شده است، که موضوع کمک می کند
ارائه خواهد شد. در غیر این صورت، فهرستی از موضوعات راهنمای موجود ارائه خواهد شد.

La کمک هنگام درخواست کمک برای یک موضوع، الگو ارائه می شود. موضوع های کمک کننده خواهد بود
برای نمایه موضوعات راهنما ارائه شده است.

/log[/{revision}[/{path}]]
نمایش مخزن یا تاریخچه فایل.

برای URL های فرم /log/{بازبینی}، لیستی از مجموعه تغییرات که از مقدار مشخص شده شروع می شود
شناسه تغییرات ست نشان داده شده است. اگر {بازبینی} تعریف نشده است، پیش فرض است نوک. این فرم
معادل است تغییرات دستیار

برای URL های فرم /log/{revision}/{file}، تاریخچه برای یک فایل خاص خواهد بود
نشان داده شده. این فرم معادل است filelog دستیار

‎/manifest[/{revision}[/{path}]]
نمایش اطلاعات مربوط به دایرکتوری

اگر آرگومان های مسیر URL حذف شوند، اطلاعات مربوط به دایرکتوری ریشه برای نوک
تغییرات مجموعه نشان داده خواهد شد.

از آنجایی که این کنترلر فقط می تواند اطلاعات دایرکتوری ها را نشان دهد، توصیه می شود از آن استفاده کنید
la پرونده در عوض، handler، زیرا می تواند هم دایرکتوری ها و هم فایل ها را مدیریت کند.

La ظاهر الگو برای این کنترل کننده ارائه خواهد شد.

/changeset[/{بازبینی}]
اطلاعات مربوط به یک مجموعه تغییرات را نشان دهید.

آرگومان مسیر URL، شناسه تغییرات مجموعه است که باید نشان داده شود. دیدن hg کمک تجدید نظر برای
مقادیر ممکن اگر تعریف نشده باشد، نوک تغییرات مجموعه نشان داده خواهد شد.

La رویدادنگاری الگو ارائه شده است. محتویات تگ تغییرات, تغییر نشانک,
filenodelink, filenolink، و بسیاری از الگوهای مربوط به تفاوت ها ممکن است برای همه استفاده شوند
خروجی را تولید کند.

/ shortlog
نمایش اطلاعات اولیه در مورد مجموعه ای از تغییرات.

این پارامترهای مشابه را می پذیرد تغییرات کنترل کننده تنها تفاوت این است
کوتاه الگو به جای رندر می شود تغییرات قالب.

/خلاصه
نمایش خلاصه ای از وضعیت مخزن.

اطلاعات مربوط به آخرین تغییرات، نشانک‌ها، برچسب‌ها و شاخه‌ها توسط این ذخیره می‌شود
دستیار

La خلاصه الگو ارائه شده است.

/برچسب ها
نمایش اطلاعات در مورد برچسب ها

هیچ استدلالی پذیرفته نمی شود.

La برچسب ها الگو ارائه شده است.

فنی پیاده سازی موضوعات

بسته
ظرفی برای تبادل داده های مخزن

تغییر گروه ها
نمایش داده های revlog

revlogs
مکانیسم ذخیره سازی تجدید نظر

ادغام ابزارها

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

ابزار ادغام دو نسخه مختلف از یک فایل را در یک فایل ادغام شده ترکیب می کند. ابزارهای ادغام هستند
با توجه به دو فایل و بزرگترین جد مشترک دو نسخه فایل، بنابراین آنها می توانند
تغییرات ایجاد شده در هر دو شاخه را تعیین کنید.

ابزار ادغام هر دو مورد استفاده قرار می گیرد hg تصمیم, hg ادغام کردن, hg به روز رسانی, hg عقب نشینی و در چندین
پسوند ها

معمولاً ابزار ادغام سعی می‌کند تا با ترکیب همه فایل‌ها، فایل‌ها را به‌طور خودکار آشتی دهد
تغییرات غیر همپوشانی که به طور جداگانه در دو تکامل مختلف رخ داده است
همان فایل پایه اولیه علاوه بر این، برخی از برنامه‌های ادغام تعاملی این کار را آسان‌تر می‌کنند
ادغام های متناقض را به صورت دستی یا به صورت گرافیکی یا با درج برخی از آنها حل کنید
نشانگرهای تعارض Mercurial هیچ برنامه ادغام تعاملی را شامل نمی شود اما به آن متکی است
ابزارهای خارجی برای آن

در دسترس ادغام کردن ابزار
ابزارهای ادغام خارجی و ویژگی های آنها در پیکربندی merge-tools پیکربندی می شوند
بخش - ببینید hgrc(5) - اما اغلب می توان آنها را فقط با اجرای آنها نامگذاری کرد.

یک ابزار ادغام معمولاً در صورتی قابل استفاده است که بتوان آن را در سیستم یافت و آن را اجرا کرد
می تواند ادغام را اداره کند. اجرایی در صورتی یافت می شود که یک اجرایی مطلق یا نسبی باشد
مسیر یا نام یک برنامه کاربردی در مسیر جستجوی اجرایی. ابزار فرض شده است
اگر می تواند پیوندهای نمادین را مدیریت کند، اگر فایل یک پیوند نمادین باشد، می تواند ادغام را مدیریت کند، اگر بتواند
اگر فایل باینری است، فایل‌های باینری را مدیریت کنید و اگر ابزار نیاز به رابط کاربری گرافیکی داشته باشد
یک رابط کاربری گرافیکی

برخی از ابزارهای ادغام داخلی وجود دارد که می توان از آنها استفاده کرد. ابزارهای ادغام داخلی عبارتند از:

:زباله

سه نسخه از فایل ها را برای ادغام ایجاد می کند که حاوی محتویات محلی است،
دیگر و پایه. سپس می توان از این فایل ها برای انجام ادغام به صورت دستی استفاده کرد. اگر
فایلی که باید ادغام شود نامگذاری شده است a.txt، این فایل ها بر این اساس نامگذاری می شوند
a.txt.local, a.txt.other و a.txt.base و در همان جا قرار خواهند گرفت
دایرکتوری به عنوان a.txt.

:مردود شدن

به جای تلاش برای ادغام فایل هایی که در هر دو شاخه اصلاح شده اند، علامت گذاری می کند
آنها به عنوان حل نشده برای حل این تضادها باید از دستور حل استفاده شود.

:محلی

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

:ادغام

از الگوریتم ادغام ساده غیر تعاملی داخلی برای ادغام فایل ها استفاده می کند. خواهد شد
در صورت وجود هر گونه تداخل با شکست مواجه شود و نشانگرها در فایل ادغام شده باقی بماند.
نشانگرها دو بخش خواهند داشت، یکی برای هر طرف ادغام.

:merge-local

مانند :merge، اما همه درگیری ها را به صورت غیر تعاملی به نفع محلی حل کنید
تغییرات.

:ادغام-دیگر

مانند :merge، اما همه درگیری ها را به صورت غیر تعاملی به نفع دیگری حل کنید
تغییرات.

:merge3

از الگوریتم ادغام ساده غیر تعاملی داخلی برای ادغام فایل ها استفاده می کند. خواهد شد
در صورت وجود هر گونه تداخل با شکست مواجه شود و نشانگرها در فایل ادغام شده باقی بماند.
نشانگر دارای سه بخش است، یکی از هر طرف ادغام و یکی برای ادغام
محتوای پایه

:دیگر

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

:سریع

از کاربر می‌پرسد کدام یک از نسخه‌های محلی یا نسخه‌های دیگر را به عنوان ادغام شده نگه دارد
نسخه.

:tagmerge

از الگوریتم ادغام برچسب داخلی (تجربی) استفاده می کند.

:اتحاد. اتصال

از الگوریتم ادغام ساده غیر تعاملی داخلی برای ادغام فایل ها استفاده می کند. خواهد شد
از هر دو سمت چپ و راست برای مناطق درگیری استفاده کنید. هیچ نشانگری درج نشده است.

ابزارهای داخلی همیشه در دسترس هستند و نیازی به رابط کاربری گرافیکی ندارند، اما به طور پیش‌فرض به آن نیازی نخواهد بود
مدیریت پیوندهای نمادین یا فایل های باینری.

انتخاب a ادغام کردن ابزار
Mercurial هنگام تصمیم گیری از ابزار ادغام برای استفاده از این قوانین استفاده می کند:

1. اگر ابزاری با گزینه --tool برای ادغام یا حل کردن مشخص شده باشد، از آن استفاده می شود.
اگر نام ابزاری در پیکربندی merge-tools باشد، پیکربندی آن است
استفاده شده. در غیر این صورت ابزار مشخص شده باید توسط پوسته قابل اجرا باشد.

2. اگر HGMERGE متغیر محیطی موجود است، مقدار آن استفاده می شود و باید باشد
قابل اجرا توسط پوسته

3. اگر نام فایل فایلی که باید ادغام شود با هر یک از الگوهای موجود در فایل مطابقت دارد
بخش پیکربندی الگوهای ادغام، اولین ابزار ادغام قابل استفاده مربوط به a
الگوی تطبیق استفاده می شود. در اینجا، قابلیت های باینری ابزار ادغام وجود ندارد
در نظر گرفته شده.

4. اگر ui.merge تنظیم شده باشد در مرحله بعد در نظر گرفته می شود. اگر مقدار نام a نباشد
ابزار پیکربندی شده، مقدار مشخص شده استفاده می شود و باید توسط پوسته قابل اجرا باشد.
در غیر این صورت از ابزار نام برده در صورت قابل استفاده بودن استفاده می شود.

5. اگر ابزارهای ادغام قابل استفاده در بخش پیکربندی ابزارهای ادغام وجود داشته باشد،
با بالاترین اولویت استفاده می شود.

6. اگر برنامه ای به نام hgmerge را می توان در سیستم پیدا کرد، از آن استفاده می شود - اما خواهد شد
به طور پیش فرض برای سیملینک ها و فایل های باینری استفاده نمی شود.

7. اگر فایلی که باید ادغام شود باینری نیست و یک پیوند نمادین نیست، داخلی است :ادغام is
استفاده شده.

8. ادغام فایل با شکست مواجه می شود و باید قبل از commit حل شود.

توجه داشته باشید پس از انتخاب یک برنامه ادغام، Mercurial به طور پیش فرض سعی در ادغام آن ها خواهد کرد
ابتدا فایل ها با استفاده از یک الگوریتم ادغام ساده. فقط در صورتی که به دلیل موفق نشدن
تغییرات متناقض Mercurial در واقع برنامه ادغام را اجرا می کند. آیا به
استفاده از الگوریتم ادغام ساده برای اولین بار می تواند توسط تنظیم premerge کنترل شود
ابزار ادغام Premerge به طور پیش فرض فعال است مگر اینکه فایل باینری یا a باشد
پیوند نمادین

بخش‌های ابزارهای ادغام و رابط کاربری را ببینید hgrc(5) برای جزئیات در مورد پیکربندی ادغام
ابزار.

مشخص کردن چند برابر تجدید نظرها

هنگامی که Mercurial بیش از یک ویرایش را می پذیرد، ممکن است آنها به صورت جداگانه مشخص شوند، یا
ارائه شده به عنوان یک محدوده توپولوژیکی پیوسته، که با کاراکتر ":" از هم جدا شده است.

نحو نمادگذاری محدوده [BEGIN]:[END] است، که در آن BEGIN و END تجدید نظر هستند
شناسه ها BEGIN و END هر دو اختیاری هستند. اگر BEGIN مشخص نشده باشد، به طور پیش فرض روی آن تنظیم می شود
شماره ویرایش 0. اگر END مشخص نشده باشد، به طور پیش فرض روی نوک قرار می گیرد. محدوده ":" بنابراین
به معنی "همه تجدید نظرها".

اگر BEGIN بزرگتر از END باشد، تجدید نظرها به ترتیب معکوس بررسی می شوند.

یک محدوده به عنوان یک بازه بسته عمل می کند. این بدان معنی است که محدوده 3:5 3، 4 و 5 را می دهد.
به طور مشابه، محدوده 9:6 9، 8، 7 و 6 را به دست می دهد.

فایل نام پدر و مادرها

Mercurial چندین نماد را برای شناسایی یک یا چند فایل در یک زمان می پذیرد.

به طور پیش‌فرض، Mercurial نام فایل‌ها را به‌عنوان الگوهای گلوب توسعه‌یافته به سبک پوسته در نظر می‌گیرد.

نمادهای الگوی جایگزین باید به صراحت مشخص شوند.

توجه داشته باشید الگوهای مشخص شده در .hgignore روت نشده اند. لطفا ببینید hg کمک hgignore برای
جزئیات.

برای استفاده از نام مسیر ساده بدون تطابق الگو، آن را با آن شروع کنید مسیر:. این مسیر
نام ها باید کاملاً مطابق با ریشه مخزن فعلی باشند.

برای استفاده از یک گلوب توسعه یافته، نام را با آن شروع کنید کره زمین:. گلوب ها در جریان ریشه دارند
فهرست راهنما؛ کره ای مانند *.c فقط فایل‌های موجود در فهرست فعلی را که با آن ختم می‌شود مطابقت خواهد داد
.c.

پسوندهای نحوی glob پشتیبانی شده هستند ** برای مطابقت با هر رشته ای در جداکننده های مسیر و
{a,b} به معنای "الف یا ب".

برای استفاده از یک عبارت منظم Perl/Python، یک نام را با آن شروع کنید دوباره:. تطبیق الگوی Regexp
در ریشه مخزن لنگر انداخته است.

برای خواندن الگوهای نام از یک فایل، استفاده کنید لیست فایل: or listfile0:. دومی انتظار تهی دارد
الگوهای محدود شده در حالی که اولی انتظار تغذیه خط را دارد. هر رشته خوانده شده از فایل است
خود به عنوان یک الگوی فایل در نظر گرفته می شود.

برای خواندن مجموعه ای از الگوها از یک فایل، استفاده کنید عبارتند از: or فرعی شامل:. عبارتند از: از همه استفاده خواهد کرد
الگوهای فایل داده شده و با آنها به گونه ای رفتار کنید که گویی به صورت دستی منتقل شده اند.
فرعی شامل: الگوها را فقط در برابر فایل هایی اعمال می کند که در قسمت فرعی قرار دارند
دایرکتوری فایل دیدن hg کمک hgignore برای جزئیات بیشتر در مورد فرمت این فایل ها.

همه الگوها به جز کره زمین: در خط فرمان مشخص شده است (نه برای -I or -X گزینه ها)، می تواند
مطابقت با دایرکتوری ها: فایل های زیر دایرکتوری های منطبق به عنوان منطبق تلقی می شوند.

مثال های ساده:

path:foo/bar یک نوار نام در فهرستی به نام foo در ریشه
از مخزن
path:path:نام یک فایل یا دایرکتوری با نام "path:name"

نمونه های گلوب:

glob:*.c هر نامی که در فهرست فعلی به ".c" ختم شود
*.c هر نامی که در فهرست فعلی به ".c" ختم شود
**.c هر نامی که به ".c" ختم می شود در هر زیر شاخه ای از
دایرکتوری فعلی از جمله خودش.
foo/*.c هر نامی که در دایرکتوری foo به ".c" ختم شود
foo/**.c هر نامی که به ".c" ختم می شود در هر زیر شاخه foo
از جمله خودش.

نمونه های Regexp:

re:.*\.c$ هر نامی که به ".c" ختم شود، در هر نقطه از مخزن

نمونه فایل:

listfile:list.txt خواندن لیست از list.txt با یک الگوی فایل در هر خط
listfile0:list.txt خواندن لیست از list.txt با جداکننده بایت تهی

همچنین مشاهده کنید hg کمک مجموعه فایل ها.

شامل مثال ها:

include:path/to/mypatternfile الگوهایی را می خواند تا در همه مسیرها اعمال شود
subinclude:path/to/subignorefile الگوهایی را به طور خاص برای مسیرهای موجود می خواند
زیرشاخه

کار با فاز

چی هستند فاز؟
فازها سیستمی برای ردیابی تغییراتی هستند که به اشتراک گذاشته شده یا باید به اشتراک گذاشته شوند. این
هنگام اصلاح تاریخچه (مثلاً با mq یا rebase) از اشتباهات رایج جلوگیری می کند
پسوندها).

هر تغییر در یک مخزن در یکی از مراحل زیر است:

· public: تغییرات در یک سرور عمومی قابل مشاهده است

· پیش نویس: تغییرات هنوز منتشر نشده است

· مخفی: تغییرات مجموعه نباید فشار داده شود، کشیده شود، یا شبیه سازی شود

این مراحل مرتب شده اند (عمومی < پیش نویس < مخفی) و هیچ تغییری نمی تواند در پایین تر باشد
فاز نسبت به اجدادش به عنوان مثال، اگر یک تغییر مجموعه عمومی باشد، همه اجداد آن عمومی هستند
همچنین عمومی در نهایت، مراحل تغییرات فقط باید به مرحله عمومی تغییر کند.

چگونه هستند فاز اداره می شود؟
در بیشتر موارد، فازها باید شفاف کار کنند. به طور پیش فرض، یک تغییرات در ایجاد می شود
مرحله پیش نویس است و زمانی که به مرحله دیگر منتقل می شود به مرحله عمومی منتقل می شود
مخزن

به محض اینکه مجموعه‌های تغییرات عمومی شوند، برنامه‌های افزودنی مانند mq و rebase از کار کردن خودداری می‌کنند
آنها را برای جلوگیری از ایجاد تغییرات تکراری. همچنین می توان فازها را به صورت دستی دستکاری کرد
با hg فاز در صورت نیاز دستور دهید دیدن hg کمک -v فاز برای نمونه.

برای مخفی کردن commit های شما به صورت پیش فرض، این را در فایل پیکربندی خود قرار دهید:

[فاز]
new-commit = راز

فاز و سرورها
به طور معمول، همه سرورها هستند چاپ و نشر به صورت پیش فرض. این یعنی:

- تمام مجموعه تغییرات پیش نویس که کشیده یا شبیه سازی شده اند در فاز ظاهر می شوند
عمومی بر روی مشتری

- همه تغییرات پیش نویس که فشار داده می شوند به عنوان عمومی در هر دو ظاهر می شوند
مشتری و سرور

- تغییرات مخفی نه تحت فشار، کشیده، و یا شبیه سازی شده است

توجه: بیرون کشیدن یک پیش نویس تغییرات از یک سرور انتشار، آن را به عنوان عمومی در آن علامت گذاری نمی کند
سمت سرور به دلیل ماهیت فقط خواندنی کشش.

گاهی اوقات ممکن است برای اشتراک گذاری، فشار دادن و کشیدن تغییرات در مرحله پیش نویس مطلوب باشد
کار ناتمام این را می توان با تنظیم یک مخزن برای غیرفعال کردن انتشار در آن انجام داد
فایل پیکربندی:

[فاز]
انتشار = نادرست

دیدن hg کمک پیکربندی برای اطلاعات بیشتر در مورد فایل های پیکربندی

توجه داشته باشید سرورهایی که نسخه‌های قدیمی‌تر مرکوریال را اجرا می‌کنند به عنوان انتشار تلقی می‌شوند.

توجه داشته باشید مجموعه تغییرات در فاز مخفی با سرور رد و بدل نمی شود. این در مورد آنها صدق می کند
محتوا: نام فایل، محتویات فایل، و متادیتای تغییرات مجموعه. به دلایل فنی،
شناسه (مانند d825e4025e39) مجموعه تغییرات مخفی ممکن است به
سرور.

مثال ها
· فهرست تغییرات در مرحله پیش نویس یا مخفی:

hg log -r "not public()"

· تغییر همه تغییرات مخفی به پیش نویس:

فاز hg -- پیش نویس "secret()"

· به اجبار مجموعه تغییرات و فرزندان فعلی را از عمومی به پیش نویس منتقل کنید:

فاز hg -- نیرو -- پیش نویس .

· نمایش فهرستی از بازنگری و مرحله تغییرات مجموعه:

hg log --template "{rev} {phase}\n"

· تغییرات پیش نویس را مجدداً با یک مخزن راه دور هماهنگ کنید:

فاز hg -fd "خروجی(URL)"

دیدن hg کمک فاز برای اطلاعات بیشتر در مورد دستکاری فازها.

مشخص کردن تنها تجدید نظرها

Mercurial از چندین روش برای مشخص کردن بازبینی‌های فردی پشتیبانی می‌کند.

یک عدد صحیح ساده به عنوان یک شماره تجدید نظر در نظر گرفته می شود. اعداد صحیح منفی به عنوان رفتار می شوند
جابجایی های متوالی از نوک، با -1 نشان دهنده نوک، -2 نشان دهنده تجدید نظر قبلی
به نوک، و غیره.

یک رشته هگزادسیمال 40 رقمی به عنوان یک شناسه تجدیدنظر منحصر به فرد در نظر گرفته می شود.

یک رشته هگزادسیمال کمتر از 40 کاراکتر به عنوان یک ویرایش منحصر به فرد در نظر گرفته می شود
شناسه و به عنوان شناسه فرم کوتاه نامیده می شود. یک شناسه فرم کوتاه فقط است
اگر پیشوند دقیقاً یک شناسه تمام قد باشد معتبر است.

هر رشته دیگری به عنوان نشانک، برچسب یا نام شاخه در نظر گرفته می شود. نشانک یک متحرک است
اشاره به یک تجدید نظر برچسب یک نام دائمی است که با یک ویرایش مرتبط است. یک اسم شعبه
نشان دهنده نوک بازترین سر شاخه آن شاخه است - یا اگر همه آنها بسته باشند، به
سر بسته ترین شاخه نام نشانک‌ها، برچسب‌ها و شاخه‌ها نباید حاوی این باشد
":" شخصیت.

نام رزرو شده "نکته" همیشه آخرین ویرایش را مشخص می کند.

نام رزرو شده "null" نشان دهنده بازبینی null است. این بازبینی یک خالی است
مخزن و والد ویرایش 0.

نام رزرو شده "." والد دایرکتوری کاری را نشان می دهد. اگر هیچ دایرکتوری کار نمی کند
بررسی شد، معادل null است. اگر یک ادغام غیرمتعهد در حال انجام است، "." هست
بازبینی والد اول

مشخص کردن تجدید نظر SETS

Mercurial از یک زبان کاربردی برای انتخاب مجموعه ای از ویرایش ها پشتیبانی می کند.

این زبان از تعدادی گزاره پشتیبانی می کند که توسط عملگرهای infix به آن ها می پیوندند.
از پرانتز می توان برای گروه بندی استفاده کرد.

شناسه‌هایی مانند نام شاخه‌ها ممکن است نیاز به نقل‌قول با نقل قول‌های تک یا دوگانه داشته باشند
شامل کاراکترهایی مانند - یا اگر با یکی از محمول های از پیش تعریف شده مطابقت داشته باشند.

نویسه های ویژه را می توان در شناسه های نقل قول شده با فرار از آنها استفاده کرد، به عنوان مثال، \n is
به عنوان یک خط جدید تفسیر می شود. برای جلوگیری از تفسیر آنها، رشته ها را می توان پیشوند گذاشت
با r، به عنوان مثال r'...'.

یک عملگر پیشوندی وجود دارد:

نه x

تغییرات در x نیست. فرم کوتاه است ! x.

اینها اپراتورهای infix پشتیبانی شده هستند:

x::y

یک محدوده DAG، به معنای همه مجموعه‌های تغییراتی که از فرزندان x و اجداد y هستند،
از جمله خود x و y. اگر اولین نقطه پایانی حذف شود، این معادل است
به اجداد (y)، اگر دومی کنار گذاشته شود معادل است با نوادگان (x).

یک نحو جایگزین است x..y.

x:y

همه تغییرات با اعداد بازبینی بین x و y، هر دو شامل. هر دو
نقطه پایانی را می توان کنار گذاشت، آنها به طور پیش فرض روی 0 و نوک هستند.

x و y

تقاطع مجموعه تغییرات در x و y. فرم کوتاه است x & y.

x or y

اتحاد تغییرات در x و y. دو فرم کوتاه جایگزین وجود دارد: x | y
و x + y.

x - y

در x تغییر می کند اما در y نه.

x^n

nامین والد x، n == 0، 1 یا 2. برای n == 0، x; برای n == 1، اولین والد
از هر تغییر در x; برای n == 2، والد دوم تغییرات در x.

x~n

nامین جد اول x; x~0 x است. x~3 is x^^^.

یک اپراتور postfix واحد وجود دارد:

x^

معادل با x^1، اولین والد هر تغییر در x.

محمول های زیر پشتیبانی می شوند:

اضافه می کند (الگو)

مجموعه‌های تغییراتی که الگوی تطبیقی ​​فایل را اضافه می‌کند.

الگوی بدون نوع صریح مانند کره زمین: انتظار می رود نسبت به
دایرکتوری فعلی و مطابقت با یک فایل یا دایرکتوری.

همه()

همه تغییرات، مانند 0: نکته.

اجداد (*تغییر مجموعه)

بزرگترین جد مشترک تغییرات مجموعه ها.

0 یا بیشتر تغییرات را می پذیرد. پس از ارسال بدون آرگ، لیست خالی را برمی گرداند.
بزرگترین جد مشترک یک تغییرات منفرد همان تغییرات است.

اجداد (مجموعه)

Changeset هایی که اجداد یک تغییرات در مجموعه هستند.

نویسنده (رشته)

نام مستعار برای کاربر (رشته).

دوقسمت (رشته)

مجموعه‌های تغییرات علامت‌گذاری شده در وضعیت دوگانه مشخص شده:

· خوب, بد, تماس با ما: cset ها به صراحت به عنوان خوب/بد/پرش علامت گذاری شده اند

· مغازه, بد : csets از نظر توپولوژیکی خوب/بد

· محدوده : سیست هایی که در تقسیم بندی شرکت می کنند

· مهره دار : مجموعه هایی که کالاها، بد یا حذف شده اند

· تست نشده : سیست هایی که هنوز سرنوشت آنها مشخص نیست

· نادیده گرفته : cset ها به دلیل توپولوژی DAG نادیده گرفته شدند

· جاری : cset در حال دو نیم شدن

نشانک ([نام])

نشانک نام‌گذاری شده یا همه نشانک‌ها.

If نام شروع می شود با دوباره:، باقی مانده نام به عنوان یک نام عادی در نظر گرفته می شود
اصطلاح. برای مطابقت با نشانکی که در واقع با آن شروع می شود دوباره:، از پیشوند استفاده کنید
تحت اللفظی:.

شاخه (رشته or تنظیم)

همه تغییرات متعلق به شاخه داده شده یا شاخه های داده شده
را تغییر می دهد.

If رشته شروع می شود با دوباره:، باقی مانده نام به عنوان یک نام عادی در نظر گرفته می شود
اصطلاح. برای مطابقت با شاخه ای که در واقع با آن شروع می شود دوباره:، از پیشوند استفاده کنید
تحت اللفظی:.

شعبه ()

تغییرات با بیش از یک فرزند.

ضربه خورده()

تغییرات قابل تغییر به‌عنوان جانشین مجموعه‌های تغییرات عمومی علامت‌گذاری شده‌اند.

فقط تغییرات غیر عمومی و غیر منسوخ می تواند باشد دست انداز.

دسته()

تغییرات در بسته نرم افزاری

Bundle باید با گزینه -R مشخص شود.

کودکان (مجموعه)

تغییرات فرزند مجموعه تغییرات در مجموعه.

بسته ()

Changeset بسته است.

حاوی (الگو)

مانیفست ویرایش حاوی یک الگوی مطابق با فایل است (اما ممکن است آن را تغییر ندهد).
دیدن hg کمک الگوهای برای اطلاعات در مورد الگوهای فایل

الگوی بدون نوع صریح مانند کره زمین: انتظار می رود نسبت به
دایرکتوری فعلی و مطابقت با یک فایل دقیقا برای کارایی.

تبدیل شده ([id])

تغییرات از شناسه داده شده در مخزن قدیمی در صورت وجود، یا
همه تغییرات تبدیل شده در صورتی که هیچ شناسه ای مشخص نشده باشد.

تاریخ (فاصله)

تغییرات در بازه زمانی، ببینید hg کمک تاریخ.

توصیف (رشته)

جستجوی پیام commit برای رشته. مسابقه به حروف بزرگ و کوچک حساس است.

فرزندان (مجموعه)

Changeset هایی که از فرزندان تغییرات مجموعه هستند.

مقصد ([مجموعه])

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

واگرا()

جانشینان نهایی تغییرات مجموعه با مجموعه جایگزینی از جانشینان نهایی.

پیش نویس()

تغییر در مرحله پیش نویس

منقرض شده()

تغییرات منسوخ فقط با فرزندان منسوخ.

اضافی (برچسب، [مقدار])

با برچسب داده شده در فراداده اضافی، با انتخابی داده شده، مجموعه را تغییر می دهد
ارزش.

If ارزش شروع می شود با دوباره:، باقیمانده مقدار به عنوان یک مقدار عادی در نظر گرفته می شود
اصطلاح. برای مطابقت با مقداری که در واقع با آن شروع می شود دوباره:، از پیشوند استفاده کنید
تحت اللفظی:.

فایل (الگو)

تغییراتی که بر فایل‌های مطابق با الگو تأثیر می‌گذارد.

برای یک نتیجه سریعتر اما کمتر دقیق، استفاده را در نظر بگیرید filelog() به جای آن.

این محمول استفاده می کند کره زمین: به عنوان الگوی پیش فرض

فایل لاگ (الگو)

تنظیمات مربوط به فایل لاگ مشخص شده.

به دلایل عملکرد، فقط از بازبینی‌های ذکر شده در فایل لاگ سطح فایل بازدید می‌کند.
به جای فیلتر کردن تمام تغییرات (بسیار سریعتر، اما شامل نمی شود
حذف یا تکرار تغییرات). برای نتیجه آهسته تر و دقیق تر، استفاده کنید فایل().

الگوی بدون نوع صریح مانند کره زمین: انتظار می رود نسبت به
دایرکتوری فعلی و مطابقت با یک فایل دقیقا برای کارایی.

اگر برخی از linkrev به تجدید نظرهایی که توسط بازبینی فعلی فیلتر شده اند اشاره کند، کار خواهیم کرد
اطراف آن برای برگرداندن یک مقدار غیر فیلتر شده.

اول (مجموعه، [n])

نام مستعار برای limit().

دنبال کردن ([الگو])

نام مستعار برای ::. (اجداد اولین والد دایرکتوری کاری). اگر الگو
مشخص شده است، تاریخچه فایل های مطابق با الگوی داده شده دنبال می شود، از جمله
کپی کردن

grep (regex)

پسندیدن کلمه کلیدی (رشته) اما یک regex را می پذیرد. استفاده کنید grep (r'...') برای اطمینان از فرار ویژه
کاراکترها به درستی مدیریت می شوند بر خلاف کلمه کلیدی (رشته)، مسابقه است
حساس به حروف بزرگ

سر()

Changeset یک سر شاخه با نام است.

سر (مجموعه)

اعضای مجموعه بدون فرزند در مجموعه.

پنهان ()

تغییرات پنهان

شناسه (رشته)

بازبینی بدون ابهام توسط پیشوند رشته هگزا داده شده مشخص شده است.

کلمه کلیدی (رشته)

پیام commit، نام کاربری و نام فایل های تغییر یافته را برای رشته جستجو کنید. مسابقه
به حروف بزرگ و کوچک حساس است

آخرین (مجموعه، [n])

آخرین n عضو مجموعه، پیش‌فرض ۱.

حد(تنظیم[, n[، انحراف]])

n عضو اول مجموعه، به طور پیش فرض 1، شروع از افست.

تطبیق (بازبینی [, رشته])

مجموعه‌های تغییراتی که در آن یک مجموعه مشخص از فیلدها با مجموعه فیلدهای انتخاب شده مطابقت دارد
تجدید نظر یا تنظیم

برای مطابقت با بیش از یک فیلد، فهرست فیلدهایی را که با فاصله از هم جدا شده اند، عبور دهید
(به عنوان مثال نویسنده شرح).

فیلدهای معتبر اغلب فیلدهای تجدیدنظر معمولی و برخی فیلدهای خاص هستند.

فیلدهای تجدید نظر منظم هستند شرح, نویسنده, شاخه, تاریخ, فایل ها, فاز,
پدر و مادر, زیر دولت, کاربر و تفاوت. توجه داشته باشید که نویسنده و کاربر مترادف هستند تفاوت
به محتوای بازنگری اشاره دارد. دو ویرایش مطابق با آنها تفاوت نیز
آنها را مطابقت دهد فایل ها.

فیلدهای خاص هستند خلاصه و فراداده: خلاصه با خط اول مطابقت دارد
شرح. فراداده معادل تطبیق است شرح کاربر تاریخ (یعنی آن
با فیلدهای ابرداده اصلی مطابقت دارد).

فراداده فیلد پیش فرضی است که زمانی استفاده می شود که هیچ فیلدی مشخص نشده باشد. تو می توانی
با بیش از یک زمینه در یک زمان مطابقت دهید.

حداکثر (مجموعه)

تغییر مجموعه با بالاترین تعداد بازبینی در مجموعه.

ادغام()

Changeset یک مجموعه تغییرات ادغامی است.

دقیقه (مجموعه)

تغییر مجموعه با کمترین تعداد بازبینی در مجموعه.

اصلاح می کند (الگو)

فایل‌های مطابق با الگو را تغییر می‌دهد.

الگوی بدون نوع صریح مانند کره زمین: انتظار می رود نسبت به
دایرکتوری فعلی و مطابقت با یک فایل یا دایرکتوری.

با نام (فضای نام)

تغییرات در یک فضای نام مشخص.

If فضای نام شروع می شود با دوباره:، بقیه رشته به عنوان یک منظم در نظر گرفته می شود
اصطلاح. برای مطابقت با فضای نامی که در واقع با آن شروع می شود دوباره:، از پیشوند استفاده کنید
تحت اللفظی:.

منسوخ ()

تغییرات قابل تغییر با نسخه جدیدتر.

فقط(تنظیم، [تنظیم])

تغییراتی که اجداد مجموعه اول هستند که اجداد دیگری نیستند
سر در مخزن اگر مجموعه دوم مشخص شود، نتیجه اجداد آن است
مجموعه اول که اجداد مجموعه دوم نیستند (یعنی :: - :: ).

مبدا ([مجموعه])

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

خروجی ([مسیر])

مجموعه تغییراتی که در مخزن مقصد مشخص شده یا فشار پیش‌فرض یافت نشدند
محل.

p1 ([مجموعه])

والد اول تغییرات مجموعه در مجموعه یا دایرکتوری کاری.

p2 ([مجموعه])

والد دوم تغییرات مجموعه در مجموعه یا دایرکتوری کاری.

والدین ([مجموعه])

مجموعه ای از همه والدین برای همه تغییرات در مجموعه یا دایرکتوری کاری.

حاضر (مجموعه)

یک مجموعه خالی، اگر ویرایشی در مجموعه یافت نشد. در غیر این صورت، تمام ویرایش ها در مجموعه.

اگر هر یک از ویرایش های مشخص شده در مخزن محلی وجود نداشته باشد، پرس و جو وجود دارد
به طور معمول سقط می شود اما این گزاره اجازه می دهد تا پرس و جو حتی در چنین مواردی ادامه یابد
موارد.

عمومی()

تغییر در فاز عمومی

از راه دور ([id [،مسیر]])

ویرایش محلی که مطابق با شناسه داده شده در یک مخزن راه دور است، اگر
حاضر. اینجا '.' شناسه مترادف شاخه محلی فعلی است.

حذف می کند (الگو)

مجموعه‌های تغییراتی که فایل‌های مطابق با الگو را حذف می‌کنند.

الگوی بدون نوع صریح مانند کره زمین: انتظار می رود نسبت به
دایرکتوری فعلی و مطابقت با یک فایل یا دایرکتوری.

دور (تعداد)

بازبینی با شناسه عددی داده شده.

معکوس (مجموعه)

ترتیب معکوس مجموعه

ریشه (مجموعه)

تغییرات در مجموعه بدون تغییر والدین در مجموعه.

راز()

تغییر در فاز مخفی

مرتب سازی(مجموعه[, [-]کلید...])

مرتب سازی بر اساس کلیدها ترتیب مرتب سازی پیش فرض صعودی است، یک کلید را به عنوان مشخص کنید -کی به
مرتب سازی به ترتیب نزولی

کلیدها می توانند:

· احیای برای شماره تجدید نظر،

· شاخه برای نام شعبه،

· نزولی برای پیام commit (توضیحات)،

· کاربر برای نام کاربری (نویسنده می تواند به عنوان نام مستعار استفاده شود)

· تاریخ برای تاریخ ارتکاب

subrepo ([الگو])

مجموعه‌های تغییراتی که زیر رپو داده شده را اضافه، تغییر یا حذف می‌کنند. اگر الگوی ساب رپو وجود نداشته باشد
به نام، هر گونه تغییر subrepo برگردانده می شود.

برچسب ([نام])

برچسب مشخص شده بر اساس نام، یا تمام ویرایش های برچسب گذاری شده در صورت عدم وجود نام.

If نام شروع می شود با دوباره:، باقی مانده نام به عنوان یک نام عادی در نظر گرفته می شود
اصطلاح. برای مطابقت با برچسبی که در واقع با آن شروع می شود دوباره:، از پیشوند استفاده کنید تحت اللفظی:.

ناپایدار()

تغییرات غیر منسوخ با اجداد منسوخ.

کاربر (رشته)

نام کاربری شامل رشته است. مسابقه به حروف بزرگ و کوچک حساس است.

If رشته شروع می شود با دوباره:، بقیه رشته به عنوان یک منظم در نظر گرفته می شود
اصطلاح. برای مطابقت با کاربری که در واقع شامل دوباره:، از پیشوند استفاده کنید تحت اللفظی:.

محمول های جدید (معروف به نام مستعار) را می توان با استفاده از هر ترکیبی از موجود تعریف کرد
محمول یا نام مستعار دیگر. یک تعریف مستعار به نظر می رسد:

=

در revsetalias بخش از فایل پیکربندی Mercurial. استدلال های فرم $1,
$2و غیره از نام مستعار به تعریف جایگزین می شوند.

به عنوان مثال،

[revsetalias]
h = heads()
d ($1) = مرتب سازی ($1، تاریخ)
rs ($1، $2) = معکوس (مرتب سازی ($1، $2))

سه نام مستعار را تعریف می کند، h, dو rs. rs(0:نکته، نویسنده) دقیقا معادل است
معکوس(مرتب (0:نکته، نویسنده)).

یک اپراتور infix ## می تواند رشته ها و شناسه ها را در یک رشته به هم متصل کند. مثلا:

[revsetalias]
Issue($1) = grep(r'\bissue[:]?' ## $1 ## r'\b|\bbug\(' ## $1 ## r'\)')

موضوع(1234) برابر است با grep(r'\bissue[ :]?1234\b|\bbug\(1234\)') در این مورد. این
منطبق بر همه "مسأله 1234"، "issue:1234"، "issue1234" و "اشکال(1234) ".

سایر اپراتورهای پیشوند، infix و postfix اولویت کمتری دارند ##. مثلا، $1
## 2 ~ 2 دلار برابر است با (1 دلار) ## $2) ~ 2.

معادل های خط فرمان برای hg ورود به سیستم:

-f -> ::.
-dx -> تاریخ(x)
-kx -> کلمه کلیدی (x)
-m -> merge()
-ux -> کاربر(x)
-bx -> شاخه (x)
-P x -> !::x
-lx -> limit(expr, x)

چند نمونه پرس و جو:

· تغییرات در شاخه پیش فرض:

hg log -r "branch(default)"

· تغییرات در شاخه پیش فرض از تگ 1.5 (به استثنای ادغام):

hg log -r "branch(default) and 1.5:: and not merge()"

· باز کردن سر شاخه ها:

hg log -r "head() and not close()"

· تغییرات بین برچسب های 1.3 و 1.5 با ذکر "اشکال" که تاثیر می گذارد hgext/*:

hg log -r "1.3::1.5 و کلیدواژه (اشکال) و فایل ('hgext/*')"

· تغییرات انجام شده در می 2008، مرتب شده بر اساس کاربر:

hg log -r "مرتب (تاریخ('مه 2008')، کاربر)"

· مجموعه‌های تغییراتی که «اشکال» یا «مشکل» را ذکر می‌کنند که در نسخه برچسب‌گذاری شده نیستند:

hg log -r "(کلمه کلیدی(اشکال) یا کلمه کلیدی(مشکل)) و نه اجداد(برچسب())"

استفاده كردن دمدمی مزاج از اسکریپت ها و اتوماسیون

مصرف مرکوریال توسط ماشین ها (بر خلاف انسان) رایج است. این موضوع کمک می کند
برخی از ملاحظات مربوط به واسط ماشین ها با مرکوریال را شرح می دهد.

انتخاب an رابط
ماشین‌ها برای ارتباط با مرکوریال از بین روش‌های مختلفی انتخاب می‌کنند. این شامل:

· اجرای hg روند

پرس و جو از سرور HTTP

· فراخوانی به سرور فرمان

اجرای hg فرآیندها بسیار شبیه به نحوه تعامل انسان با مرکوریال در پوسته است.
باید قبلاً برای شما آشنا باشد.

hg خدمت می توان از آن برای راه اندازی سرور استفاده کرد. به طور پیش فرض، این یک سرور HTTP "hgweb" را راه اندازی می کند.
این سرور HTTP از خروجی های قابل خواندن توسط ماشین مانند JSON پشتیبانی می کند. برای اطلاعات بیشتر، ببینید hg
کمک hgweb.

hg خدمت همچنین می تواند یک "سرور فرمان" راه اندازی کند. کلاینت ها می توانند به این سرور متصل شوند و مشکل را ایجاد کنند
مرکوریال از طریق یک پروتکل خاص فرمان می دهد. برای جزئیات بیشتر در مورد سرور فرمان،
از جمله پیوندهایی به کتابخانه های مشتری، به https://mercurial.selenic.com/wiki/CommandServer مراجعه کنید.

hg خدمت رابط های مبتنی بر (سرورهای hgweb و فرمان) نسبت به ساده مزیت دارند
hg فراخوانی ها را از این نظر پردازش کنید که احتمالاً کارآمدتر هستند. این به این دلیل است که وجود دارد
سربار قابل توجهی برای ایجاد فرآیندهای جدید پایتون.

نکته اگر لازم است چندین را فراخوانی کنید hg فرآیندها در کوتاه مدت و/یا عملکرد است
برای شما مهم است، استفاده از یک رابط مبتنی بر سرور به شدت توصیه می شود.

محیط متغیر
همانطور که مستند در hg کمک محیط، متغیرهای مختلف محیطی بر
عملیات مرکوریال موارد زیر به ویژه برای ماشین های مصرف کننده مرتبط است
دمدمی مزاج:

HGPLAIN
اگر تنظیم نشود، خروجی Mercurial می تواند تحت تأثیر تنظیمات پیکربندی قرار گیرد
روی رمزگذاری، حالت پرمخاطب، محلی سازی و غیره تاثیر بگذارد.

به شدت توصیه می شود که ماشین ها این متغیر را هنگام فراخوانی تنظیم کنند hg
فرآیندهای.

HGENCODING
اگر تنظیم نشود، منطقه مورد استفاده توسط Mercurial از محیط شناسایی می شود. اگر
منطقه تعیین شده از نمایش نویسه های خاص پشتیبانی نمی کند، ممکن است Mercurial
این توالی کاراکترها را به اشتباه ارائه کنید (اغلب با استفاده از "؟" به عنوان یک مکان نگهدار
برای کاراکترهای نامعتبر در منطقه فعلی).

تنظیم صریح این متغیر محیطی عمل خوبی برای تضمین است
نتایج ثابت "utf-8" انتخاب خوبی در محیط های یونیکس مانند است.

HGRCPATH
اگر تنظیم نشود، Mercurial گزینه های پیکربندی را از فایل های پیکربندی با استفاده از به ارث می برد
فرآیند شرح داده شده در hg کمک پیکربندی. این شامل ارث بردن کاربر یا سیستم در کل است
فایل های پیکربندی

هنگامی که حداکثر کنترل بر پیکربندی Mercurial مورد نظر باشد، مقدار
HGRCPATH را می توان روی یک فایل واضح با تنظیمات خوب شناخته شده تنظیم کرد. در موارد نادر،
مقدار را می توان روی یک فایل خالی یا دستگاه تهی (اغلب / dev / null) دور زدن
بارگیری هر کاربر یا فایل پیکربندی سیستم. توجه داشته باشید که این رویکردها می توانند داشته باشند
عواقب ناخواسته، زیرا کاربر و فایل های پیکربندی سیستم اغلب چیزهایی را تعریف می کنند
مانند نام کاربری و برنامه های افزودنی که ممکن است برای ارتباط با a مورد نیاز باشد
مخزن

مصرف فرمان تولید
معمولاً ماشین‌ها نیاز به تجزیه خروجی دستورات Mercurial برای موارد مرتبط دارند
داده ها. این بخش تکنیک های مختلف برای انجام این کار را شرح می دهد.

تجزیه خام فرمان تولید
احتمالاً ساده‌ترین و مؤثرترین راه‌حل برای مصرف خروجی فرمان، ساده‌ترین راه‌حل است
فراخوانی hg دستورات را همانطور که به عنوان یک کاربر انجام می دهید و خروجی آنها را تجزیه و تحلیل کنید.

خروجی بسیاری از دستورات را می توان به راحتی با ابزارهایی مانند تجزیه و تحلیل کرد grep استفاده, SEDو بیدار.

یک نقطه ضعف بالقوه خروجی فرمان تجزیه این است که خروجی دستورات می تواند تغییر کند
هنگامی که مرکوریال ارتقا داده می شود. در حالی که مرکوریال به طور کلی برای عقب ماندگی قوی تلاش می کند
سازگاری، خروجی فرمان گاهی اوقات تغییر می کند. داشتن تست برای خودکار شما
تعاملات با hg دستورات به طور کلی توصیه می شود، اما زمانی که اهمیت بیشتری دارد
تجزیه خروجی دستور خام درگیر است.

با استفاده از قالب به کنترل تولید
بسیاری hg دستورات از خروجی قالب بندی شده از طریق -T/--قالب بحث و جدل. برای اطلاعات بیشتر، ببینید
hg کمک قالب.

الگوها برای کنترل صریح خروجی مفید هستند تا دقیقاً داده ها را دریافت کنید
شما می خواهید آن طور که می خواهید فرمت شود. مثلا، ورود به سیستم -T {node}\n می توان از آن برای چاپ یک استفاده کرد
خط جدید فهرستی از گره‌های مجموعه تغییرات به‌جای یک خروجی سفارشی‌شده توسط انسان حاوی
نویسندگان، تاریخ ها، توضیحات و غیره

نکته اگر تجزیه خروجی دستور خام خیلی پیچیده است، برای ساختن از الگوها استفاده کنید
زندگی شما راحت تر

La -T/--قالب آرگومان اجازه می دهد تا سبک های از پیش تعریف شده را مشخص کنید. کشتی مرکوریال با
سبک های ماشین خوان json و XML، که به ترتیب خروجی JSON و XML را ارائه می دهند.
اینها برای تولید خروجی قابل خواندن با ماشین همانطور که هست مفید هستند.

مهم
La json و XML سبک ها تجربی در نظر گرفته می شوند. در حالی که ممکن است جذاب باشند
برای به دست آوردن آسان خروجی قابل خواندن توسط ماشین، ممکن است رفتار آنها تغییر کند
نسخه های بعدی

این سبک‌ها همچنین ممکن است نتایج غیرمنتظره‌ای را هنگام برخورد با برخی از آنها نشان دهند
رمزگذاری ها Mercurial چیزهایی مانند نام فایل ها را به عنوان یک سری بایت و
عادی سازی توالی بایت های خاص به JSON یا XML با تنظیمات رمزگذاری خاص
می تواند به شگفتی منجر شود.

فرمان سرور تولید
اگر از سرور فرمان برای تعامل با Mercurial استفاده می کنید، احتمالاً از یک موجود استفاده می کنید
کتابخانه/API که جزئیات پیاده سازی سرور فرمان را خلاصه می کند. اگر چنین است، این
لایه رابط ممکن است تجزیه را برای شما انجام دهد و کار اجرای آن را برای شما صرفه جویی کند
خودتان.

تولید اصطلاح
دستورات اغلب دارای پرگویی خروجی متفاوتی هستند، حتی زمانی که سبک‌های قابل خواندن ماشین وجود دارند
استفاده می شود (مثلا -T json). اضافه كردن -v/--کلام و - رفع اشکال به آرگومان های فرمان می تواند
میزان داده های در معرض دید مرکوریال را افزایش دهید.

یک راه جایگزین برای به دست آوردن داده های مورد نیازتان، مشخص کردن صریح یک الگو است.

دیگر تاپیک
دوباره تنظیم می کند
مجموعه‌های تجدیدنظر یک زبان پرس و جو کاربردی برای انتخاب مجموعه‌ای از ویرایش‌ها است.
آن را به عنوان SQL برای مخازن Mercurial در نظر بگیرید. Revset ها برای پرس و جو مفید هستند
مخازن برای داده های خاص

دیدن hg کمک دوباره تنظیم می کند برای اطلاعات بیشتر.

سهم گسترش
La سهم افزونه قابلیتی را برای به اشتراک گذاری داده های مخزن در سراسر فراهم می کند
چندین نسخه کار حتی می تواند به طور خودکار ذخیره سازی را به صورت منطقی "استخر" کند
مخازن مرتبط هنگام شبیه سازی

پیکربندی سهم گسترش می تواند منجر به استفاده قابل توجه از منابع شود
کاهش، به ویژه در اطراف فضای دیسک و شبکه. این به ویژه صادق است
برای محیط های ادغام پیوسته (CI).

دیدن hg کمک -e سهم برای اطلاعات بیشتر.

مخازن فرعی

مخازن فرعی به شما امکان می دهند مخازن یا پروژه های خارجی را در Mercurial مادر قرار دهید
مخزن، و دستورات را به صورت گروهی روی آنها عمل کنید.

Mercurial در حال حاضر از مخازن فرعی Mercurial، Git و Subversion پشتیبانی می کند.

مخازن فرعی از سه جزء تشکیل شده اند:

1. تسویه حساب های مخزن تو در تو. آنها می توانند در هر جایی از فهرست کاری والد ظاهر شوند.

2. مراجع مخزن تو در تو. آنها در تعریف شده اند hgsub، که باید در قرار داده شود
ریشه دایرکتوری کاری، و بگویید که تسویه‌حساب‌های مخزن فرعی از کجا آمده‌اند.
مخازن فرعی مرکوریال به شرح زیر است:

path/to/nested = https://example.com/nested/repo/path

زیر مخزن‌های Git و Subversion نیز پشتیبانی می‌شوند:

path/to/nested = [git]git://example.com/nested/repo/path
path/to/nested = [svn]https://example.com/nested/trunk/path

جایی که مسیر/به/تودرتو محل پرداخت نسبت به ریشه Mercurial است،
و https://example.com/nested/repo/path مسیر مخزن منبع است. منبع می تواند
همچنین به یک مسیر سیستم فایل اشاره کنید.

توجه داشته باشید که hgsub به طور پیش فرض در مخازن Mercurial وجود ندارد، شما باید این کار را انجام دهید
قبل از استفاده از مخازن فرعی، آن را ایجاد کرده و به مخزن اصلی اضافه کنید.

3. حالت های مخزن تو در تو. آنها در تعریف شده اند .hgsubstate، که در ریشه قرار می گیرد
دایرکتوری کار، و هر اطلاعاتی را که برای بازیابی مورد نیاز است، ضبط کنید
مخازن فرعی به حالتی که در یک مجموعه تغییرات مخزن والد متعهد شده بودند.
مرکوریال به طور خودکار حالت های مخازن تودرتو را هنگام ارتکاب به ثبت می کند
مخزن والد

توجه داشته باشید
La .hgsubstate فایل نباید به صورت دستی ویرایش شود.

اضافه کردن a مخزن فرعی
If hgsub وجود ندارد، آن را ایجاد کنید و به مخزن والد اضافه کنید. کلون یا پرداخت
پروژه های خارجی که می خواهید آن را در مخزن اصلی زندگی کنید. ویرایش کنید hgsub و
همانطور که در بالا توضیح داده شد، ورودی مخزن فرعی را اضافه کنید. در این مرحله، مخزن فرعی است
ردیابی می شود و commit بعدی وضعیت خود را در آن ثبت می کند .hgsubstate و آن را به
تغییرات متعهد

همگام سازی a مخزن فرعی
Subrepos به طور خودکار آخرین مجموعه تغییرات منابع خود را ردیابی نمی کند. در عوض، آنها
به مجموعه تغییراتی که با مجموعه تغییرات بررسی شده در آن مطابقت دارد، به روز می شوند
تغییرات سطح بالا این به این دلیل است که توسعه دهندگان همیشه مجموعه ای ثابت از کدهای سازگار را دریافت می کنند
و کتابخانه ها وقتی به روز می شوند.

بنابراین، به‌روزرسانی subrepos یک فرآیند دستی است. به سادگی subrepo هدف را در قسمت بررسی کنید
ویرایش مورد نظر، در مخزن سطح بالا تست کنید، سپس در مخزن والد به آن متعهد شوید
ترکیب جدید را ضبط کنید

حذف a مخزن فرعی
برای حذف یک مخزن فرعی از مخزن اصلی، مرجع آن را از آن حذف کنید hgsub,
سپس فایل های آن را حذف کنید.

اثر متقابل با تند دستورات
اضافه کردن add در subrepos تکرار نمی شود مگر اینکه -S/--subrepos مشخص شده باشد. با این حال، اگر
شما مسیر کامل یک فایل را در یک ساب ریپو مشخص می کنید، حتی بدون آن اضافه می شود
-S/--subrepos مشخص شده است. مخازن فرعی براندازی در حال حاضر بی صدا هستند
نادیده گرفته شد

اضافه کردن حذف
adremove به subrepos باز نمی گردد مگر اینکه -S/--subrepos مشخص شده باشد.
با این حال، اگر مسیر کامل یک دایرکتوری را در یک زیر رپو مشخص کنید، addremove will
حتی بدون اینکه -S/--subrepos مشخص شده باشد روی آن اجرا شود. Git و Subversion
مخازن فرعی یک اخطار چاپ می کنند و ادامه می دهند.

بایگانی
بایگانی در مخازن فرعی تکرار نمی شود مگر اینکه -S/--subrepos مشخص شده باشد.

گربه cat در حال حاضر فقط تطابق دقیق فایل ها را در زیر مخزن انجام می دهد. براندازی
مخازن فرعی در حال حاضر نادیده گرفته شده اند.

مرتکب شدن commit یک عکس فوری ثابت از وضعیت کل پروژه و آن ایجاد می کند
مخازن فرعی اگر مخازن فرعی اصلاح شده باشد، Mercurial لغو خواهد شد.
مرکوریال را می‌توان وادار کرد که در عوض تمام مخازن فرعی اصلاح‌شده را با مشخص کردن، متعهد کند
-S/--subrepos یا تنظیم "ui.commitsubrepos=True" در یک فایل پیکربندی (نگاه کنید به hg
کمک پیکربندی). پس از اینکه دیگر هیچ مخزن فرعی اصلاح شده ای وجود نداشت، ضبط می کند
وضعیت آنها را انجام می دهد و در نهایت آن را در مخزن والد انجام می دهد. --addremove
گزینه همچنین گزینه -S/--subrepos را مورد احترام قرار می دهد. با این حال Git و Subversion
مخازن فرعی یک اخطار چاپ می کنند و لغو می کنند.

تفاوت diff در subrepos تکرار نمی شود مگر اینکه -S/--subrepos مشخص شده باشد. تغییرات هستند
به طور معمول در عناصر زیرمخزن نمایش داده می شود. مخازن فرعی براندازی هستند
در حال حاضر بی سر و صدا نادیده گرفته شده است.

فایل ها فایل‌ها به subrepos باز نمی‌گردند مگر اینکه -S/--subrepos مشخص شده باشد. با این حال،
اگر مسیر کامل یک فایل یا دایرکتوری را در یک ساب ریپو مشخص کنید، این خواهد بود
حتی بدون اینکه -S/--subrepos مشخص شده باشد نمایش داده می شود. Git و Subversion
مخازن فرعی در حال حاضر بی سر و صدا نادیده گرفته می شوند.

فراموش کردن فراموش کنید در حال حاضر فقط تطابق دقیق فایل ها را در زیر انبارها کنترل می کند. Git و Subversion
مخازن فرعی در حال حاضر بی سر و صدا نادیده گرفته می شوند.

وارد شونده
incoming در subrepos تکرار نمی شود مگر اینکه -S/--subrepos مشخص شده باشد. گیت و
مخازن فرعی براندازی در حال حاضر بی سر و صدا نادیده گرفته می شوند.

برونگرا
خروجی در subrepos تکرار نمی شود مگر اینکه -S/--subrepos مشخص شده باشد. گیت و
مخازن فرعی براندازی در حال حاضر بی سر و صدا نادیده گرفته می شوند.

کشیدن pull بازگشتی نیست زیرا مشخص نیست قبل از اجرا چه چیزی را بکشید hg به روز رسانی
. فهرست کردن و بازیابی تمام تغییرات مخازن فرعی که توسط والد ارجاع شده است
تغییرات کشیده شده از مخزن در بهترین حالت گران است و در Subversion غیرممکن است
مورد.

فشار Mercurial به طور خودکار تمام مخازن فرعی را در ابتدا در زمانی که والد تحت فشار قرار می دهد، فشار می دهد
مخزن در حال فشار دادن است. این تضمین می کند که تغییرات زیر مخزن جدید در دسترس هستند
هنگامی که توسط مخازن سطح بالا ارجاع داده می شود. Push برای براندازی غیر فعال است
مخازن فرعی

وضعیت وضعیت به مخازن فرعی باز نمی گردد مگر اینکه -S/--subrepos مشخص شده باشد.
تغییرات مخزن فرعی به صورت تغییرات مرکوری معمولی بر روی نمایش داده می شود
عناصر مخزن فرعی مخازن فرعی براندازی در حال حاضر بی سر و صدا نادیده گرفته می شوند.

برداشتن remove به مخازن فرعی باز نمی گردد مگر اینکه -S/--subrepos مشخص شده باشد.
با این حال، اگر یک مسیر فایل یا دایرکتوری را در یک زیر رپو مشخص کنید، حذف خواهد شد
حتی بدون -S/--subrepos. مخازن فرعی Git و Subversion در حال حاضر هستند
بی صدا نادیده گرفته شد

به روز رسانی به‌روزرسانی، مخزن‌های فرعی را در حالتی که در ابتدا در هدف قرار گرفته بودند، بازیابی می‌کند
تغییرات مجموعه اگر مجموعه تغییرات ثبت شده در مخزن فرعی فعلی موجود نباشد،
Mercurial قبل از به‌روزرسانی، ابتدا آن را وارد می‌کند. این بدان معنی است که به روز رسانی می تواند
هنگام استفاده از مخازن فرعی نیاز به دسترسی به شبکه دارد.

بازگرداندن مخازن فرعی منابع
مکان منبع مخزن فرعی ممکن است در طول عمر پروژه تغییر کند و مراجع را باطل کند
در تاریخچه مخزن والد ذخیره می شود. برای رفع این مشکل، قوانین بازنویسی را می توان در آن تعریف کرد
مخزن والد hgrc فایل یا در پیکربندی Mercurial. را ببینید [زیر مسیرها] بخش در
hgrc(5) برای جزئیات بیشتر.

قالب طریقه استفاده

Mercurial به شما امکان می دهد خروجی دستورات را از طریق قالب ها سفارشی کنید. شما هم می توانید
در یک الگو بفرستید یا یک الگوی سبک موجود را از خط فرمان انتخاب کنید
گزینه --template.

می‌توانید خروجی را برای هر دستور «log مانند» سفارشی کنید: ورود، خروجی، ورودی، نوک،
والدین و سران

برخی از سبک های داخلی با مرکوریال بسته بندی شده اند. اینها را می توان با فهرست کرد hg ورود به سیستم
--قالب فهرست. مثال استفاده:

$ hg log -r1.0::1.1 - تغییرات الگو

یک الگو یک قطعه متن است که دارای نشانه گذاری برای فراخوانی بسط متغیر است:

$ hg log -r1 --template "{node}\n"
b56ce7b07c52de7d5fd79fb89701ea538af65746

رشته ها در بریس های فرفری کلمات کلیدی نامیده می شوند. در دسترس بودن کلمات کلیدی به این بستگی دارد
زمینه دقیق قالب این کلمات کلیدی معمولاً برای الگوسازی در دسترس هستند
دستور log مانند:

نشانک فعال
رشته نشانک فعال، اگر با تغییرات مرتبط باشد

نویسنده رشته نویسنده تغییرناپذیر مجموعه تغییرات.

بیتکت رشته وضعیت تقسیم بندی تغییرات.

بوک مارک ها
لیست رشته ها هر نشانک مرتبط با مجموعه تغییرات. همچنین "فعال" را تنظیم می کند،
نام نشانک فعال

شاخه رشته نام شاخه ای که تغییرات در آن انجام شده است.

تغییراتسینسلاتگ
عدد صحیح همه اجداد در آخرین برچسب نیستند.

فرزندان
لیست رشته ها بچه های تغییرات.

تاریخ اطلاعات تاریخ تاریخ انجام تغییرات مجموعه.

نزولی رشته متن توضیحات تغییرات.

دفستات
رشته آمار تغییرات با فرمت زیر: "فایل های اصلاح شده:
خطوط +added/-removed"

موضوعات فهرست دیکته‌ها با کلید، ورودی‌های مقدار فیلد «اضافی» این تغییرات.

file_adds
لیست رشته ها فایل های اضافه شده توسط این تغییرات.

file_copies
لیست رشته ها فایل های کپی شده در این تغییرات با منابع خود.

file_copies_switch
لیست رشته ها مانند "file_copies" اما تنها در صورتی نمایش داده می شود که سوئیچ --copied باشد
تنظیم شده است.

file_dels
لیست رشته ها فایل‌هایی که توسط این تغییرات حذف شدند.

file_mods
لیست رشته ها فایل های اصلاح شده توسط این تغییرات.

فایل ها لیست رشته ها همه فایل‌های اصلاح شده، اضافه یا حذف شده توسط این تغییرات.

گره گراف
رشته کاراکتری که گره تغییرات مجموعه را در یک گراف بازبینی ASCII نشان می دهد

آخرین برچسب
لیست رشته ها برچسب‌های جهانی بر روی جدیدترین اجداد برچسب‌گذاری شده جهانی
این تغییرات

آخرین تگ فاصله
عدد صحیح طولانی ترین مسیر تا آخرین تگ.

فضای نام ها
دستور لیست ها نام های پیوست شده به این مجموعه تغییرات در هر فضای نام.

گره رشته هش شناسایی تغییرات مجموعه، به عنوان یک رشته 40 رقمی هگزادسیمال.

p1node رشته هش شناسایی والد اول تغییرات مجموعه، به صورت 40 رقمی
رشته هگزادسیمال اگر مجموعه تغییرات فاقد والدین باشد، همه ارقام 0 هستند.

p1rev عدد صحیح شماره بازبینی مخزن-محلی اولین والد مجموعه تغییرات، یا
-1 اگر تغییرات مجموعه فاقد والدین باشد.

p2node رشته هش شناسایی والد دوم تغییرات مجموعه به صورت 40 رقمی است
رشته هگزادسیمال اگر مجموعه تغییرات والد دوم نداشته باشد، همه ارقام 0 هستند.

p2rev عدد صحیح شماره بازبینی مخزن-محلی والد دوم تغییرات مجموعه، یا
-1 اگر مجموعه تغییرات والد دوم نداشته باشد.

پدر و مادر
لیست رشته ها والدین تغییرات در قالب "rev:node". اگر
تغییرات ست فقط یک والد "طبیعی" دارد (نسخه قبلی) هیچ چیز نیست
نشان داده شده.

فاز رشته نام فاز تغییرات مجموعه.

فازیدکس
عدد صحیح شاخص فاز تغییرات.

احیای عدد صحیح شماره ویرایش مخزن-محلی تغییرات مجموعه.

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

برچسب ها لیست رشته ها هر برچسب مرتبط با تغییرات.

کلمه کلیدی "تاریخ" خروجی قابل خواندن برای انسان تولید نمی کند. اگر می خواهید از تاریخ استفاده کنید
خروجی شما، می توانید از یک فیلتر برای پردازش آن استفاده کنید. فیلترها توابعی هستند که a را برمی‌گردانند
رشته بر اساس متغیر ورودی. مطمئن شوید که در ابتدا از فیلتر stringify استفاده کنید
اعمال یک فیلتر ورودی رشته ای به متغیر ورودی لیست مانند. شما همچنین می توانید از یک زنجیره استفاده کنید
فیلترها برای به دست آوردن خروجی مورد نظر:

$ hg tip --template "{date|isodate}\n"
2008-08-21 18:22 +0000

لیست فیلترها:

افزونه ها
هر متنی یک XHTML اضافه کنید " "قبل از پایان هر خط به جز آخرین خط را تگ کنید.

سن تاریخ. یک تفاوت تاریخ/زمان قابل خواندن توسط انسان بین تاریخ/زمان داده شده و
تاریخ/زمان فعلی

نام اصلی
هر متنی متن را به عنوان یک مسیر در نظر می گیرد و آخرین جزء مسیر را برمی گرداند
پس از تقسیم توسط جداکننده مسیر (نادیده گرفتن جداکننده های دنباله دار). مثلا،
«فو/بار/باز» به «باز» و «فو/بار//» به «بار» تبدیل می شود.

تعداد دفعات مشاهده فهرست یا متن طول را به صورت یک عدد صحیح برمی گرداند.

دامنه هر متنی اولین رشته ای که شبیه آدرس ایمیل است را پیدا کرده و استخراج می کند
فقط جزء دامنه مثال: کاربر <[ایمیل محافظت شده]> شود example.com.

پست الکترونیک هر متنی اولین رشته ای که شبیه آدرس ایمیل است را استخراج می کند. مثال: کاربر
<[ایمیل محافظت شده]> شود [ایمیل محافظت شده].

کاربر ایمیل
هر متنی بخش کاربری یک آدرس ایمیل را برمی گرداند.

فرار هر متنی کاراکترهای خاص XML/XHTML "&"، "<" و ">" را با XML جایگزین می کند
موجودیت ها، و کاراکترهای NUL را فیلتر می کند.

پر کردن 68 هر متنی متن را در 68 ستون قرار می دهد.

پر کردن 76 هر متنی متن را در 76 ستون قرار می دهد.

خط اول
هر متنی خط اول متن را برمی گرداند.

هگزا هر متنی یک شناسه گره مرکوریال باینری را به هگزادسیمال طولانی آن تبدیل کنید
نمایندگی.

hgdate تاریخ. تاریخ را به صورت یک جفت اعداد برمی گرداند: "1157407993 25200" (مهر زمانی یونیکس،
افست منطقه زمانی).

ایزودا
تاریخ. تاریخ را در قالب ISO 8601 برمی گرداند: "2009-08-18 13:00 +0200".

isodatesec
تاریخ. تاریخ را در قالب ISO 8601، شامل ثانیه برمی گرداند: "2009-08-18 13:00:13
0200+". همچنین فیلتر rfc3339date را ببینید.

کاهش هر متنی متن را به حروف کوچک تبدیل می کند.

خالی
هر متنی اگر رشته خالی باشد «(هیچ)» را برمی‌گرداند.

مبهم
هر متنی متن ورودی ارائه شده به عنوان دنباله ای از موجودیت های XML را برمی گرداند.

شخص هر متنی نام را قبل از یک آدرس ایمیل برمی گرداند و آن را مطابق با RFC تفسیر می کند
5322.

revescape
هر متنی از همه کاراکترهای "ویژه" به جز @ فرار می کند. اسلش های رو به جلو حذف می شوند
دو بار برای جلوگیری از فرار پیش از موعد وب سرورها. به عنوان مثال، "@foo
bar/baz" به "@foo%20bar%252Fbaz" تبدیل می شود.

تاریخ rfc3339
تاریخ. تاریخ را با استفاده از قالب تاریخ اینترنت مشخص شده در RFC 3339 برمی گرداند:
"2009-08-18T13:00:13+02:00".

تاریخ rfc822
تاریخ. تاریخ را با استفاده از همان قالب استفاده شده در سرصفحه های ایمیل برمی گرداند: "Tue, 18 Aug 2009
13:00:13 +0200".

کوتاه هش را تغییر دهید. شکل کوتاه یک هش changeset، یعنی 12 هگزادسیمال را برمی گرداند
رشته رقمی

برش کوتاه
هر متنی درمان می کند متن به عنوان یک وضعیت دو بخش، و یک کاراکتر را برمی گرداند
نشان دهنده وضعیت (G: خوب، B: بد، S: نادیده گرفته شده، U: آزمایش نشده، I: نادیده گرفته شده).
اگر فضای تک را برمی گرداند متن وضعیت دوبخشی معتبر نیست.

تاریخ کوتاه
تاریخ. تاریخی مانند "2006-09-18" را برمی گرداند.

خطوط تقسیم شده
هر متنی متن را به لیستی از خطوط تقسیم کنید.

رشته کردن
هر نوعی. با تبدیل مقادیر به متن، مقدار را به متن تبدیل می کند و
به هم پیوستن آنها

stripdir
متن را به عنوان مسیر در نظر بگیرید و در صورت امکان سطح دایرکتوری را حذف کنید. به عنوان مثال، "فو"
و «فو/بار» به «فو» تبدیل می شود.

تابیده
هر متنی متن را باز می گرداند، با هر خط غیر خالی به جز اولین شروع
با کاراکتر تب

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

urlescape
هر متنی از همه شخصیت های "خاص" فرار می کند. مثلا «فو بار» می شود
"foo%20bar".

کاربر هر متنی نمایش کوتاهی از نام کاربری یا آدرس ایمیل را برمی‌گرداند.

توجه داشته باشید که یک فیلتر چیزی بیش از یک فراخوانی تابع نیست expr|فیلتر معادل است
به فیلتر (expr).

علاوه بر فیلترها، برخی از عملکردهای اساسی داخلی وجود دارد:

تاریخ(تاریخ[, fmt])
یک تاریخ را قالب بندی کنید دیدن hg کمک تاریخ برای قالب بندی رشته ها پیش فرض تاریخ یونیکس است
قالب، از جمله منطقه زمانی: "Mon Sep 04 15:13:13 2006 0700".

diff([شامل الگو [, الگوی استثنا]])
نمایش یک تفاوت، به صورت اختیاری مشخص کردن فایل‌ها برای گنجاندن یا حذف کردن.

پر کردن(متن[, عرض[، نام اولیه[, آویزان]]])
بسیاری از پاراگراف ها را با تورفتگی اختیاری پر کنید. فیلتر «پر» را ببینید.

گرفتن (دیکته، کلید)
یک ویژگی/کلید از یک شیء دریافت کنید. برخی از کلمات کلیدی انواع پیچیده ای هستند. این تابع
به شما اجازه می دهد تا مقدار یک ویژگی را در این انواع بدست آورید.

if(expr, سپس[، دیگر])
به صورت مشروط بر اساس نتیجه یک عبارت اجرا کنید.

ifcontains(جستجو، چیز، سپس[، دیگر])
بر اساس اینکه آیا مورد "جستجو" در "چیز" است یا نه، به صورت مشروط اجرا کنید.

ifeq(expr1, expr2، سپس[، دیگر])
به صورت مشروط بر اساس معادل بودن 2 مورد اجرا کنید.

تورفتگی(متن، indentchars[, خط اول])
تمام خطوط غیر خالی را با کاراکترهای داده شده در رشته indentchars تورفتگی می کند. یک
پارامتر سوم اختیاری تورفتگی خط اول را فقط در صورتی لغو می کند
حاضر.

پیوستن (فهرست، سپتامبر)
موارد را در یک لیست با یک جداکننده بپیوندید.

برچسب (برچسب، expr)
یک برچسب به محتوای تولید شده اعمال کنید. محتوای دارای برچسب اعمال شده می تواند منجر به این شود
پس پردازش اضافی، مانند رنگ آمیزی خودکار.

آخرین برچسب ([الگو])
برچسب‌های جهانی با الگوی داده شده در جدیدترین برچسب‌های جهانی مطابقت دارند
اجداد این تغییرات.

تاریخ محلی(تاریخ[, tz])
تاریخ را به منطقه زمانی مشخص شده تبدیل می کند. پیش فرض تاریخ محلی است.

پد(متن، عرض[، fillchar=' '[, درست = نادرست]])
متن پد با کاراکتر پر.

revset(query[, قالب بندی...])
یک پرس و جو مجموعه بازبینی را اجرا کنید. دیدن hg کمک تنظیم مجدد.

rstdoc(متن، سبک)
ReStructuredText را قالب بندی کنید.

کوتاهترین(گره، Minlength=4)
کوتاه ترین نمایش گره را بدست آورید.

شروع با(الگو، متن)
اگر آرگومان "text" با محتوایی از the شروع شود، مقدار را برمی‌گرداند
استدلال "الگو".

نوار(متن[, کاراکترها])
کاراکترهای یک رشته را حذف کنید. به‌طور پیش‌فرض، همه موارد پیشرو و انتهایی را حذف می‌کند
فضای سفید.

زیر(الگو، جایگزینی، اصطلاح)
جایگزینی متن را با استفاده از عبارات منظم انجام دهید.

کلمه (تعداد، متن[, جداکننده])
کلمه n را از یک رشته برگردانید.

همچنین، برای هر عبارتی که یک لیست را برمی گرداند، یک عملگر لیست وجود دارد:

expr % "{template}"

همانطور که در مثال بالا مشاهده می شود، {قالب} به عنوان یک الگو تفسیر می شود. برای جلوگیری از آن
در حال تفسیر، می توانید از یک کاراکتر فرار استفاده کنید \{ یا یک پیشوند رشته خام، r'...'.

چند نمونه از الگوهای خط فرمان:

· قالب بندی لیست ها، به عنوان مثال فایل ها:

$ hg log -r 0 --template "files:\n{files % ' {file}\n'}"

· به لیست فایل ها با علامت "، " بپیوندید:

$ hg log -r 0 --template "files: {join(files, ',')}\n"

هر خط از توضیحات commit را اصلاح کنید:

$ hg log --template "{splitlines(desc) % '**** {line}\n'}"

· تاریخ قالب بندی:

$ hg log -r 0 --template "{date(date, '%Y')}\n"

تاریخ نمایش در UTC:

$ hg log -r 0 --template "{localdate(date, 'UTC')|date}\n"

· خروجی توصیف تنظیم شده به عرض پر 30:

$ hg log -r 0 --template "{fill(desc, 30)}"

· از یک شرطی برای آزمایش شاخه پیش فرض استفاده کنید:

$ hg log -r 0 --template "{ifeq(شاخه، 'پیش فرض'، 'در شعبه اصلی'،
'در شعبه {شاخه}')}\n"

· در صورت خالی نبودن یک خط جدید اضافه کنید:

$ hg tip --template "{if(author, '{author}\n')}"

· خروجی را برای استفاده با پسوند رنگ برچسب بزنید:

$ hg log -r 0 --template "{label('changeset.{phase}', node|short)}\n"

· فیلتر خط اول، یعنی همه چیز به جز خط اول را معکوس کنید:

$ hg log -r 0 --template "{sub(r'^.*\n?\n?', '', desc)}\n"

· نمایش محتویات فیلد «اضافی»، یکی در هر خط:

$ hg log -r 0 --template "{join(extras, '\n')}\n"

· نشانک فعال را با "*" علامت گذاری کنید:

$ hg log --template "{bookmarks % '{bookmark}{ifeq(bookmark, active, '*')} '}\n"

· تگ نامزد انتشار قبلی، فاصله و تغییرات از تگ را بیابید:

$ hg log -r . --template "{latesttag('re:^.*-rc$') % '{tag}, {changes}, {distance}'}\n"

· والد کپی کار را با "@" علامت گذاری کنید:

$ hg log --template "{ifcontains(rev, revset('.'), '@')}\n"

· نمایش جزئیات اصلاحات والدین:

$ hg log --template "{revset('parents(%d)', rev) % '{desc|firstline}\n'}"

· فقط توضیحات commit را نشان دهید که با "الگو" شروع می شوند:

$ hg log --template "{startswith('template', firstline(desc))}\n"

· اولین کلمه هر خط از یک پیام commit را چاپ کنید:

$ hg log --template "{word(0, desc)}\n"

URL راه ها

URL های معتبر به شکل زیر هستند:

local/filesystem/path[#revision]
file://local/filesystem/path[#revision]
http://[user[:pass]@]host[:port]/[path][#revision]
https://[user[:pass]@]host[:port]/[path][#revision]
ssh://[user@]host[:port]/[path][#revision]

مسیرها در سیستم فایل محلی می توانند به مخازن مرکوریال یا باندل اشاره کنند
فایل ها (همانطور که توسط hg بسته or hg وارد شونده --دسته) همچنین ببینید hg کمک راه ها.

یک شناسه اختیاری بعد از # نشان دهنده یک شاخه، تگ یا مجموعه تغییرات خاص برای استفاده است
از مخزن راه دور همچنین ببینید hg کمک تجدید نظر.

برخی از ویژگی ها، مانند فشار دادن به آدرس های http:// و https:// تنها در صورتی امکان پذیر است که
این ویژگی به صراحت در سرور مرکوریال راه دور فعال شده است.

توجه داشته باشید که امنیت URL های HTTPS به پیکربندی مناسب web.cacerts بستگی دارد.

چند نکته در مورد استفاده از SSH با Mercurial:

· SSH به یک حساب پوسته قابل دسترسی در دستگاه مقصد و یک کپی از hg نیاز دارد
مسیر راه دور یا با عنوان remotecmd مشخص شده است.

· مسیر به طور پیش فرض نسبت به فهرست اصلی کاربر راه دور است. از یک اسلش اضافی در استفاده کنید
شروع یک مسیر برای تعیین یک مسیر مطلق:

ssh://example.com//tmp/repository

Mercurial از فشرده سازی خود از طریق SSH استفاده نمی کند. کار درست این است که پیکربندی کنید
آن را در شما ~ / .ssh / پیکربندی، به عنوان مثال:

میزبان *.mylocalnetwork.example.com
شماره فشرده سازی
میزبان *
فشرده سازی بله

یا "ssh -C" را به عنوان دستور ssh خود در فایل پیکربندی خود یا با
گزینه خط فرمان --ssh.

همه این URL ها می توانند در فایل پیکربندی شما با نام مستعار مسیر در زیر ذخیره شوند
بخش [مسیرها] مانند این:

[راه ها]
نام مستعار1 = URL1
نام مستعار2 = URL2
...

سپس می توانید از نام مستعار برای هر دستوری که از URL استفاده می کند استفاده کنید (مثلا hg کشیدن نام مستعار 1
به عنوان رفتار خواهد شد hg کشیدن URL1).

دو نام مستعار مسیر خاص هستند زیرا زمانی که شما آن را ارائه نمی کنید به عنوان پیش فرض استفاده می شوند
URL به یک دستور:

پیش فرض:
هنگامی که یک مخزن با کلون hg ایجاد می کنید، دستور clone مکان را ذخیره می کند
مخزن منبع به عنوان مسیر "پیش فرض" مخزن جدید. سپس از این استفاده می شود
وقتی مسیر را از دستورات فشاری و کششی (از جمله ورودی و.) حذف می کنید
برونگرا).

پیش فرض فشار:
دستور push به دنبال مسیری به نام "default-push" می گردد و آن را به آن ترجیح می دهد
"پیش فرض" اگر هر دو تعریف شده باشند.

حرکات

این بخش حاوی راهنمایی برای برنامه های افزودنی است که همراه با Mercurial توزیع شده اند.
راهنما برای سایر برنامه های افزودنی در سیستم راهنما موجود است.

لیگ قهرمانان آسیا
قلاب هایی برای کنترل دسترسی به مخزن

این قلاب اجازه یا رد دسترسی نوشتن به شاخه ها و مسیرهای داده شده a را ممکن می سازد
مخزن هنگام دریافت تغییرات ورودی از طریق pretxnchangegroup و pretxncommit.

مجوز بر اساس نام کاربری محلی در سیستمی که در آن قلاب است مطابقت داده می شود
اجرا می شود، و نه committer تغییرات اصلی (چون دومی صرفاً است
آموزنده).

قلاب acl به بهترین وجه همراه با یک پوسته محدود مانند hgsh استفاده می شود که از آن جلوگیری می کند
احراز هویت کاربران از انجام هر کاری غیر از فشار دادن یا کشیدن. قلاب نیست
در صورتی که کاربران دسترسی به پوسته تعاملی داشته باشند، قابل استفاده نیست، زیرا می توانند قلاب را غیرفعال کنند. نه
آیا اگر کاربران راه دور یک حساب به اشتراک بگذارند، ایمن است، زیرا در این صورت هیچ راهی برای تشخیص وجود ندارد
آنها.

ترتیب انجام بررسی های دسترسی به این صورت است:

1. لیست رد برای شعب (بخش acl.ny.branches)

2. لیست را برای شاخه ها مجاز کنید (بخش acl.allow.branches)

3. لیست مسیرها را رد کنید (بخش انکار)

4. لیست مسیرها را مجاز کنید (بخش acl.allow)

بخش های مجاز و رد جفت های کلید-مقدار می گیرند.

شعبه محور دسترسی کنترل
استفاده از acl.ny.branches و acl.allow.branches بخش هایی برای دسترسی مبتنی بر شعبه
کنترل. کلیدهای این بخش ها می توانند به صورت زیر باشند:

· نام شعبه، یا

· یک ستاره، برای مطابقت با هر شاخه.

مقادیر مربوطه می تواند یکی از این موارد باشد:

· یک لیست جدا شده با کاما حاوی کاربران و گروه ها، یا

· یک ستاره، برای مطابقت با هر کسی.

شما می توانید "!" پیشوند نام کاربری یا گروه برای معکوس کردن حس تطابق.

مبتنی بر مسیر دسترسی کنترل
استفاده از انکار و acl.allow بخش هایی برای کنترل دسترسی مبتنی بر مسیر. کلید در این
بخش ها یک الگوی زیردرخت را می پذیرند (به طور پیش فرض با یک نحو glob). مربوطه
مقادیر از دستوری مشابه سایر بخش های بالا پیروی می کنند.

گروه ها
نام گروه ها باید با یک پیشوند باشد @ نماد. تعیین نام گروه نیز همین اثر را دارد
همانطور که تمام کاربران آن گروه را مشخص می کند.

می توانید اعضای گروه را در قسمت تعریف کنید acl.groups بخش. اگر نام گروهی تعریف نشده باشد
در آنجا، و Mercurial تحت یک سیستم مشابه یونیکس در حال اجرا است، لیست کاربران گرفته خواهد شد
از سیستم عامل در غیر این صورت استثناء مطرح می شود.

مثال پیکر بندی
[قلاب]

# اگر می‌خواهید محدودیت‌های دسترسی را در زمان commit بررسی کنید، از این استفاده کنید
pretxncommit.acl = python:hgext.acl.hook

# اگر می‌خواهید محدودیت‌های دسترسی را برای کشیدن، فشار دادن، بررسی کنید، از این استفاده کنید.
# بسته بندی کنید و سرو کنید.
pretxnchangegroup.acl = پایتون:hgext.acl.hook

[acl]
# اجازه یا رد دسترسی برای تغییرات دریافتی تنها در صورتی که منبع آنها باشد
# در اینجا فهرست شده است، اجازه دهید آنها را در غیر این صورت عبور دهند. منبع "خدمت" برای همه است
# دسترسی از راه دور (http یا ssh)، "فشار"، "کشیدن" یا "بسته" زمانی که
# دستورات مرتبط به صورت محلی اجرا می شوند.
# پیش فرض: خدمت
منابع = خدمت

[acl.deny.branches]

# همه از شعبه یخ زده محروم می شوند:
شاخه منجمد = *

# کاربر بد در همه شعبه ها رد می شود:
* = کاربر بد

[acl.allow.branches]

# چند کاربر مجاز به شعبه a هستند:
شعبه-a = کاربر-1، کاربر-2، کاربر-3

# فقط یک کاربر در شاخه b مجاز است:
branch-b = user-1

# کاربر فوق العاده در هر شعبه مجاز است:
* = کاربر فوق العاده

# همه مجاز به شرکت در شعبه برای آزمون هستند:
شاخه برای آزمون = *

[acl.deny]
# این لیست ابتدا بررسی می شود. اگر مطابقت پیدا شد، acl.allow نیست
# بررسی شد. اگر acl.deny وجود نداشته باشد به همه کاربران اجازه دسترسی داده می شود.
# قالب برای هر دو لیست: الگوی گلوب = کاربر، ...، گروه @، ​​...

# برای مطابقت با همه، از یک ستاره برای کاربر استفاده کنید:
# my/glob/pattern = *

# user6 به هیچ فایلی دسترسی نوشتن نخواهد داشت:
** = user6

# گروه "hg-denied" به هیچ فایلی دسترسی نوشتن نخواهد داشت:
** = @hg-denied

# با وجود این، هیچ کس نمی تواند "DONT-TOUCH-THIS.txt" را تغییر دهد
# همه می توانند همه فایل های دیگر را تغییر دهند. زیر را ببینید.
src/main/resources/DONT-TOUCH-THIS.txt = *

[acl.allow]
# اگر acl.allow وجود نداشته باشد، همه کاربران به طور پیش فرض مجاز هستند
# خالی acl.allow = هیچ کاربری مجاز نیست

# کاربر "doc_writer" به هر فایلی در زیر "docs" دسترسی نوشتن دارد.
# پوشه:
docs/** = doc_writer

# کاربر "جک" و گروه "طراحان" دسترسی نوشتن به هر فایلی دارند
# در زیر پوشه "تصاویر":
images/** = جک، @designers

# همه (به جز "user6" و "@hg-denied" - acl.deny را در بالا ببینید)
# به هر فایلی که در پوشه "Resources" قرار دارد دسترسی نوشتن خواهد داشت
# (به جز 1 فایل. به acl.deny مراجعه کنید):
src/main/resources/** = *

hgtags = release_engineer

مثال ها با استفاده از la ! پیشوند
فرض کنید شاخه ای وجود دارد که فقط یک کاربر (یا گروه) باید بتواند به آن فشار وارد کند، و
شما نمی خواهید دسترسی به شاخه دیگری را که ممکن است ایجاد شود محدود کنید.

"!" پیشوند به شما امکان می دهد از فشار دادن هر کسی به جز یک کاربر یا گروه معین جلوگیری کنید
در یک شاخه یا مسیر مشخص تغییر می کند.

در مثال‌های زیر، ما موارد زیر را انجام خواهیم داد: 1) دسترسی به شاخه "ring" را به هر کسی غیر از کاربر منع می‌کنیم
"gollum" 2) دسترسی به شاخه "دریاچه" را برای هر کسی غیر از اعضای گروه "هابیت" 3) ممنوع کنید.
امتناع از دسترسی به فایل برای هر کسی به جز کاربر "gollum"

[acl.allow.branches]
# خالی

[acl.deny.branches]

# 1) فقط 'gollum' می تواند به شاخه 'ring' متعهد شود.
# 'gollum' و هر کس دیگری همچنان می تواند به هر شاخه دیگری متعهد شود.
حلقه = !gollum

# 2) فقط اعضای گروه "هابیت" می توانند به شاخه "دریاچه" متعهد شوند.
# اعضای "هابیت" و هر کس دیگری همچنان می تواند به هر شاخه دیگری متعهد شود.
دریاچه = !@hobbit

# همچنین می توانید بر اساس مسیرهای فایل دسترسی را رد کنید:

[acl.allow]
# خالی

[acl.deny]
# 3) فقط 'gollum' می تواند فایل زیر را تغییر دهد.
# 'gollum' و هر کس دیگری همچنان می تواند هر فایل دیگری را تغییر دهد.
/mysty/mountains/cave/ring = !gollum

جعبه سیاه
رویدادهای مخزن را برای اشکال زدایی در یک جعبه سیاه ثبت کنید

اطلاعات رویداد را به .hg/blackbox.log ثبت می کند تا به اشکال زدایی و تشخیص مشکلات کمک کند. در
رویدادهایی که ثبت می شوند را می توان از طریق کلید پیکربندی blackbox.track پیکربندی کرد. مثال ها:

[جعبه سیاه]
آهنگ = *

[جعبه سیاه]
track = command، commandfinish، commandexception، exthook، pythonhook

[جعبه سیاه]
آهنگ = ورودی

[جعبه سیاه]
# اندازه یک فایل گزارش را محدود کنید
حداکثر حجم = 1.5 مگابایت
# وقتی فایل لاگ فعلی خیلی بزرگ شد، تا N بچرخانید
حداکثر فایل = 3

دستورات
جعبه سیاه
مشاهده رویدادهای مخزن اخیر:

جعبه سیاه hg [OPTION]...

مشاهده رویدادهای مخزن اخیر

گزینه های ارسال:

-ل،--حد
تعداد رویدادها برای نمایش (پیش‌فرض: 10)

بوگزیلا
قلاب هایی برای ادغام با ردیاب اشکال Bugzilla

این افزونه قلاب نظراتی را در مورد اشکالات در Bugzilla هنگام تغییر مجموعه‌هایی که به اشکالات اشاره می‌کنند اضافه می‌کند
توسط Bugzilla ID دیده می شوند. نظر با استفاده از مکانیزم الگوی Mercurial قالب‌بندی می‌شود.

ارجاعات باگ می توانند به صورت اختیاری شامل به روز رسانی ساعت های صرف شده برای Bugzilla باشند
کار بر روی اشکال اشکالات را نیز می توان ثابت کرد.

سه حالت اصلی دسترسی به Bugzilla ارائه شده است:

1. دسترسی از طریق رابط Bugzilla XMLRPC. به Bugzilla 3.4 یا بالاتر نیاز دارد.

2. داده ها را از طریق رابط Bugzilla XMLRPC بررسی کنید و تغییرات اشکال را از طریق ایمیل به آن ارسال کنید
رابط ایمیل Bugzilla. به Bugzilla 3.4 یا بالاتر نیاز دارد.

3. نوشتن مستقیم در پایگاه داده Bugzilla. فقط نصب های Bugzilla با استفاده از MySQL هستند
پشتیبانی. به MySQLdb پایتون نیاز دارد.

نوشتن مستقیم در پایگاه داده مستعد تغییرات طرحواره است و بر a متکی است
اسکریپت Bugzilla برای ارسال ایمیل‌های اعلان تغییر اشکال. این اسکریپت به صورت اجرا می شود
کاربری که Mercurial را اجرا می کند، باید روی هاست با نصب Bugzilla اجرا شود، و
برای خواندن جزئیات پیکربندی Bugzilla و کاربر ضروری MySQL به مجوز نیاز دارد
و رمز عبور برای داشتن حقوق دسترسی کامل به پایگاه داده Bugzilla. به این دلایل این
حالت دسترسی اکنون منسوخ شده در نظر گرفته می شود و برای Bugzilla جدید به روز نمی شود
نسخه های آینده فقط افزودن نظرات در این حالت دسترسی پشتیبانی می شود.

دسترسی از طریق XMLRPC نیاز به نام کاربری و رمز عبور Bugzilla دارد که باید در آن مشخص شود
پیکربندی نظرات زیر آن نام کاربری اضافه می شود. از آنجایی که پیکربندی باید باشد
قابل خواندن توسط تمامی کاربران مرکوریال، توصیه می شود که حقوق آن کاربر باشد
در Bugzilla به حداقل لازم برای افزودن نظرات محدود شده است. اشکالات علامت گذاری رفع شد
به Bugzilla 4.0 و بالاتر نیاز دارد.

دسترسی از طریق XMLRPC/ایمیل از XMLRPC برای درخواست Bugzilla استفاده می کند، اما ایمیل را به Bugzilla ارسال می کند.
رابط ایمیل برای ارسال نظرات به اشکالات. آدرس From: در ایمیل به روی تنظیم شده است
آدرس ایمیل کاربر Mercurial، بنابراین به نظر می رسد نظر از Mercurial آمده است
کاربر. در صورتی که ایمیل کاربر Mercurial توسط Bugzilla به عنوان یک مورد شناسایی نشود
کاربر Bugzilla، ایمیل مرتبط با نام کاربری Bugzilla که برای ورود به Bugzilla استفاده می شود
به جای آن به عنوان منبع نظر استفاده می شود. علامت گذاری اشکالات ثابت کار می کند در همه پشتیبانی می شود
نسخه های Bugzilla

موارد پیکربندی مشترک برای همه حالت‌های دسترسی:

نسخه bugzilla
نوع دسترسی برای استفاده ارزش های شناسایی شده عبارتند از:

xmlrpc

رابط Bugzilla XMLRPC.

xmlrpc + ایمیل

Bugzilla XMLRPC و رابط های ایمیل.

3.0

دسترسی MySQL، Bugzilla 3.0 و بالاتر.

2.18

دسترسی MySQL، Bugzilla 2.18 و بالاتر، اما شامل 3.0 نیست.

2.16

دسترسی MySQL، Bugzilla 2.16 و بالاتر، اما شامل 2.18 نیست.

bugzilla.regexp
عبارت منظم برای مطابقت با شناسه های اشکال برای به روز رسانی در پیام commit تغییرات. آی تی
باید دارای یک گروه با نام "()" باشد حاوی شناسه های اشکال جدا شده توسط
کاراکترهای غیر رقمی همچنین ممکن است شامل یک گروه با نام باشد با یک
عدد ممیز شناور که ساعات کار روی باگ را نشان می دهد. اگر هیچ گروه نامی وجود ندارد
در حال حاضر، اولین گروه "()" حاوی شناسه های باگ است و زمان کار این است
بروزرسانی نشده. عبارت پیش فرض مطابقت دارد اشکال 1234, اشکال نه. 1234, اشکال عدد
1234, اشکالات 1234,5678, اشکال 1234 و 5678 و تغییرات آن، به دنبال آن
شماره ساعت پیشوند توسط h or ساعت، به عنوان مثال ساعت 1.5. تطبیق به حروف بزرگ و کوچک حساس نیست.

bugzilla.fixregexp
عبارت منظم برای مطابقت با شناسه‌های اشکال برای علامت‌گذاری ثابت شده در پیام commit تغییرات.
این باید حاوی یک گروه با نام "()" باشد ` حاوی la اشکال شناسه جدا از هم by
غیر رقمی کاراکتر باشد. It ممکن است همچنین شامل a تحت عنوان گروه `` با یک
عدد ممیز شناور که ساعات کار روی باگ را نشان می دهد. اگر هیچ گروه نامی وجود ندارد
در حال حاضر، اولین گروه "()" حاوی شناسه های باگ است و زمان کار این است
بروزرسانی نشده. عبارت پیش فرض مطابقت دارد رفع 1234, رفع اشکال 1234, رفع اشکالات
1234,5678, رفع 1234 و 5678 و تغییرات آن، به دنبال آن یک عدد ساعت
پیشوند توسط h or ساعت، به عنوان مثال ساعت 1.5. تطبیق به حروف بزرگ و کوچک حساس نیست.

bugzilla.fixstatus
وضعیتی که باید هنگام علامت گذاری رفع شد، یک اشکال را تنظیم کنید. پیش فرض تصميم گرفته شده.

bugzilla.fixresolution
وضوح برای تنظیم یک اشکال در هنگام علامت گذاری ثابت. پیش فرض درست شد.

bugzilla.style
فایل سبکی که هنگام قالب بندی نظرات استفاده می شود.

bugzilla.template
الگویی برای استفاده در قالب بندی نظرات. در صورت مشخص شدن، سبک را لغو می کند. علاوه بر این
به کلیدواژه های مرکوریال معمول، پسوند مشخص می کند:

{حشره}

شناسه اشکال Bugzilla.

{ریشه}

نام مسیر کامل مخزن Mercurial.

{webroot}

نام مسیر مخزن Mercurial حذف شده است.

{hgweb}

URL پایه برای مرور مخازن Mercurial.

به طور پیش فرض رویدادنگاری {node|کوتاه} in مخزن {ریشه} اشاره دارد به اشکال
{bug}.\جزئیات:\n\t{desc|tabindent}

bugzilla.strip
تعداد کاراکترهای جداکننده مسیر که باید از جلوی مرکوریال برداشته شوند
مسیر مخزن ({ریشه} در قالب ها) برای تولید {webroot}. به عنوان مثال، a
مخزن با {ریشه} /var/local/my-project با یک نوار 2 مقداری برای
{webroot} of پروژه من. پیش فرض 0.

web.baseurl
URL پایه برای مرور مخازن Mercurial. ارجاع شده از الگوها به عنوان {hgweb}.

موارد پیکربندی مشترک در حالت های دسترسی XMLRPC+email و MySQL:

bugzilla.usermap
مسیر فایل حاوی ایمیل مرکوریال کامیتر به نگاشت ایمیل کاربر Bugzilla.
اگر مشخص شده باشد، فایل باید شامل یک نقشه برداری در هر خط باشد:

committer = کاربر Bugzilla

همچنین ببینید [نقشه کاربری] بخش.

La [نقشه کاربری] بخش برای تعیین نگاشت ایمیل مرکوریال committer به Bugzilla استفاده می شود
ایمیل کاربر همچنین ببینید bugzilla.usermap. شامل ورودی های فرم است جنایتکار = زیلا
کاربر.

پیکربندی حالت دسترسی XMLRPC:

bugzilla.bzurl
URL پایه برای نصب Bugzilla. پیش فرض http://localhost/bugzilla.

bugzilla.user
نام کاربری برای ورود به Bugzilla از طریق XMLRPC. پیش فرض اشکالات.

bugzilla.password
رمز عبور برای ورود به Bugzilla.

حالت دسترسی به ایمیل XMLRPC از موارد پیکربندی حالت دسترسی XMLRPC و همچنین:

bugzilla.bzemail
آدرس ایمیل Bugzilla

علاوه بر این، تنظیمات ایمیل Mercurial باید پیکربندی شوند. مستندات را در
hgrc(5)، بخش ها [پست الکترونیک] و [smtp].

پیکربندی حالت دسترسی MySQL:

bugzilla.host
نام میزبان سرور MySQL که پایگاه داده Bugzilla را در خود جای داده است. پیش فرض localhost را.

bugzilla.db
نام پایگاه داده Bugzilla در MySQL. پیش فرض اشکالات.

bugzilla.user
نام کاربری برای دسترسی به سرور MySQL. پیش فرض اشکالات.

bugzilla.password
رمز عبور برای دسترسی به سرور MySQL.

bugzilla.timeout
توقف اتصال پایگاه داده (ثانیه). پیش فرض 5.

bugzilla.bzuser
نام کاربری جایگزین Bugzilla برای ثبت نظرات، در صورتی که کامیتر تغییرات ست نمی تواند
به عنوان یک کاربر Bugzilla پیدا شود.

bugzilla.bzdir
دایرکتوری نصب Bugzilla. به طور پیش فرض استفاده می شود اعلان. پیش فرض /var/www/html/bugzilla.

bugzilla.notify
دستور اجرا برای واداشتن Bugzilla به ارسال ایمیل های اطلاع رسانی تغییر اشکال.
جایگزین هایی از یک نقشه با 3 کلید، بزدیر, id (شناسه اشکال) و کاربر (committer bugzilla
پست الکترونیک). پیش فرض بستگی به نسخه دارد. از 2.18 "cd %(bzdir)s && perl -T است
contrib/sendbugmail.pl %(id)s %(user)s".

فعال سازی پسوند:

[افزونه ها]
باگزیلا =

[قلاب]
# قلاب bugzilla را روی هر تغییری که در اینجا کشیده یا فشار داده اید اجرا کنید
incoming.bugzilla = python:hgext.bugzilla.hook

نمونه تنظیمات:

پیکربندی نمونه XMLRPC. این از Bugzilla در استفاده می کند http://my-project.org/bugzilla,
ورود به عنوان کاربر [ایمیل محافظت شده] با رمز عبور پلاگین. با a استفاده می شود
مجموعه ای از مخازن مرکوریال در /var/local/hg/repos/، با یک رابط وب در
http://my-project.org/hg.

[bugzilla]
bzurl=http://my-project.org/bugzilla
کاربر=[ایمیل محافظت شده]
رمز عبور = پلاگ
نسخه=xmlrpc
template=تغییر {node|short} در {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{desc}\n
نوار=5

[وب]
baseurl=http://my-project.org/hg

پیکربندی مثال XMLRPC + ایمیل. این از Bugzilla در استفاده می کند
http://my-project.org/bugzilla، وارد شدن به عنوان کاربر [ایمیل محافظت شده] با رمز عبور
پلاگین. این با مجموعه ای از مخازن مرکوریال در استفاده می شود /var/local/hg/repos/,
با رابط وب در http://my-project.org/hg. نظرات اشکالات به Bugzilla ارسال می شود
آدرس ایمیل [ایمیل محافظت شده].

[bugzilla]
bzurl=http://my-project.org/bugzilla
کاربر=[ایمیل محافظت شده]
رمز عبور = پلاگ
نسخه=xmlrpc+ایمیل
bzemail=[ایمیل محافظت شده]
template=تغییر {node|short} در {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{desc}\n
نوار=5

[وب]
baseurl=http://my-project.org/hg

[نقشه کاربری]
[ایمیل محافظت شده]=[ایمیل محافظت شده]

پیکربندی نمونه MySQL. این دارای نصب بوگزیلا 3.2 محلی است
/opt/bugzilla-3.2. پایگاه داده MySQL روشن است localhost را، نام پایگاه داده Bugzilla است اشکالات
و MySQL با نام کاربری MySQL قابل دسترسی است اشکالات کلمه عبور XYZZY. با a استفاده می شود
مجموعه ای از مخازن مرکوریال در /var/local/hg/repos/، با یک رابط وب در
http://my-project.org/hg.

[bugzilla]
میزبان = میزبان محلی
رمز عبور = XYZZY
نسخه=3.0
bzuser=[ایمیل محافظت شده]
bzdir=/opt/bugzilla-3.2
template=تغییر {node|short} در {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{desc}\n
نوار=5

[وب]
baseurl=http://my-project.org/hg

[نقشه کاربری]
[ایمیل محافظت شده]=[ایمیل محافظت شده]

همه موارد بالا یک نظر به رکورد اشکال Bugzilla فرم اضافه می کنند:

3b16791d6642 را در نام مخزن تغییر دهید.
http://my-project.org/hg/repository-name/rev/3b16791d6642

Changeset Commit Comment. اشکال 1234.

سانسورچی
پاک کردن محتوای فایل در یک ویرایش داده شده

فرمان سانسور به مرکوریال دستور می دهد تا تمام محتوای یک فایل را در یک ویرایش داده شده پاک کند
بدون به روز رسانی la رویدادنگاری هش این به تاریخچه موجود اجازه می‌دهد تا زمانی معتبر بماند
جلوگیری از دریافت داده های پاک شده توسط کلون ها/کشش های آینده.

کاربردهای معمول سانسور به دلیل الزامات امنیتی یا قانونی است، از جمله:

* رمزهای عبور، کلیدهای خصوصی، مواد رمزنگاری
* داده ها/کد/کتابخانه های دارای مجوز که مجوز آنها منقضی شده است
* اطلاعات قابل شناسایی شخصی یا سایر داده های خصوصی

گره‌های سانسور شده می‌توانند هر زمان که داده‌های بریده‌شده نیاز داشته باشند، عملکرد معمول جیوه را قطع کنند
تحقق یابد. برخی از دستورات، مانند hg گربه/hg برگرداندن، هنگامی که از شما خواسته می شود شکست بخورید
تولید داده های سانسور شده دیگران، مانند hg بررسی و hg به روز رسانی، باید قابلیت تحمل داشته باشد
داده های سانسور شده برای ادامه عملکرد به شیوه ای معنادار. چنین دستوراتی فقط تحمل می کند
در صورتی که توسط گزینه پیکربندی "censor.policy=ignore" مجاز باشد، ویرایش های فایل سانسور شده انجام می شود.

دستورات
سانسورچی
سانسور hg -r REV [-t TEXT] [FILE]

گزینه های ارسال:

-r،-- برگشت
فایل سانسور از بازبینی مشخص شده

-t،--سنگ قبر
داده های سنگ قبر جایگزین

chgserver
پسوند سرور فرمان برای cHg (تجربی)

'S' کانال (خواندن/نوشتن)
درخواست ()ui.system را به مشتری منتشر کنید

"اتاشیو" فرمان
ضمیمه stdio کلاینت توسط sendmsg()

"چدیر" فرمان
دایرکتوری فعلی را تغییر دهید

"getpager" فرمان
بررسی می کند که آیا پیجر فعال است و کدام پیجر باید اجرا شود

'setenv' فرمان
جایگزین os.environ به طور کامل

آه سیگنال
بارگذاری مجدد فایل های پیکربندی

فرزندان
فرمان برای نمایش تغییرات فرزند (منسوخ شده)

این برنامه افزودنی منسوخ شده است. شما باید استفاده کنید hg ورود به سیستم -r "کودکان (REV)" به جای آن.

دستورات
فرزندان
نشان دادن فرزندان ویرایش فهرست داده شده یا در حال کار:

کودکان hg [-r REV] [FILE]

نسخه های مربوط به دایرکتوری کاری را چاپ کنید. اگر تجدید نظر از طریق
-r/--rev، فرزندان آن ویرایش چاپ خواهند شد. اگر آرگومان فایل داده شود،
ویرایشی که در آن فایل آخرین بار تغییر کرده است (پس از ویرایش دایرکتوری کاری یا
آرگومان به --rev در صورت داده شدن) چاپ می شود.

خواهش می کنم استفاده کنید hg ورود به سیستم بجای:

hg children => hg log -r 'children()'
hg children -r REV => hg log -r 'children(REV)'

دیدن hg کمک ورود به سیستم و hg کمک resets.فرزندان.

گزینه های ارسال:

-r،-- برگشت
فرزندان بازبینی مشخص شده را نشان دهید

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

تعویض
دستور نمایش آمار تاریخچه مخزن

دستورات
تعویض
هیستوگرام تغییرات مخزن:

hg churn [-d DATE] [-r REV] [--نام مستعار FILE] [FILE]

این دستور یک هیستوگرام نشان می دهد که تعداد خطوط تغییر یافته یا
تجدید نظرها، بر اساس الگوی داده شده گروه بندی شده اند. الگوی پیش فرض گروه بندی می شود
تغییرات توسط نویسنده گزینه --dateformat ممکن است برای گروه بندی نتایج بر اساس تاریخ استفاده شود
به جای آن.

آمار بر اساس تعداد خطوط تغییر یافته یا به طور متناوب تعداد خطوط است
اگر گزینه --changesets مشخص شده باشد، تجدید نظرها را مطابقت دهید.

مثال:

# نمایش تعداد خطوط تغییر یافته برای هر committer
hg churn -t "{author|email}"

# نمایش نمودار فعالیت روزانه
hg churn -f "%H" -s -c

# نمایش فعالیت توسعه دهندگان بر اساس ماه
hg churn -f "%Y-%m" -s -c

# تعداد نمایش خطوط در هر سال تغییر می کند
hg churn -f "%Y" -s

می توان با ارائه یک فایل آدرس های ایمیل جایگزین را به آدرس اصلی نگاشت
با استفاده از قالب زیر:

=

چنین فایلی ممکن است با گزینه --aliases مشخص شود، در غیر این صورت یک فایل .hgchurn خواهد بود.
در ریشه دایرکتوری کاری جستجو شد. نام مستعار از سمت راست ترین "=" تقسیم می شود.

گزینه های ارسال:

-r،-- برگشت
نرخ شمارش برای بازبینی یا تنظیم مجدد مشخص شده

-د،--تاریخ
نرخ شمارش برای بازبینی‌ها مطابق با مشخصات تاریخ

-t،--الگوی قدیمی
الگوی گروه‌بندی مجموعه‌های تغییرات (منسوخ شده)

-T،--قالب
الگوی گروه‌بندی مجموعه‌های تغییرات (پیش‌فرض: {author|email})

-f،--فرمت تاریخ
فرمت سازگار با strftime برای گروه بندی بر اساس تاریخ

-c، --تغییرها
نرخ شمارش بر اساس تعداد مجموعه تغییرات

-s ، --مرتب سازی
مرتب سازی بر اساس کلید (پیش فرض: مرتب سازی بر اساس تعداد)

--diffstat
خطوط اضافه/حذف شده را جداگانه نمایش دهید

-- نام مستعار
فایل با نام مستعار ایمیل

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

کلون باندل ها
بسته های از پیش تولید شده را برای کلون های بذر تبلیغ کنید

"clonebundles" یک افزونه سمت سرور است که برای تبلیغ وجود استفاده می شود
فایل‌های باندل از پیش تولید شده و میزبان خارجی برای مشتریانی که در حال شبیه‌سازی هستند
می تواند سریع تر، قابل اطمینان تر باشد و به منابع کمتری روی سرور نیاز داشته باشد.

شبیه سازی می تواند یک عملیات فشرده CPU و I/O بر روی سرورها باشد. به طور سنتی، سرور، در
پاسخ به درخواست مشتری برای شبیه سازی، به صورت پویا یک بسته نرم افزاری حاوی
کل محتوای مخزن و ارسال آن به مشتری. هیچ کش روی سرور وجود ندارد
و سرور باید در پاسخ به آن، همان بسته خروجی را به طور اضافی ایجاد کند
هر درخواست کلون برای سرورهایی با مخازن بزرگ یا با حجم کلون بالا،
بارگیری از کلون ها می تواند مقیاس پذیری سرور را چالش برانگیز و پرهزینه کند.

این برنامه افزودنی به اپراتورهای سرور امکان تخلیه بالقوه گران قیمت را می دهد
بارگذاری کلون به یک سرویس خارجی در اینجا نحوه عملکرد آن است.

1. یک اپراتور سرور مکانیزمی را برای در دسترس قرار دادن فایل های بسته نرم افزاری در a ایجاد می کند
سرویس میزبانی که مشتریان Mercurial می توانند آنها را دریافت کنند.

2. یک فایل مانیفست لیست URL های بسته موجود و برخی فراداده اختیاری به آن اضافه می شود
مخزن Mercurial روی سرور.

3. یک کلاینت یک کلون را در برابر یک کلون باندل سرور آگاه آغاز می کند.

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

5. کلاینت بسته های موجود را بر اساس آنچه که پشتیبانی می کند و مرتب می کند
ترجیح می دهد.

6. سرویس گیرنده یک بسته در دسترس را از URL مشخص شده توسط سرور دانلود و اعمال می کند.

7. کلاینت دوباره به سرور اصلی متصل می شود و معادل آن را انجام می دهد hg کشیدن به
همه داده های مخزن را که در بسته نیستند بازیابی کنید. (مخزن می توانست به روز شده باشد
بین زمانی که بسته ایجاد شد و زمانی که مشتری کلون را شروع کرد.)

به جای اینکه سرور برای هر درخواست کلون، بسته‌های مخزن کامل ایجاد کند، آن را ایجاد می‌کند
یک بار بسته‌های کامل را تولید می‌کند و متعاقباً از آنها برای راه‌اندازی کلون‌های جدید استفاده مجدد می‌شود. در
سرور ممکن است همچنان داده ها را در زمان کلون انتقال دهد. با این حال، این تنها داده هایی است که بوده است
از زمان ایجاد بسته نرم افزاری اضافه/تغییر شده است. برای مخازن بزرگ و تاسیس شده، این می تواند
بار سرور برای کلون ها را به کمتر از 1٪ از اصلی کاهش دهید.

برای کار کردن، این افزونه به اپراتورهای سرور زیر نیاز دارد:

· تولید فایل های بسته ای از محتوای مخزن (معمولاً به صورت دوره ای، مانند یک بار در هر
روز)

· سرور فایلی که مشتریان به شبکه دسترسی دارند و پایتون می داند چگونه با آن صحبت کند
از طریق تسهیلات عادی مدیریت URL آن (معمولا یک سرور HTTP).

· فرآیندی برای حفظ بسته های نرم افزاری در همگام با فایل های بسته نرم افزاری موجود.

به طور دقیق، استفاده از سرور میزبان فایل ثابت مورد نیاز نیست: یک اپراتور سرور
می تواند از یک سرویس پویا برای بازیابی داده های بسته استفاده کند. با این حال، میزبانی فایل استاتیک
خدمات ساده و مقیاس پذیر هستند و باید برای اکثر نیازها کافی باشند.

فایل های بسته نرم افزاری را می توان با hg بسته فرمان معمولا hg بسته --همه is
برای تولید بسته ای از کل مخزن استفاده می شود.

hg debugcreatestreamclonebundle می توان از آن برای تولید ویژه استفاده کرد جریان کلون کردن بسته.
اینها فایل های بسته ای هستند که برای تولید و مصرف بسیار کارآمد هستند (بخوانید: سریع).
با این حال، آنها بزرگتر از فرمت های بسته نرم افزاری سنتی هستند و نیاز به پشتیبانی مشتریان دارند
مجموعه دقیق فرمت‌های ذخیره‌سازی داده‌های مخزن که توسط مخزنی که آنها را ایجاد کرده است، استفاده می‌کند.
به طور معمول، یک سرور جدیدتر می تواند داده هایی را ارائه دهد که با مشتریان قدیمی سازگار است. با این حال،
جریان کلون کردن بسته این تضمین را ندارد سرور اپراتور نیاز به be مطلع که
جدیدتر نسخه of تند ممکن است تولید کردن جریان کلون کردن بسته ناسازگار با بزرگتر
تند نسخه ها

یک اپراتور سرور مسئول ایجاد a است .hg/clonebundles.manifest فایل حاوی
لیست فایل های باندل موجود مناسب برای کاشت کلون ها. اگر این فایل نیست
وجود داشته باشد، مخزن وجود بسته‌های شبیه‌سازی را زمانی که کلاینت‌ها وجود دارد، تبلیغ نمی‌کند
اتصال

فایل مانیفست حاوی یک لیست ورودی با خط جدید ( ) است.

هر خط در این فایل یک بسته در دسترس را تعریف می کند. خطوط دارای فرمت هستند:

[ = [ = ]]

یعنی یک URL به دنبال یک لیست اختیاری و با فاصله محدود از جفت‌های کلید=مقدار که توصیف می‌کند.
خواص اضافی این بسته نرم افزاری هم کلیدها و هم مقادیر URI کدگذاری شده اند.

کلیدهای UPPERCASE برای استفاده توسط Mercurial محفوظ است و در زیر تعریف شده است. همه
کلیدهای غیر بزرگ را می توان توسط تاسیسات سایت استفاده کرد. یک مثال برای خواص سفارشی
استفاده از مرکز داده ویژگی برای تعیین اینکه یک فایل در کدام مرکز داده میزبانی می شود.
سپس مشتریان می توانند سروری را در نزدیک ترین مرکز داده به آنها ترجیح دهند.

کلیدهای رزرو شده زیر در حال حاضر تعریف شده اند:

BUNDLESPEC
یک رشته «مشخصات بسته نرم افزاری» که نوع بسته را توصیف می کند.

اینها مقادیر رشته ای هستند که توسط آرگومان "--type" پذیرفته می شوند hg بسته.

مقادیر در حالت دقیق تجزیه می شوند، به این معنی که آنها باید از یک باشند
" - برای اطلاعات بیشتر به () mercurial.exchange.parsebundlespec مراجعه کنید
جزئیات.

hg اشکال زدایی --مشخصات می توان برای چاپ رشته مشخصات بسته نرم افزاری برای a استفاده کرد
فایل بسته. خروجی این دستور را می توان کلمه به کلمه برای مقدار استفاده کرد
BUNDLESPEC (از قبل فرار کرده است).

مشتریان به طور خودکار مشخصاتی را که ناشناخته هستند یا فیلتر می کنند
پشتیبانی نمی‌شود، بنابراین سعی نمی‌کنند چیزی را دانلود کنند که احتمالاً کاربردی نخواهد بود.

ارزش واقعی بر رفتار مشتری فراتر از فیلتر کردن تأثیر نمی گذارد: مشتریان این کار را خواهند کرد
همچنان نوع بسته نرم افزاری را از سربرگ فایل های دانلود شده استشمام کنید.

استفاده کنید of این کلید is خیلی توصیه می شود، زیرا به مشتریان اجازه می دهد به راحتی از آن بگذرند
بسته های پشتیبانی نشده اگر این کلید تعریف نشده باشد، یک کلاینت قدیمی ممکن است اقدام به اعمال کند
دسته ای که از خواندن آن ناتوان است.

نیاز است
اینکه آیا نشانگر نام سرور (SNI) برای اتصال به URL مورد نیاز است یا خیر. SNI اجازه می دهد
سرورها برای استفاده از چندین گواهی در یک IP. در CDN ها تا حدودی رایج است
و سایر ارائه دهندگان هاست. نسخه های قدیمی پایتون از SNI پشتیبانی نمی کنند. تعریف کردن
این ویژگی به کلاینت هایی با نسخه های قدیمی پایتون این امکان را می دهد که این ورودی را فیلتر کنند
بدون اینکه در زمان اتصال دچار شکست SSL مات شوید.

اگر این تعریف شده باشد، تبلیغ یک URL بازگشتی یا مشتریان غیر SNI مهم است
اجرای نسخه های قدیمی پایتون ممکن است نتواند با کلون باندل ها کلون شود
امکانات.

ارزش باید "درست" باشد.

مانیفست ها می توانند حاوی چندین ورودی باشند. با فرض تعریف متادیتا، کلاینت ها فیلتر خواهند شد
ورودی‌هایی از مانیفست که پشتیبانی نمی‌کنند. ورودی های باقی مانده اختیاری هستند
مرتب شده بر اساس ترجیحات مشتری (تجربی گزینه پیکربندی). مشتری
سپس سعی می کند بسته را در اولین URL در لیست باقیمانده واکشی کند.

خطاهای چه زمانی دانلود a بسته اراده شکست خوردن la تمام کلون کردن عمل: مشتریان do نه
بطور خودکار سقوط به عقب به a سنتی شبیه. دلیل این امر این است که اگر یک سرور است
با استفاده از بسته های کلون، احتمالاً این کار را انجام می دهد زیرا این ویژگی برای کمک به آن ضروری است
مقیاس به عبارت دیگر، این فرض وجود دارد که بار کلون به دیگری تخلیه می شود
سرویس و اینکه سرور Mercurial مسئول سرویس دهی به این بار کلون نیست. اگر
که سایر خدمات با مشکلاتی مواجه می شوند و مشتریان شروع به بازگشت به حالت اولیه می کنند
سرور مرکوریال، بار کلون اضافه شده می تواند سرور را به دلیل بار غیرمنتظره غرق کند
و به طور موثر آن را آفلاین کنید. نداشتن مشتری به طور خودکار به شبیه سازی بازمی گردد
از سرور اصلی این سناریو را کاهش می دهد.

از آنجا که هیچ بازگشت خودکار مرکوریال سرور در هنگام خرابی میزبانی بسته وجود ندارد
سرویس، برای اپراتورهای سرور مهم است که سرویس میزبانی بسته را به عنوان یک مشاهده کنند
گسترش سرور Mercurial از نظر در دسترس بودن و توافقات سطح خدمات:
اگر سرویس میزبانی بسته از کار بیفتد، امکان کلون کردن مشتریان نیز کاهش می یابد. توجه داشته باشید:
مشتریان پیامی را مشاهده می‌کنند که به آنها اطلاع می‌دهد چگونه از تسهیلات کلون باندل‌ها عبور کنند
شکست رخ می دهد. بنابراین اپراتورهای سرور باید برای برخی از افراد برای دنبال کردن این موارد آماده شوند
دستورالعمل های زمانی که خرابی رخ می دهد، بنابراین بار بیشتری را به مرکوریال اصلی هدایت می کند
سرور زمانی که سرویس میزبانی بسته از کار بیفتد.

رنگ
رنگی کردن خروجی از برخی دستورات

پسوند رنگ خروجی از چندین دستور Mercurial را رنگی می کند. به عنوان مثال
دستور diff اضافات را با رنگ سبز و حذف ها را با رنگ قرمز نشان می دهد، در حالی که دستور وضعیت نشان می دهد
فایل های اصلاح شده در سرخابی بسیاری از دستورات دیگر رنگ های مشابهی دارند. ممکن است که
این رنگ ها را سفارشی کنید

اثرات
علاوه بر رنگ، جلوه های دیگری مانند متن برجسته و خط دار نیز موجود است. توسط
به طور پیش فرض، پایگاه داده terminfo برای یافتن کدهای ترمینال مورد استفاده برای تغییر رنگ و
اثر اگر اطلاعات پایانی در دسترس نباشد، افکت‌ها با ECMA-48 SGR ارائه می‌شوند
تابع کنترل (معروف به کدهای فرار ANSI).

افکت‌های موجود در حالت terminfo عبارتند از: «چشمک زدن»، «پررنگ»، «کدر»، «معکوس»، «نامرئی»،
«مورب»، «متمایز»، و «زیرخط»؛ در حالت ECMA-48، گزینه‌ها «بولد»، «معکوس»،
"مورب" و "زیرخط". نحوه ارائه هر کدام به شبیه ساز ترمینال بستگی دارد. مقداری
ممکن است برای یک نوع ترمینال مشخص در دسترس نباشد، و بی سر و صدا نادیده گرفته می شود.

برچسب ها
متن بسته به برچسب هایی که دارد، جلوه های رنگی را دریافت می کند. بسیاری از مرکوریال های پیش فرض
دستورات متن برچسب دار را منتشر می کنند. شما همچنین می توانید برچسب های خود را در قالب ها با استفاده از
تابع برچسب، ببینید hg کمک قالب. یک بخش از متن ممکن است بیش از یک داشته باشد
برچسب. در آن صورت، افکت‌هایی که به آخرین برچسب داده می‌شوند، هر اثر دیگری را لغو می‌کنند. این
شامل اثر ویژه "هیچ" است که سایر اثرات را باطل می کند.

برچسب ها معمولاً نامرئی هستند. برای دیدن این برچسب ها و موقعیت آنها در
متن، از گزینه global --color=debug استفاده کنید. ممکن است همان anchor text به آن مرتبط شود
چندین برچسب، به عنوان مثال

[log.changeset changeset.secret|changeset: 22611:6f0a53c8f587]

در زیر افکت های پیش فرض برای برخی از برچسب های پیش فرض آورده شده است. اثرات پیش فرض ممکن است باشد
از فایل پیکربندی شما نادیده گرفته شده است:

[رنگ]
status.modified = زیر خط آبی پررنگ red_background
status.added = پررنگ سبز
status.removed = پس زمینه آبی پررنگ قرمز
status.deleted = زیر خط پررنگ فیروزه ای
status.unknown = زیر خط پررنگ سرخابی
status.ignored = پررنگ سیاه

# "هیچ" همه جلوه ها را خاموش می کند
status.clean = هیچ
status.copied = هیچ

qseries.applied = زیر خط پررنگ آبی
qseries.unapplied = پررنگ مشکی
qseries.missing = پررنگ قرمز

diff.diffline = پررنگ
diff.extended = پررنگ فیروزه ای
diff.file_a = پررنگ قرمز
diff.file_b = پررنگ سبز
diff.hunk = سرخابی
diff.deleted = قرمز
diff.inserted = سبز
diff.changed = سفید
diff.tab =
diff.trailingwhitespace = red_background پررنگ

# خالی، بنابراین سبک برچسب اطراف را به ارث می برد
changeet.public =
changeet.draft =
changeet.secret =

solve.unresolved = پررنگ قرمز
Resolved.resolved = پررنگ سبز

bookmarks.active = سبز

branches.active = هیچ
شاخه ها.بسته = پررنگ سیاه
شاخه ها.جریان = سبز
branches.inactive = هیچ

tags.normal = سبز
tags.local = پررنگ مشکی

rebase.rebased = آبی
rebase.remaining = پررنگ قرمز

shelve.age = فیروزه ای
shelve.newest = پررنگ سبز
shelve.name = پررنگ آبی

histedit.remaining = پررنگ قرمز

سفارشی رنگ
از آنجایی که تنها هشت رنگ استاندارد وجود دارد، این ماژول به شما امکان می دهد نام رنگ ها را تعریف کنید
برای سایر اسلات های رنگی که ممکن است برای نوع ترمینال شما در دسترس باشند، با فرض اطلاعات ترمینال
حالت برای مثال:

رنگ آبی روشن = 12
color.pink = 207
color.orange = 202

برای تنظیم "brightblue" روی شکاف رنگی 12 (مفید برای 16 پایانه رنگی که روشن تر هستند
رنگ‌های تعریف‌شده در هشت بالا) و «صورتی» و «نارنجی» تا رنگ‌ها در xterm 256 رنگ
مکعب رنگ پیش فرض این رنگ های تعریف شده ممکن است به عنوان هر یک از رنگ های از پیش تعریف شده استفاده شوند
هشت، از جمله اضافه کردن «_background» برای تنظیم پس‌زمینه به آن رنگ.

حالت های
به طور پیش‌فرض، پسوند رنگی از حالت ANSI (یا حالت win32 در ویندوز) استفاده می‌کند
ترمینال را تشخیص می دهد برای لغو حالت خودکار (به عنوان مثال برای فعال کردن حالت terminfo)، را تنظیم کنید
گزینه تنظیمات زیر:

[رنگ]
حالت = اطلاعات پایانی

هر مقداری غیر از «ansi»، «win32»، «terminfo» یا «auto» رنگ را غیرفعال می‌کند.

توجه داشته باشید که در برخی از سیستم ها، حالت terminfo ممکن است هنگام استفاده از رنگ با آن مشکل ایجاد کند
پسوند پیجر و کمتر -R. کمتر با گزینه -R فقط رنگ ECMA-48 را نمایش می دهد
کدها و حالت terminfo گاهی اوقات ممکن است کدهایی را منتشر کنند که کمتر آن را درک نمی کند. تو می توانی
با استفاده از حالت ansi (یا حالت خودکار)، یا با استفاده از -r کمتر (که این کار را انجام می دهد، این کار را حل کنید
از تمام کدهای کنترل ترمینال عبور کنید، نه فقط کدهای کنترل رنگ).

در برخی از سیستم ها (مانند MSYS در ویندوز)، ترمینال ممکن است از حالت رنگ متفاوتی پشتیبانی کند
از پیجر (فعال شده از طریق پسوند "پیجر"). امکان تعریف جدا وجود دارد
بسته به فعال بودن پیجر حالت ها:

[رنگ]
حالت = خودکار
pagermode = ansi

If حالت صفحه تعریف نشده است، حالت استفاده خواهد شد.

دستورات
تبدیل
بازبینی‌ها را از مخازن VCS خارجی به Mercurial وارد کنید

دستورات
تبدیل
یک مخزن خارجی SCM را به یک مرکوریال تبدیل کنید:

تبدیل hg [OPTION]... منبع [DEST [REVMAP]]

فرمت های منبع پذیرفته شده [شناسه ها]:

· جیوه [hg]

· CVS [cvs]

· دارک [دارک]

· git [git]

· براندازی [svn]

· یکنواخت [mtn]

· قوس گنو [gnuarch]

· بازار [bzr]

· پرفورس [p4]

قالب‌های مقصد مورد قبول [شناسه‌ها]:

· جیوه [hg]

· براندازی [svn] (تاریخچه روی شاخه ها حفظ نشده است)

اگر بازنگری داده نشود، تمام ویرایش‌ها تبدیل می‌شوند. در غیر این صورت، فقط تبدیل خواهد شد
تا ویرایش نام‌گذاری شده را وارد کنید (در قالبی که منبع قابل درک است ارائه شده است).

اگر هیچ نام دایرکتوری مقصد مشخص نشده باشد، به طور پیش‌فرض روی نام پایه منبع قرار می‌گیرد
با -HG ضمیمه شده است. اگر مخزن مقصد وجود نداشته باشد، ایجاد خواهد شد.

به طور پیش فرض، همه منابع به جز Mercurial از --branchsort استفاده می کنند. استفاده از جیوه
--sourcesort برای حفظ ترتیب اعداد ویرایش اصلی. حالت های مرتب سازی موارد زیر را دارند
اثرات:

-- شاخه مرتب سازی
در صورت امکان از والد به تجدیدنظر فرزند تبدیل کنید، که به این معنی است که شاخه ها هستند
معمولا یکی پس از دیگری تبدیل می شوند. این مخازن فشرده تری تولید می کند.

--Datesort
مرتب سازی ویرایش ها بر اساس تاریخ مخازن تبدیل شده دارای تغییرات ظاهری خوبی هستند اما هستند
غالباً مرتبه ای بزرگتر از قدرهای مشابهی که توسط --branchsort تولید می شوند.

--منبعمرتب
سعی کنید ترتیب تجدید نظرهای منبع را حفظ کنید، فقط توسط منابع Mercurial پشتیبانی می شود.

--closesort
سعی کنید ویرایش های بسته را تا حد امکان به شعبه های مادر نزدیک کنید
توسط منابع مرکوریال پشتیبانی می شود.

If REVMAP داده نمی شود، در یک مکان پیش فرض قرار می گیرد (/.hg/shamap by
پیش فرض). در REVMAP یک فایل متنی ساده است که هر شناسه commit منبع را به آن نگاشت می کند
شناسه مقصد برای آن ویرایش، مانند این موارد:



اگر فایل وجود نداشته باشد، به طور خودکار ایجاد می شود. در هر commit کپی شده به روز می شود،
so hg تبدیل می تواند قطع شود و می تواند به طور مکرر برای کپی کردن commit های جدید اجرا شود.

نویسنده نقشه یک فایل متنی ساده است که هر نویسنده منبع را به یک مقصد نگاشت می کند
متعهد نویسنده برای SCM های منبع که از لاگین یونیکس برای شناسایی نویسندگان استفاده می کنند مفید است (مثلا:
CVS). یک خط برای هر نگاشت نویسنده و قالب خط به این صورت است:

نویسنده منبع = نویسنده مقصد

خطوط خالی و خطوطی که با a شروع می شوند # نادیده گرفته می شوند

فایل مپ فایلی است که امکان فیلتر کردن و نقشه برداری مجدد فایل ها و دایرکتوری ها را فراهم می کند. هر یک
خط می تواند شامل یکی از دستورالعمل های زیر باشد:

شامل path/to/file-or-dir

path/to/file-or-dir را حذف کنید

تغییر نام مسیر/به/مسیر منبع/به/مقصد

خطوط نظر با شروع می شود #. یک مسیر مشخص شده در صورتی مطابقت دارد که با نام نسبی کامل برابر باشد
یک فایل یا یکی از دایرکتوری های اصلی آن. در شامل or محروم کردن بخشنامه با
طولانی ترین مسیر تطبیق اعمال می شود، بنابراین ترتیب خط مهم نیست.

La شامل دستورالعمل باعث می شود که یک فایل، یا همه فایل های زیر یک فهرست، در فهرست گنجانده شوند
مخزن مقصد پیش فرض اگر وجود نداشته باشد شامل بیانیه باید شامل شود
همه چیز. اگر وجود دارد شامل اظهارات، هیچ چیز دیگری گنجانده نشده است. در محروم کردن
دستورالعمل باعث حذف فایل ها یا دایرکتوری ها می شود. در تغییر نام دهید دستورالعمل یک فایل را تغییر نام می دهد
یا دایرکتوری اگر تبدیل شده باشد. برای تغییر نام از یک زیر شاخه به ریشه the
مخزن، استفاده . به عنوان مسیر تغییر نام به.

--پر شده مطمئن خواهد شد که تغییرات تبدیل شده دقیقاً حاوی فایل های مناسبی هستند
محتوای درست این یک تبدیل کامل از تمام فایل ها، نه فقط آنهایی که دارند را انجام می دهد
تغییر کرد. فایل هایی که از قبل صحیح هستند تغییر نخواهند کرد. این را می توان برای اعمال استفاده کرد
نقشه فایل هنگام تبدیل تدریجی تغییر می کند. این در حال حاضر فقط برای پشتیبانی می شود
مرکوریال و براندازی.

splicmap فایلی است که اجازه درج تاریخچه مصنوعی را می دهد و به شما امکان می دهد مشخص کنید
والدین یک تجدید نظر اگر می خواهید به عنوان مثال یک Subversion ادغام کنید، این کار مفید است
والدین، یا پیوند دو سری از تاریخ جدا شده با هم. هر ورودی حاوی یک کلید است،
به دنبال آن یک فاصله، به دنبال آن یک یا دو مقدار جدا شده با کاما:

والد کلیدی 1، والد2

کلید، شناسه بازبینی در سیستم کنترل بازبینی منبع است که والدین آن باید باشند
اصلاح شده (همان قالب کلید در .hg/shamap). مقادیر، شناسه‌های بازبینی (در هر یک از آنها) هستند
سیستم کنترل بازنگری منبع یا مقصد) که باید به عنوان والدین جدید استفاده شود
برای آن گره به عنوان مثال، اگر "release-1.0" را در "Trunk" ادغام کرده اید، پس باید
بازبینی را در "Trunk" به عنوان والد اول و یکی را در "release-1.0" مشخص کنید.
شاخه به عنوان دوم.

شعبه مپ فایلی است که به شما اجازه می دهد تا زمانی که یک شاخه وارد می شود نام آن را تغییر دهید
از هر مخزن خارجی. هنگامی که همراه با splicmap استفاده می شود، اجازه می دهد
برای یک ترکیب قدرتمند برای کمک به تعمیر حتی بدترین مخازن با سوء مدیریت و
آنها را به مخازن Mercurial با ساختار زیبا تبدیل کنید. نقشه شاخه شامل خطوطی از
فرم:

اصل_شاخه_نام new_branch_name

که در آن "original_branch_name" نام شعبه در مخزن منبع است و
"new_branch_name" نام شعبه ای است که مخزن مقصد است. بدون فضای خالی
در نام شعب مجاز است. این را می توان برای (به عنوان مثال) انتقال کد در یک مورد استفاده کرد
مخزن از "پیش فرض" به یک شاخه با نام.

تند منبع
منبع Mercurial گزینه های پیکربندی زیر را تشخیص می دهد که می توانید آنها را تنظیم کنید
خط فرمان با - پیکربندی:

convert.hg.ignoreerrors
هنگام خواندن، خطاهای یکپارچگی را نادیده بگیرید. از آن برای تعمیر مخازن مرکوریال استفاده کنید
revlog های از دست رفته، با تبدیل از و به Mercurial. پیش فرض نادرست است.

تبدیل.hg.saverev
شناسه نسخه اصلی را در تغییرات مجموعه ذخیره کنید (شناسه های هدف را مجبور به تغییر می کند). طول می کشد
آرگومان بولی و پیش فرض False است.

convert.hg.startrev
بازنگری اولیه Mercurial را مشخص کنید. پیش فرض 0 است.

تبدیل.hg.revs
revset تعیین منبع تجدید نظر برای تبدیل.

CVS منبع
منبع CVS از جعبه شنی (به عنوان مثال یک کپی بررسی شده) از CVS برای نشان دادن شروع استفاده می کند
نقطه آنچه تبدیل خواهد شد دسترسی مستقیم به فایل های مخزن مورد نیاز نیست،
مگر اینکه مخزن باشد :local:. تبدیل از دایرکتوری سطح بالا استفاده می کند
جعبه شنی برای یافتن مخزن CVS، و سپس از دستورات CVS rlog برای یافتن فایل‌ها استفاده می‌کند.
تبدیل. این به این معنی است که مگر اینکه یک نقشه فایل داده شود، همه فایل ها در دایرکتوری شروع هستند
تبدیل خواهد شد و هر گونه سازماندهی مجدد دایرکتوری در جعبه ایمنی CVS نادیده گرفته می شود.

گزینه های زیر را می توان با استفاده از - پیکربندی:

convert.cvsps.cache
برای غیرفعال کردن حافظه پنهان گزارش از راه دور، برای اهداف آزمایش و اشکال زدایی، روی False تنظیم کنید.
پیش فرض درست است.

convert.cvsps.fuzz
حداکثر زمان مجاز (بر حسب ثانیه) بین commit ها را مشخص کنید
پیام کاربر و گزارش یکسان در یک مجموعه تغییرات واحد. زمانی که فایل های بسیار بزرگ بودند
به عنوان بخشی از تغییرات انتخاب شده است، پس از آن ممکن است پیش فرض به اندازه کافی طولانی نباشد. در
پیش فرض 60 است.

convert.cvsps.mergeto
یک عبارت منظم را مشخص کنید که پیام های گزارش commit با آن مطابقت دارند. اگر یک مسابقه
رخ می دهد، سپس فرآیند تبدیل یک تجدید نظر ساختگی را وارد می کند که شاخه را ادغام می کند
که در آن این پیام ورود به شاخه نشان داده شده در regex رخ می دهد. پیش فرض است
{{شاخه ادغام ([-\w]+)}}

convert.cvsps.mergefrom
یک عبارت منظم را مشخص کنید که پیام های گزارش commit با آن مطابقت دارند. اگر یک مسابقه
رخ می دهد، سپس فرآیند تبدیل آخرین ویرایش را در شعبه اضافه می کند
در regex به عنوان والد دوم تغییرات مجموعه نشان داده شده است. پیش فرض است
{{ادغام از شاخه ([-\w]+)}}

convert.localtimezone
از زمان محلی (که توسط متغیر محیطی TZ تعیین می شود) برای تغییرات استفاده کنید
تاریخ/زمان پیش فرض نادرست است (از UTC استفاده کنید).

hooks.cvslog
یک تابع پایتون را مشخص کنید تا در پایان جمع آوری گزارش CVS فراخوانی شود. را
تابع یک لیست با ورودی های گزارش ارسال می شود و می تواند ورودی ها را تغییر دهد
در جای خود، یا آنها را اضافه یا حذف کنید.

hooks.cvschangesets
یک تابع پایتون را مشخص کنید تا پس از محاسبه مجموعه تغییرات از روی آن فراخوانی شود
گزارش CVS. این تابع یک لیست با ورودی های تغییرات ارسال می شود و می تواند آن را تغییر دهد
تغییرات را در محل خود اضافه کنید یا آنها را حذف کنید.

یک فرمان Mercurial "debugcvsps" اضافی به کد ادغام مجموعه تغییرات داخلی اجازه می دهد
بدون انجام تبدیل اجرا شود. پارامترها و خروجی آن شبیه به cvsps است
2.1. لطفاً برای جزئیات بیشتر به راهنمای دستور مراجعه کنید.

خرابکاری منبع
منبع براندازی طرح‌بندی کلاسیک تنه/شاخه/برچسب را تشخیص می‌دهد. به طور پیش فرض، ارائه شده است
svn://repo/path/ URL منبع به عنوان یک شاخه تبدیل می شود. اگر svn://repo/path/trunk
وجود دارد که جایگزین شاخه پیش فرض می شود. اگر svn://repo/path/branches وجود دارد، آن است
زیر شاخه ها به عنوان شاخه های ممکن فهرست شده اند. اگر svn://repo/path/tags وجود دارد، هست
به دنبال برچسب هایی بود که به شاخه های تبدیل شده ارجاع می دادند. پیش فرض تنه, شاخه ها و برچسب ها ارزش
را می توان با گزینه های زیر لغو کرد. آنها را روی مسیرهایی نسبت به URL منبع تنظیم کنید، یا
آنها را خالی بگذارید تا تشخیص خودکار غیرفعال شود.

گزینه های زیر را می توان با تنظیم کرد - پیکربندی:

convert.svn.branches
دایرکتوری حاوی شاخه ها را مشخص کنید. پیش فرض است شاخه ها.

convert.svn.tags
دایرکتوری حاوی تگ ها را مشخص کنید. پیش فرض است برچسب ها.

convert.svn.trunk
نام شاخه تنه را مشخص کنید. پیش فرض است تنه.

convert.localtimezone
از زمان محلی (که توسط متغیر محیطی TZ تعیین می شود) برای تغییرات استفاده کنید
تاریخ/زمان پیش فرض نادرست است (از UTC استفاده کنید).

تاریخچه منبع را می توان با شروع یک بازبینی خاص، به جای بودن، بازیابی کرد
یکپارچه تبدیل شده است. فقط تبدیل تک شاخه پشتیبانی می شود.

convert.svn.startrev
شماره بازبینی start Subversion را مشخص کنید. پیش فرض 0 است.

رفتن منبع
واردکننده Git تعهدات را از تمام شاخه‌های قابل دسترسی (رجوع به refs/heads) تبدیل می‌کند و
از راه دور (رجوع در refs/remotes) به Mercurial. شعبه ها به نشانک تبدیل می شوند
همان نام، با «رف/ سر» حذف شده است. زیر ماژول های Git به Git تبدیل می شوند
subrepos در Mercurial.

گزینه های زیر را می توان با تنظیم کرد - پیکربندی:

convert.git.similarity
مشخص کنید که چگونه فایل های مشابه اصلاح شده در یک commit باید به عنوان تغییر نام وارد شوند
کپی، به عنوان درصدی بین 0 (از کار افتاده) و 100 (فایل ها باید یکسان باشند). برای
مثال، 90 به این معنی که یک جفت حذف/افزودن به عنوان تغییر نام وارد می شود اگر بیشتر از
90٪ از فایل تغییر نکرده است. پیش فرض است 50.

convert.git.findcopiesharder
در حین شناسایی کپی ها، به جای اینکه فقط به همه فایل های موجود در کپی کار نگاه کنید
تغییر کرده اند این برای پروژه های بزرگ بسیار گران است و تنها زمانی موثر است
convert.git.similarity بزرگتر از 0 است. پیش فرض نادرست است.

convert.git.remoteprefix
ref های راه دور به عنوان نشانک با تبدیل می شوند convert.git.remoteprefix به عنوان پیشوند
به دنبال یک /. پیش فرض "راه دور" است.

convert.git.skipsubmodules
فایل‌های gitmodules. سطح ریشه یا فایل‌هایی را با حالت 160000 تبدیل نمی‌کند
یک زیر ماژول پیش فرض نادرست است.

جادوگری منبع
وارد کننده Perforce (P4) می تواند یک مسیر انبار p4 یا یک مشخصات مشتری به عنوان داده شود
منبع تمام فایل‌های موجود در منبع را بدون توجه به یک مخزن مرکوریال تبدیل می‌کند
برچسب ها، شاخه ها و ادغام ها. توجه داشته باشید که وقتی یک مسیر انبار به شما داده می شود، معمولاً
باید یک فهرست هدف را مشخص کند، زیرا در غیر این صورت ممکن است هدف نامگذاری شود ...-HG.

گزینه های زیر را می توان با تنظیم کرد - پیکربندی:

convert.p4.encoding
رمزگذاری مورد استفاده در هنگام رمزگشایی خروجی استاندارد دستور Perforce را مشخص کنید
ابزار خط پیش‌فرض کدگذاری پیش‌فرض سیستم است.

convert.p4.startrev
بازبینی اولیه Perforce (یک شماره لیست تغییرات Perforce) را مشخص کنید.

تند مقصد
مقصد مرکوریال مخازن فرعی مرکوریال را در مقصد شناسایی می کند
دایرکتوری، و فایل hgsubstate. را به صورت خودکار در صورت مقصد به روز کنید
مخازن فرعی حاوی فایل / /.hg/shamap. تبدیل یک مخزن با
مخازن فرعی نیاز به تبدیل یک مخزن واحد در یک زمان، از پایین به بالا دارند.

مثالی که نحوه تبدیل یک مخزن با مخازن فرعی را نشان می دهد:

# بنابراین تبدیل وقتی یک مقصد غیر خالی را می بیند نوع آن را می شناسد
$ hg init تبدیل شد

$ hg تبدیل orig/sub1 تبدیل/sub1
$ hg تبدیل orig/sub2 تبدیل/sub2
$ hg تبدیل منبع تبدیل شد

گزینه های زیر پشتیبانی می شوند:

تبدیل.hg.شاخه های کلون
شاخه های منبع را در کلون های جداگانه ارسال کنید. حالت پیش فرض غلط است.

convert.hg.tagsbranch
نام شعبه برای ویرایش برچسب ها، پیش فرض است به طور پیش فرض.

convert.hg.usebranchnames
حفظ نام شاخه ها پیش فرض True است.

convert.hg.sourcename
رشته داده شده را به عنوان یک مقدار اضافی 'convert_source' در هر commit انجام شده ثبت می کند
مخزن هدف پیش فرض None است.

معرفی مقصدهای
همه انواع مقصد گزینه های زیر را می پذیرند:

convert.skiptags
تگ ها را از مخزن منبع به مخزن هدف تبدیل نمی کند. پیش فرض است
غلط

گزینه های ارسال:

-- نویسندگان
نام فایل نگاشت نام کاربری (منسوخ شده) (به جای آن از --authormap استفاده کنید)

-s ،---منبع-نوع
نوع مخزن منبع

-د،--بهترین نوع
نوع مخزن مقصد

-r،-- برگشت
وارد کردن به منبع تجدید نظر REV

-آ،--authormap
با استفاده از این فایل نام های کاربری را مجدداً ترسیم کنید

-- نقشه فایل
نقشه مجدد نام فایل ها با استفاده از محتویات فایل

--پر شده با تبدیل مجدد همه فایل ها، تغییرات نقشه فایل را اعمال کنید

--نقشه اتصال
پیوند تاریخ را در جای خود ترکیب کرد

--نقشه شاخه
هنگام تبدیل نام شاخه ها را تغییر دهید

-- شاخه مرتب سازی
سعی کنید تغییرات را بر اساس شاخه ها مرتب کنید

--Datesort
سعی کنید تغییرات را بر اساس تاریخ مرتب کنید

--منبعمرتب
حفظ ترتیب تغییرات منبع

--closesort
سعی کنید بازبینی های بسته را دوباره ترتیب دهید

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

خنده دار
به طور خودکار خطوط جدید را در فایل های مخزن مدیریت کنید

این پسوند به شما امکان می دهد نوع انتهای خط (CRLF یا LF) که در آن استفاده می شود را مدیریت کنید
مخزن و در دایرکتوری کاری محلی. به این ترتیب می توانید انتهای خطوط CRLF را دریافت کنید
در ویندوز و LF در یونیکس/مک، در نتیجه به همه اجازه می‌دهد از انتهای خط بومی سیستم‌عامل خود استفاده کنند.

برنامه افزودنی پیکربندی خود را از نسخه نسخه شده می خواند .hgeol فایل پیکربندی موجود در
ریشه دایرکتوری کاری در .hgeol فایل از همان نحوی استفاده می کند که سایر فایل ها
فایل های پیکربندی Mercurial. از دو بخش استفاده می کند، [الگوها] و [مخزن].

La [الگوها] بخش مشخص می کند که چگونه انتهای خط باید بین کار تبدیل شود
دایرکتوری و مخزن فرمت با الگوی فایل مشخص می شود. مسابقه اول
استفاده می شود، بنابراین ابتدا الگوهای خاص تری را قرار دهید. انتهای خطوط موجود هستند LF, CRLFو
BIN.

فایل هایی با فرمت اعلام شده از CRLF or LF همیشه بررسی و ذخیره می شوند
مخزن در آن فرمت و فایل های باینری اعلام شده (BIN) بدون تغییر باقی می مانند.
علاوه بر این، بومی نام مستعار برای بررسی در انتهای خط پیش فرض پلت فرم است:
LF در یونیکس (از جمله Mac OS X) و CRLF روی ویندوز توجه داشته باشید که BIN (برای خط کشی کاری انجام ندهید
پایان ها) رفتار پیش فرض مرکوریال است. فقط در صورت نیاز به لغو الف مورد نیاز است
بعد، الگوی کلی تر

اختیاری [مخزن] بخش انتهای خط را برای استفاده برای فایل های ذخیره شده در آن مشخص می کند
مخزن دارای یک تنظیم واحد، بومی، که انتهای خط ذخیره سازی را تعیین می کند
برای فایل های اعلام شده به عنوان بومی در [الگوها] بخش. می توان آن را تنظیم کرد LF or CRLF.
پیش فرض است LF. به عنوان مثال، به این معنی است که در ویندوز، فایل‌ها به‌عنوان پیکربندی شده‌اند بومی (CRLF
به طور پیش فرض) به تبدیل می شود LF هنگامی که در مخزن ذخیره می شود. فایل های اعلام شده به عنوان LF,
CRLF، یا BIN در [الگوها] بخش همیشه همانطور که هست در مخزن ذخیره می شود.

نمونه نسخه شده .hgeol فایل:

[الگوها]
**.py = بومی
**.vcproj = CRLF
**.txt = بومی
Makefile = LF
**.jpg = BIN

[مخزن]
بومی = LF

توجه قوانین ابتدا زمانی اعمال می شود که فایل ها در فهرست کار لمس می شوند، به عنوان مثال توسط
به روز رسانی به null و بازگشت به نوک برای لمس همه فایل ها.

برنامه افزودنی از یک اختیاری استفاده می کند [eol] بخش خوانده شده از هر دو مرکوریال معمولی
فایل های پیکربندی و .hgeol فایل، با دومی غلبه بر اولی. تو می توانی
از آن بخش برای کنترل رفتار کلی استفاده کنید. سه تنظیمات وجود دارد:

· eol.بومی (پیش فرض os.linesep) قابل تنظیم است LF or CRLF برای لغو پیش فرض
تفسیر بومی برای تسویه حساب این را می توان با استفاده کرد hg بایگانی در یونیکس، مثلاً به
یک آرشیو ایجاد کنید که در آن فایل ها دارای انتهای خط برای ویندوز هستند.

· eol.only-consistent (پیش‌فرض True) را می‌توان روی False تنظیم کرد تا پسوند تبدیل شود
فایل هایی با EOL های ناسازگار. ناسازگار به این معنی است که هر دو وجود دارد CRLF و LF در حال حاضر
در فایل چنین پرونده هایی معمولاً با این فرض که دارند لمس نمی شوند
EOL های مخلوط به طور عمدی

· eol.fix-trailing-newline (پیش‌فرض False) را می‌توان روی True تنظیم کرد تا اطمینان حاصل شود که تبدیل شده است
فایل ها با یک کاراکتر EOL (یا \n or \ r \ n و مطابق با الگوهای پیکربندی شده).

پسوند فراهم می کند کد هوشمند: و cleverdecode: فیلترهایی مانند منسوخ شده
پسوند win32text انجام می دهد. این بدان معنی است که شما می توانید win32text را غیرفعال کنید و eol و را فعال کنید
فیلترهای شما همچنان کار خواهند کرد. شما فقط باید به این فیلترها تا زمانی که شما آماده کرده اید
.hgeol فایل.

La win32text.forbid* قلاب های ارائه شده توسط پسوند win32text به یک واحد تبدیل شده اند
تک قلاب به نام eol.checkheadshook. قلاب انتهای خط مورد انتظار را از آن جستجو می کند
la .hgeol فایل، یعنی باید به a مهاجرت کنید .hgeol قبل از استفاده از
قلاب. eol.checkheadshook فقط سر چک ها، تجدید نظرهای نامعتبر میانی تحت فشار قرار خواهند گرفت.
برای منع کامل آنها از eol.checkallhook قلاب. این قلاب ها بهترین استفاده را دارند
pretxnchangegroup قلاب ها

دیدن hg کمک الگوهای برای اطلاعات بیشتر در مورد الگوهای گلوب استفاده شده.

extdiff
دستوری که به برنامه های خارجی اجازه می دهد تا ویرایش ها را با هم مقایسه کنند

پسوند extdiff Mercurial به شما امکان می دهد از برنامه های خارجی برای مقایسه نسخه ها استفاده کنید.
یا ویرایش با دایرکتوری کاری. برنامه های تفاوت خارجی با a فراخوانی می شوند
مجموعه ای از گزینه های قابل تنظیم و دو آرگومان غیر گزینه ای: مسیرهایی به دایرکتوری های حاوی
عکس های فوری از فایل ها برای مقایسه

پسوند extdiff همچنین به شما اجازه می دهد تا دستورات جدید diff را پیکربندی کنید، بنابراین نیازی به آن ندارید
تایپ کردن hg extdiff -p kdiff3 همیشه

[extdiff]
# دستور جدیدی اضافه کنید که گنو را اجرا می کند تفاوت(1) در حالت "تفاوت متن".
cdiff = gdiff -Nprc5
## یا به روش قدیمی:
#cmd.cdiff = gdiff
#opts.cdiff = -Nprc5

# دستور جدیدی به نام meld اضافه کنید، meld را اجرا می کند (نیازی به نام بردن دوبار نیست). اگر
# فایل اجرایی meld در دسترس نیست، ابزار meld در [merge-tools]
در صورت موجود بودن از # استفاده خواهد شد
مخلوط کردن =

# دستور جدیدی به نام vimdiff اضافه کنید، gvimdiff را با افزونه DirDiff اجرا می کند
# (دیدن http://www.vim.org/scripts/script.php?script_id=102) خیر
# کاربر انگلیسی، حتماً "let g:DirDiffDynamicDiffText = 1" را در
# vimrc. شما
vimdiff = gvim -f "+next" \
"+ اجرای "DirDiff" fnameescape(argv(0)) fnameescape(argv(1))"

آرگومان های ابزار می توانند شامل متغیرهایی باشند که در زمان اجرا گسترش می یابند:

$parent1، $plabel1 - نام فایل، برچسب توصیفی والد اول
$child، $clabel - نام فایل، برچسب توصیفی بازبینی فرزند
$parent2، $plabel2 - نام فایل، برچسب توصیفی والد دوم
$root - ریشه مخزن
$parent نام مستعار برای $parent1 است.

پسوند extdiff در بخش‌های [diff-tools] و [merge-tools] شما برای تفاوت جستجو می‌کند.
آرگومان های ابزار، زمانی که هیچ کدام در [extdiff] مشخص نشده باشند.

[extdiff]
kdiff3 =

[ابزارهای تفاوت]
kdiff3.diffargs=--L1 '$plabel1' --L2 '$clabel' $parent $child

می‌توانید از -I/-X و لیستی از نام‌های فایل یا دایرکتوری مانند عادی استفاده کنید hg تفاوت فرمان دادن
پسوند extdiff فقط از فایل های مورد نیاز عکس فوری می گیرد، بنابراین تفاوت خارجی را اجرا کنید
برنامه در واقع بسیار سریع خواهد بود (حداقل سریعتر از مقایسه کل
درخت)

دستورات
extdiff
از برنامه خارجی برای تفاوت مخزن (یا فایل های انتخاب شده) استفاده کنید:

hg extdiff [OPT]... [FILE]...

با استفاده از یک برنامه خارجی، تفاوت بین ویرایش‌ها را برای فایل‌های مشخص شده نشان دهید. را
برنامه پیش فرض استفاده شده با گزینه های پیش فرض "-Npru" متفاوت است.

برای انتخاب یک برنامه دیگر، از گزینه -p/--program استفاده کنید. این برنامه تصویب خواهد شد
نام دو دایرکتوری برای مقایسه برای ارسال گزینه های اضافی به برنامه، استفاده کنید
-o/--گزینه. اینها قبل از نام دایرکتوری ها برای مقایسه ارسال می شوند.

هنگامی که دو آرگومان تجدید نظر داده می شود، تغییرات بین آن تجدید نظرها نشان داده می شود. اگر
فقط یک ویرایش مشخص شده است، سپس آن ویرایش با فهرست کار مقایسه می شود،
و زمانی که هیچ ویرایشی مشخص نشده باشد، فایل های دایرکتوری کاری با آن مقایسه می شوند
والدین.

گزینه های ارسال:

-پ،--برنامه
برنامه مقایسه برای اجرا

-و ،--گزینه
گزینه پاس به برنامه مقایسه

-r،-- برگشت
تجدید نظر

-c،--تغییر دادن
تغییر ایجاد شده توسط تجدید نظر

-- پچ
وصله ها را برای دو ویرایش مقایسه کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-S، -- subrepos
بازگشت به مخازن فرعی

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

واقعیت
احراز هویت http با فکتوتوم

این پسوند اجازه می دهد تا واقعیت(4) تسهیلات در پلان 9 از پلت فرم های آزمایشگاه های بل به
اطلاعات احراز هویت را برای دسترسی HTTP فراهم کنید. ورودی های پیکربندی مشخص شده در
بخش احراز هویت و همچنین اطلاعات احراز هویت ارائه شده در URL مخزن هستند
به طور کامل پشتیبانی می شود. اگر هیچ پیشوندی مشخص نشده باشد، مقدار "*" در نظر گرفته می شود.

به طور پیش فرض، کلیدها به صورت زیر مشخص می شوند:

proto=pass service=hg prefix= کاربر= !password=

اگر افزونه factotum نتواند کلید مورد نیاز را بخواند، یک مورد درخواست می شود
به صورت تعاملی

یک بخش پیکربندی برای سفارشی کردن رفتار زمان اجرا موجود است. به طور پیش فرض، اینها
ورودی ها عبارتند از:

[فکتوتوم]
قابل اجرا = /bin/auth/factotum
mountpoint = /mnt/factotum
سرویس = hg

ورودی اجرایی مسیر کامل باینری فکتوتوم را تعریف می کند. ورودی نقطه کوه
مسیر سرویس فایل factotum را تعریف می کند. در نهایت، ورودی سرویس کنترل می کند
نام سرویس مورد استفاده هنگام خواندن کلیدها

رفتن و آوردن
کشیدن، به روز رسانی و ادغام در یک دستور (منسوخ شده)

دستورات
رفتن و آوردن
تغییرات را از یک مخزن راه دور بکشید، در صورت نیاز تغییرات جدید را ادغام کنید.

واکشی hg [منبع]

این همه تغییرات را از مخزن در مسیر یا URL مشخص شده پیدا کرده و به آن اضافه می کند
مخزن محلی

اگر تغییرات کشیده شده یک سر شاخه جدید اضافه کند، سر به طور خودکار ادغام می شود و
نتیجه ادغام متعهد است. در غیر این صورت، دایرکتوری کاری به روز می شود تا شامل شود
تغییرات جدید

هنگامی که به یک ادغام نیاز است، دایرکتوری کاری ابتدا به فهرست تازه کشیده شده به روز می شود
تغییر می کند. سپس تغییرات محلی در تغییرات کشیده شده ادغام می شوند. برای تغییر ترتیب ادغام،
از --switch-parent استفاده کنید.

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-r،-- برگشت
یک تجدید نظر خاص که می خواهید انجام دهید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

--force-editor
پیام ارتکاب ویرایش (منسوخ شده)

--switch-parent
هنگام ادغام، والدین را تغییر دهید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

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

gpg
دستورات امضا و تأیید تغییرات

دستورات
سیگ چک کردن
تمام امضاهایی که ممکن است برای یک بازبینی خاص وجود داشته باشد را تأیید کنید:

hg sigcheck REV

تمام امضاهایی که ممکن است برای یک ویرایش خاص وجود داشته باشد را تأیید کنید

امضاء
یک امضا برای ویرایش فعلی یا داده شده اضافه کنید:

علامت hg [OPTION]... [REV]...

اگر هیچ تجدیدنظری داده نشود، از والد دایرکتوری کاری استفاده می‌شود، یا اگر نه، نکته استفاده می‌شود
تجدید نظر بررسی می شود.

La gpg.cmd تنظیمات پیکربندی را می توان برای تعیین دستور اجرا استفاده کرد. یک کلید پیش فرض می تواند باشد
مشخص شده با gpg.key.

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

گزینه های ارسال:

-ل، -- محلی
امضا را محلی کنید

-f، --زور
حتی اگر فایل sig اصلاح شده باشد، امضا کنید

--عدم تعهد
پس از امضای فایل sigfile را انجام ندهید

-k،-- کلید
شناسه کلید برای امضا

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

نشان می دهد
لیست تغییرات امضا شده:

hg sigs

لیست تغییرات امضا شده

graphlog
دستور مشاهده نمودارهای بازبینی از پوسته (منسوخ شده)

عملکرد این افزونه از نسخه 2.3 در مرکوریال اصلی گنجانده شده است.
خواهش می کنم استفاده کنید hg ورود به سیستم -G ... به جای آن.

این برنامه افزودنی یک گزینه --graph را به دستورات ورودی، خروجی و log اضافه می کند. وقتی این
گزینه های داده شده است، یک نمایش ASCII از نمودار تجدید نظر نیز نشان داده شده است.

دستورات
زالزالک
تاریخچه ویرایش را در کنار نمودار بازبینی ASCII نشان دهید:

hg glog [OPTION]... [FILE]

تاریخچه ویرایش را در کنار یک نمودار بازبینی که با کاراکترهای ASCII ترسیم شده است چاپ کنید.

گره هایی که به صورت کاراکتر @ چاپ می شوند، والدین دایرکتوری کاری هستند.

این نام مستعار است hg ورود به سیستم -G.

گزینه های ارسال:

-f، --دنبال کردن
تاریخچه تغییرات مجموعه یا تاریخچه فایل را در بین کپی ها و تغییر نام ها دنبال کنید

--پیگیری-اول
فقط اولین والد ادغام تغییرات را دنبال کنید (منسوخ شده)

-د،--تاریخ
نمایش نسخه های مطابق با مشخصات تاریخ

-C ، -- کپی ها
نمایش فایل های کپی شده

-k،--کلمه کلیدی
جستجوی بدون حروف بزرگ برای یک متن داده شده انجام دهید

-r،-- برگشت
بازبینی یا تنظیم مجدد مشخص شده را نشان دهید

--حذف شده
شامل ویرایش هایی که در آن فایل ها حذف شده اند

-m، --only-ادغام می شود
نمایش فقط ادغام ها (منسوخ شده)

-u،--کاربر
تجدید نظرهای انجام شده توسط کاربر

--فقط شعبه
فقط تغییرات را در شاخه نامگذاری شده نشان دهید (منسوخ شده)

-ب،--شاخه
تغییرات را در شاخه نامگذاری شده نشان دهید

-پ،-- هرس کنید
ویرایش یا هیچ یک از اجداد آن را نمایش ندهید

-پ، -- پچ
نشان دادن پچ

-g، --git
از فرمت git extended diff استفاده کنید

-ل،--حد
محدود کردن تعداد تغییرات نمایش داده شده

-M، -----ادغام نمی شود
ادغام ها را نشان ندهید

--stat خلاصه تغییرات به سبک diffstat خروجی

-G، -- نمودار
بازبینی DAG را نشان دهید

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

hgcia
قلاب هایی برای ادغام با سرویس اعلان CIA.vc

این قرار است به عنوان یک گروه تغییر یا قلاب ورودی اجرا شود. برای پیکربندی، آن را تنظیم کنید
گزینه های زیر در hgrc شما:

[cia]
# نام کاربری ثبت شده سیا شما
کاربر = فو
# نام پروژه در سیا
پروژه = فو
# ماژول (پروژه فرعی) (اختیاری)
#ماژول = فو
# یک diffstat را به پیام گزارش اضافه کنید (اختیاری)
#diffstat = نادرست
# الگو برای استفاده برای پیام های گزارش (اختیاری)
#template = {desc}\n{baseurl}{webroot}/rev/{node}-- {diffstat}
# سبک برای استفاده (اختیاری)
#سبک = فو
# URL سرویس اطلاع رسانی سیا (اختیاری)
# می‌توانید از mailto استفاده کنید: نشانی‌های اینترنتی برای ارسال از طریق ایمیل، به عنوان مثال
# لازمه: mailto[ایمیل محافظت شده]
# در صورت انجام این کار حتما email.from را تنظیم کنید.
#url = http://cia.vc/
# چاپ پیام به جای ارسال آن (اختیاری)
#تست = غلط
# تعداد اسلش برای حذف مسیرهای آدرس اینترنتی
#نوار = 0

[قلاب]
# یکی از اینها:
changegroup.cia = python:hgcia.hook
#incoming.cia = python:hgcia.hook

[وب]
# اگر هایپرلینک می خواهید (اختیاری)
بیسورل = http://server/path/to/repo

hgk
مخزن را به صورت گرافیکی مرور کنید

پسوند hgk اجازه می دهد تا تاریخچه یک مخزن را به صورت گرافیکی مرور کنید. آی تی
به Tcl/Tk نسخه 8.4 یا بالاتر نیاز دارد. (Tcl/Tk با Mercurial توزیع نمی شود.)

hgk از دو بخش تشکیل شده است: یک اسکریپت Tcl که نمایش و پرس و جو را انجام می دهد
اطلاعات، و یک برنامه افزودنی برای Mercurial به نام hgk.py، که قلاب هایی را برای hgk به
اطلاعات بگیر. hgk را می توان در دایرکتوری مشارکت پیدا کرد و پسوند ارسال می شود
در مخزن hgext، و باید فعال شود.

La hg دیدن دستور اسکریپت hgk Tcl را راه اندازی می کند. برای اینکه این دستور کار کند، hgk باید باشد
در مسیر جستجوی شما همچنین می توانید مسیر hgk را در پیکربندی خود مشخص کنید
فایل:

[hgk]
مسیر = /location/of/hgk

hgk می تواند از پسوند extdiff برای تجسم ویرایش ها استفاده کند. به فرض که داشتی
دستور extdiff vdiff قبلاً پیکربندی شده است، فقط اضافه کنید:

[hgk]
vdiff=vdiff

منوی زمینه ویرایش‌ها اکنون ورودی‌های اضافی را برای فعال کردن vdiff در hovered و نمایش می‌دهد
بازبینی های انتخاب شده

دستورات
دیدن
نمایشگر تاریخچه تعاملی را شروع کنید:

نمای hg [-l LIMIT] [REVRANGE]

نمایشگر تاریخچه تعاملی را شروع کنید

گزینه های ارسال:

-ل،--حد
محدود کردن تعداد تغییرات نمایش داده شده

برجسته
برجسته سازی نحو برای hgweb (نیاز به Pygments)

این به کتابخانه برجسته سازی نحوی Pygments بستگی دارد: http://pygments.org/

گزینه های پیکربندی زیر وجود دارد:

[وب]
pygments_style = (default: colorful)
هایلایت فایل = (پیش‌فرض: اندازه ('<5M'))
highlightonlymatchfilename = (پیش فرض نادرست)

highlightonlymatchfilename فقط در صورتی فایل ها را برجسته می کند که نوع آنها توسط آنها قابل شناسایی باشد
نام فایل آنها وقتی این فعال نباشد (پیش‌فرض)، Pygments بسیار تلاش می‌کند
نوع فایل را از روی محتوا و هر تطابقی (حتی مطابق با اطمینان کم) شناسایی کنید
امتیاز) استفاده خواهد شد.

هیستیدیت
ویرایش تعاملی تاریخ

با نصب این افزونه، مرکوریال یک فرمان جدید به دست می آورد: histedit. استفاده به صورت است
با فرض سابقه زیر به شرح زیر است:

@ 3[tip] 7c2fd3b9020c 2009-04-27 18:04 -0500 durin42
| دلتا را اضافه کنید
|
o 2 030b686bedc4 2009-04-27 18:04 -0500 durin42
| گاما را اضافه کنید
|
o 1 c561b4e977df 2009-04-27 18:04 -0500 durin42
| بتا اضافه کنید
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
آلفا را اضافه کنید

اگر قرار بود بدوید hg هیستیدیت c561b4e977df، فایل زیر را در خود باز می بینید
ویرایشگر:

c561b4e977df را انتخاب کنید بتا را اضافه کنید
030b686bedc4 را انتخاب کنید گاما را اضافه کنید
7c2fd3b9020c را انتخاب کنید دلتا را اضافه کنید

# ویرایش تاریخچه بین c561b4e977df و 7c2fd3b9020c
#
# تعهدات از کمترین تا جدیدترین فهرست شده اند
#
# دستورات:
# p، انتخاب = استفاده از commit
# e، ویرایش = از commit استفاده کنید، اما برای اصلاح متوقف شوید
# f، fold = از commit استفاده کنید، اما آن را با مورد بالا ترکیب کنید
# r، roll = مانند fold، اما توضیحات این commit را کنار بگذارید
# d، drop = حذف commit از تاریخچه
# m, mess = ویرایش پیام commit بدون تغییر محتوای commit
#

در این فایل، خطوطی که با # نادیده گرفته می شوند. باید برای هر کدام یک قانون مشخص کنید
تجدید نظر در تاریخ شما به عنوان مثال، اگر قصد داشتید قبل از بتا گاما را اضافه کنید و سپس
می‌خواهید دلتا را در همان نسخه بتا اضافه کنید، می‌توانید فایل را دوباره سازماندهی کنید تا ظاهر شود
مثل این:

030b686bedc4 را انتخاب کنید گاما را اضافه کنید
c561b4e977df را انتخاب کنید بتا را اضافه کنید
7c2fd3b9020c را تا بزنید دلتا را اضافه کنید

# ویرایش تاریخچه بین c561b4e977df و 7c2fd3b9020c
#
# تعهدات از کمترین تا جدیدترین فهرست شده اند
#
# دستورات:
# p، انتخاب = استفاده از commit
# e، ویرایش = از commit استفاده کنید، اما برای اصلاح متوقف شوید
# f، fold = از commit استفاده کنید، اما آن را با مورد بالا ترکیب کنید
# r، roll = مانند fold، اما توضیحات این commit را کنار بگذارید
# d، drop = حذف commit از تاریخچه
# m, mess = ویرایش پیام commit بدون تغییر محتوای commit
#

در این مرحله ویرایشگر را می بندید و هیستیدیت شروع به کار می کند وقتی الف را مشخص می کنید تا کردن
عمل، هیستیدیت زمانی که این ویرایش‌ها را با هم جمع می‌کند، یک ویرایشگر باز می‌کند و ارائه می‌کند
شما فرصتی برای پاک کردن پیام commit دارید:

بتا اضافه کنید
***
دلتا را اضافه کنید

پیام commit را مطابق میل خود ویرایش کنید، سپس ویرایشگر را ببندید. برای این مثال، اجازه دهید
فرض کنید پیام commit به تغییر کرده است اضافه کردن بتا و دلتا پس از اجرای histedit
و فرصتی برای حذف هر گونه تجدید نظر قدیمی یا موقتی که نیاز داشت، به نظر می رسد
مثل این:

@ 2[tip] 989b4d060121 2009-04-27 18:04 -0500 durin42
| بتا و دلتا را اضافه کنید.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 durin42
| گاما را اضافه کنید
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
آلفا را اضافه کنید

توجه داشته باشید که هیستیدیت میکند نه حذف هر گونه تجدید نظر (حتی نسخه های موقت خود) تا بعد از آن
تمام عملیات ویرایش را تکمیل کرده است، بنابراین احتمالاً چندین نوار را انجام خواهد داد
عملیات زمانی که انجام شد برای مثال بالا، باید نوار را دو بار اجرا می کرد. نوار می تواند باشد
بسته به عوامل مختلفی کند است، بنابراین ممکن است لازم باشد کمی صبور باشید. تو می توانی
با گذراندن گزینه، بازبینی های اصلی را حفظ کنید --نگاه داشتن پرچم.

La ویرایش کنید عملیات شما را به یک خط فرمان باز می‌گرداند و به شما امکان ویرایش فایل‌ها را می‌دهد
آزادانه یا حتی استفاده کنید hg رکورد برای انجام برخی تغییرات به عنوان یک commit جداگانه. وقتی شما هستید
انجام شود، هر گونه تغییرات غیرمتعهد باقی مانده نیز متعهد خواهد شد. پس از اتمام، اجرا کنید hg
هیستیدیت --ادامه هید برای اتمام این مرحله از شما یک پیام commit جدید خواسته می شود، اما
پیام commit پیش فرض پیام اصلی برای ویرایش کنید ویرایش ویرایش

La پیام عملیات به شما فرصتی می دهد تا پیام commit را بدون تغییر اصلاح کنید
مطالب این یک میانبر برای انجام دادن است ویرایش کنید بلافاصله به دنبال hg هیستیدیت
--ادامه`.

If هیستیدیت هنگام جابجایی یک ویرایش (هنگام مدیریت، با یک تضاد مواجه می شود انتخاب کنید or تا کردن),
به روشی مشابه متوقف خواهد شد ویرایش کنید با این تفاوت که شما را برای یک درخواست نمی کند
commit پیام پس از اتمام اگر در این مرحله تصمیم گرفتید که چقدر کار را دوست ندارید
خواهد بود برای تنظیم مجدد تاریخ، و یا اینکه شما مرتکب اشتباه، شما می توانید استفاده کنید hg هیستیدیت -- سقط
تا تغییرات جدیدی را که ایجاد کرده اید رها کنید و به حالت قبل از تلاش برگردید
تاریخچه خود را ویرایش کنید

اگر مخزن نمونه هیستدیت شده در بالا را کلون کنیم و چهار تغییر دیگر اضافه کنیم، به این ترتیب
ما تاریخچه زیر را داریم:

@ 6[tip] 038383181893 2009-04-27 18:04 -0500 stefan
| تتا را اضافه کنید
|
o 5 140988835471 2009-04-27 18:04 -0500 stefan
| eta را اضافه کنید
|
o 4 122930637314 2009-04-27 18:04 -0500 stefan
| زتا را اضافه کنید
|
o 3 836302820282 2009-04-27 18:04 -0500 stefan
| اپسیلون را اضافه کنید
|
o 2 989b4d060121 2009-04-27 18:04 -0500 durin42
| بتا و دلتا را اضافه کنید.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 durin42
| گاما را اضافه کنید
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
آلفا را اضافه کنید

اگر اجرا کنی hg هیستیدیت --برونگرا در کلون پس از آن همان اجرا است hg هیستیدیت
836302820282. اگر نیاز به برنامه ریزی برای فشار دادن به مخزنی دارید که Mercurial آن را شناسایی نمی کند
مربوط به مخزن منبع باشد، می توانید a اضافه کنید --زور گزینه.

پیکربندی
خطوط قانون Histedit به طور پیش فرض به 80 کاراکتر کوتاه شده است. شما می توانید این را سفارشی کنید
با تنظیم طول متفاوت در فایل پیکربندی خود رفتار کنید:

[histedit]
linelen = 120 # خطوط قانون را با 120 کاراکتر کوتاه کنید

hg هیستیدیت تلاش می کند به طور خودکار یک بازنگری پایه مناسب را برای استفاده انتخاب کند. به
تغییر دهید که کدام نسخه پایه استفاده می شود، یک revset در فایل پیکربندی خود تعریف کنید:

[histedit]
defaultrev = only(.) & draft()

به طور پیش فرض هر نسخه ویرایش شده باید در دستورات histedit وجود داشته باشد. برای حذف
ویرایشی که باید استفاده کنید قطره عمل. شما می توانید قطره را طوری پیکربندی کنید که برای آن ضمنی باشد
تعهدات گمشده با اضافه کردن:

[histedit]
رها کردن = درست است

دستورات
هیستیدیت
به صورت تعاملی تاریخچه تغییرات را ویرایش کنید:

hg histedit [گزینه‌ها] ([اجداد] | --خروجی [URL])

این دستور به شما امکان می‌دهد مجموعه‌ای خطی از تغییرات را ویرایش کنید (تا و شامل موارد کار).
دایرکتوری که باید تمیز باشد). تو می توانی:

· انتخاب کنید برای [دوباره] سفارش یک تغییرات

· قطره برای حذف تغییرات

· یک ظرف غذا برای بازنویسی پیام commit تغییرات مجموعه

· تا کردن برای ترکیب آن با تغییرات قبلی

· چرخش مانند fold، اما از توضیحات این commit صرف نظر کنید

· ویرایش کنید برای ویرایش این تغییرات

چندین راه برای انتخاب تغییرات root وجود دارد:

· ANCETOR را مستقیماً مشخص کنید

· استفاده از --خروجی -- این اولین مجموعه تغییرات خطی خواهد بود که در مقصد گنجانده نشده است.
(نگاه کنید به hg کمک config.default-push)

· در غیر این صورت، مقدار از گزینه پیکربندی "histedit.defaultrev" به عنوان یک تنظیم مجدد برای
زمانی که ANCESTOR مشخص نشده است، نسخه پایه را انتخاب کنید. بازنگری اول توسط
revset استفاده شده است. به طور پیش فرض، این تاریخچه قابل ویرایش را انتخاب می کند که منحصر به فرد است
اصل و نسب فهرست کاری

اگر از --outgoing استفاده کنید، در صورت وجود ویرایش های مبهم خروجی، این دستور لغو می شود.
به عنوان مثال، اگر چندین شعبه حاوی ویرایش های خروجی وجود داشته باشد.

از "min(outgoing() و ::.)" یا مشخصات مشابه به جای --outgoing به استفاده کنید.
ویرایش هدف را دقیقاً در چنین شرایط مبهم مشخص کنید. دیدن hg کمک دوباره تنظیم می کند برای
جزئیات در مورد انتخاب ویرایش ها

مثال:

· تعدادی تغییرات ایجاد شده است. ویرایش 3 دیگر مورد نیاز نیست.

شروع ویرایش تاریخچه از ویرایش 3:

hg histedit -r 3

یک ویرایشگر باز می‌شود که شامل فهرستی از بازبینی‌ها می‌شود و اقدامات خاصی مشخص شده است:

5339bf82f0ca 3 Zworgle را انتخاب کنید
8ef592ce7cc4 را انتخاب کنید 4 زرلوگ را خیره کنید
0a9639fcda9d 5 را انتخاب کنید cromulancy را برطرف کنید

اطلاعات اضافی در مورد اقدامات احتمالی برای انجام در زیر لیست ظاهر می شود
تجدید نظرها

برای حذف نسخه 3 از تاریخچه، اقدام آن (در ابتدای مربوطه
خط) به "قطع" تغییر می کند:

drop 5339bf82f0ca 3 Zworgle the foobar
8ef592ce7cc4 را انتخاب کنید 4 زرلوگ را خیره کنید
0a9639fcda9d 5 را انتخاب کنید cromulancy را برطرف کنید

· تعدادی تغییرات ایجاد شده است. ویرایش 2 و 4 باید تعویض شوند.

شروع ویرایش تاریخچه از ویرایش 2:

hg histedit -r 2

یک ویرایشگر باز می‌شود که شامل فهرستی از بازبینی‌ها می‌شود و اقدامات خاصی مشخص شده است:

انتخاب 252a1af424ad 2 Blorb a morgwazzle
5339bf82f0ca 3 Zworgle را انتخاب کنید
8ef592ce7cc4 را انتخاب کنید 4 زرلوگ را خیره کنید

برای تعویض نسخه 2 و 4، خطوط آن در ویرایشگر تعویض می شود:

8ef592ce7cc4 را انتخاب کنید 4 زرلوگ را خیره کنید
5339bf82f0ca 3 Zworgle را انتخاب کنید
انتخاب 252a1af424ad 2 Blorb a morgwazzle

0 در صورت موفقیت، 1 در صورت نیاز به مداخله کاربر (نه فقط برای "ویرایش" عمدی
فرمان، بلکه برای حل تعارضات غیرمنتظره).

گزینه های ارسال:

-- دستورات
ویرایش های تاریخچه را از فایل مشخص شده بخوانید

-c، --ادامه هید
ویرایشی را که از قبل در حال انجام است ادامه دهید

--ویرایش-طرح
لیست اقدامات باقی مانده را ویرایش کنید

-k، --نگاه داشتن
گره های قدیمی را پس از تکمیل ویرایش، پاک نکنید

-- سقط
لغو ویرایش در حال انجام

-و ، --برونگرا
تغییرات در مقصد یافت نشد

-f، --زور
اجبار خروجی حتی برای مخازن نامرتبط

-r،-- برگشت
اولین ویرایش برای ویرایش

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

کلمه کلیدی
گسترش کلمات کلیدی در فایل های ردیابی شده

این برنامه افزودنی $Keywords$ مانند RCS/CVS یا شخصی‌سازی‌شده را در فایل‌های متنی ردیابی شده گسترش می‌دهد.
توسط پیکربندی شما انتخاب شده است.

کلمات کلیدی فقط در مخازن محلی گسترش می یابند و در تاریخچه تغییرات ذخیره نمی شوند. در
مکانیزم را می توان به عنوان یک راحتی برای کاربر فعلی یا برای آرشیو در نظر گرفت
توزیع.

کلیدواژه ها به داده های مجموعه تغییرات مربوط به آخرین تغییر نسبت به آن گسترش می یابند
والد دایرکتوری کاری هر فایل.

پیکربندی در بخش‌های [keyword]، [keywordset] و [keywordmaps] hgrc انجام می‌شود.
فایل های.

مثال:

[کلمه کلیدی]
# گسترش کلمات کلیدی در هر فایل پایتون به جز مواردی که با "x*" مطابقت دارند.
**.py =
x* = نادیده گرفتن

[مجموعه کلمات کلیدی]
# نقشه‌های کلیدواژه‌های پیش‌فرض svn-مانند cvs را ترجیح می‌دهند
svn = درست است

توجه داشته باشید هرچه در الگوهای نام فایل خود دقیق تر باشید، سرعت کمتری را از دست خواهید داد
مخازن

برای [keywordmaps] نگاشت قالب و نمایش و کنترل اجرا hg kwdemo.
دیدن hg کمک قالب برای لیستی از قالب ها و فیلترهای موجود.

سه فیلتر قالب تاریخ اضافی ارائه شده است:

utcdate

"2006/09/18 15:13:13"

svnutcdate

"2006-09-18 15:13:13Z"

svnisodate

"2006-09-18 08:13:13 -700 (Mon, 18 Sep 2006)"

نگاشتهای قالب پیش فرض (مشاهده با hg kwdemo -d) را می توان با سفارشی جایگزین کرد
کلمات کلیدی و قالب ها باز هم فرار کن hg kwdemo برای کنترل نتایج پیکربندی خود
تغییرات.

قبل از تغییر/غیرفعال کردن کلمات کلیدی فعال، باید اجرا کنید hg kwshrink برای جلوگیری از ذخیره سازی
کلمات کلیدی گسترش یافته در تاریخچه تغییرات

برای اجبار گسترش پس از فعال کردن آن، یا تغییر پیکربندی، اجرا کنید hg kwexpand.

بسط های بیش از یک خط و بسط های افزایشی، مانند $Log$ CVS، هستند
پشتیبانی نشده. نقشه الگوی کلمه کلیدی "Log = {desc}" به خط اول گسترش می یابد
توضیحات تغییرات

دستورات
kwdemo
print [keywordmaps] پیکربندی و یک مثال بسط:

hg kwdemo [-d] [-f RCFILE] [TEMPLATEMAP]...

نقشه های قالب کلیدواژه فعلی، سفارشی یا پیش فرض و بسط آنها را نمایش دهید.

با مشخص کردن نقشه ها به عنوان آرگومان و استفاده از -f/--rcfile، پیکربندی فعلی را گسترش دهید.
منبع یک فایل hgrc خارجی

از -d/--default برای غیرفعال کردن پیکربندی فعلی استفاده کنید.

دیدن hg کمک قالب برای اطلاعات در مورد قالب ها و فیلترها.

گزینه های ارسال:

-د، -- پیش فرض
نمایش نقشه های قالب کلیدواژه پیش فرض

-f،-rcfile
نقشه ها را از rcfile بخوانید

kwexpand
گسترش کلمات کلیدی در دایرکتوری کاری:

hg kwexpand [OPTION]... [FILE]...

پس از (دوباره) فعال کردن گسترش کلمه کلیدی اجرا شود.

اگر فایل های داده شده حاوی تغییرات محلی باشند، kwexpand از اجرا خودداری می کند.

گزینه های ارسال:

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

kwfiles
نمایش فایل های پیکربندی شده برای گسترش کلمه کلیدی:

hg kwfiles [OPTION]... [FILE]...

فهرست کنید که کدام فایل ها در دایرکتوری کاری با پیکربندی [keyword] مطابقت دارند
الگوهای.

برای جلوگیری از گسترش ناخواسته کلمه کلیدی و افزایش سرعت اجرا با گنجاندن مفید است
فقط فایل هایی که کاندیدای واقعی برای گسترش هستند.

دیدن hg کمک کلمه کلیدی در مورد چگونگی ساخت الگوهایی هم برای گنجاندن و هم برای حذف
فایل های.

با -A/--all و -v/--verbose کدهای مورد استفاده برای نشان دادن وضعیت فایل ها عبارتند از:

K = نامزد گسترش کلمه کلیدی
k = نامزد گسترش کلمه کلیدی (ردیابی نشده)
من = نادیده گرفته شدم
i = نادیده گرفته شد (ردیابی نشد)

گزینه های ارسال:

-آ، --همه
پرچم های وضعیت کلمه کلیدی همه فایل ها را نشان دهید

-من، --چشم پوشی
نمایش فایل های حذف شده از گسترش

-u، --ناشناس
فقط فایل های ناشناخته (ردیابی نشده) را نشان می دهد

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

kwshrink
کلمات کلیدی گسترش یافته را در دایرکتوری کاری برگردانید:

hg kwshrink [OPTION]... [FILE]...

قبل از تغییر/غیرفعال کردن کلمات کلیدی فعال باید اجرا شود.

اگر فایل های داده شده حاوی تغییرات محلی باشند، kwshrink از اجرا خودداری می کند.

گزینه های ارسال:

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

فایل های بزرگ
ردیابی فایل های باینری بزرگ

فایل‌های باینری بزرگ معمولاً نه چندان قابل فشرده‌سازی هستند، نه خیلی قابل تغییر هستند و نه اصلاً
قابل ادغام چنین فایل هایی با فرمت ذخیره سازی Mercurial (revlog) به طور موثر مدیریت نمی شوند.
که مبتنی بر دلتاهای باینری فشرده است. ذخیره فایل های باینری بزرگ به صورت معمولی
فایل‌های Mercurial پهنای باند و فضای دیسک را هدر می‌دهند و استفاده از حافظه Mercurial را افزایش می‌دهند.
پسوند largefiles این مشکلات را با افزودن یک سرویس گیرنده-سرور متمرکز برطرف می کند
لایه بالای مرکوریال: فایل های بزرگ در الف زندگی می کنند مرکزی opbevare در شبکه
در جایی، و شما فقط در زمانی که به آن‌ها نیاز دارید، ویرایش‌هایی را که نیاز دارید دریافت می‌کنید.

largefiles با نگهداری یک "فایل standin" در .hglf/ برای هر فایل بزرگ کار می کند. در
استندین ها کوچک هستند (41 بایت: هش SHA-1 به اضافه خط جدید) و توسط Mercurial ردیابی می شوند.
نسخه های بزرگ فایل با هش SHA-1 محتویات آنها که نوشته شده است شناسایی می شوند
به جایگاه largefiles از شناسه ویرایش برای دریافت/قرار دادن نسخه های بزرگ فایل از/به استفاده می کند
فروشگاه مرکزی این باعث صرفه جویی در فضای دیسک و پهنای باند می شود، زیرا شما نیازی به این کار ندارید
تمام ویرایش های تاریخی فایل های بزرگ را هنگام شبیه سازی یا کشیدن بازیابی کنید.

برای راه‌اندازی یک مخزن جدید یا افزودن فایل‌های باینری بزرگ جدید، کافی است --large را به خود اضافه کنید hg اضافه کردن
فرمان مثلا:

$ dd if=/dev/urandom of=randomdata count=2000
$ hg اضافه کردن -- داده های تصادفی بزرگ
$ hg commit -m "افزودن داده های تصادفی به عنوان یک فایل بزرگ"

هنگامی که مجموعه تغییراتی را فشار می دهید که فایل های بزرگ را به یک مخزن راه دور اضافه یا تغییر می دهد،
نسخه بزرگ فایل همراه با آن آپلود خواهد شد. توجه داشته باشید که مرکوریال از راه دور باید
همچنین پسوند largefiles را برای این کار فعال کنید.

هنگامی که یک مجموعه تغییراتی را که روی فایل های بزرگ تأثیر می گذارد، از یک مخزن راه دور بیرون می آورید، فایل های بزرگ
زیرا تغییرات به طور پیش فرض پایین کشیده نمی شود. با این حال، هنگامی که شما به چنین یک
ویرایش، هر فایل بزرگ مورد نیاز آن ویرایش دانلود و ذخیره می شود (در صورت وجود
قبلا دانلود نشده بود). یکی از راه‌های کشیدن فایل‌های بزرگ هنگام کشیدن، استفاده از آن است
---update، که کپی کاری شما را به آخرین ویرایش کشیده شده به روز می کند (و در نتیجه
دانلود هر فایل بزرگ جدید).

اگر می‌خواهید فایل‌های بزرگی را که هنوز برای به‌روزرسانی نیاز ندارید، بکشید، می‌توانید از pull with استفاده کنید
la -- frev گزینه یا hg lfpull فرمان

اگر می‌دانید که از یک مکان غیر پیش‌فرض خارج می‌شوید و می‌خواهید همه آن‌ها را دانلود کنید
فایل های بزرگی که همزمان با تغییرات جدید مطابقت دارند، سپس می توانید با آن ها را بکشید
-- frev "کشیده()".

اگر فقط می‌خواهید مطمئن شوید که فایل‌های بزرگ مورد نیاز برای ادغام یا تغییر پایه را در اختیار خواهید داشت
با سرهای جدیدی که در حال کشیدن آنها هستید، سپس می توانید با آنها بکشید -- frev "سر(کشیده())" پرچم
برای دانلود پیشگیرانه هر فایل بزرگی که در سرهایی که می کشید جدید هستند.

به خاطر داشته باشید که اکنون ممکن است برای به روز رسانی به تغییراتی که دارید به دسترسی به شبکه نیاز باشد
قبلاً به روز نشده است. ماهیت پسوند largefiles به این معنی است که به روز رسانی است
دیگر تضمین نمی شود که یک عملیات فقط محلی باشد.

اگر قبلاً فایل های بزرگی دارید که توسط Mercurial بدون پسوند largefiles ردیابی شده اند، شما
برای بهره مندی از فایل های بزرگ، باید مخزن خود را تبدیل کنید. این کار انجام می شود
با hg lfconvert فرمان:

$ hg lfconvert --size 10 oldrepo newrepo

در مخازنی که در حال حاضر فایل های بزرگ در آنها وجود دارد، هر فایل جدید بیش از 10 مگابایت خواهد بود
به طور خودکار به عنوان یک فایل بزرگ اضافه می شود. برای تغییر این آستانه، تنظیم کنید largefiles.minsize in
فایل پیکربندی Mercurial خود را به حداقل اندازه در مگابایت برای ردیابی به عنوان یک فایل بزرگ یا
از گزینه --lfsize برای دستور add (همچنین در مگابایت) استفاده کنید:

[فایل های بزرگ]
کوچک = 2

$ hg اضافه کنید --lfsize 2

La largefiles.patterns گزینه config به شما امکان می دهد لیستی از الگوهای نام فایل را مشخص کنید
(نگاه کنید به hg کمک الگوهای) که همیشه باید به عنوان فایل های بزرگ ردیابی شوند:

[فایل های بزرگ]
الگوها =
* .jpg
re:.*\.(png|bmp)$
library.zip
محتوا/صوتی/*

فایل هایی که با یکی از این الگوها مطابقت دارند، بدون توجه به آنها به عنوان فایل های بزرگ اضافه می شوند
اندازه.

La largefiles.minsize و largefiles.patterns گزینه های پیکربندی برای هر کدام نادیده گرفته می شود
مخازن که قبلاً حاوی فایل بزرگ نیستند. برای افزودن اولین فایل بزرگ به a
مخزن، شما باید به صراحت این کار را با پرچم --large که به آن ارسال شده است انجام دهید hg اضافه کردن فرمان

دستورات
lfconvert
یک مخزن معمولی را به یک مخزن بزرگ فایل ها تبدیل کنید:

hg lfconvert منبع DEST [فایل ...]

مخزن SOURCE را به یک مخزن DEST جدید، یکسان با SOURCE تبدیل کنید با این تفاوت که
فایل های خاصی به عنوان فایل های بزرگ تبدیل می شوند: به طور خاص، هر فایلی که با هر کدام مطابقت دارد
الگو or که اندازه آن بالاتر از حداقل آستانه اندازه است به عنوان یک فایل بزرگ تبدیل می شود. در
اندازه مورد استفاده برای تعیین اینکه آیا یک فایل را به عنوان یک فایل بزرگ ردیابی کنیم یا نه، اندازه آن است
نسخه اول فایل حداقل اندازه را می توان با --size یا in مشخص کرد
پیکربندی به عنوان largefiles.size.

پس از اجرای این دستور، باید مطمئن شوید که فایل های بزرگ در هر جایی فعال هستند
شما قصد دارید مخزن جدید را فشار دهید.

از --to-normal برای تبدیل فایل های بزرگ به فایل های معمولی استفاده کنید. پس از این، DEST
مخزن را می توان بدون فایل های بزرگ استفاده کرد.

گزینه های ارسال:

-s ،--اندازه
حداقل اندازه (MB) برای فایل هایی که باید به فایل های بزرگ تبدیل شوند

--به حالت عادی
تبدیل از یک مخزن بزرگ فایل به یک مخزن معمولی

lfpull
فایل های بزرگ را برای ویرایش های مشخص شده از منبع مشخص شده بکشید:

hg lfpull -r REV... [-e CMD] [--remotecmd CMD] [منبع]

فایل های بزرگی را که از تغییرات محلی ارجاع داده شده اند اما به صورت محلی وجود ندارند، بکشید
از یک مخزن راه دور به حافظه پنهان محلی.

اگر SOURCE حذف شود، مسیر "پیش فرض" استفاده خواهد شد. دیدن hg کمک URL ها برای اطلاعات بیشتر
اطلاعات.

بعضی مثالها:

· کشیدن فایل های بزرگ برای همه سر شاخه ها:

hg lfpull -r "head() and not close()"

· فایل های بزرگ را در شاخه پیش فرض بکشید:

hg lfpull -r "شاخه(پیش فرض)"

گزینه های ارسال:

-r،-- برگشت
فایل های بزرگ را برای این ویرایش ها بکشید

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

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

mq
دسته ای از وصله ها را مدیریت کنید

این برنامه افزودنی به شما امکان می دهد با پشته ای از وصله ها در یک مخزن Mercurial کار کنید. مدیریت می کند
دو پشته از وصله ها - همه وصله های شناخته شده، و وصله های اعمال شده (زیر مجموعه پچ های شناخته شده).

وصله های شناخته شده به عنوان فایل های وصله در دایرکتوری hg/patches نشان داده می شوند. پچ های اعمال شده
هم فایل های پچ هستند و هم مجموعه تغییرات.

وظایف مشترک (استفاده از hg کمک فرمان برای جزئیات بیشتر):

پچ جدید qnew بسازید
پچ موجود qimport را وارد کنید

پرینت پچ سری qseries
وصله های کاربردی چاپ شده

پچ شناخته شده را به stack qpush اعمال شده اضافه کنید
پچ را از پشته اعمال شده qpop حذف کنید
تازه کردن محتویات پچ بالای اعمال شده qrefresh

به‌طور پیش‌فرض، mq به‌طور خودکار در صورت نیاز از وصله‌های git استفاده می‌کند تا حالت فایل را از دست ندهد
تغییرات، کپی رکوردها، فایل های باینری یا فایل های خالی ایجاد یا حذف. این رفتار
قابل پیکربندی با:

[mq]
git = خودکار / نگه داشتن / بله / خیر

اگر روی "keep" تنظیم شود، mq از پیکربندی بخش [diff] پیروی می کند و در عین حال موجود را حفظ می کند.
وصله های git روی qrefresh. اگر روی "بله" یا "خیر" تنظیم شود، mq بخش [تفاوت] را لغو می کند
و همیشه git یا وصله‌های معمولی تولید می‌کنند که احتمالاً در مورد دوم داده‌ها را از دست می‌دهند.

ممکن است مطلوب باشد که تغییرات mq در فاز مخفی نگهداری شوند (نگاه کنید به hg کمک فاز),
که با تنظیمات زیر قابل فعال کردن است:

[mq]
راز = درست

شما به طور پیش فرض یک صف وصله به نام "patches" را مدیریت خواهید کرد. شما می توانید موارد دیگر را ایجاد کنید،
صف های پچ مستقل با hg صف فرمان

اگر دایرکتوری کاری حاوی فایل های غیرمتعهد است، qpush، qpop و qgoto abort
بلافاصله. مستقیما. اگر از -f/--force استفاده شود، تغییرات کنار گذاشته می شوند. تنظیمات:

[mq]
keepchanges = درست است

آنها را وادار کنید طوری رفتار کنند که گویی تغییرات ---keep تصویب شده است و تغییرات محلی غیر متضاد انجام خواهد شد
قابل تحمل و حفظ شود. اگر گزینه های ناسازگار مانند -f/--force یا --exact هستند
گذشت، این تنظیم نادیده گرفته شد.

این پسوند برای ارائه یک دستور نوار استفاده می شود. این دستور اکنون در نوار وجود دارد
افزونه.

دستورات
اعمال شده است
وصله هایی که قبلا اعمال شده اند را چاپ کنید:

hg qapplied [-1] [-s] [PATCH]

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-1، --آخر
فقط پچ اعمال شده قبلی را نشان دهید

-s ، --خلاصه
خط اول هدر پچ را چاپ کنید

qclone
کلون کردن مخزن اصلی و پچ همزمان:

hg qclone [OPTION]... منبع [DEST]

اگر منبع محلی باشد، مقصد هیچ وصله‌ای اعمال نخواهد شد. اگر منبع از راه دور است، این
فرمان نمی تواند بررسی کند که آیا وصله ها در منبع اعمال شده اند یا خیر، بنابراین نمی توان آن وصله ها را تضمین کرد
در مقصد اعمال نمی شوند. اگر مخزن از راه دور را شبیه سازی می کنید، قبل از آن مطمئن شوید که آن را انجام داده است
هیچ وصله ای اعمال نشده است

مخزن وصله منبع در جستجو شده است /.hg/patches به طور پیش فرض. از -p استفاده کنید به
را تغییر دهید.

دایرکتوری پچ باید یک مخزن Mercurial تو در تو باشد، همانطور که توسط ایجاد می شود hg init انجام
--mq.

با موفقیت 0 را برگردانید.

گزینه های ارسال:

--کشیدن از پروتکل pull برای کپی متادیتا استفاده کنید

-U، -- به روز رسانی
دایرکتوری های کاری جدید را به روز نکنید

-- فشرده نشده
استفاده از انتقال غیر فشرده (سریع از طریق LAN)

-پ،-- تکه ها
محل مخزن پچ منبع

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

qcommit
انجام تغییرات در مخزن صف (منسوخ شده):

hg qcommit [OPTION]... [FILE]...

این دستور منسوخ شده است. استفاده کنید hg مرتکب شدن --mq به جای آن.

گزینه های ارسال:

-آ، --اضافه کردن حذف
قبل از انجام، فایل‌های جدید/از دست رفته را به‌عنوان اضافه/حذف شده علامت‌گذاری کنید

-- نزدیک شعبه
یک سر شاخه را بسته علامت بزنید

--اصلاح
والد دایرکتوری کاری را اصلاح کنید

-s ، --راز
از مرحله مخفی برای ارتکاب استفاده کنید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-من، --در ارتباط بودن
از حالت تعاملی استفاده کنید

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

-S، -- subrepos
بازگشت به مخازن فرعی

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

نام مستعار: qci

qdelete
حذف وصله ها از صف:

hg qdelete [-k] [PATCH]...

پچ ها نباید اعمال شوند و حداقل یک پچ لازم است. پچ دقیق
شناسه ها باید داده شود با -k/--keep، فایل‌های پچ در پچ حفظ می‌شوند
دایرکتوری.

برای توقف مدیریت یک پچ و انتقال آن به تاریخچه دائمی، از hg پایان دادن فرمان

گزینه های ارسال:

-k، --نگاه داشتن
فایل پچ را نگه دارید

-r،-- برگشت
توقف مدیریت یک ویرایش (منسوخ شده)

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

نام مستعار: qremove qrm

qdiff
تفاوت پچ فعلی و تغییرات بعدی:

hg qdiff [OPTION]... [FILE]...

تفاوتی را نشان می دهد که شامل وصله فعلی و همچنین تغییرات ایجاد شده است
در پوشه کاری از آخرین رفرش (بنابراین نشان می دهد که وصله فعلی چه خواهد کرد
بعد از قرفرش شدن).

استفاده کنید hg تفاوت اگر فقط می خواهید تغییرات ایجاد شده از آخرین qrefresh را ببینید یا hg صادرات
qtip اگر می خواهید تغییرات ایجاد شده توسط پچ فعلی را بدون درج تغییرات انجام شده مشاهده کنید
از زمان qrefresh.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-آ، --متن
تمام فایل ها را به عنوان متن در نظر بگیرید

-g، --git
از فرمت git extended diff استفاده کنید

-- گره ها
تاریخ ها را از سرصفحه های متفاوت حذف کنید

-- بدون پیشوند
پیشوندهای a/ و b/ را از نام فایل حذف کنید

-پ، --نمایش عملکرد
نشان دهید که هر تغییر در کدام تابع است

--معکوس
یک تفاوت تولید می کند که تغییرات را خنثی می کند

-w، - نادیده گرفتن همه فضا
هنگام مقایسه خطوط، فضای سفید را نادیده بگیرید

-ب، - نادیده گرفتن-فضا-تغییر
تغییرات در مقدار فضای سفید را نادیده بگیرید

-ب، -نادیده گرفتن-خطوط خالی
تغییراتی را که همه خطوط آن خالی است نادیده بگیرید

-U،-- متحد
تعداد خطوط زمینه برای نشان دادن

--stat خلاصه تغییرات به سبک diffstat خروجی

-- ریشه
تفاوت هایی را نسبت به زیر شاخه تولید می کند

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

پایان دادن
وصله های اعمال شده را به تاریخچه مخزن منتقل کنید:

hg qfinish [-a] [REV]...

ویرایش های مشخص شده (مرتبط با وصله های اعمال شده) را با خارج کردن آنها از آن به پایان می رساند
کنترل mq به تاریخچه مخزن منظم.

محدوده بازبینی یا گزینه -a/--applied را می پذیرد. اگر --applied مشخص شده باشد، همه
اصلاحات mq اعمال شده از کنترل mq حذف می شوند. در غیر این صورت، اصلاحات داده شده باید باشد
در پایه پشته تکه های اعمال شده.

این می تواند به ویژه مفید باشد اگر تغییرات شما در یک مخزن بالادستی اعمال شده باشد.
یا اگر می خواهید تغییرات خود را به سمت بالادستی فشار دهید.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-آ، --کاربردی
تمام تغییرات اعمال شده را تمام کنید

qfold
وصله های نامگذاری شده را در پچ فعلی تا کنید:

hg qfold [-e] [-k] [-m TEXT] [-l FILE] PATCH...

پچ ها هنوز نباید اعمال شوند. هر پچ به صورت متوالی روی جریان اعمال می شود
پچ به ترتیب داده شده اگر همه وصله ها با موفقیت اعمال شوند، پچ فعلی خواهد بود
با پچ تجمعی جدید به روز می شود و وصله های تا شده حذف می شوند. با
-k/--keep، فایل های پچ تا شده پس از آن حذف نمی شوند.

هدر هر پچ تا شده با هدر وصله فعلی الحاق خواهد شد.
جدا شده توسط یک خط از * * *.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-k، --نگاه داشتن
فایل های پچ تا شده را نگه دارید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

qgoto
وصله های فشار یا پاپ تا زمانی که وصله نامگذاری شده در بالای پشته قرار گیرد:

hg qgoto [OPTION]... PATCH

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-----تغییر می دهد
تغییرات محلی غیر متضاد را تحمل کنید

-f، --زور
هر گونه تغییر محلی را بازنویسی کنید

--بدون پشتیبان
کپی های پشتیبان فایل ها را ذخیره نکنید

qguard
گاردهایی را برای یک پچ تنظیم یا چاپ کنید:

hg qguard [-l] [-n] [PATCH] [-- [+GUARD]... [-GUARD]...]

نگهبانان کنترل می کنند که آیا می توان یک وصله را فشار داد یا خیر. یک وصله بدون محافظ همیشه فشار داده می شود. آ
وصله با محافظ مثبت ("+foo") فقط در صورتی فشار داده شود که hg qselect فرمان دارد
آن را فعال کرد. وصله ای با گارد منفی ("-foo") هرگز فشار داده نمی شود hg qselect
دستور آن را فعال کرده است.

بدون هیچ آرگومان، محافظ های فعال فعلی را چاپ کنید. با استدلال، نگهبانی برای
پچ به نام

توجه: مشخص کردن محافظ های منفی اکنون به «--» نیاز دارد.

برای تنظیم محافظ روی پچ دیگر:

hg qguard other.patch -- +2.6.17 -stable

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-ل، -- لیست
همه وصله ها و محافظ ها را فهرست کنید

-n، --هیچ یک
همه نگهبانان را رها کنید

qheader
هدر بالاترین یا پچ مشخص شده را چاپ کنید:

hg qheader [PATCH]

در صورت موفقیت 0 برمی گرداند.

qimport
یک پچ یا مجموعه تغییرات موجود را وارد کنید:

hg qimport [-e] [-n NAME] [-f] [-g] [-P] [-r REV]... [فایل]...

پچ پس از آخرین پچ اعمال شده در سری قرار می گیرد. اگر پچ نداشته باشد
استفاده شده است، qimport پچ را به سری اضافه می کند.

وصله نامی مشابه فایل منبع خود خواهد داشت مگر اینکه یک نام جدید به آن بدهید
-n/--نام.

می‌توانید یک پچ موجود در فهرست پچ با پرچم موجود -e/-- ثبت کنید.

با -f/--force، یک پچ موجود به همین نام رونویسی می شود.

یک تغییرات موجود ممکن است تحت کنترل mq با -r/--rev قرار گیرد (به عنوان مثال qimport --rev .
-n وصله ویرایش فعلی را تحت کنترل mq قرار می دهد). با -g/--git، وصله ها
وارد شده با --rev از فرمت git diff استفاده می کند. برای اطلاعات به مبحث راهنمای تفاوت ها مراجعه کنید
در مورد اینکه چرا این برای حفظ تغییر نام/کپی اطلاعات و تغییرات مجوز مهم است.
استفاده کنید hg پایان دادن برای حذف تغییرات از کنترل mq.

برای وارد کردن یک وصله از ورودی استاندارد، - را به عنوان فایل وصله ارسال کنید. هنگام واردات از
ورودی استاندارد، یک نام پچ باید با استفاده از پرچم --name مشخص شود.

برای وارد کردن یک پچ موجود در حین تغییر نام:

hg qimport -e موجود-patch -n new-name

اگر وارد کردن با موفقیت انجام شود، 0 را برمی‌گرداند.

گزینه های ارسال:

-ه ، -- موجود
وارد کردن فایل در دایرکتوری پچ

-n،--نام
نام فایل پچ

-f، --زور
بازنویسی فایل های موجود

-r،-- برگشت
ویرایش های موجود را تحت کنترل mq قرار دهید

-g، --git
از فرمت git extended diff استفاده کنید

-پ، --فشار دادن
qpush بعد از وارد کردن

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

qinit
یک مخزن صف جدید راه اندازی کنید (منسوخ شده):

جیوه قینیت [-c]

مخزن صف به طور پیش فرض لغو شده است. اگر -c/--create-repo مشخص شده است، qinit
یک مخزن تو در تو جداگانه برای وصله ها ایجاد می کند (qinit -c ممکن است بعداً اجرا شود
یک مخزن پچ بدون نسخه را به یک مخزن نسخه شده تبدیل کنید). می توانید از qcommit استفاده کنید
تغییرات را در این مخزن صف انجام دهید.

این دستور منسوخ شده است. بدون -c، توسط سایر دستورات مربوطه مشخص می شود. با -c،
استفاده کنید hg init انجام --mq به جای آن.

گزینه های ارسال:

-c، --create-repo
ایجاد مخزن صف

qnew
ایجاد یک پچ جدید:

hg qnew [-e] [-m TEXT] [-l FILE] PATCH [FILE]...

qnew یک پچ جدید در بالای پچ فعلی (در صورت وجود) ایجاد می کند. پچ خواهد بود
با هر گونه تغییر برجسته در فهرست کاری مقداردهی اولیه می شود. شما همچنین می توانید استفاده کنید
-I/--include، -X/--exclude، و/یا لیستی از فایل ها بعد از نام پچ فقط برای افزودن
تغییر در فایل های تطبیق با پچ جدید، باقی مانده را به عنوان تغییرات غیرمتعهد باقی می گذارد.

-u/--user و -d/--date را می توان به ترتیب برای تنظیم کاربر (داده شده) و تاریخ استفاده کرد.
-U/--currentuser و -D/--currentdate کاربر را به کاربر فعلی و تاریخ را به تاریخ فعلی تنظیم می کند.

-e/--edit، -m/--message یا -l/--logfile هدر پچ و همچنین commit را تنظیم می کند.
پیام اگر هیچ یک مشخص نشده باشد، هدر خالی است و پیام commit '[mq] است:
PATCH'.

از گزینه -g/--git برای نگه داشتن پچ در فرمت git extensiond diff استفاده کنید. تفاوت ها را بخوانید
برای اطلاعات بیشتر در مورد اینکه چرا این موضوع برای حفظ تغییرات مجوز مهم است، به موضوع کمک کنید
و کپی/تغییر نام اطلاعات

با ایجاد موفقیت آمیز یک پچ جدید، 0 را برمی گرداند.

گزینه های ارسال:

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-f، --زور
وارد کردن تغییرات غیرمتعهد (منسوخ شده)

-g، --git
از فرمت git extended diff استفاده کنید

-U، --کاربر فعلی
افزودن "از: "وصله کردن

-u،--کاربر
افزودن "از: "وصله کردن

-دی، --تاریخ فعلی
اضافه کردن "تاریخ: "وصله کردن

-د،--تاریخ
اضافه کردن "تاریخ: "وصله کردن

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

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

qnext
نام پچ قابل فشار بعدی را چاپ کنید:

hg qnext [-s]

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-s ، --خلاصه
خط اول هدر پچ را چاپ کنید

qpop
پچ فعلی را از پشته خارج کنید:

hg qpop [-a] [-f] [PATCH | فهرست مطالب]

بدون استدلال، از بالای پشته وصله خارج می شود. اگر نام پچ داده شود، نگه می دارد
تکه‌ها را تا زمانی که پچ نام‌گذاری‌شده در بالای پشته قرار گیرد، از بین می‌رود.

به طور پیش فرض، اگر دایرکتوری کاری حاوی تغییرات غیرمتعهد باشد، آن را لغو کنید. با
--keep-changes، فقط در صورتی که فایل های غیرمتعهد با فایل های وصله شده همپوشانی داشته باشند، لغو شود. با
-f/--اجبار، پشتیبان گیری و حذف تغییرات ایجاد شده در چنین فایل هایی.

با موفقیت 0 را برگردانید.

گزینه های ارسال:

-آ، --همه
همه وصله ها را پاپ کنید

-n،--نام
نام صف برای پاپ (منسوخ شده)

-----تغییر می دهد
تغییرات محلی غیر متضاد را تحمل کنید

-f، --زور
هر گونه تغییر محلی در فایل های وصله شده را فراموش کنید

--بدون پشتیبان
کپی های پشتیبان فایل ها را ذخیره نکنید

qprev
نام پچ اعمال شده قبلی را چاپ کنید:

hg qprev [-s]

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-s ، --خلاصه
خط اول هدر پچ را چاپ کنید

qpush
پچ بعدی را روی پشته فشار دهید:

hg qpush [-f] [-l] [-a] [--move] [PATCH | فهرست مطالب]

به طور پیش فرض، اگر دایرکتوری کاری حاوی تغییرات غیرمتعهد باشد، آن را لغو کنید. با
--keep-changes، فقط در صورتی که فایل های غیرمتعهد با فایل های وصله شده همپوشانی داشته باشند، لغو شود. با
-f/--اجبار، پشتیبان گیری و وصله روی تغییرات غیرمتعهد.

با موفقیت 0 را برگردانید.

گزینه های ارسال:

-----تغییر می دهد
تغییرات محلی غیر متضاد را تحمل کنید

-f، --زور
در بالای تغییرات محلی اعمال شود

-ه ، --دقیقا
پچ هدف را روی والد ثبت شده آن اعمال کنید

-ل، -- لیست
لیست نام پچ در متن commit

-آ، --همه
همه وصله ها را اعمال کنید

-m، --ادغام
ادغام از یک صف دیگر (منسوخ شده)

-n،--نام
نام صف ادغام (منسوخ شده)

--حرکت سری پچ را دوباره سفارش دهید و فقط پچ را اعمال کنید

--بدون پشتیبان
کپی های پشتیبان فایل ها را ذخیره نکنید

صف
چندین صف پچ را مدیریت کنید:

صف hg [OPTION] [QUEUE]

از جابه‌جایی بین صف‌های پچ مختلف و همچنین ایجاد صف‌های پچ جدید پشتیبانی می‌کند
و موارد موجود را حذف کنید.

حذف یک نام صف یا مشخص کردن -l/--list، صف های ثبت شده را به شما نشان می دهد - توسط
به طور پیش فرض صف وصله های "عادی" ثبت شده است. صف فعال فعلی خواهد بود
با "(فعال)" مشخص شده است. با تعیین --active فقط نام صف فعال چاپ می شود.

برای ایجاد یک صف جدید، از -c/--create استفاده کنید. صف به طور خودکار فعال می شود، به جز در
موردی که در آن وصله های اعمال شده از صف فعال فعلی در
مخزن سپس صف فقط ایجاد می شود و سوئیچینگ ناموفق خواهد بود.

برای حذف یک صف موجود، از --delete استفاده کنید. شما نمی توانید صف فعال فعلی را حذف کنید.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-ل، -- لیست
لیست تمام صف های موجود

--فعال
چاپ نام صف فعال

-c، --ایجاد کردن
ایجاد صف جدید

-- تغییر نام
تغییر نام صف فعال

--حذف
حذف ارجاع به صف

-- پاکسازی
صف را حذف کنید و پچ dir را حذف کنید

qrefresh
به روز رسانی پچ فعلی:

hg qrefresh [-I] [-X] [-e] [-m TEXT] [-l FILE] [-s] [FILE]...

اگر الگوهای فایلی ارائه شود، وصله تازه‌سازی شده فقط شامل تغییرات خواهد بود
که با آن الگوها مطابقت دارند. تغییرات باقی مانده در کار باقی می ماند
دایرکتوری.

اگر -s/--short مشخص شده باشد، فایل‌هایی که در حال حاضر در پچ گنجانده شده‌اند، تازه‌سازی می‌شوند
فایل های همسان را دوست دارند و در پچ باقی می مانند.

اگر -e/--edit مشخص شده باشد، Mercurial ویرایشگر پیکربندی شده شما را برای وارد کردن
پیام در صورتی که qrefresh با مشکل مواجه شود، یک نسخه پشتیبان از پیام خود را در آن پیدا خواهید کرد
hg/last-message.txt.

hg افزودن/حذف/کپی/تغییر نام کار طبق معمول کار می کند، اگرچه ممکن است بخواهید از وصله های سبک git استفاده کنید
(-g/--git یا [diff] git=1) برای ردیابی کپی ها و تغییر نام ها. برای اطلاعات بیشتر به مبحث کمک تفاوت ها مراجعه کنید
اطلاعات مربوط به فرمت git diff.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-g، --git
از فرمت git extended diff استفاده کنید

-s ، --کوتاه
فقط فایل های موجود در پچ و فایل های مشخص شده را بازخوانی کنید

-U، --کاربر فعلی
افزودن/به‌روزرسانی فیلد نویسنده در پچ با کاربر فعلی

-u،--کاربر
افزودن/به‌روزرسانی فیلد نویسنده در پچ با کاربر داده شده

-دی، --تاریخ فعلی
افزودن/به‌روزرسانی فیلد تاریخ در پچ با تاریخ فعلی

-د،--تاریخ
فیلد تاریخ اضافه/به‌روزرسانی در پچ با تاریخ معین

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

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

qrename
تغییر نام یک پچ:

hg qrename PATCH1 [PATCH2]

با یک آرگومان، پچ فعلی را به PATCH1 تغییر نام می دهد. با دو آرگومان، تغییر نام
PATCH1 به PATCH2.

در صورت موفقیت 0 برمی گرداند.

نام مستعار: qmv

qrestore
بازیابی حالت صف ذخیره شده توسط یک ویرایش (منسوخ شده):

hg qrestore [-d] [-u] REV

این دستور منسوخ شده است، استفاده کنید hg تخفیف به جای آن.

گزینه های ارسال:

-د، --حذف
حذف ورودی ذخیره

-u، --به روز رسانی
به روز رسانی فهرست کار صف

qsave
ذخیره وضعیت صف فعلی (منسوخ شده):

hg qsave [-m TEXT] [-l FILE] [-c] [-n NAME] [-e] [-f]

این دستور منسوخ شده است، استفاده کنید hg تخفیف به جای آن.

گزینه های ارسال:

-c، --کپی 🀄
دایرکتوری پچ را کپی کنید

-n،--نام
کپی نام دایرکتوری

-ه ، --خالی
پاک کردن فایل وضعیت صف

-f، --زور
کپی اجباری

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

qselect
وصله های محافظت شده را تنظیم یا چاپ کنید تا فشار دهید:

hg qانتخاب [OPTION]... [GUARD]...

استفاده از hg qguard دستور تنظیم یا چاپ گاردها بر روی پچ، سپس از qselect برای گفتن mq استفاده کنید
از کدام محافظ ها استفاده کنید یک پچ در صورتی که فاقد محافظ یا محافظ مثبت باشد، هل داده می شود
با گارد منتخب فعلی مطابقت داشته باشد، اما در صورت تطابق گاردهای منفی، هل داده نخواهد شد
نگهبان فعلی مثلا:

qguard foo.patch -- -stable (نگهبان منفی)
qguard bar.patch +stable (گارد مثبت)
qstable را انتخاب کنید

این محافظ "پایدار" را فعال می کند. mq از foo.patch عبور می کند (زیرا دارای یک منفی است
match) اما فشار bar.patch (چون تطابق مثبت دارد).

بدون آرگومان، محافظ های فعال فعلی را چاپ می کند. با یک آرگومان، فعال را تنظیم می کند
نگهبان.

برای غیرفعال کردن محافظ ها از -n/--none استفاده کنید (بدون نیاز به آرگومان های دیگری). وقتی هیچ نگهبانی نیست
فعال، تکه های با محافظ مثبت حذف می شوند و تکه های با محافظ منفی هستند
رانده شد.

qselect می تواند محافظ ها را روی وصله های اعمال شده تغییر دهد. وصله های محافظت شده توسط آن پاپ نمی شود
پیش فرض برای بازگشت به آخرین پچ اعمال شده که محافظت نشده است، از --pop استفاده کنید. استفاده کنید
--reapply (که به معنی --pop است) تا پس از آن به پچ فعلی برگردید، اما از آن بگذرید
تکه های محافظت شده

از -s/--series برای چاپ لیستی از تمام محافظ ها در فایل سری استفاده کنید (هیچ آرگومان دیگری وجود ندارد
مورد نیاز). برای اطلاعات بیشتر از -v استفاده کنید.

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-n، --هیچ یک
همه نگهبان ها را غیرفعال کنید

-s ، --سلسله
لیست تمام محافظ ها در فایل سری

--ترکیدن به قبل از اولین پچ اعمال شده محافظت شده بروید

-- درخواست مجدد
پاپ کنید، سپس وصله ها را دوباره اعمال کنید

qseries
پرینت کل فایل سری:

hg qseries [-ms]

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-m، -- گم شده
تکه های چاپی به صورت سری نیستند

-s ، --خلاصه
خط اول هدر پچ را چاپ کنید

qtop
چاپ نام پچ فعلی:

hg qtop [-s]

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-s ، --خلاصه
خط اول هدر پچ را چاپ کنید

qunapplied
وصله هایی را که هنوز اعمال نشده اند چاپ کنید:

hg qunapplied [-1] [-s] [PATCH]

در صورت موفقیت 0 برمی گرداند.

گزینه های ارسال:

-1، --اولین
فقط اولین پچ را نشان دهید

-s ، --خلاصه
خط اول هدر پچ را چاپ کنید

مطلع ساختن
قلاب هایی برای ارسال اعلان های فشار ایمیل

این برنامه افزودنی قلاب‌هایی را برای ارسال اعلان‌های ایمیل در هنگام ارسال تغییرات از آن پیاده‌سازی می‌کند
یا توسط مخزن محلی دریافت شده است.

ابتدا افزونه را همانطور که در توضیح داده شده فعال کنید hg کمک ضمیمهها، و قلاب شما را ثبت کنید
می خواهند اجرا کنند وارد شونده و تغییر گروه قلاب ها با دریافت تغییرات اجرا می شوند
برونگرا قلاب‌ها برای مجموعه‌های تغییرات ارسال شده به مخزن دیگری هستند:

[قلاب]
# یک ایمیل برای هر مجموعه تغییرات ورودی
incoming.notify = python:hgext.notify.hook
# یک ایمیل برای همه تغییرات ورودی
changegroup.notify = python:hgext.notify.hook

# یک ایمیل برای همه تغییرات خروجی
outgoing.notify = python:hgext.notify.hook

این قلاب ها را ثبت می کند. برای فعال کردن اعلان، مشترکین باید به آنها اختصاص داده شوند
مخازن در [زیر کاربران] بخش مخازن متعدد را به یک گیرنده معین نگاشت می کند. در
[reposubs] بخش، چندین گیرنده را به یک مخزن نگاشت می کند:

[زیر کاربران]
کلید # ایمیل مشترک است، مقدار فهرستی از الگوهای مخزن است که با کاما از هم جدا شده اند
user@host = الگو

[reposubs]
کلید # الگوی مخزن است، مقدار فهرستی از ایمیل‌های مشترک با کاما است
الگو = user@host

A الگو هست یک کره تطبیق مسیر مطلق به یک مخزن، به صورت اختیاری با a ترکیب می شود
عبارت revset یک عبارت revset، در صورت وجود، با یک هش از glob جدا می شود.
مثال:

[reposubs]
*/ابزارک#شاخه(انتشار) = [ایمیل محافظت شده]

این ارسال می کند به [ایمیل محافظت شده] هر زمان که یک تغییر در آزاد محرک های شاخه الف
اطلاع رسانی در هر مخزنی که به پایان می رسد ویدجت.

به منظور قرار دادن آنها تحت مدیریت مستقیم کاربر، [زیر کاربران] و [reposubs] بخش
ممکن است در یک قسمت جداگانه قرار گیرد hgrc فایل و با مرجع گنجانده شده است:

[اعلام کردن]
config = /path/to/subscriptionsfile

اعلان ها تا قبل از این ارسال نمی شود notify.test مقدار تنظیم شده است غلط; زیر را ببینید.

محتوای اعلان‌ها را می‌توان با ورودی‌های پیکربندی زیر بهینه‌سازی کرد:

notify.test
If درست، پیام ها را به جای ارسال در stdout چاپ کنید. پیش فرض: درست است.

notify.sources
فهرست منابع تغییر جدا شده با فضا. اعلان ها فقط زمانی فعال می شوند که a
منبع تغییرات در این لیست است. منابع ممکن است:

خدمت

تغییرات دریافت شده از طریق http یا ssh

کشیدن

تغییرات دریافت شده از طریق hg کشیدن

جدا کردن

تغییرات دریافت شده از طریق hg جدا کردن

فشار

تغییرات ارسال یا دریافت شده از طریق hg فشار

بسته

تغییرات ارسال شده از طریق hg جدا کردن

پیش فرض: خدمت.

notify.strip
تعداد اسلش های پیشرو برای حذف از مسیرهای url. به طور پیش فرض، اعلان ها
مخازن مرجع با مسیر مطلق خود. notify.strip به شما اجازه می دهد آنها را بچرخانید
به مسیرهای نسبی مثلا، notify.strip=3 تغییر خواهد کرد /long/path/repository
به مخزن. پیش فرض: 0.

notify.domain
دامنه ایمیل پیش فرض برای فرستنده یا گیرندگان بدون دامنه صریح.

notify.style
فایل سبک برای استفاده هنگام قالب بندی ایمیل ها.

notify.template
الگویی برای استفاده هنگام قالب بندی ایمیل ها.

notify.incoming
الگوی مورد استفاده هنگام اجرا به عنوان یک قلاب ورودی، نادیده گرفته می شود notify.template.

اطلاع رسانی.خروجی
الگوی مورد استفاده هنگام اجرا به عنوان یک قلاب خروجی، نادیده گرفته می شود notify.template.

notify.changegroup
الگویی برای استفاده هنگام اجرا به عنوان قلاب گروه تغییر، نادیده گرفته می شود notify.template.

notify.maxdiff
حداکثر تعداد خطوط تفاوت برای درج در ایمیل اعلان. برای غیرفعال کردن روی 0 تنظیم کنید
تفاوت، یا -1 تا همه آن را شامل شود. پیش فرض: 300.

notify.maxsubject
حداکثر تعداد کاراکترها در خط موضوع ایمیل. پیش فرض: 67.

notify.diffstat
روی True تنظیم کنید تا یک diffstat قبل از محتوای diff اضافه شود. پیش فرض: درست است.

notify.merge
اگر درست است، اعلان‌هایی برای ادغام تغییرات ارسال کنید. پیش فرض: درست است.

notify.mbox
در صورت تنظیم، ایمیل ها را به جای ارسال به این فایل mbox اضافه کنید. پیش فرض: هیچ.

notify.fomauthor
در صورت تنظیم، از committer اولین تغییرات در یک گروه تغییر برای "From" استفاده کنید.
فیلد ایمیل اطلاع رسانی اگر تنظیم نشده است، کاربر را از مخزن فشار خارج کنید.
پیش فرض: نادرست.

در صورت تنظیم، از ورودی‌های زیر نیز برای سفارشی‌سازی اعلان‌ها استفاده می‌شود:

ایمیل.از
پست الکترونیک (ایمیل) از جانب آدرسی برای استفاده اگر در محتوای ایمیل ایجاد شده یافت نشد.

web.baseurl
URL مخزن ریشه برای ترکیب با مسیرهای مخزن هنگام ایجاد ارجاعات. دیدن
همچنین notify.strip.

صفحه
خروجی فرمان را با پیجر خارجی مرور کنید

برای تنظیم پیجری که باید استفاده شود، متغیر برنامه را تنظیم کنید:

[پیجر]
پیجر = کمتر -FRX

اگر پیجر تنظیم نشده باشد، پسوندهای پیجر از متغیر محیطی $PAGER استفاده می کنند. اگر هیچ کدام
pager.pager، و $PAGER تنظیم نشده است، هیچ پیجری استفاده نمی شود.

می توانید با افزودن آنها به لیست pager.ignore، پیجر را برای دستورات خاصی غیرفعال کنید:

[پیجر]
نادیده گرفتن = نسخه، کمک، به روز رسانی

همچنین می‌توانید پیجر را فقط برای دستورات خاصی با استفاده از pager.attend فعال کنید. در زیر است
فهرست پیش‌فرض دستوراتی که باید صفحه‌بندی شوند:

[پیجر]
حضور = حاشیه نویسی، گربه، تفاوت، صادر کردن، glog، log، qdiff

تنظیم pager.attend روی یک مقدار خالی باعث صفحه بندی شدن همه دستورات می شود.

اگر pager.attend وجود داشته باشد، pager.ignore نادیده گرفته می شود.

در نهایت، می توانید صفحه بندی را برای دستورات فردی با استفاده از آن فعال و غیرفعال کنید
مراجعه كردن- گزینه. این تنظیم بر حضور و نادیده گرفتن موجود اولویت دارد
گزینه ها و پیش فرض ها:

[پیجر]
حضور-گربه = نادرست

برای نادیده گرفتن دستورات جهانی مانند hg نسخه or hg کمک، باید آنها را در خود مشخص کنید
فایل پیکربندی کاربر

برای کنترل اینکه آیا پیجر اصلاً برای یک فرمان جداگانه استفاده می شود، می توانید استفاده کنید
--پیجر= :

- در صورت نیاز استفاده کنید: "خودکار".
- نیاز به پیجر: «بله» یا «روشن».
- پیجر را سرکوب کنید: «نه» یا «خاموش» (هر مقدار ناشناخته
نیز کار خواهد کرد).

بمب پچ
دستور برای ارسال تغییرات به عنوان (یک سری از) ایمیل های وصله

این مجموعه با یک مقدمه "[PATCH 0 of N]" شروع می شود که مجموعه را توصیف می کند.
در کل.

هر ایمیل پچ دارای یک خط موضوع "[PATCH M of N] ..." است که از خط اول استفاده می‌کند
توضیحات را به عنوان متن موضوع تغییر می دهد. پیام حاوی دو یا سه قسمت بدن است:

· توضیحات تغییرات.

· [اختیاری] نتیجه اجرای diffstat روی پچ.

· خود پچ، همانطور که توسط hg صادرات.

هر پیام به اولین پیام در این سری با استفاده از In-Reply-To و References اشاره دارد
سرصفحه ها، بنابراین به صورت توالی در نامه های رشته ای و اخبار خوان ها و در نامه نشان داده می شوند.
بایگانی

برای پیکربندی سایر پیش فرض ها، بخشی مانند این را به فایل پیکربندی خود اضافه کنید:

[پست الکترونیک]
از = نام من
به = گیرنده1، گیرنده2، ...
cc = cc1، cc2، ...
bcc = bcc1، bcc2، ...
پاسخ به = آدرس 1، آدرس 2، ...

استفاده کنید [پچ بمب] به عنوان نام بخش پیکربندی اگر نیاز به لغو جهانی دارید [پست الکترونیک]
تنظیمات آدرس

سپس می توانید از hg پست الکترونیک فرمان برای ارسال یک سری تغییرات به عنوان یک Patchbomb.

همچنین می توانید گزینه روش را در قسمت ایمیل پیکربندی کنید تا یک sendmail باشد
ایمیل سازگار یا بخش [smtp] را پر کنید تا پسوند patchbomb بتواند
به طور خودکار Patchbomb ها را مستقیماً از خط فرمان ارسال می کند. مشاهده [email] و [smtp]
بخشها در hgrc(5) برای جزئیات.

به طور پیش فرض، hg پست الکترونیک الف را درخواست خواهد کرد به or CC هدر اگر شما یکی از طریق عرضه نمی کنید
پیکربندی یا خط فرمان شما می توانید با پیکربندی این مورد را لغو کنید تا هرگز از شما خواسته نشود
یک مقدار خالی:

[پست الکترونیک]
سی سی =

شما می توانید گنجاندن پیش فرض یک پیام مقدمه را با patchbomb.intro
گزینه پیکربندی پیکربندی همیشه با پرچم های خط فرمان بازنویسی می شود
--intro و --desc:

[پچ بمب]
intro=auto # اگر بیش از 1 پچ باشد (پیش‌فرض) شامل پیام معرفی می‌شود
intro=never # هرگز یک پیام مقدمه درج نکنید
intro=always # همیشه شامل یک پیام مقدمه است

می‌توانید Patchbomb را طوری تنظیم کنید که همیشه با تنظیم درخواست تأیید کند patchbomb.confirm به حقیقت

دستورات
پست الکترونیک
ارسال تغییرات از طریق ایمیل:

ایمیل hg [OPTION]... [DEST]...

به طور پیش‌فرض، تفاوت‌ها در قالب تولید شده توسط ارسال می‌شوند hg صادرات، یک در هر پیام در
سری با مقدمه "[PATCH 0 of N]" شروع می شود که مجموعه را به عنوان یک کل توصیف می کند.

هر ایمیل پچ دارای یک خط موضوع "[PATCH M of N] ..." است که از خط اول استفاده می‌کند
توضیحات را به عنوان متن موضوع تغییر می دهد. پیام شامل دو یا سه قسمت است.
اول، توضیحات تغییرات.

با گزینه -d/--diffstat در صورت نصب برنامه diffstat نتیجه اجرا می شود
diffstat روی پچ درج شده است.

در نهایت، خود پچ، همانطور که توسط hg صادرات.

با گزینه های -d/--diffstat یا --confirm، یک خلاصه نهایی از شما نمایش داده می شود
همه پیام ها و درخواست تایید قبل از ارسال پیام ها.

به‌طور پیش‌فرض، وصله به‌عنوان متن در متن ایمیل برای بررسی آسان گنجانده شده است. با استفاده از
گزینه -a/--attach در عوض یک پیوست برای پچ ایجاد می کند. با -i/--inline an
پیوست درون خطی ایجاد خواهد شد. می‌توانید یک وصله را به صورت متن در متن ایمیل اضافه کنید
و به عنوان یک پیوست منظم یا درون خطی با ترکیب -a/--attach یا -i/--inline با
گزینه --body.

با -o/--خروجی، ایمیل‌ها برای وصله‌هایی که در مقصد یافت نمی‌شوند ایجاد می‌شوند
مخزن (یا فقط آنهایی که اجداد بازنگری های مشخص شده در صورت وجود هستند
ارائه شده)

با -b/--bundle، تغییرات به‌عنوان -خروجی انتخاب می‌شوند، اما یک ایمیل حاوی یک ایمیل است
یک بسته دودویی مرکوریال به عنوان پیوست ارسال خواهد شد. استفاده کنید patchbomb.bundletype
گزینه config برای کنترل نوع بسته مانند با hg بسته --نوع.

با -m/--mbox، به جای پیش نمایش هر پیام Patchbomb در پیجر یا ارسال پیام
مستقیماً پیام می دهد، یک فایل صندوق پستی یونیکس با ایمیل های پچ ایجاد می کند. این صندوق پستی
فایل را می توان با هر عامل ایمیلی که از فایل های mbox UNIX پشتیبانی می کند، پیش نمایش کرد.

با -n/--test، تمام مراحل اجرا می شود، اما نامه ارسال نمی شود. از شما خواسته می شود
یک آدرس گیرنده ایمیل، یک موضوع و یک پیام مقدماتی که پچ ها را توصیف می کند
از بمب پچ شما سپس وقتی همه چیز تمام شد، پیام های Patchbomb نمایش داده می شود. اگر PAGER
متغیر محیطی تنظیم شده است، پیجر شما یک بار برای هر پیام Patchbomb فعال می شود،
بنابراین می توانید بررسی کنید که همه چیز درست است.

در صورت عدم ارسال ایمیل، یک نسخه پشتیبان از پیام مقدماتی سری خود را در آن پیدا خواهید کرد
hg/last-email.txt.

رفتار پیش فرض این دستور را می توان از طریق پیکربندی سفارشی کرد. (دیدن hg کمک
بمب پچ برای جزئیات بیشتر)

مثال:

ایمیل hg -r 3000 # فقط ارسال پچ 3000
ایمیل hg -r 3000 -r 3001 # ارسال وصله های 3000 و 3001
ایمیل hg -r 3000:3005 # ارسال پچ های 3000 تا 3005
ایمیل hg 3000 # ارسال پچ 3000 (منسوخ شده)

hg email -o # ارسال همه وصله ها به صورت پیش فرض نیست
ایمیل hg -o DEST # همه وصله‌ها را در DEST ارسال کنید
ایمیل hg -o -r 3000 # ارسال تمام اجداد 3000 به صورت پیش فرض نیست
ایمیل hg -o -r 3000 DEST # ارسال تمام اجداد 3000 در DEST

hg email -b # send bundle از همه وصله ها به صورت پیش فرض نیست
hg email -b DEST # ارسال بسته‌ای از همه وصله‌های غیر در DEST
hg email -b -r 3000 # بسته نرم افزاری همه اجداد 3000 به صورت پیش فرض نیست
hg email -b -r 3000 DEST # بسته نرم افزاری همه اجداد 3000 در DEST نیستند

hg email -o -m mbox && # یک فایل mbox تولید کنید...
mutt -R -f mbox # ... و آن را با mutt مشاهده کنید
hg email -o -m mbox && # یک فایل mbox تولید کنید...
formail -s sendmail \ # ... و از formail برای ارسال از mbox استفاده کنید
-bm -t < mbox # ... با استفاده از sendmail

قبل از استفاده از این دستور، باید ایمیل را در hgrc خود فعال کنید. مشاهده [ایمیل]
بخش در hgrc(5) برای جزئیات.

گزینه های ارسال:

-g، --git
از فرمت git extended diff استفاده کنید

--جلگه
هدر پچ hg را حذف کنید

-و ، --برونگرا
تغییراتی را که در مخزن هدف یافت نشد ارسال کنید

-ب، --دسته
تغییرات را در هدف به عنوان یک بسته باینری ارسال کنید

--نام بسته
نام فایل پیوست بسته نرم افزاری (پیش فرض: بسته نرم افزاری)

-r،-- برگشت
یک ویرایش برای ارسال

--زور
حتی زمانی که مخزن راه دور نامرتبط باشد (با -b/--bundle) اجرا شود.

--پایه
یک تغییر پایه برای تعیین به جای مقصد (با -b/--bundle)

--مقدمه
برای یک پچ یک ایمیل معرفی بفرستید

--بدن ارسال وصله ها به عنوان متن پیام درون خطی (پیش فرض)

-آ، -- ضمیمه کردن
وصله ها را به عنوان پیوست ارسال کنید

-من، -- به صورت خطی
وصله ها را به عنوان پیوست های درون خطی ارسال کنید

--BCC
آدرس ایمیل گیرندگان کپی کربن کور

-c،-- سی سی
آدرس ایمیل گیرندگان کپی

--تایید
قبل از ارسال درخواست تایید کنید

-د، --diffstat
خروجی diffstat را به پیام ها اضافه کنید

--تاریخ
از تاریخ معین به عنوان تاریخ ارسال استفاده کنید

-- توصیف
از فایل داده شده به عنوان توضیحات سری استفاده کنید

-f،--از جانب
آدرس ایمیل فرستنده

-n، --تست
پیام هایی را که ارسال می شود چاپ کنید

-m،--mbox
پیام ها را به جای ارسال در فایل mbox بنویسید

--پاسخ دادن به
پاسخ به آدرس های ایمیل باید ارسال شود

-s ،--موضوع
موضوع اولین پیام (معرفی یا تک پچ)

--در پاسخ به
شناسه پیام برای پاسخ دادن

--پرچم
پرچم برای اضافه کردن در پیشوندهای موضوع

-t،--به
آدرس ایمیل گیرندگان

-ه ،--ssh
دستور ssh را برای استفاده مشخص کنید

-- راه دور
دستور hg را برای اجرا در سمت راه دور مشخص کنید

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

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

پالایش
دستور حذف فایل های ردیابی نشده از دایرکتوری کاری

دستورات
پالایش
فایل هایی که توسط Mercurial ردیابی نشده اند را حذف می کند:

hg purge [OPTION]... [DIR]...

حذف فایل هایی که مرکوریال نمی شناسد. این برای آزمایش تغییرات محلی و غیرمتعهد مفید است
در درخت منبع در غیر این صورت تمیز.

این بدان معنی است که پاکسازی موارد زیر را به طور پیش فرض حذف می کند:

· فایل های ناشناخته: فایل های علامت گذاری شده با "?" توسط hg وضعیت

· دایرکتوری های خالی: در واقع Mercurial دایرکتوری ها را نادیده می گیرد مگر اینکه حاوی فایل های زیر باشند
مدیریت کنترل منبع

اما دست نخورده باقی خواهد ماند:

· فایل های ردیابی شده اصلاح شده و اصلاح نشده

فایل های نادیده گرفته شده (مگر اینکه --all مشخص شده باشد)

· فایل های جدید اضافه شده به مخزن (با hg اضافه کردن)

از گزینه های --files و --dirs می توان برای پاکسازی مستقیم استفاده کرد تا فقط فایل ها را حذف کند
دایرکتوری ها یا هر دو اگر هیچ یک از گزینه ها داده نشد، هر دو حذف خواهند شد.

اگر دایرکتوری ها در خط فرمان داده شوند، فقط فایل های موجود در این دایرکتوری ها هستند
در نظر گرفته شده.

مراقب پاکسازی باشید، زیرا می‌توانید برخی از فایل‌هایی را که فراموش کرده‌اید به آن‌ها اضافه کنید، به‌طور برگشت‌ناپذیر حذف کنید
مخزن اگر فقط می خواهید لیست فایل هایی را که این برنامه چاپ می کند چاپ کنید
حذف، از گزینه --print استفاده کنید.

گزینه های ارسال:

-آ، -- سقط در اشتباه
در صورت بروز خطا، لغو شود

--همه فایل های نادیده گرفته شده را نیز پاک کنید

-- کارگردانان دایرکتوری های خالی را پاک کنید

--فایل ها
پاکسازی فایل ها

-پ، --چاپ
به جای حذف نام فایل ها را چاپ کنید

-0، -- چاپ 0
نام فایل های پایانی با NUL، برای استفاده با xargs (به معنی -p/--print است)

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

نام مستعار: پاک

تخفیف
دستور انتقال مجموعه‌ای از بازبینی‌ها به یک جد متفاوت

این برنامه افزودنی به شما امکان می دهد تغییرات را در یک مخزن Mercurial موجود تغییر دهید.

برای اطلاعات بیشتر: https://mercurial-scm.org/wiki/RebaseExtension

دستورات
تخفیف
تغییرات (و فرزندان) را به شاخه دیگری منتقل کنید:

hg rebase [-s REV | -b REV] [-d REV] [OPTION]

Rebase از ادغام مکرر برای پیوند مجموعه‌های تغییرات از یک بخش از تاریخ استفاده می‌کند (منبع)
به دیگری (مقصد). این می تواند برای خطی سازی مفید باشد محلی نسبی تغییر می کند
به درخت توسعه اصلی.

تعهدات منتشر شده را نمی توان مجدداً تغییر داد (نگاه کنید به hg کمک فاز). برای کپی کردن commit ها را ببینید hg کمک
پیوند.

اگر مجموعه تغییرات مقصد را مشخص نکنید (-d/--dest، rebase از شاخه فعلی استفاده می کند
نوک به عنوان مقصد (مجموعه تغییرات مقصد با تغییر پایه تغییر نمی کند، بلکه جدید است
تغییرات به عنوان فرزندان آن اضافه می شود.)

در اینجا راه هایی برای انتخاب تغییرات وجود دارد:

1. صریحاً آنها را با استفاده از آن انتخاب کنید -- برگشت.

2. استفاده -- منبع برای انتخاب یک تغییرات ریشه و شامل همه فرزندان آن.

3. استفاده --پایه برای انتخاب یک مجموعه تغییرات؛ rebase اجداد و فرزندان آنها را پیدا خواهد کرد
که اجداد مقصد هم نیستند.

4. اگر هیچ کدام را مشخص نکنید -- برگشت, منبع، یا --پایه، rebase استفاده خواهد شد --پایه . as
در بالا.

Rebase تغییرات اصلی را از بین می برد مگر اینکه از آن استفاده کنید --نگاه داشتن. شما را نیز حرکت خواهد داد
نشانک ها (حتی اگر این کار را داشته باشید).

برخی از تغییرات ممکن است در صورت عدم ایجاد تغییرات حذف شوند (مثلاً ادغام از
شعبه مقصد).

برخلاف ادغام کردن، rebase هیچ کاری انجام نمی دهد اگر در نوک شاخه یک شاخه نامگذاری شده با باشید
دو سر شما باید به صراحت منبع و/یا مقصد را مشخص کنید.

اگر یک rebase برای حل دستی یک تضاد قطع شود، می توان آن را ادامه داد
--continue/-c یا با --abort/-a سقط شد.

مثال:

· "تغییرات محلی" (تعهد فعلی به نقطه انشعاب) را به نوک شاخه فعلی منتقل کنید
بعد از کشش:

hg rebase

یک تغییر مجموعه را به شاخه پایدار منتقل کنید:

hg rebase -r 5f493448 -d پایدار است

یک commit و تمام فرزندان آن را در قسمت دیگری از تاریخ به هم متصل کنید:

hg rebase --source c0c3 --dest 4cf9

· همه چیز را در شاخه ای که با یک نشانک مشخص شده است به شاخه پیش فرض تغییر دهید:

hg rebase --base myfeature --dest default

· مجموعه ای از تغییرات را در یک commit جمع کنید:

hg rebase --collapse -r 1520:1525 -d .

· حرکت یک شاخه با نام با حفظ نام آن:

hg rebase -r "branch(featureX)" -d 1.3 --keepbranches

در صورت موفقیت 0، اگر چیزی برای تغییر مجدد وجود نداشته باشد یا تضادهای حل نشده وجود داشته باشد، 1 را برمی گرداند.

گزینه های ارسال:

-s ،-- منبع
تغییر مجموعه تغییرات و فرزندان مشخص شده را تغییر دهید

-ب،--پایه
همه چیز را از نقطه انشعاب تغییرات مشخص شده تغییر دهید

-r،-- برگشت
این تجدید نظرها را مجدداً تغییر دهید

-د،--دسترسی
مجدداً روی تغییرات مشخص شده قرار دهید

--سقوط - فروپاشی
مجموعه های تغییرات مبتنی بر تغییر را جمع کنید

-m،--پیام
از متن به عنوان پیام commit collapse استفاده کنید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-ل،--ورود به سیستم فایل
خواندن پیام commit collapse از فایل

-k، --نگاه داشتن
تغییرات اصلی را حفظ کنید

--شاخه های نگهدارنده
نام شعب اصلی را حفظ کنید

-دی، -- جدا کردن
(منسوخ)

-من، --در ارتباط بودن
(منسوخ)

-t،--ابزار
ابزار ادغام را مشخص کنید

-c، --ادامه هید
به یک تغییر پایه قطع شده ادامه دهید

-آ، -- سقط
بازبيني قطع شده را لغو كنيد

--سبک
نمایش با استفاده از فایل نقشه الگو (منسوخ شده)

-T،--قالب
نمایش با قالب

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

رکورد
دستورات برای انتخاب تعاملی تغییرات برای commit/qrefresh

دستورات
qrecord
به صورت تعاملی یک پچ جدید را ضبط کنید:

hg qrecord [OPTION]... Patch [FILE]...

دیدن hg کمک qnew & hg کمک رکورد برای اطلاعات بیشتر و استفاده

رکورد
به صورت تعاملی تغییرات را برای انجام انتخاب کنید:

رکورد hg [OPTION]... [FILE]...

اگر لیستی از فایل ها حذف شود، همه تغییرات توسط hg وضعیت نامزد خواهند بود
ضبط

دیدن hg کمک تاریخ برای لیستی از قالب‌های معتبر برای -d/--date.

از شما خواسته می شود که آیا باید تغییرات را در هر فایل اصلاح شده و برای فایل ها ثبت کنید
با تغییرات متعدد، برای هر تغییر استفاده کنید. برای هر پرس و جو، پاسخ های زیر است
ممکن است:

y - این تغییر را ثبت کنید
n - از این تغییر رد شوید
e - این تغییر را به صورت دستی ویرایش کنید

s - از تغییرات باقی مانده در این فایل رد شوید
f - ثبت تغییرات باقی مانده در این فایل

d - انجام شد، از تغییرات و فایل‌های باقی‌مانده رد شوید
الف - تمام تغییرات را در تمام فایل های باقی مانده ضبط کنید
q - خروج، ضبط بدون تغییر

? - نمایش کمک

این دستور هنگام انجام ادغام در دسترس نیست.

گزینه های ارسال:

-آ، --اضافه کردن حذف
قبل از انجام، فایل‌های جدید/از دست رفته را به‌عنوان اضافه/حذف شده علامت‌گذاری کنید

-- نزدیک شعبه
یک سر شاخه را بسته علامت بزنید

--اصلاح
والد دایرکتوری کاری را اصلاح کنید

-s ، --راز
از مرحله مخفی برای ارتکاب استفاده کنید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

-m،--پیام
از متن به عنوان پیام commit استفاده کنید

-ل،--ورود به سیستم فایل
خواندن پیام commit از فایل

-د،--تاریخ
تاریخ مشخص شده را به عنوان تاریخ تعهد ثبت کنید

-u،--کاربر
کاربر مشخص شده را به عنوان committer ثبت کنید

-S، -- subrepos
بازگشت به مخازن فرعی

-w، - نادیده گرفتن همه فضا
هنگام مقایسه خطوط، فضای سفید را نادیده بگیرید

-ب، - نادیده گرفتن-فضا-تغییر
تغییرات در مقدار فضای سفید را نادیده بگیرید

-ب، -نادیده گرفتن-خطوط خالی
تغییراتی را که همه خطوط آن خالی است نادیده بگیرید

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

پیوند مجدد
پیوندهای سخت بین کلون های مخزن را دوباره ایجاد می کند

دستورات
پیوند مجدد
ایجاد مجدد پیوندهای سخت بین دو مخزن:

پیوند مجدد hg [ORIGIN]

هنگامی که مخازن به صورت محلی کلون می شوند، فایل های داده آن ها به صورت هاردلینک می شوند تا بتوانند
فقط از فضای یک مخزن استفاده کنید.

متأسفانه، کشش های بعدی به هر یک از مخازن، پیوندهای سخت را برای هر فایلی از بین می برد
تغییرات جدید تحت تأثیر قرار می گیرند، حتی اگر هر دو مخزن در نهایت تغییرات یکسانی را انجام دهند.

به طور مشابه، با انتقال --rev به "hg clone" از هیچ پیوند سختی استفاده نمی شود و به یک
کپی کامل از مخزن منبع

این دستور به شما امکان می دهد آن هاردلینک ها را دوباره ایجاد کنید و فضای تلف شده را بازیابی کنید.

این مخزن برای اشتراک گذاری فضا با ORIGIN، که باید روی همان باشد، مجدداً پیوند خواهد شد
دیسک محلی اگر ORIGIN حذف شود، به دنبال "پیش‌فرض-relink" و سپس "default" در [مسیرها] می‌گردد.

در حین اجرای دستور، هیچ عملیات خواندنی روی این مخزن انجام ندهید. (هر دو
مخازن در برابر نوشتن قفل خواهند شد.)

طرح ها
طرح ها را با میانبرها به گروه های مخزن گسترش دهید

این افزونه به شما امکان می دهد میانبرهایی را برای URL های والد با مخازن زیاد مشخص کنید
مانند یک طرح عمل کنید، برای مثال:

[طرح ها]
py = http://code.python.org/hg/

پس از آن می توانید از آن استفاده کنید مانند:

کلون hg py://trunk/

علاوه بر این، از برخی طرح‌واره‌های پیچیده‌تر پشتیبانی می‌شود، به عنوان مثال توسط Google استفاده می‌شود
کد:

[طرح ها]
gcode = http://{1}.googlecode.com/hg/

نحو از الگوهای Mercurial گرفته شده است و شما تعداد نامحدودی متغیر دارید.
شروع با 1 {} و ادامه با 2 {}, 3 {} و غیره این متغیرها دریافت خواهند کرد
بخش‌هایی از URL ارائه شده، تقسیم بر /. هر چیزی که به عنوان مشخص نشده است {بخش} فقط ضمیمه خواهد شد
به یک URL

برای راحتی، برنامه افزودنی به طور پیش فرض این طرح ها را اضافه می کند:

[طرح ها]
py = http://hg.python.org/
bb = https://bitbucket.org/
bb+ssh = ssh://[ایمیل محافظت شده]/
gcode = https://{1}.googlecode.com/hg/
کوره = https://{1}.kilnhg.com/Repo/

شما می توانید یک طرح از پیش تعریف شده را با تعریف یک طرح جدید با همان نام لغو کنید.

سهم
یک تاریخچه مشترک بین چندین فهرست کاری به اشتراک بگذارید

اتوماتیک جمع شده ذخیره سازی برای کلونها
وقتی این افزونه فعال است، hg کلون کردن را می توان به گونه ای پیکربندی کرد که به طور خودکار به اشتراک گذاشته شود
ذخیره سازی در چندین کلون این حالت به طور موثر تبدیل می شود hg کلون کردن به hg کلون کردن + hg
سهم. مزیت استفاده از این حالت مدیریت خودکار مسیرهای فروشگاه و
ادغام هوشمند مخازن مرتبط

در زیر اشتراک گذاری. گزینه های پیکربندی بر این ویژگی تأثیر می گذارد:

اشتراک گذاری. استخر

مسیر سیستم فایل که در آن داده های مخزن مشترک ذخیره می شود. وقتی تعریف شد، hg کلون کردن
به‌جای ایجاد یک فروشگاه در داخل، به‌طور خودکار از ذخیره‌سازی مخزن مشترک استفاده می‌کند
هر کلون

اشتراک گذاری.نامگذاری

نحوه نام گذاری دایرکتوری ها در اشتراک گذاری. استخر ساخته می شوند.

"identity" به این معنی است که نام از اولین مجموعه تغییرات در مخزن گرفته شده است. که در
در این حالت، ریموت‌های مختلف ذخیره‌سازی را به اشتراک می‌گذارند، در صورتی که تنظیمات اولیه/روت آن‌ها باشد
همسان. در این حالت، مخزن مشترک محلی مجموع همه است
با مخازن راه دور مواجه شد.

"Remote" به این معنی است که نام از مسیر یا URL منبع منبع مشتق شده است. که در
در این حالت، ذخیره سازی تنها در صورتی به اشتراک گذاشته می شود که مسیر یا URL درخواست شده در آن باشد hg کلون کردن
دستور دقیقاً با مخزنی که قبلاً کلون شده بود مطابقت دارد.

حالت پیش فرض نامگذاری "هویت" است.

دستورات
سهم
یک مخزن مشترک جدید ایجاد کنید:

سهم hg [-U] [-B] منبع [DEST]

یک مخزن جدید و دایرکتوری کاری که تاریخچه خود را به اشتراک می گذارد (و به صورت اختیاری) راه اندازی کنید
نشانک ها) با یک مخزن دیگر.

توجه داشته باشید با استفاده از rollback یا افزونه هایی که تاریخچه را از بین می برند/تغییر می دهند (mq، rebase، و غیره) می توانند
باعث سردرگمی قابل توجهی با کلون های مشترک شود. به ویژه، اگر دو به اشتراک گذاشته شود
کلون ها هر دو به یک مجموعه تغییرات به روز می شوند و یکی از آنها آن را از بین می برد
با بازگشت به عقب، کلون دیگر به طور ناگهانی کار نمی کند: همه عملیات
با "abort: پوشه کاری دارای والد ناشناخته است" شکست خواهد خورد. تنها شناخته شده
راه حل این است که از debugsetparents بر روی کلون شکسته برای بازنشانی آن به یک تغییرات استفاده کنید
که هنوز وجود دارد

گزینه های ارسال:

-U، -- به روز رسانی
دایرکتوری کاری ایجاد نکنید

-ب، -- نشانک ها
همچنین نشانک ها را به اشتراک بگذارید

لغو اشتراک گذاری
یک مخزن مشترک را به یک مخزن معمولی تبدیل کنید:

hg لغو اشتراک

داده های فروشگاه را در مخزن کپی کنید و داده های مسیر مشترک را حذف کنید.

قفسه
تغییرات را در پوشه کاری ذخیره و بازیابی کنید

دستور "hg shelve" تغییرات ایجاد شده در پوشه کاری را ذخیره می کند و آنها را برمی گرداند
تغییرات، بازنشانی دایرکتوری کاری به حالت تمیز.

بعداً، دستور "hg unshelve" تغییرات ذخیره شده توسط "hg shelve" را بازیابی می کند. تغییرات می تواند
حتی پس از به‌روزرسانی به والد دیگری بازیابی شود، در این صورت Mercurial ادغام می‌شود
ماشین آلات در صورت لزوم هرگونه تعارض را حل می کنند.

می‌توانید همزمان بیش از یک تغییر قفسه‌بندی برجسته داشته باشید. هر تغییر قفسه دارای یک
نام متمایز برای جزئیات، به راهنمای "hg shelve" مراجعه کنید.

دستورات
قفسه
تغییرات را از دایرکتوری کاری ذخیره و کنار بگذارید:

قفسه hg [OPTION]... [FILE]...

Shelving فایل‌هایی را می‌گیرد که «وضعیت hg» به‌عنوان غیر تمیز گزارش می‌کند، تغییرات را در a ذخیره می‌کند
بسته نرم افزاری (یک تغییر قفسه بندی شده)، و فایل ها را به گونه ای برمی گرداند که حالت آنها در حال کار باشد
دایرکتوری تمیز می شود

برای بازگرداندن این تغییرات به دایرکتوری کاری، با استفاده از "hg unshelve"؛ این کار خواهد کرد
حتی اگر به یک commit دیگر تغییر دهید.

هنگامی که هیچ فایلی مشخص نشده است، "hg shelve" همه فایل های پاک نشده را ذخیره می کند. اگر فایل های خاص یا
دایرکتوری ها نامگذاری شده اند، فقط تغییرات آن فایل ها در قفسه بندی باقی می مانند.

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

برای مشاهده لیستی از تغییرات قفسه بندی شده موجود، از -- لیست گزینه. برای هر تغییر قفسه،
این نام، سن، و توضیحات آن را چاپ می کند. استفاده کنید -- پچ or --stat برای جزئیات بیشتر.

برای حذف تغییرات خاص قفسه بندی شده، استفاده کنید --حذف. برای حذف همه تغییرات قفسه بندی شده، استفاده کنید
--پاک کردن.

گزینه های ارسال:

-آ، --اضافه کردن حذف
قبل از قفسه بندی، فایل های جدید/از دست رفته را به عنوان اضافه/حذف شده علامت گذاری کنید

-u، --ناشناس
فایل های ناشناخته را در قفسه ذخیره کنید

--پاک کردن
تمام تغییرات قفسه بندی شده را حذف کنید

--تاریخ
قفسه با تاریخ انجام مشخص شده

-د، --حذف
تغییر(های) قفسه بندی شده نامگذاری شده را حذف کنید

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-ل، -- لیست
لیست قفسه های فعلی

-m،--پیام
استفاده از متن به عنوان پیام قفسه

-n،--نام
از نام داده شده برای commit قفسه بندی شده استفاده کنید

-پ، -- پچ
نشان دادن پچ

-من، --در ارتباط بودن
حالت تعاملی، فقط هنگام ایجاد یک قفسه کار می کند

--stat خلاصه تغییرات به سبک diffstat خروجی

-من،--عبارتند از
شامل اسامی مطابق با الگوهای داده شده باشد

-ایکس،-- استثناء کردن
نام های مطابق با الگوهای داده شده را حذف کنید

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

باز کردن قفسه
یک تغییر قفسه بندی شده را به دایرکتوری کاری بازیابی کنید:

hg unshelve [قفسه بندی شده]

این دستور نام اختیاری یک تغییر قفسه بندی شده را برای بازیابی می پذیرد. اگر هیچ کدام داده نشود،
جدیدترین تغییر قفسه استفاده شده است.

اگر تغییر قفسه‌بندی با موفقیت اعمال شود، بسته‌ای که حاوی قفسه‌بندی‌شده است تغییر می‌کند
به یک مکان پشتیبان (.hg/shelve-backup) منتقل می شود.

از آنجایی که می‌توانید تغییرات قفسه‌ای را در بالای یک تعهد دلخواه بازیابی کنید، این امکان وجود دارد
حذف قفسه منجر به تضاد بین تغییرات شما و تعهداتی می شود که دارید
قفسه برداشتن روی اگر این اتفاق افتاد، باید تضاد را حل کنید، سپس استفاده کنید --ادامه هید به
عملیات باز کردن قفسه را کامل کنید. (تا زمانی که با موفقیت نشوید، بسته جابجا نخواهد شد
قفسه را کامل کنید.)

(به طور متناوب، می توانید استفاده کنید -- سقط رها کردن قفسه ای که باعث درگیری می شود. این
تغییرات بدون قفسه را برمی گرداند و بسته را در جای خود باقی می گذارد.)

پس از حذف موفقیت آمیز، تغییرات قفسه بندی شده در یک فهرست پشتیبان ذخیره می شوند. فقط
N آخرین نسخه پشتیبان نگهداری می شود. N پیش‌فرض 10 است، اما می‌توان با استفاده از آن، آن را لغو کرد
shelve.maxbackups گزینه پیکربندی

مهر زمانی در ثانیه برای تصمیم گیری ترتیب پشتیبان گیری استفاده می شود. بیشتر از maxbackups پشتیبان گیری هستند
برای ایمنی، اگر همان مهر زمانی مانع از تصمیم گیری در مورد ترتیب دقیق آنها شود، نگهداری می شود.

گزینه های ارسال:

-آ، -- سقط
یک عملیات unshelve ناقص را لغو کنید

-c، --ادامه هید
ادامه عملیات باز کردن قفسه ناقص

-k، --نگاه داشتن
بعد از باز کردن قفسه در قفسه نگه دارید

-t،--ابزار
ابزار ادغام را مشخص کنید

--تاریخ
تعیین تاریخ برای تعهدات موقت (منسوخ شده)

نوار
تغییر مجموعه ها و فرزندان آنها را از تاریخ حذف کنید

این برنامه افزودنی به شما امکان می دهد تا تغییرات و تمام فرزندان آنها را از آن حذف کنید
مخزن برای جزئیات بیشتر به راهنمای دستور مراجعه کنید.

دستورات
نوار
نوار تغییرات و همه فرزندان آنها را از مخزن حذف کنید:

نوار hg [-k] [-f] [-B نشانک] [-r] REV...

دستور strip تغییرات مشخص شده و تمام فرزندان آنها را حذف می کند. اگر
دایرکتوری کاری تغییرات غیرمتعهد دارد، عملیات متوقف می شود مگر اینکه --force
پرچم ارائه شده است، در این صورت تغییرات حذف خواهند شد.

اگر والد دایرکتوری کاری حذف شود، دایرکتوری کاری حذف می شود
به طور خودکار به آخرین جد موجود والد محروم به روز می شود
پس از اتمام عملیات

هر گونه تغییرات حذف شده در آن ذخیره می شود hg/strip-backup به عنوان یک بسته نرم افزاری (نگاه کنید به hg کمک بسته و
hg کمک جدا کردن). آنها را می توان با اجرا بازیابی کرد hg جدا کردن hg/strip-backup/BUNDLE,
که در آن BUNDLE فایل بسته ای است که توسط نوار ایجاد می شود. توجه داشته باشید که شماره های تجدید نظر محلی
به طور کلی بعد از بازیابی متفاوت خواهد بود.

از گزینه --no-backup استفاده کنید تا پس از اتمام عملیات، بسته پشتیبان را کنار بگذارید.

Strip یک عملیات بازنویسی تاریخ نیست و می تواند در تغییرات عمومی استفاده شود
فاز. اما اگر تنظیمات حذف شده به یک مخزن راه دور منتقل شده باشند، این کار را انجام خواهید داد
احتمالا دوباره آنها را بکشید

با موفقیت 0 را برگردانید.

گزینه های ارسال:

-r،-- برگشت
strip specified revision (اختیاری، می توانید ویرایش ها را بدون این گزینه مشخص کنید)

-f، --زور
حذف اجباری تغییرات، حذف تغییرات غیرمتعهد (بدون پشتیبان)

--بدون پشتیبان
بدون پشتیبان

--بدون پشتیبان
بدون پشتیبان (منسوخ شده)

-n نادیده گرفته شد (منسوخ شده)

-k، --نگاه داشتن
دایرکتوری کاری را در طول نوار تغییر ندهید

-ب،-- نشانک
دورهای قابل دسترسی را فقط از نشانک داده شده حذف کنید

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

پیوند
دستور پیوند تغییرات از شاخه دیگر

این برنامه افزودنی به شما امکان می دهد تغییرات را به نسخه والد دیگری پیوند دهید، احتمالاً در
یک مخزن دیگر پیوند با استفاده از تکه های 'diff' انجام می شود.

تکه‌های پیوندی در .hg/transplant/transplants، به‌عنوان نقشه‌ای از مجموعه تغییرات ثبت می‌شوند.
هش به هش آن در مخزن منبع.

دستورات
پیوند
پیوند از شاخه دیگری تغییر می کند:

پیوند جیوه [-s REPO] [-b BRANCH [-a]] [-p REV] [-m REV] [REV]...

تغییرات انتخاب شده در بالای دایرکتوری کاری فعلی همراه با گزارش اعمال می شود
از تغییرات اصلی مجموعه‌های تغییرات کپی می‌شوند و بنابراین دو بار در صفحه نمایش داده می‌شوند
تاریخ با هویت های مختلف

استفاده از دستور graft را در نظر بگیرید اگر همه چیز در همان مخزن است - از آن استفاده خواهد شد
ادغام می شود و معمولاً نتیجه بهتری می دهد. اگر تغییرات تنظیم شد از پسوند rebase استفاده کنید
منتشر نشده اند و می خواهید به جای کپی کردن آنها را جابجا کنید.

اگر --log مشخص شده باشد، پیام های log یک نظر به فرم اضافه می شود:

(پیوند از CHANGESETHASH)

می توانید پیام تغییرات را با گزینه --filter بازنویسی کنید. استدلال آن خواهد بود
با پیام تغییرات فعلی به عنوان $1 و وصله به عنوان $2 فراخوانی می شود.

--source/-s مخزن دیگری را مشخص می کند تا از آن برای انتخاب تغییرات استفاده شود، درست مثل اینکه آن را انتخاب کنید
به طور موقت کشیده شده بود. اگر --branch/-b مشخص شده باشد، از این ویرایش ها به عنوان استفاده می شود
زمانی که تصمیم می‌گیرید چه تغییراتی را برای پیوند انجام دهید، سر می‌زند، درست مثل این که فقط این تجدیدنظرها داشته باشند
کشیده شده است. اگر --all/-a مشخص شده باشد، تمام اصلاحات تا سرهای مشخص شده با
--شاخه پیوند زده می شود.

مثال:

· پیوند تمام تغییرات تا REV در بالای نسخه فعلی شما:

پیوند جیوه -- شاخه REV -- همه

شما می توانید به صورت اختیاری تغییرات پیوندی انتخاب شده را به عنوان تغییرات ادغام علامت گذاری کنید. شما نمی خواهید
از شما خواسته می شود که هر اجداد پیوند ادغام شده را پیوند بزنید، و می توانید ادغام کنید
نوادگان آنها به طور معمول به جای پیوند آنها.

ادغام تغییرات ممکن است به طور مستقیم با مشخص کردن تغییرات والد مناسب توسط
فراخوانی hg پیوند --والدین.

اگر هیچ ادغام یا تجدید نظری ارائه نشد، hg پیوند یک مجموعه تغییرات تعاملی را شروع می کند
مرورگر.

اگر یک برنامه تغییرات ناموفق بود، می‌توانید ادغام را با دست برطرف کنید و سپس به جایی که می‌خواهید ادامه دهید
با تماس قطع شد hg پیوند --ادامه/-ج.

گزینه های ارسال:

-s ،-- منبع
تغییرات پیوند از REPO

-ب،--شاخه
از این منبع تغییرات به عنوان سر استفاده کنید

-آ، --همه
همه تغییرات را به بازبینی های --branch بکشید

-پ،-- هرس کنید
از REV عبور کنید

-m،--ادغام
ادغام در REV

--والدین
انتخاب والدین هنگام ادغام پیوند

-ه ، -- ویرایش
فراخوانی ویرایشگر در پیام های commit

-- ثبت نام اطلاعات پیوند را به پیام وارد کنید

-c، --ادامه هید
آخرین جلسه پیوند را پس از رفع تضادها ادامه دهید

-- فیلتر
تغییرات را از طریق دستور فیلتر کنید

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

win32mbcs
اجازه استفاده از مسیرهای MBCS با رمزگذاری های مشکل ساز را می دهد

برخی از رمزگذاری‌های MBCS برای برخی از عملیات‌های مسیر (به عنوان مثال تقسیم مسیر، کیس) خوب نیستند
تبدیل و غیره) با بایت های کدگذاری شده آن. ما چنین رمزگذاری را می نامیم (یعنی shift_jis و
big5) به عنوان "رمزگذاری مشکل دار". از این افزونه می توان برای رفع مشکل آن ها استفاده کرد
رمزگذاری با بسته بندی برخی از توابع برای تبدیل به رشته یونیکد قبل از عملیات مسیر.

این پسوند برای موارد زیر مفید است:

· کاربران ژاپنی ویندوز با استفاده از رمزگذاری shift_jis.

· کاربران چینی ویندوز با استفاده از رمزگذاری big5.

· همه کاربرانی که از یک مخزن با یکی از رمزگذاری های مشکل دار در حروف حساس استفاده می کنند
سیستم فایل

این پسوند برای موارد زیر مورد نیاز نیست:

· هر کاربری که فقط از کاراکترهای ASCII در مسیر استفاده می کند.

· هر کاربری که از کدگذاری های مشکل ساز استفاده نمی کند.

توجه داشته باشید که برای استفاده از این پسوند محدودیت هایی وجود دارد:

· شما باید از رمزگذاری واحد در یک مخزن استفاده کنید.

· اگر مسیر مخزن به 0x5c ختم شود، hg/hgrc. قابل خواندن نیست.

· win32mbcs با پسوند fixutf8 سازگار نیست.

به طور پیش فرض، win32mbcs از encoding.encoding که توسط Mercurial تعیین شده است استفاده می کند. می توانید مشخص کنید
گزینه encoding by config:

[win32mbcs]
رمزگذاری = sjis

این برای کاربرانی که می خواهند با پیام UTF-8 log commit کنند مفید است.

متن win32
انجام تبدیل خودکار خط جدید (منسوخ شده)

منسوخ شدن: پسوند win32text به هر کاربر نیاز دارد تا برنامه افزودنی را پیکربندی کند
بارها و بارها برای هر کلون از آنجایی که پیکربندی هنگام شبیه سازی کپی نمی شود.

بنابراین ما را ساخته ایم خنده دار به عنوان جایگزین. را خنده دار از یک نسخه کنترل شده استفاده می کند
برای پیکربندی خود فایل کنید و بنابراین هر کلون از تنظیمات مناسب استفاده می کند
آغاز.

برای انجام تبدیل خودکار خط جدید، از موارد زیر استفاده کنید:

[افزونه ها]
win32text =
[رمزگذاری]
** = کد هوشمند:
# یا ** = macecode:

[رمزگشایی]
** = رمزگشایی هوشمند:
# یا ** = macdecode:

اگر تبدیل را انجام نمی دهید، برای اطمینان از اینکه تصادفی CRLF/CR را انجام نمی دهید:

[قلاب]
pretxncommit.crlf = python:hgext.win32text.forbidcrlf
# یا pretxncommit.cr = python:hgext.win32text.forbidcr

برای انجام همین بررسی روی سرور برای جلوگیری از فشار یا کشیدن CRLF/CR:

[قلاب]
pretxnchangegroup.crlf = python:hgext.win32text.forbidcrlf
# یا pretxnchangegroup.cr = python:hgext.win32text.forbidcr

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

پسوند zeroconf تبلیغ خواهد کرد hg خدمت نمونه هایی بر روی DNS-SD به طوری که آنها می توانند باشند
کشف شده با استفاده از hg راه ها دستور بدون دانستن آدرس سرور.

برای اینکه افراد دیگر بتوانند مخزن شما را با استفاده از run کشف کنند hg خدمت در مخزن شما:

تست سی دی $
سرویس دلار جیوه

می توانید با اجرا کردن مخازن دارای Zeroconf را کشف کنید hg راه ها:

مسیرهای $ hg
zc-test = http://example.com:8000/تست

با استفاده از خدمات onworks.net از hg آنلاین استفاده کنید