HG(SHELVE) HG(SHELVE)

hg shelve - ذخیره و کنار گذاشتن تغییرات از دایرکتوری کاری

hg shelve [OPTION]... [FILE]...

عملیات shelve فایل‌هایی را که «hg status» به عنوان ناپاک (not clean) گزارش می‌دهد گرفته، اصلاحات را در یک بسته (یک تغییر کنار گذاشته‌شده یا shelved change) ذخیره می‌کند و فایل‌ها را برمی‌گرداند تا وضعیت آن‌ها در دایرکتوری کاری پاک شود.

برای بازیابی این تغییرات به دایرکتوری کاری، از «hg unshelve» استفاده کنید؛ این دستور حتی در صورت جابه‌جایی به یک کامیت دیگر نیز کار خواهد کرد.

هنگامی که هیچ فایلی مشخص نشود، «hg shelve» تمام فایل‌های ناپاک را ذخیره می‌کند. اگر فایل‌ها یا دایرکتوری‌های خاصی نام برده شوند، تنها تغییرات مربوط به آن فایل‌ها کنار گذاشته می‌شوند.

در حالت shelve ساده (زمانی که هیچ فایلی مشخص نشده باشد و بدون گزینه‌های interactive، include و exclude)، این دستور به خاطر می‌سپارد که آیا دایرکتوری کاری روی شاخه‌ای تازه ایجاد شده بوده است یا خیر؛ به بیان دیگر، آیا دایرکتوری کاری روی شاخه‌ای متفاوت از اولین والد خود قرار داشته است یا خیر. در این وضعیت، اجرای unshelve اطلاعات شاخه را به دایرکتوری کاری بازیابی می‌کند.

هر تغییر کنار گذاشته‌شده دارای نامی است که یافتن مجدد آن را آسان‌تر می‌کند. به صورت پیش‌فرض، نام تغییر کنار گذاشته‌شده بر اساس نشانک (bookmark) فعال تعیین می‌شود، و در صورت نبود نشانک فعال، بر اساس نام شاخه فعلی خواهد بود. برای تعیین نامی دیگر، از --name استفاده کنید.

برای دیدن فهرستی از تغییرات کنار گذاشته‌شده موجود، از گزینه --list استفاده کنید. برای هر تغییر کنار گذاشته‌شده، نام، قدمت و توضیحات آن نمایش داده می‌شود؛ برای جزئیات بیشتر از --patch یا --stat استفاده کنید.

برای حذف تغییرات کنار گذاشته‌شده خاص، از --delete استفاده کنید. برای حذف همه تغییرات کنار گذاشته‌شده، از --cleanup استفاده کنید.

علامت‌گذاری فایل‌های جدید/ناموجود به عنوان افزوده/حذف‌شده پیش از انجام shelve
ذخیره فایل‌های ناشناخته (unknown) در shelve
حذف تمام تغییرات کنار گذاشته‌شده
انجام shelve با تاریخ کامیت مشخص‌شده
حذف تغییر(های) کنار گذاشته‌شده مشخص‌شده
فراخوانی ویرایشگر برای پیام‌های کامیت
کنار گذاشتن، اما نگه داشتن تغییرات در دایرکتوری کاری
فهرست کردن shelveهای فعلی
استفاده از متن مشخص‌شده به عنوان پیام shelve
استفاده از نام داده‌شده برای کامیت shelved
خروجی وصله‌ها (patches) برای تغییرات (نام‌های تغییرات کنار گذاشته‌شده را به عنوان آرگومان‌های مکانی مشخص کنید)
حالت تعاملی
خروجی خلاصه‌ای از تغییرات در قالب diffstat (نام‌های تغییرات کنار گذاشته‌شده را به عنوان آرگومان‌های مکانی مشخص کنید)
شامل کردن نام‌های مطابق با الگوهای داده‌شده
مستثنی کردن نام‌های مطابق با الگوهای داده‌شده

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