نام (NAME)

hg backout - خنثی‌سازی اثر changeset پیشین

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

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

توضیحات (DESCRIPTION)

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

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

نکته: از hg backout نمی‌توان برای برطرف کردن یک ادغام (merge) ناخواسته یا نادرست استفاده کرد.

مثال‌ها:

خنثی‌سازی اثر والد دایرکتوری کاری. این backout بلافاصله کامیت خواهد شد:
```
hg backout -r .
```
خنثی‌سازی اثر revision معیوب پیشین 23:
```
hg backout -r 23
```
خنثی‌سازی اثر revision معیوب پیشین 23 و باقی گذاشتن تغییرات به‌صورت کامیت‌نشده:
```
hg backout -r 23 --no-commit
hg commit -m "Backout revision 23"
```
به‌طور پیش‌فرض، changeset معلق دارای یک والد خواهد بود و تاریخچه خطی را حفظ می‌کند. با --merge، changeset معلق در عوض دو والد خواهد داشت: والد قدیمی دایرکتوری کاری و یک فرزند جدید از REV که صرفاً REV را خنثی می‌کند.

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

برای فهرستی از قالب‌های معتبر برای -d/--date، به hg help dates مراجعه کنید.

برای روش بازگردانی فایل‌ها به وضعیت یک revision دیگر، به hg help revert مراجعه کنید.

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

گزینه‌ها (OPTIONS)

--merge: ادغام با والد قبلی وضعیت دایرکتوری (dirstate) پس از backout
--commit: کامیت در صورت عدم برخورد با تداخل (منسوخ شده)
--no-commit: عدم انجام کامیت
--parent <REV>: انتخاب والد هنگام بازگردانی ادغام (منسوخ شده)
-r,--rev <REV>: ویرایش (revision) مورد نظر برای بازگردانی
-e, --edit: فراخوانی ویرایشگر متن برای پیام‌های کامیت
-t,--tool <TOOL>: تعیین ابزار ادغام
-I,--include <PATTERN[+]>: شامل کردن نام‌های منطبق با الگوهای مشخص‌شده
-X,--exclude <PATTERN[+]>: مستثنی کردن نام‌های منطبق با الگوهای مشخص‌شده
-m,--message <TEXT>: استفاده از متن مشخص‌شده به عنوان پیام کامیت
-l,--logfile <FILE>: خواندن پیام کامیت از فایل
-d,--date <DATE>: ثبت تاریخ مشخص‌شده به عنوان تاریخ کامیت
-u,--user <USER>: ثبت کاربر مشخص‌شده به عنوان کامیت‌کننده
گزینه‌های مشخص‌شده با [+] را می‌توان چندین بار تعیین کرد