HG(BACKOUT)                                                        HG(BACKOUT)

نام (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>
              ثبت کاربر مشخص‌شده به عنوان کامیت‌کننده

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

                                                                   HG(BACKOUT)