| HG(UNSHELVE) | HG(UNSHELVE) |
نام (NAME)
hg unshelve - بازگردانی تغییرات بایگانی‌شده به دایرکتوری کاری
خلاصه دستور (SYNOPSIS)
hg unshelve [OPTION]... [[-n] SHELVED]
توضیحات (DESCRIPTION)
این دستور یک نام اختیاری از تغییر بایگانی‌شده را برای بازگردانی می‌پذیرد. اگر نامی مشخص نشود، از جدیدترین تغییر بایگانی‌شده استفاده می‌شود.
اگر یک تغییر بایگانی‌شده با موفقیت اعمال شود، بستهٔ (bundle) حاوی تغییرات بایگانی‌شده به یک مکان پشتیبان (.hg/shelve-backup) منتقل می‌شود.
از آن‌جا که می‌توانید یک تغییر بایگانی‌شده را روی هر کامیت دلخواهی بازگردانی کنید، ممکن است عملیات unshelve به تداخل (conflict) میان تغییرات شما و کامیت‌هایی که روی آن‌ها بازگردانی می‌کنید منجر شود. در صورت بروز این حالت، باید تداخل را برطرف کرده و سپس از --continue برای تکمیل عملیات unshelve استفاده کنید. (بسته تا زمانی که unshelve را با موفقیت تکمیل نکنید منتقل نخواهد شد.)
(به عنوان روش جایگزین، می‌توانید از --abort برای رها کردن عملیات unshelve که باعث تداخل شده است استفاده کنید. این کار تغییرات بازگردانی‌شده را لغو کرده و بسته را دست‌نخورده باقی می‌گذارد.)
اگر تغییر بایگانی‌شدهٔ ساده (بدون گزینه‌های interactive، include و exclude) روی شاخه‌ای تازه ایجادشده انجام شده باشد، اطلاعات شاخه را به دایرکتوری کاری بازمی‌گرداند.
پس از یک unshelve موفق، تغییرات بایگانی‌شده در یک دایرکتوری پشتیبان ذخیره می‌شوند. تنها N نسخهٔ پشتیبان اخیر نگه‌داری می‌شوند. مقدار N به‌طور پیش‌فرض ۱۰ است اما می‌توان آن را با استفاده از گزینهٔ پیکربندی shelve.maxbackups بازنویسی کرد.
برچسب زمانی بر حسب ثانیه برای تعیین ترتیب پشتیبان‌ها استفاده می‌شود. جهت ایمنی بیشتر، در صورتی که یکسان بودن برچسب زمانی مانع از تعیین ترتیب دقیق آن‌ها شود، تعداد نسخه‌های پشتیبان بیشتری نسبت به maxbackups نگه‌داری می‌شود.
تغییرات انتخاب‌شده را می‌توان با پرچم --interactive بازگردانی کرد. دایرکتوری کاری با تغییرات انتخاب‌شده به‌روزرسانی شده و تنها تغییرات انتخاب‌نشده به‌صورت بایگانی باقی می‌مانند. نکته: پیش از اجرای تعاملی، کل تغییرات بایگانی‌شده ابتدا روی دایرکتوری کاری اعمال می‌شود. بنابراین، بدون در نظر گرفتن این‌که کدام تغییرات بازگردانی خواهند شد، تمام تداخل‌های میان دایرکتوری کاری و تغییرات بایگانی‌شده نمایان می‌شوند.
گزینه‌ها (OPTIONS)
- -a, --abort
- لغو یک عملیات ناتمام unshelve
- -c, --continue
- ادامه دادن یک عملیات ناتمام unshelve
- -i, --interactive
- استفاده از حالت تعاملی (آزمایشی)
- -k, --keep
- نگه‌داشتن بایگانی پس از بازگردانی (unshelve)
- -n,--name <NAME>
- بازگردانی تغییر بایگانی‌شده با نام مشخص‌شده
- -t,--tool <VALUE>
- مشخص کردن ابزار ادغام (merge)
- --date <DATE>
- تنظیم تاریخ برای کامیت‌های موقت (منسوخ‌شده)