.TH HG COMMIT  "" "" ""
.SH "نام (NAME)"
hg-commit \- ثبت تغییرات اعمال‌شده در مخزن کنترل نسخه Mercurial
.\" Man page generated from reStructuredText.
.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.ft C
hg commit [OPTION]... [FILE]...
.ft P
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
تغییرات اعمال‌شده در فایل‌های مشخص‌شده را در مخزن ثبت می‌کند. برخلاف سامانه‌های کنترل نسخه متمرکز، این عملیات یک عملیات محلی است. برای مشاهده روش انتشار فعال تغییرات خود،
\%\fBhg push\fP\:
را ببینید.
.sp
اگر فهرستی از فایل‌ها مشخص نشود، تمام تغییرات گزارش‌شده توسط
\%\fBhg status\fP\:
ثبت خواهند شد.
.sp
اگر در حال ثبت نتیجه یک ادغام (Merge) هستید، هیچ نام فایل یا فیلتر
\-I/\-X
ارائه ندهید.
.sp
اگر پیام ثبتی مشخص نشود، مرکوریال ویرایشگر پیکربندی‌شده شما را باز می‌کند تا بتوانید پیام را وارد کنید. در صورتی که ثبت با شکست مواجه شود، یک نسخه پشتیبان از پیام خود را در
\fB.hg/last\-message.txt\fP
پیدا خواهید کرد.
.sp
گزینه
\-\-close\-branch
می‌تواند برای نشانه‌گذاری سرشاخه جاری به عنوان بسته استفاده شود. هنگامی که تمام سرشاخه‌های یک شاخه بسته شوند، آن شاخه بسته در نظر گرفته شده و دیگر در فهرست‌ها نمایش داده نمی‌شود.
.sp
گزینه
\-\-amend
می‌تواند برای اصلاح والد دایرکتوری کاری با یک ثبت جدید حاوی تغییرات والد به علاوه تغییرات گزارش‌شده فعلی توسط
\%\fBhg status\fP\:
(در صورت وجود) استفاده شود. ثبت قبلی در یک بسته پشتیبان در
\fB.hg/strip\-backup\fP
ذخیره می‌شود (برای نحوه بازیابی آن،
\%\fBhg help bundle\fP\:
و
\%\fBhg help unbundle\fP\:
را ببینید).
.sp
پیام، کاربر و تاریخ از ثبت اصلاح‌شده گرفته می‌شوند مگر اینکه به‌صورت صریح مشخص شوند. هنگامی که پیامی در خط فرمان مشخص نشده باشد، ویرایشگر با پیام ثبت اصلاح‌شده باز خواهد شد.
.sp
امکان اصلاح مجموعه‌تغییرات عمومی (ببینید \%\fBhg help phases\fP\:)
یا مجموعه‌تغییراتی که دارای فرزند هستند وجود ندارد.
.sp
برای فهرستی از قالب‌های معتبر برای
\-d/\-\-date
به
\%\fBhg help dates\fP\:
مراجعه کنید.
.sp
در صورت موفقیت مقدار 0 و در صورتی که چیزی تغییر نکرده باشد مقدار 1 برمی‌گرداند.
.sp
مثال‌ها:
.INDENT 0.0
.IP \(bu 2
.
ثبت تمام فایل‌هایی با پسوند py.:
.sp
.nf
.ft C
hg commit \-\-include "set:**.py"
.ft P
.fi
.IP \(bu 2
.
ثبت تمام فایل‌های غیر باینری (غیر دودویی):
.sp
.nf
.ft C
hg commit \-\-exclude "set:binary()"
.ft P
.fi
.IP \(bu 2
.
اصلاح ثبت فعلی و تنظیم تاریخ بر روی اکنون:
.sp
.nf
.ft C
hg commit \-\-amend \-\-date now
.ft P
.fi
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-A,  \-\-addremove
.
نشانه‌گذاری فایل‌های جدید/ناموجود به عنوان اضافه‌شده/حذف‌شده پیش از ثبت
.TP
.B \-\-close\-branch
.
نشانه‌گذاری یک سرشاخه به عنوان بسته
.TP
.B \-\-amend
.
اصلاح والد دایرکتوری کاری
.TP
.B \-s,  \-\-secret
.
استفاده از فاز secret برای ثبت
.TP
.B \-\-draft
.
استفاده از فاز draft برای ثبت
.TP
.B \-e,  \-\-edit
.
فراخوانی ویرایشگر متن برای پیام‌های ثبت
.TP
.B \-\-force\-close\-branch
.
بستن اجباری شاخه از یک مجموعه‌تغییرات غیر سرشاخه (پیشرفته)
.TP
.B \-i,  \-\-interactive
.
استفاده از حالت تعاملی
.TP
.BI \-I,  \-\-include \ <PATTERN[+]>
.
شامل کردن نام‌های منطبق با الگوهای داده‌شده
.TP
.BI \-X,  \-\-exclude \ <PATTERN[+]>
.
مستثنی کردن نام‌های منطبق با الگوهای داده‌شده
.TP
.BI \-m,  \-\-message \ <TEXT>
.
استفاده از متن به عنوان پیام ثبت
.TP
.BI \-l,  \-\-logfile \ <FILE>
.
خواندن پیام ثبت از فایل
.TP
.BI \-d,  \-\-date \ <DATE>
.
ثبت تاریخ مشخص‌شده به عنوان تاریخ ثبت
.TP
.BI \-u,  \-\-user \ <USER>
.
ثبت کاربر مشخص‌شده به عنوان ثبت‌کننده
.TP
.B \-S,  \-\-subrepos
.
پیمایش بازگشتی در زیرمخزن‌ها
.UNINDENT
.sp
[+] گزینه مشخص‌شده را می‌توان چندین بار تعیین کرد
.SH "نام‌های مستعار (ALIASES)"
.sp
.nf
.ft C
ci
.ft P
.fi
.\" Generated by docutils manpage writer.
.\"
.