| HG(COMMIT) | HG(COMMIT) |
نام (NAME)
hg-commit - ثبت تغییرات اعمال‌شده در مخزن کنترل نسخه Mercurial
خلاصه دستور (SYNOPSIS)
hg commit [OPTION]... [FILE]...
توضیحات (DESCRIPTION)
تغییرات اعمال‌شده در فایل‌های مشخص‌شده را در مخزن ثبت می‌کند. برخلاف سامانه‌های کنترل نسخه متمرکز، این عملیات یک عملیات محلی است. برای مشاهده روش انتشار فعال تغییرات خود، hg push را ببینید.
اگر فهرستی از فایل‌ها مشخص نشود، تمام تغییرات گزارش‌شده توسط hg status ثبت خواهند شد.
اگر در حال ثبت نتیجه یک ادغام (Merge) هستید، هیچ نام فایل یا فیلتر -I/-X ارائه ندهید.
اگر پیام ثبتی مشخص نشود، مرکوریال ویرایشگر پیکربندی‌شده شما را باز می‌کند تا بتوانید پیام را وارد کنید. در صورتی که ثبت با شکست مواجه شود، یک نسخه پشتیبان از پیام خود را در .hg/last-message.txt پیدا خواهید کرد.
گزینه --close-branch می‌تواند برای نشانه‌گذاری سرشاخه جاری به عنوان بسته استفاده شود. هنگامی که تمام سرشاخه‌های یک شاخه بسته شوند، آن شاخه بسته در نظر گرفته شده و دیگر در فهرست‌ها نمایش داده نمی‌شود.
گزینه --amend می‌تواند برای اصلاح والد دایرکتوری کاری با یک ثبت جدید حاوی تغییرات والد به علاوه تغییرات گزارش‌شده فعلی توسط hg status (در صورت وجود) استفاده شود. ثبت قبلی در یک بسته پشتیبان در .hg/strip-backup ذخیره می‌شود (برای نحوه بازیابی آن، hg help bundle و hg help unbundle را ببینید).
پیام، کاربر و تاریخ از ثبت اصلاح‌شده گرفته می‌شوند مگر اینکه به‌صورت صریح مشخص شوند. هنگامی که پیامی در خط فرمان مشخص نشده باشد، ویرایشگر با پیام ثبت اصلاح‌شده باز خواهد شد.
امکان اصلاح مجموعه‌تغییرات عمومی (ببینید hg help phases) یا مجموعه‌تغییراتی که دارای فرزند هستند وجود ندارد.
برای فهرستی از قالب‌های معتبر برای -d/--date به hg help dates مراجعه کنید.
در صورت موفقیت مقدار 0 و در صورتی که چیزی تغییر نکرده باشد مقدار 1 برمی‌گرداند.
مثال‌ها:
- ثبت تمام
فایل‌هایی
با پسوند py.:
hg commit --include "set:**.py"
- ثبت تمام
فایل‌های
غیر باینری
(غیر
دودویی):
hg commit --exclude "set:binary()"
- اصلاح ثبت
فعلی و
تنظیم
تاریخ بر
روی اکنون:
hg commit --amend --date now
گزینه‌ها (OPTIONS)
- -A, --addremove
- نشانه‌گذاری فایل‌های جدید/ناموجود به عنوان اضافه‌شده/حذف‌شده پیش از ثبت
- --close-branch
- نشانه‌گذاری یک سرشاخه به عنوان بسته
- --amend
- اصلاح والد دایرکتوری کاری
- -s, --secret
- استفاده از فاز secret برای ثبت
- --draft
- استفاده از فاز draft برای ثبت
- -e, --edit
- فراخوانی ویرایشگر متن برای پیام‌های ثبت
- --force-close-branch
- بستن اجباری شاخه از یک مجموعه‌تغییرات غیر سرشاخه (پیشرفته)
- -i, --interactive
- استفاده از حالت تعاملی
- -I,--include <PATTERN[+]>
- شامل کردن نام‌های منطبق با الگوهای داده‌شده
- -X,--exclude <PATTERN[+]>
- مستثنی کردن نام‌های منطبق با الگوهای داده‌شده
- -m,--message <TEXT>
- استفاده از متن به عنوان پیام ثبت
- -l,--logfile <FILE>
- خواندن پیام ثبت از فایل
- -d,--date <DATE>
- ثبت تاریخ مشخص‌شده به عنوان تاریخ ثبت
- -u,--user <USER>
- ثبت کاربر مشخص‌شده به عنوان ثبت‌کننده
- -S, --subrepos
- پیمایش
بازگشتی در
زیرمخزن‌ها
[+] گزینه مشخص‌شده را می‌توان چندین بار تعیین کرد
نام‌های مستعار (ALIASES)
ci