'\" t .\" Title: git-mailinfo .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2026-06-29 .\" Manual: Git Manual .\" Source: Git 2.55.0 .\" Language: English .\" .TH "GIT\-MAILINFO" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" git-mailinfo \- استخراج وصله و اطلاعات نویسنده از یک پیام ایمیل .SH "خلاصه دستور (SYNOPSIS)" .sp .nf \fIgit mailinfo\fR [\-k|\-b] [\-u | \-\-encoding= | \-n] [\-\-[no\-]scissors] [\-\-quoted\-cr=] .fi .sp .SH "توضیحات (DESCRIPTION)" .sp یک پیام ایمیل را از ورودی استاندارد می‌خواند و پیام گزارش کامیت را در فایل و وصله‌ها را در فایل می‌نویسد\&. نام نویسنده، ایمیل و موضوع ایمیل در خروجی استاندارد نوشته می‌شوند تا توسط \fIgit am\fR برای ایجاد کامیت مورد استفاده قرار گیرند\&. معمولاً نیازی به استفاده مستقیم از این دستور نیست؛ به جای آن \fBgit-am\fR(1) را ببینید\&. .SH "گزینه‌ها (OPTIONS)" .PP \-k .RS 4 معمولاً این برنامه زواید ایمیل را از خط سربرگ Subject: حذف می‌کند تا عنوان پیام گزارش کامیت را استخراج کند\&. این گزینه مانع از این دستکاری می‌شود و بیشترین کاربرد آن هنگام بازخوانی خروجی \fIgit format\-patch \-k\fR است\&. .sp به‌طور مشخص، موارد زیر تا زمانی که دیگر چیزی از آن‌ها باقی نماند حذف می‌شوند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} فاصله‌های خالی ابتدا و انتهای متن\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} عبارت‌های ابتدایی \fBRe:\fR، \fBre:\fR و \fB:\fR\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} رشته‌های درون کروشه در ابتدا (میان [ و ]، معمولاً [\fBPATCH\fR])\&. .RE .sp در نهایت، فاصله‌های خالی پیاپی به یک نویسه فاصله ASCII یکسان‌سازی می‌شوند\&. .RE .PP \-b .RS 4 هنگامی که \-k فعال نباشد، تمام رشته‌های ابتدایی محصور میان جفت‌های \fI[\fR و \fI]\fR حذف می‌شوند\&. این گزینه حذف کردن را تنها به جفت‌هایی محدود می‌کند که رشته درون کروشه آن‌ها حاوی کلمه "PATCH" باشد\&. .RE .PP \-u .RS 4 پیام گزارش کامیت، نام نویسنده و ایمیل نویسنده از ایمیل گرفته شده و پس از رمزگشایی حداقلی کدگذاری انتقال MIME، با نویسه‌گردانی در مجموعه نویسه‌های مشخص‌شده توسط \fBi18n\&.commitEncoding\fR (با مقدار پیش‌فرض UTF\-8) بازکدگذاری می‌شوند\&. این ویژگی قبلاً اختیاری بود اما اکنون رفتار پیش‌فرض است\&. .sp توجه داشته باشید که وصله همیشه بدون تغییر و بدون تبدیل مجموعه نویسه‌ها استفاده می‌شود، حتی با وجود این گزینه\&. .RE .PP \-\-encoding= .RS 4 مشابه با \-u است، اما هنگام بازکدگذاری، مجموعه نویسه‌های مشخص‌شده در اینجا به جای مقدار تعیین‌شده در \fBi18n\&.commitEncoding\fR یا UTF\-8 استفاده می‌شود\&. .RE .PP \-n .RS 4 غیرفعال کردن تمام بازکدگذاری‌های مجموعه نویسه‌ها برای متاداده\&. .RE .PP \-m, \-\-message\-id .RS 4 کپی کردن سربرگ Message\-ID در انتهای پیام کامیت\&. این گزینه برای پیوند دادن کامیت‌ها به بحث‌های فهرست پستی (mailing list) مفید است\&. .RE .PP \-\-scissors .RS 4 حذف هر آنچه در بدنه پیام پیش از خط قیچی (مانند "\-\- >8 \-\-") قرار دارد\&. این خط نماد قیچی و خط‌چین برش است و برای درخواست از خواننده جهت برش پیام در آن خط استفاده می‌شود\&. اگر چنین خطی در بدنه پیام پیش از وصله ظاهر شود، با استفاده از این گزینه، تمام موارد پیش از آن (شامل خود خط قیچی) نادیده گرفته می‌شوند\&. .sp این قابلیت زمانی مفید است که بخواهید پیام خود را در یک رشته گفتگو با نظرات و پیشنهاد‌ها درباره پیامی که به آن پاسخ می‌دهید آغاز کنید و آن را با ارسال یک وصله به پایان برسانید، به گونه‌ای که بحث و آغاز پیام گزارش کامیت پیشنهادی با یک خط قیچی از هم جدا شوند\&. .sp این ویژگی را می‌توان به‌طور پیش‌فرض با گزینه پیکربندی mailinfo\&.scissors فعال کرد\&. .RE .PP \-\-no\-scissors .RS 4 نادیده گرفتن خطوط قیچی\&. برای بازنویسی و بی‌اثر کردن تنظیمات mailinfo\&.scissors مفید است\&. .RE .PP \-\-quoted\-cr= .RS 4 عملی که باید هنگام پردازش پیام‌های ایمیل ارسال‌شده با کدگذاری base64 یا quoted\-printable انجام شود، در صورتی که خطوط رمزگشایی‌شده به جای یک LF ساده با CRLF پایان یابند\&. .sp عملیات‌های معتبر عبارتند از: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBnowarn\fR: گیت هنگام یافتن چنین CRLF هیچ واکنشی نشان نخواهد داد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBwarn\fR: در صورت یافتن چنین CRLF، گیت برای هر پیام هشداری صادر خواهد کرد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBstrip\fR: گیت آن نویسه‌های CRLF را به LF تبدیل خواهد کرد\&. .RE .sp عمل پیش‌فرض را می‌توان از طریق گزینه پیکربندی \fBmailinfo\&.quotedCR\fR تنظیم کرد\&. اگر چنین گزینه‌ای تنظیم نشده باشد، از \fBwarn\fR استفاده خواهد شد\&. .RE .PP .RS 4 پیام گزارش کامیت استخراج‌شده از ایمیل، معمولاً به استثنای خط عنوان که از Subject ایمیل گرفته می‌شود\&. .RE .PP .RS 4 وصله استخراج‌شده از ایمیل\&. .RE .SH "پیکربندی (CONFIGURATION)" .sp تمام موارد زیر این خط در این بخش، به‌صورت گزینش‌شده از مستندات \fBgit-config\fR(1) گنجانده شده‌اند\&. محتوای آن‌ها همان چیزی است که در آنجا یافت می‌شود: .PP mailinfo\&.scissors .RS 4 در صورت تنظیم روی true، باعث می‌شود \fBgit-mailinfo\fR(1) (و در نتیجه \fBgit-am\fR(1)) به‌طور پیش‌فرض طوری رفتار کنند که گویی گزینه \-\-scissors در خط فرمان داده شده است\&. هنگام فعال بودن، این ویژگی هر آنچه را که در بدنه پیام پیش از خط قیچی (یعنی خطی که عمدتاً شامل ">8"، "8<" و "\-" است) قرار دارد حذف می‌کند\&. .RE .SH "گیت (GIT)" .sp بخشی از مجموعه \fBgit\fR(1)