HG(BRANCH) HG(BRANCH)

hg-branch - تنظیم یا نمایش شاخه کاری فعلی در Mercurial

hg branch [-fC] [NAME]

نکته (Note)
نام‌های شاخه دائمی و سراسری هستند. به‌جای آن از hg bookmark برای ایجاد نشانک سبک استفاده کنید. برای اطلاعات بیشتر در مورد شاخه‌های نام‌گذاری‌شده و نشانک‌ها به hg help glossary مراجعه کنید.

بدون آرگومان، نام شاخه کاری فعلی را نمایش می‌دهد. با یک آرگومان، نام شاخه دایرکتوری کاری را تنظیم می‌کند (شاخه تا زمان ثبت (commit) بعدی در مخزن وجود نخواهد داشت). روال استاندارد توصیه می‌کند توسعه اصلی روی شاخه 'default' انجام شود.

مگر اینکه -f/--force مشخص شده باشد، دستور branch اجازه نخواهد داد نام شاخه‌ای را تنظیم کنید که از قبل وجود دارد.

از -C/--clean برای بازنشانی شاخه دایرکتوری کاری به شاخه والد دایرکتوری کاری و لغو تغییر شاخه پیشین استفاده کنید.

از دستور hg update برای جابه‌جایی به شاخه‌ای موجود استفاده کنید. از hg commit --close-branch برای علامت‌گذاری این سرشاخه (head) به‌صورت بسته‌شده استفاده کنید. زمانی که تمامی سرشاخه‌های یک شاخه بسته شوند، آن شاخه بسته‌شده تلقی می‌شود.

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

تنظیم نام شاخه حتی در صورتی که روی شاخه‌ای موجود سایه بیندازد
بازنشانی نام شاخه به نام شاخه والد
تغییر شاخه رونوشت‌های (revs) داده‌شده (آزمایشی)

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