HG(TAG) HG(TAG)

hg-tag - اختصاص یا مدیریت برچسب‌ها (تگ‌ها) برای یک بازنگری در Mercurial

hg tag [-f] [-l] [-m TEXT] [-d DATE] [-u USER] [-r REV] NAME...

نام‌گذاری یک بازنگری خاص با استفاده از <name>.

برچسب‌ها (تگ‌ها) برای نام‌گذاری بازنگری‌های خاصی از مخزن به کار می‌روند و برای مقایسه بازنگری‌های گوناگون، بازگشت به نسخه‌های مهم قبلی یا مشخص کردن نقاط انشعاب به‌عنوان انتشار (Release) و موارد دیگر بسیار کاربردی هستند. تغییر دادن یک برچسب موجود به‌طور عادی مجاز نیست؛ برای بازنویسی و اعمال اجباری از -f/--force استفاده کنید.

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

برای تسهیل کنترل نسخه، توزیع و ادغام برچسب‌ها، آن‌ها در فایلی با نام «.hgtags» ذخیره می‌شوند که مشابه سایر فایل‌های پروژه مدیریت می‌شود و در صورت نیاز می‌توان آن را به‌صورت دستی نیز ویرایش کرد. این موضوع همچنین بدان معناست که ایجاد برچسب یک کامیت جدید ثبت می‌کند. فایل «.hg/localtags» برای برچسب‌های محلی (که میان مخازن به اشتراک گذاشته نمی‌شوند) استفاده می‌شود.

کامیت‌های برچسب معمولاً در نوک (head) یک شاخه ایجاد می‌شوند. اگر والدِ دایرکتوری کاری نوک شاخه نباشد، دستور hg tag متوقف می‌شود؛ از -f/--force برای اجبار کامیت برچسب بر مبنای یک مجموعه تغییر غیر از نوک شاخه استفاده کنید.

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

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

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

اجبار در ایجاد یا تغییر برچسب
ایجاد برچسب به‌صورت محلی
بازنگری مورد نظر برای برچسب‌گذاری
حذف یک برچسب
فراخوانی ویرایشگر متنی برای پیام کامیت
استفاده از متن مشخص‌شده به‌عنوان پیام کامیت
ثبت تاریخ مشخص‌شده به‌عنوان تاریخ کامیت
ثبت کاربر مشخص‌شده به‌عنوان کامیت‌کننده