HG(BOOKMARKS) HG(BOOKMARKS)

hg bookmarks - ایجاد یک نشانک جدید یا فهرست کردن نشانک‌های موجود

hg bookmarks [OPTIONS]... [NAME]...

نشانک‌ها برچسب‌هایی بر روی مجموعه‌تغییرات هستند که به ردیابی مسیرهای توسعه کمک می‌کنند. نشانک‌ها فاقد نسخه هستند و می‌توان آن‌ها را جابه‌جا کرد، تغییر نام داد و حذف نمود. حذف یا جابه‌جایی یک نشانک هیچ اثری بر مجموعه‌تغییرات مرتبط نخواهد داشت.

ایجاد یک نشانک یا به‌روزرسانی به یک نشانک باعث می‌شود که آن نشانک به عنوان «فعال» ('active') علامت‌گذاری شود. نشانک فعال با یک '*' مشخص می‌شود. هنگامی که یک کامیت ایجاد می‌شود، نشانک فعال به کامیت جدید پیشروی می‌کند. دستور سادهٔ hg update نیز در صورت امکان نشانک فعال را پیش خواهد برد. به‌روزرسانی به مقصدی غیر از نشانک فعلی باعث غیرفعال شدن آن می‌شود.

نشانک‌ها را می‌توان میان مخازن ارسال (push) و دریافت (pull) کرد (به hg help push و hg help pull مراجعه کنید). اگر یک نشانکِ به اشتراک گذاشته‌شده دچار واگرایی شود، یک «نشانک واگرا» به فرم 'name@path' ایجاد خواهد شد. استفاده از hg merge این واگرایی را حل خواهد کرد.

مشخص کردن نشانک به صورت '.' برای گزینه‌های -m/-d/-l معادل مشخص کردن نام نشانک فعال است.

نشانکی با نام '@' ویژگی خاصی دارد که دستور hg clone در صورت وجود، آن را به طور پیش‌فرض وارسی (checkout) می‌کند.

الگو:

کلمات کلیدی زیر علاوه بر کلمات کلیدی و توابع مشترک الگو نظیر {bookmark} پشتیبانی می‌شوند. همچنین hg help templates را ببینید.

بولی (Boolean). درست (True) اگر نشانک فعال باشد.

مثال‌ها:

  • ایجاد یک نشانک فعال برای یک مسیر توسعهٔ جدید: 
    hg book new-feature
  • ایجاد یک نشانک غیرفعال به عنوان نشانه‌گذار: 
    hg book -i reviewed
  • ایجاد یک نشانک غیرفعال بر روی مجموعه‌تغییری دیگر: 
    hg book -r .^ tested
  • تغییر نام نشانک turkey به dinner: 
    hg book -m turkey dinner
  • انتقال نشانک '@' از شاخه‌ای دیگر: 
    hg book -f @
  • تنها چاپ کردن نام نشانک فعال: 
    hg book -ql .

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

bookmark