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

                                                                    HG(COMMIT)