'\" t .\" Title: git-shortlog .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2026-06-29 .\" Manual: دستورات عمومی کاربر .\" Source: Git 2.55.0 .\" Language: Persian .\" .TH "GIT\-SHORTLOG" "1" "2026\-06\-29" "Git 2\&.55\&.0" "دستورات عمومی کاربر" .\" ----------------------------------------------------------------- .\" * 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-shortlog \- خلاصه‌سازی خروجی git log .SH "خلاصه دستور (SYNOPSIS)" .sp .nf \fBgit\fR \fBshortlog\fR [\fI\fR] [\fI\fR] [[\fB\-\-\fR] \fI\fR\&...] \fBgit\fR \fBlog\fR \fB\-\-pretty=short\fR | \fBgit\fR \fBshortlog\fR [\fI\fR] .fi .sp .SH "توضیحات (DESCRIPTION)" .sp خروجی \fBgit\fR \fBlog\fR را در قالبی مناسب برای گنجاندن در اطلاعیه‌های انتشار خلاصه‌سازی می‌کند\&. هر کامیت بر اساس نویسنده و عنوان گروه‌بندی خواهد شد\&. .sp علاوه بر این، عبارت «[PATCH]» از توضیحات کامیت حذف خواهد شد\&. .sp اگر هیچ بازنگری‌ای در خط فرمان داده نشود و ورودی استاندارد یک ترمینال نباشد یا هیچ شاخه فعلی‌ای وجود نداشته باشد، \fBgit\fR \fBshortlog\fR خلاصه‌ای از لاگ خوانده‌شده از ورودی استاندارد را بدون ارجاع به مخزن فعلی در خروجی نمایش می‌دهد\&. .SH "گزینه‌ها (OPTIONS)" .PP \fB\-n\fR, \fB\-\-numbered\fR .RS 4 خروجی را به‌جای ترتیب الفبایی نویسندگان، بر اساس تعداد کامیت‌های هر نویسنده مرتب می‌کند\&. .RE .PP \fB\-s\fR, \fB\-\-summary\fR .RS 4 از توضیحات کامیت صرف‌نظر کرده و تنها خلاصه‌ای از تعداد کامیت‌ها را ارائه می‌دهد\&. .RE .PP \fB\-e\fR, \fB\-\-email\fR .RS 4 نشانی ایمیل هر نویسنده را نمایش می‌دهد\&. .RE .PP \fB\-\-format\fR[\fB=\fR\fI\fR] .RS 4 به‌جای موضوع کامیت، از اطلاعات دیگری برای توصیف هر کامیت استفاده می‌کند\&. \fI\fR می‌تواند هر رشته‌ای باشد که توسط گزینه \fB\-\-format\fR دستور \fBgit\fR \fBlog\fR پذیرفته می‌شود، مانند \fI* [%h] %s\fR\&. (بخش \fIPRETTY FORMATS\fR از \fBgit-log\fR(1) را ببینید)\&. .sp هر کامیت با چاپ زیبا (pretty-printed) پیش از نمایش، مجدداً سطرشکنی (rewrap) خواهد شد\&. .RE .PP \fB\-\-date=\fR\fI\fR .RS 4 تاریخ‌ها را با قالب‌بندی متناسب با رشته تاریخ داده‌شده نمایش می‌دهد\&. (گزینه \fB\-\-date\fR در بخش \fICommit Formatting\fR از \fBgit-log\fR(1) را ببینید)\&. همراه با \fB\-\-group=format:\fR\fI\fR سودمند است\&. .RE .PP \fB\-\-group=\fR\fI\fR .RS 4 کامیت‌ها را بر اساس \fI\fR گروه‌بندی می‌کند\&. اگر هیچ گزینه \fB\-\-group\fR مشخص نشده باشد، پیش‌فرض \fBauthor\fR است\&. \fI\fR یکی از موارد زیر است: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBauthor\fR, کامیت‌ها بر اساس نویسنده گروه‌بندی می‌شوند .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBcommitter\fR, کامیت‌ها بر اساس ثبت‌کننده گروه‌بندی می‌شوند (مشابه \fB\-c\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBtrailer:\fR\fI\fR, \fI\fR به‌عنوان یک دنباله (trailer) در پیام کامیت بدون حساسیت به حروف کوچک و بزرگ تفسیر می‌شود (به \fBgit-interpret-trailers\fR(1) مراجعه کنید)\&. برای نمونه، اگر پروژه شما از دنباله‌های \fBReviewed\-by\fR استفاده می‌کند، ممکن است بخواهید با دستور زیر ببینید چه کسانی مشغول بازبینی بوده‌اند: \fBgit\fR \fBshortlog\fR \fB\-ns\fR \fB\-\-group=trailer:reviewed\-by\fR\&. .sp توجه داشته باشید کامیت‌هایی که شامل این دنباله نباشند شمرده نمی‌شوند\&. به همین ترتیب، کامیت‌هایی با چند دنباله (برای نمونه چند تاییدیه signoff) ممکن است بیش از یک‌بار شمرده شوند (اما تنها یک‌بار به ازای هر مقدار دنباله یکتا در آن کامیت)\&. .sp دستور Shortlog تلاش می‌کند هر مقدار دنباله را به‌عنوان یک هویت \fBname\fR \fI\fR تجزیه کند\&. در صورت موفقیت، mailmap اعمال شده و ایمیل حذف می‌شود مگر اینکه گزینه \fB\-\-email\fR مشخص شده باشد\&. اگر مقدار نتواند به‌عنوان یک هویت تجزیه شود، به‌صورت تحت‌اللفظی و کامل در نظر گرفته می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBformat:\fR\fI\fR, هر رشته‌ای که توسط گزینه \fB\-\-format\fR دستور \fBgit\fR \fBlog\fR پذیرفته می‌شود\&. (بخش \fIPRETTY FORMATS\fR از \fBgit-log\fR(1) را ببینید)\&. .RE .sp اگر \fB\-\-group\fR چندین بار مشخص شود، کامیت‌ها ذیل هر مقدار شمرده می‌شوند (اما باز هم، تنها یک‌بار به ازای هر مقدار یکتا در آن کامیت)\&. برای نمونه، \fBgit\fR \fBshortlog\fR \fB\-\-group=author\fR \fB\-\-group=trailer:co\-authored\-by\fR هم نویسندگان و هم هم‌نویسندگان (co-authors) را می‌شمارد\&. .RE .PP \fB\-c\fR, \fB\-\-committer\fR .RS 4 این یک نام مستعار برای \fB\-\-group=committer\fR است\&. .RE .PP \fB\-w\fR[\fI\fR[\fB,\fR\fI\fR[\fB,\fR\fI\fR]]] .RS 4 خروجی را با شکستن هر خط در \fBwidth\fR سطرشکنی می‌کند\&. خط نخست هر مدخل به اندازه \fBindent1\fR فاصله تورفتگی دارد، و خط دوم و خطوط بعدی به اندازه \fBindent2\fR فاصله تورفته می‌شوند\&. مقادیر پیش‌فرض برای \fBwidth\fR, \fBindent1\fR, و \fBindent2\fR به‌ترتیب برابر ۷۶، ۶ و ۹ هستند\&. .sp اگر عرض برابر \fB0\fR (صفر) باشد، خطوط خروجی بدون شکستن آن‌ها تورفته می‌شوند\&. .RE .PP \fI\fR .RS 4 تنها کامیت‌های موجود در محدوده بازنگری مشخص‌شده را نشان می‌دهد\&. هنگامی که هیچ \fI\fR مشخص نشده باشد، به‌طور پیش‌فرض روی \fBHEAD\fR تنظیم می‌شود (یعنی کل تاریخچه منتهی به کامیت کنونی)\&. \fBorigin\fR\fB\.\.\fR\fBHEAD\fR تمام کامیت‌های قابل دسترسی از کامیت فعلی (یعنی \fBHEAD\fR) را که از \fBorigin\fR قابل دسترسی نیستند مشخص می‌کند\&. برای فهرست کامل روش‌های نگارش \fI\fR, به بخش \fISpecifying Ranges\fR از \fBgitrevisions\fR(7) مراجعه کنید\&. .RE .PP [\fB\-\-\fR] \fI\fR\&.\&.\&. .RS 4 تنها کامیت‌هایی را در نظر می‌گیرد که برای توضیح چگونگی شکل‌گیری فایل‌های منطبق با مسیرهای مشخص‌شده کافی باشند\&. .sp در صورت بروز ابهام، ممکن است لازم باشد مسیرها با پیشوند \fB\-\-\fR مشخص شوند تا از گزینه‌ها یا محدوده بازنگری تفکیک گردند\&. .RE .SS "محدود کردن کامیت‌ها (Commit Limiting)" .sp علاوه بر مشخص کردن محدوده‌ای از کامیت‌ها که باید با استفاده از نمادگذاری‌های ویژه توضیح داده‌شده در بخش توضیحات فهرست شوند، محدودسازی‌های بیشتری نیز روی کامیت‌ها قابل اعمال است\&. .sp استفاده از گزینه‌های بیشتر عموماً خروجی را بیشتر محدود می‌کند (برای نمونه \fB\-\-since=\fR\fI\fR نتایج را به کامیت‌های جدیدتر از \fI\fR محدود می‌سازد، و استفاده از آن همراه با \fB\-\-grep=\fR\fI\fR نتایج را به کامیت‌هایی محدود می‌کند که پیام لاگ آن‌ها شامل خطی منطبق با \fI\fR باشد)، مگر اینکه خلاف آن ذکر شده باشد\&. .sp توجه داشته باشید که این محدودیت‌ها پیش از گزینه‌های مرتب‌سازی و قالب‌بندی کامیت، مانند \fB\-\-reverse\fR اعمال می‌شوند\&. .PP \fB\-\fR\fI\fR, \fB\-n\fR \fI\fR, \fB\-\-max\-count=\fR\fI\fR .RS 4 خروجی را به نخستین \fI\fR کامیتی که نمایش داده می‌شوند محدود می‌کند\&. .RE .PP \fB\-\-max\-count\-oldest=\fR\fI\fR .RS 4 خروجی را به آخرین \fI\fR کامیتی که نمایش داده می‌شوند محدود می‌کند\&. .RE .PP \fB\-\-skip=\fR\fI\fR .RS 4 پیش از شروع به نمایش خروجی کامیت‌ها، از \fI\fR کامیت اول صرف‌نظر می‌کند\&. .RE .PP \fB\-\-since=\fR\fI\fR, \fB\-\-after=\fR\fI\fR .RS 4 کامیت‌های جدیدتر از \fI\fR را نمایش می‌دهد\&. به‌عنوان یک حالت ویژه، \fItoday\fR به معنی نیمه‌شب گذشته است\&. .RE .PP \fB\-\-since\-as\-filter=\fR\fI\fR .RS 4 تمام کامیت‌های جدیدتر از \fI\fR را نمایش می‌دهد\&. این گزینه به‌جای توقف در نخستین کامیت قدیمی‌تر از \fI\fR, تمام کامیت‌های موجود در محدوده را پیمایش می‌کند\&. .RE .PP \fB\-\-until=\fR\fI\fR, \fB\-\-before=\fR\fI\fR .RS 4 کامیت‌های قدیمی‌تر از \fI\fR را نمایش می‌دهد\&. .RE .PP \fB\-\-author=\fR\fI\fR, \fB\-\-committer=\fR\fI\fR .RS 4 خروجی کامیت‌ها را به مواردی محدود می‌کند که خطوط هدر نویسنده/ثبت‌کننده آن‌ها با عبارت باقاعده \fI\fR مطابقت داشته باشد\&. با تعیین بیش از یک \fB\-\-author=\fR\fI\fR, کامیت‌هایی انتخاب می‌شوند که نویسنده آن‌ها با هر یک از \fI\fR ها مطابقت داشته باشد (مشابهاً برای چند مورد \fB\-\-committer=\fR\fI\fR)\&. .RE .PP \fB\-\-grep\-reflog=\fR\fI\fR .RS 4 خروجی کامیت‌ها را به مواردی محدود می‌کند که مدخل‌های رِف‌لاگ آن‌ها با عبارت باقاعده \fI\fR مطابقت داشته باشد\&. با تعیین بیش از یک \fB\-\-grep\-reflog\fR, کامیت‌هایی انتخاب می‌شوند که پیام رِف‌لاگ آن‌ها با هر یک از الگوهای داده‌شده تطبیق داشته باشد\&. استفاده از این گزینه بدون به‌کارگیری \fB\-\-walk\-reflogs\fR خطا است\&. .RE .PP \fB\-\-grep=\fR\fI\fR .RS 4 خروجی کامیت‌ها را به مواردی محدود می‌کند که پیام لاگ آن‌ها با عبارت باقاعده \fI\fR مطابقت داشته باشد\&. با مشخص کردن بیش از یک \fB\-\-grep=\fR\fI\fR, کامیت‌هایی انتخاب می‌شوند که پیام آن‌ها با هر یک از \fI\fR ها مطابقت کند (اما گزینه \fB\-\-all\-match\fR را نیز ببینید)\&. .sp هنگامی که \fB\-\-notes\fR فعال باشد، پیام موجود در یادداشت‌ها به‌گونه‌ای تطبیق داده می‌شود که گویی بخشی از پیام لاگ است\&. .RE .PP \fB\-\-all\-match\fR .RS 4 خروجی کامیت‌ها را به مواردی محدود می‌کند که با تمام الگوهای داده‌شده به \fB\-\-grep\fR مطابقت داشته باشند، به‌جای مواردی که دست‌کم با یکی تطبیق دارند\&. .RE .PP \fB\-\-invert\-grep\fR .RS 4 خروجی کامیت‌ها را به مواردی محدود می‌کند که پیام لاگ آن‌ها با \fI\fR مشخص‌شده با \fB\-\-grep=\fR\fI\fR مطابقت نداشته باشد\&. .RE .PP \fB\-i\fR, \fB\-\-regexp\-ignore\-case\fR .RS 4 الگوهای محدودکننده عبارت باقاعده را بدون حساسیت به حروف کوچک و بزرگ مطابقت می‌دهد\&. .RE .PP \fB\-\-basic\-regexp\fR .RS 4 الگوهای محدودکننده را به‌عنوان عبارات باقاعده پایه در نظر می‌گیرد؛ این رفتار پیش‌فرض است\&. .RE .PP \fB\-E\fR, \fB\-\-extended\-regexp\fR .RS 4 الگوهای محدودکننده را به‌جای عبارات باقاعده پایه پیش‌فرض، به‌عنوان عبارات باقاعده گسترش‌یافته در نظر می‌گیرد\&. .RE .PP \fB\-F\fR, \fB\-\-fixed\-strings\fR .RS 4 الگوهای محدودکننده را به‌عنوان رشته‌های ثابت در نظر می‌گیرد (الگو را به‌عنوان یک عبارت باقاعده تفسیر نمی‌کند)\&. .RE .PP \fB\-P\fR, \fB\-\-perl\-regexp\fR .RS 4 الگوهای محدودکننده را به‌عنوان عبارات باقاعده سازگار با پرل در نظر می‌گیرد\&. .sp پشتیبانی از این نوع عبارات باقاعده یک وابستگی اختیاری در زمان کامپایل است\&. اگر گیت بدون پشتیبانی از آن‌ها کامپایل شده باشد، ارائه این گزینه باعث خاتمه همراه با خطای برنامه می‌شود\&. .RE .PP \fB\-\-remove\-empty\fR .RS 4 هنگامی که یک مسیر داده‌شده از درخت ناپدید شود، متوقف می‌شود\&. .RE .PP \fB\-\-merges\fR .RS 4 تنها کامیت‌های ادغام را چاپ می‌کند\&. این دقیقاً معادل \fB\-\-min\-parents=2\fR است\&. .RE .PP \fB\-\-no\-merges\fR .RS 4 کامیت‌هایی با بیش از یک والد را چاپ نمی‌کند\&. این دقیقاً معادل \fB\-\-max\-parents=1\fR است\&. .RE .PP \fB\-\-min\-parents=\fR\fI\fR, \fB\-\-max\-parents=\fR\fI\fR, \fB\-\-no\-min\-parents\fR, \fB\-\-no\-max\-parents\fR .RS 4 تنها کامیت‌هایی را نشان می‌دهد که دست‌کم (یا حداکثر) دارای آن تعداد کامیت والد باشند\&. به‌ویژه، \fB\-\-max\-parents=1\fR مشابه \fB\-\-no\-merges\fR, \fB\-\-min\-parents=2\fR مشابه \fB\-\-merges\fR است\&. \fB\-\-max\-parents=0\fR تمام کامیت‌های ریشه و \fB\-\-min\-parents=3\fR تمام ادغام‌های اختاپوسی را نشان می‌دهد\&. .sp گزینه‌های \fB\-\-no\-min\-parents\fR و \fB\-\-no\-max\-parents\fR این محدودیت‌ها را دوباره (به حالت بدون محدودیت) بازنشانی می‌کنند\&. شکل‌های معادل عبارتند از \fB\-\-min\-parents=0\fR (هر کامیتی دارای ۰ یا چند والد است) و \fB\-\-max\-parents=\-1\fR (اعداد منفی نشان‌دهنده نبود حد بالاست)\&. .RE .PP \fB\-\-first\-parent\fR .RS 4 هنگام یافتن کامیت‌ها برای گنجاندن در خروجی، به محض مواجهه با یک کامیت ادغام، تنها کامیت والد نخست را دنبال می‌کند\&. این گزینه می‌تواند دید کلی بهتری در هنگام مشاهده سیر تکامل یک شاخه موضوعی خاص فراهم سازد، زیرا ادغام‌ها در یک شاخه موضوعی معمولاً تنها برای هماهنگ شدن دوره‌ای با بالادست به‌روزشده هستند و این گزینه به شما امکان می‌دهد کامیت‌های جداگانه‌ای را که توسط چنین ادغامی وارد تاریخچه شده‌اند نادیده بگیرید\&. .RE .PP \fB\-\-exclude\-first\-parent\-only\fR .RS 4 هنگام یافتن کامیت‌ها برای استثنا کردن (با یک \fI^\fR), به محض دیدن یک کامیت ادغام، تنها نخستین کامیت والد را دنبال می‌کند\&. این گزینه را می‌توان برای یافتن مجموعه تغییرات در یک شاخه موضوعی از نقطه‌ای که از شاخه دوردست منشعب شده است استفاده کرد، با توجه به این واقعیت که ادغام‌های دلخواه می‌توانند تغییرات معتبری برای شاخه موضوعی باشند\&. .RE .PP \fB\-\-maximal\-only\fR .RS 4 کامیت‌های خروجی را به مواردی محدود می‌کند که از هیچ کامیت دیگری در محدوده بازنگری قابل دسترسی نباشند\&. .RE .PP \fB\-\-not\fR .RS 4 معنای پیشوند \fI^\fR (یا عدم وجود آن) را برای تمام مشخص‌کننده‌های بازنگری بعدی تا گزینه بعدی \fB\-\-not\fR معکوس می‌کند\&. هنگامی که در خط فرمان قبل از \-\-stdin استفاده شود، بازنگری‌های دریافت‌شده از stdin تحت تأثیر آن قرار نخواهند گرفت\&. برعکس، هنگامی که از طریق ورودی استاندارد ارسال شود، بازنگری‌های ارسال‌شده در خط فرمان تحت تأثیر آن قرار نخواهند گرفت\&. .RE .PP \fB\-\-all\fR .RS 4 به‌گونه‌ای عمل می‌کند که گویی تمام ارجاع‌های موجود در \fBrefs/\fR, به همراه \fBHEAD\fR, در خط فرمان به‌عنوان \fI\fR فهرست شده‌اند\&. .RE .PP \fB\-\-branches\fR[\fB=\fR\fI\fR] .RS 4 به‌گونه‌ای عمل می‌کند که گویی تمام ارجاع‌های موجود در \fBrefs/heads\fR در خط فرمان به‌عنوان \fI\fR فهرست شده‌اند\&. اگر \fI\fR داده شود، شاخه‌ها را به موارد منطبق با الگوی پوسته داده‌شده محدود می‌کند\&. اگر \fI\fR فاقد \fI?\fR, \fI*\fR, یا \fI[\fR باشد، وجود \fI/*\fR در انتهای آن به صورت ضمنی فرض می‌شود\&. .RE .PP \fB\-\-tags\fR[\fB=\fR\fI\fR] .RS 4 به‌گونه‌ای عمل می‌کند که گویی تمام ارجاع‌های موجود در \fBrefs/tags\fR در خط فرمان به‌عنوان \fI\fR فهرست شده‌اند\&. اگر \fI\fR داده شود، برچسب‌ها را به موارد منطبق با الگوی پوسته داده‌شده محدود می‌کند\&. اگر الگو فاقد \fI?\fR, \fI*\fR, یا \fI[\fR باشد، وجود \fI/*\fR در انتهای آن به صورت ضمنی فرض می‌شود\&. .RE .PP \fB\-\-remotes\fR[\fB=\fR\fI\fR] .RS 4 به‌گونه‌ای عمل می‌کند که گویی تمام ارجاع‌های موجود در \fBrefs/remotes\fR در خط فرمان به‌عنوان \fI\fR فهرست شده‌اند\&. اگر \fI\fR داده شود، شاخه‌های ردگیری دوردست را به موارد منطبق با الگوی پوسته داده‌شده محدود می‌کند\&. اگر الگو فاقد \fI?\fR, \fI*\fR, یا \fI[\fR باشد، وجود \fI/*\fR در انتهای آن به صورت ضمنی فرض می‌شود\&. .RE .PP \fB\-\-glob=\fR\fI\fR .RS 4 به‌گونه‌ای عمل می‌کند که گویی تمام ارجاع‌های منطبق با الگوی پوسته \fI\fR در خط فرمان به‌عنوان \fI\fR فهرست شده‌اند\&. پیشوند \fIrefs/\fR در صورت عدم وجود، به‌طور خودکار در ابتدا اضافه می‌شود\&. اگر الگو فاقد \fI?\fR, \fI*\fR, یا \fI[\fR باشد، وجود \fI/*\fR در انتهای آن به صورت ضمنی فرض می‌شود\&. .RE .PP \fB\-\-exclude=\fR\fI\fR .RS 4 ارجاع‌های منطبق با \fI\fR را که گزینه‌های بعدی \fB\-\-all\fR, \fB\-\-branches\fR, \fB\-\-tags\fR, \fB\-\-remotes\fR, یا \fB\-\-glob\fR در نظر می‌گیرند، شامل نمی‌کند\&. تکرار این گزینه الگوهای استثنا را تا گزینه بعدی \fB\-\-all\fR, \fB\-\-branches\fR, \fB\-\-tags\fR, \fB\-\-remotes\fR, یا \fB\-\-glob\fR جمع‌آوری می‌کند (سایر گزینه‌ها یا آرگومان‌ها الگوهای جمع‌آوری‌شده را پاک نمی‌کنند)\&. .sp الگوهای داده‌شده هنگام اعمال روی \fB\-\-branches\fR, \fB\-\-tags\fR, یا \fB\-\-remotes\fR نباید با \fBrefs/heads\fR, \fBrefs/tags\fR, یا \fBrefs/remotes\fR آغاز شوند، و هنگام اعمال روی \fB\-\-glob\fR یا \fB\-\-all\fR باید حتماً با \fBrefs/\fR شروع شوند\&. اگر یک \fI/*\fR پایانی مد نظر باشد، باید صریحاً قید شود\&. .RE .PP \fB\-\-exclude\-hidden=\fR(\fBfetch\fR|\fBreceive\fR|\fBuploadpack\fR) .RS 4 ارجاع‌هایی را که توسط \fBgit\-fetch\fR, \fBgit\-receive\-pack\fR یا \fBgit\-upload\-pack\fR با مراجعه به پیکربندی مناسب \fBfetch\&.hideRefs\fR, \fBreceive\&.hideRefs\fR یا \fBuploadpack\&.hideRefs\fR به همراه \fBtransfer\&.hideRefs\fR پنهان می‌شوند، شامل نمی‌کند (به \fBgit-config\fR(1) مراجعه کنید)\&. این گزینه بر گزینه شبه‌ارجاع بعدی \fB\-\-all\fR یا \fB\-\-glob\fR تأثیر می‌گذارد و پس از پردازش آن‌ها پاک می‌شود\&. .RE .PP \fB\-\-reflog\fR .RS 4 به‌گونه‌ای عمل می‌کند که گویی تمام اشیای ذکرشده در رِف‌لاگ‌ها در خط فرمان به‌عنوان \fI\fR فهرست شده‌اند\&. .RE .PP \fB\-\-alternate\-refs\fR .RS 4 به‌گونه‌ای عمل می‌کند که گویی تمام اشیای ذکرشده به‌عنوان نوک ارجاع مخازن جایگزین در خط فرمان فهرست شده‌اند\&. یک مخزن جایگزین هر مخزنی است که پوشه اشیای آن در \fBobjects/info/alternates\fR مشخص شده باشد\&. مجموعه اشیای ارائه‌شده ممکن است توسط \fBcore\&.alternateRefsCommand\fR و غیره اصلاح شود\&. به \fBgit-config\fR(1) مراجعه کنید\&. .RE .PP \fB\-\-single\-worktree\fR .RS 4 به‌طور پیش‌فرض، در صورت وجود بیش از یک درخت کاری، تمام درخت‌های کاری توسط گزینه‌های زیر بررسی می‌شوند (به \fBgit-worktree\fR(1) مراجعه کنید): \fB\-\-all\fR, \fB\-\-reflog\fR و \fB\-\-indexed\-objects\fR\&. این گزینه آن‌ها را وادار می‌کند تا تنها درخت کاری فعلی را بررسی نمایند\&. .RE .PP \fB\-\-ignore\-missing\fR .RS 4 هنگام مشاهده نام شیء نامعتبر در ورودی، به‌گونه‌ای عمل می‌کند که گویی ورودی نامعتبر داده نشده است\&. .RE .PP \fB\-\-bisect\fR .RS 4 به‌گونه‌ای عمل می‌کند که گویی ارجاع تنصیف بد \fBrefs/bisect/bad\fR در خط فرمان فهرست شده و پس از آن \fB\-\-not\fR و ارجاع‌های تنصیف خوب \fBrefs/bisect/good\-*\fR روی خط فرمان آمده است\&. .RE .PP \fB\-\-stdin\fR .RS 4 علاوه بر دریافت آرگومان‌ها از خط فرمان، آن‌ها را از ورودی استاندارد نیز می‌خواند\&. این گزینه کامیت‌ها و شبه‌گزینه‌هایی مانند \fB\-\-all\fR و \fB\-\-glob=\fR را می‌پذیرد\&. هنگامی که یک جداکننده \fB\-\-\fR مشاهده شود، ورودی بعدی به‌عنوان مسیر در نظر گرفته شده و برای محدود کردن نتیجه استفاده می‌شود\&. گزینه‌هایی مانند \fB\-\-not\fR که از طریق ورودی استاندارد خوانده می‌شوند، تنها برای آرگومان‌هایی که به همان روش ارسال شده‌اند رعایت می‌شوند و بر هیچ‌یک از آرگومان‌های خط فرمان بعدی تأثیر نخواهند گذاشت\&. .RE .PP \fB\-\-cherry\-mark\fR .RS 4 مشابه \fB\-\-cherry\-pick\fR (در ادامه ببینید) عمل می‌کند اما کامیت‌های معادل را به‌جای حذف کردن، با علامت \fB=\fR و موارد غیرمعادل را با علامت \fB+\fR نشانه‌گذاری می‌نماید\&. .RE .PP \fB\-\-cherry\-pick\fR .RS 4 هر کامیتی را که تغییری مشابه کامیت دیگری در «طرف دیگر» ایجاد می‌کند، هنگامی که مجموعه کامیت‌ها با تفاضل متقارن محدود شده باشند، حذف می‌نماید\&. .sp برای نمونه، اگر دو شاخه \fBA\fR و \fBB\fR داشته باشید، روش معمول برای فهرست کردن تمام کامیت‌های موجود در یک طرف آن‌ها استفاده از \fB\-\-left\-right\fR است (مثال زیر در توضیحات گزینه \fB\-\-left\-right\fR را ببینید)\&. با این حال، کامیت‌هایی را که از شاخه دیگر دست‌چین (cherry-pick) شده‌اند نشان می‌دهد (برای مثال «سومین در b» ممکن است از شاخه A دست‌چین شده باشد)\&. با این گزینه، چنین جفت کامیت‌هایی از خروجی مستثنی می‌شوند\&. .RE .PP \fB\-\-left\-only\fR, \fB\-\-right\-only\fR .RS 4 تنها کامیت‌های سمت مربوطه یک تفاضل متقارن را فهرست می‌کند، یعنی تنها مواردی که با < یا > توسط \fB\-\-left\-right\fR علامت‌گذاری می‌شوند\&. .sp برای نمونه، \fB\-\-cherry\-pick\fR \fB\-\-right\-only\fR \fBA\fR\fB\.\.\.\fR\fBB\fR آن دسته از کامیت‌های موجود در \fBB\fR را که در \fBA\fR هستند یا معادل وصله‌ای با یک کامیت در \fBA\fR می‌باشند حذف می‌کند\&. به عبارت دیگر، این دستور کامیت‌های \fB+\fR را از \fBgit\fR \fBcherry\fR \fBA\fR \fBB\fR فهرست می‌کند\&. به‌طور دقیق‌تر، \fB\-\-cherry\-pick\fR \fB\-\-right\-only\fR \fB\-\-no\-merges\fR فهرست دقیق را ارائه می‌دهد\&. .RE .PP \fB\-\-cherry\fR .RS 4 مترادفی برای \fB\-\-right\-only\fR \fB\-\-cherry\-mark\fR \fB\-\-no\-merges\fR; سودمند برای محدود کردن خروجی به کامیت‌های سمت خودمان و نشانه‌گذاری مواردی که به سمت دیگر یک تاریخچه شاخه‌بندی‌شده اعمال شده‌اند با دستور \fBgit\fR \fBlog\fR \fB\-\-cherry\fR \fBupstream\fR\fB\.\.\.\fR\fBmybranch\fR, مشابه با \fBgit\fR \fBcherry\fR \fBupstream\fR \fBmybranch\fR\&. .RE .PP \fB\-g\fR, \fB\-\-walk\-reflogs\fR .RS 4 به‌جای پیمایش زنجیره نیاکان کامیت، مدخل‌های رِف‌لاگ را از جدیدترین به سمت قدیمی‌ترها پیمایش می‌کند\&. هنگامی که از این گزینه استفاده می‌شود نمی‌توانید کامیت‌هایی را برای استثنا کردن مشخص کنید (یعنی نمادگذاری‌های \fB^\fR\fI\fR, \fI\fR\fB\.\.\fR\fI\fR, و \fI\fR\fB\.\.\.\fR\fI\fR قابل استفاده نیستند)\&. .sp با قالبی از \fB\-\-pretty\fR به‌جز \fBoneline\fR و \fBreference\fR (به دلایل واضح)، این گزینه باعث می‌شود خروجی دارای دو خط اطلاعات اضافی برگرفته از رِف‌لاگ باشد\&. نشان‌دهنده رِف‌لاگ در خروجی ممکن است به‌صورت \fBref@\fR{\fI\fR} (که در آن \fI\fR اندیس معکوس زمانی در رِف‌لاگ است) یا به‌صورت \fBref@\fR{\fI\fR} (همراه با \fI\fR آن مدخل) بسته به چند قانون نمایش داده شود: .sp .RS 4 .ie n \{\ \h'-04' 1.\h'+01'\c .\} .el \{\ .sp -1 .IP " 1." 4.2 .\} اگر نقطه شروع به‌صورت \fBref@\fR{\fI\fR} مشخص شده باشد، قالب اندیس نمایش داده می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 2.\h'+01'\c .\} .el \{\ .sp -1 .IP " 2." 4.2 .\} اگر نقطه شروع به‌صورت \fBref@\fR{now} مشخص شده باشد، قالب برچسب زمان نمایش داده می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 3.\h'+01'\c .\} .el \{\ .sp -1 .IP " 3." 4.2 .\} اگر از هیچ‌کدام استفاده نشده باشد، اما \fB\-\-date\fR در خط فرمان داده شده باشد، برچسب زمان در قالب خواسته‌شده توسط \fB\-\-date\fR نمایش داده می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 4.\h'+01'\c .\} .el \{\ .sp -1 .IP " 4." 4.2 .\} در غیر این صورت، قالب اندیس نمایش داده می‌شود\&. .RE .sp تحت \fB\-\-pretty=oneline\fR, پیام کامیت با این اطلاعات در همان خط پیشوند می‌گیرد\&. این گزینه با \fB\-\-reverse\fR قابل ترکیب نیست\&. همچنین به \fBgit-reflog\fR(1) مراجعه کنید\&. .sp تحت \fB\-\-pretty=reference\fR, این اطلاعات اصلاً نمایش داده نخواهند شد\&. .RE .PP \fB\-\-merge\fR .RS 4 کامیت‌هایی را که مسیرهای دارای تعارض را در محدوده \fBHEAD\fR\fB\.\.\.\fR\fI\fR تغییر داده‌اند نمایش می‌دهد، که در آن \fI\fR نخستین شبه‌ارجاع موجود در \fBMERGE_HEAD\fR, \fBCHERRY_PICK_HEAD\fR, \fBREVERT_HEAD\fR یا \fBREBASE_HEAD\fR است\&. تنها زمانی کار می‌کند که ایندکس دارای مدخل‌های ادغام‌نشده باشد\&. این گزینه را می‌توان برای نمایش کامیت‌های مرتبط هنگام حل تعارض‌های ناشی از یک ادغام ۳-طرفه استفاده کرد\&. .RE .PP \fB\-\-boundary\fR .RS 4 کامیت‌های مرزی مستثنی‌شده را در خروجی می‌آورد\&. کامیت‌های مرزی با پیشوند \fB\-\fR مشخص می‌شوند\&. .RE .SS "ساده‌سازی تاریخچه (History Simplification)" .sp گاهی اوقات شما تنها به بخش‌هایی از تاریخچه علاقه‌مندید، برای نمونه کامیت‌هایی که یک خاص را تغییر می‌دهند\&. اما \fIساده‌سازی تاریخچه\fR دو بخش دارد: یک بخش انتخاب کامیت‌ها است و بخش دیگر چگونگی انجام آن، چرا که راهبردهای گوناگونی برای ساده‌سازی تاریخچه وجود دارد\&. .sp گزینه‌های زیر کامیت‌های نمایش‌داده‌شده را انتخاب می‌کنند: .PP \fI\fR .RS 4 کامیت‌هایی که مشخص‌شده را تغییر می‌دهند انتخاب می‌شوند\&. .RE .PP \fB\-\-simplify\-by\-decoration\fR .RS 4 کامیت‌هایی که توسط یک شاخه یا برچسب ارجاع داده شده‌اند انتخاب می‌شوند\&. .RE .sp توجه داشته باشید که ممکن است کامیت‌های اضافی نیز برای ارائه یک تاریخچه معنادار نمایش داده شوند\&. .sp گزینه‌های زیر بر نحوه انجام ساده‌سازی تأثیر می‌گذارند: .PP \fBحالت\fR \fBپیش‌فرض (Default mode)\fR .RS 4 تاریخچه را به ساده‌ترین تاریخچه‌ای که وضعیت نهایی درخت را توضیح می‌دهد ساده می‌کند\&. ساده‌ترین است زیرا برخی از شاخه‌های فرعی را در صورتی که نتیجه نهایی یکسان باشد (یعنی ادغام شاخه‌هایی با محتوای یکسان) هرس می‌کند\&. .RE .PP \fB\-\-show\-pulls\fR .RS 4 تمام کامیت‌های حالت پیش‌فرض را شامل می‌شود، به اضافه هر کامیت ادغامی که نسبت به والد نخست TREESAME نباشد ولی نسبت به والد بعدی TREESAME باشد\&. این حالت برای نمایش کامیت‌های ادغامی که «نخستین بار تغییری را وارد یک شاخه کردند» سودمند است\&. .RE .PP \fB\-\-full\-history\fR .RS 4 مشابه حالت پیش‌فرض است، اما بخشی از تاریخچه را هرس نمی‌کند\&. .RE .PP \fB\-\-dense\fR .RS 4 تنها کامیت‌های انتخاب‌شده به علاوه مواردی برای داشتن تاریخچه معنادار نمایش داده می‌شوند\&. .RE .PP \fB\-\-sparse\fR .RS 4 تمام کامیت‌ها در تاریخچه ساده‌سازی‌شده نمایش داده می‌شوند\&. .RE .PP \fB\-\-simplify\-merges\fR .RS 4 گزینه‌ای اضافی برای \fB\-\-full\-history\fR جهت حذف برخی از ادغام‌های غیرضروری از تاریخچه حاصل، چرا که هیچ کامیت انتخاب‌شده‌ای در این ادغام نقشی نداشته است\&. .RE .PP \fB\-\-ancestry\-path\fR[\fB=\fR\fI\fR] .RS 4 هنگامی که محدوده‌ای از کامیت‌ها برای نمایش داده می‌شود (مانند \fI\fR\fB\&.\&.\fR\fI\fR یا \fI\fR \fB^\fR\fI\fR), و یک کامیت \fI\fR در آن محدوده مشخص گردد، تنها کامیت‌هایی از آن محدوده را نمایش می‌دهد که نیاکان \fI\fR, نوادگان \fI\fR, یا خود \fI\fR باشند\&. اگر هیچ کامیتی مشخص نشود، از \fI\fR (بخش مستثنی‌شده محدوده) به‌عنوان \fI\fR استفاده می‌کند\&. می‌توان آن را چندین بار ارسال کرد؛ در این صورت، یک کامیت در صورتی گنجانده می‌شود که هر یک از کامیت‌های ارائه‌شده باشد یا نیا یا نواده یکی از آن‌ها باشد\&. .RE .sp توضیحات دقیق‌تر در ادامه می‌آید\&. .sp فرض کنید شما \fBfoo\fR را به‌عنوان \fI\fR مشخص کرده‌اید\&. ما کامیت‌هایی را که \fBfoo\fR را تغییر می‌دهند !TREESAME (نایکسان از نظر درخت) و بقیه را TREESAME (یکسان از نظر درخت) می‌نامیم\&. (در یک diff فیلترشده برای \fBfoo\fR، آن‌ها به ترتیب متفاوت و برابر به نظر می‌رسند\&.) .sp در ادامه، ما همواره به همین تاریخچه نمونه برای نشان دادن تفاوت‌های بین تنظیمات ساده‌سازی ارجاع خواهیم داد\&. فرض می‌کنیم شما در حال فیلتر کردن برای فایل \fBfoo\fR در این گراف کامیت هستید: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-M\-\-\-N\-\-\-O\-\-\-P\-\-\-Q / / / / / / I B C D E Y \e / / / / / `\-\-\-\-\-\-\-\-\-\-\-\-\-\*(Aq X .fi .if n \{\ .RE .\} .sp .sp خط افقی تاریخچه A\-\-\-Q به‌عنوان والد نخست هر ادغام در نظر گرفته می‌شود\&. کامیت‌ها عبارتند از: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBI\fR کامیت اولیه است که در آن \fBfoo\fR با محتوای \fBasdf\fR و فایلی به نام \fBquux\fR با محتوای \fBquux\fR وجود دارد\&. کامیت‌های اولیه با یک درخت خالی مقایسه می‌شوند، بنابراین \fBI\fR مقدار !TREESAME دارد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} در \fBA\fR, فایل \fBfoo\fR تنها حاوی \fBfoo\fR است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBB\fR شامل همان تغییر \fBA\fR است\&. ادغام آن \fBM\fR بدیهی (trivial) است و بنابراین نسبت به تمام والدین TREESAME است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBC\fR تغییری در \fBfoo\fR ایجاد نمی‌کند، اما ادغام آن \fBN\fR آن را به \fBfoobar\fR تغییر می‌دهد، بنابراین نسبت به هیچ والدی TREESAME نیست\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBD\fR مقدار \fBfoo\fR را روی \fBbaz\fR تنظیم می‌کند\&. ادغام آن \fBO\fR رشته‌های برگرفته از \fBN\fR و \fBD\fR را به \fBfoobarbaz\fR ترکیب می‌کند؛ یعنی نسبت به هیچ والدی TREESAME نیست\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBE\fR مقدار \fBquux\fR را به \fBxyzzy\fR تغییر می‌دهد، و ادغام آن \fBP\fR رشته‌ها را به \fBquux\fR \fBxyzzy\fR ترکیب می‌نماید\&. \fBP\fR نسبت به \fBO\fR دارای وضعیت TREESAME است، اما نسبت به \fBE\fR نیست\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBX\fR یک کامیت ریشه مستقل است که فایل جدید \fBside\fR را اضافه کرده، و \fBY\fR آن را اصلاح نموده است\&. \fBY\fR نسبت به \fBX\fR وضعیت TREESAME دارد\&. ادغام آن \fBQ\fR فایل \fBside\fR را به \fBP\fR اضافه کرده است، و \fBQ\fR نسبت به \fBP\fR دارای وضعیت TREESAME است، اما نسبت به \fBY\fR نیست\&. .RE .sp دستور \fBrev\-list\fR در تاریخچه به سمت عقب پیمایش می‌کند، و بر اساس اینکه آیا \fB\-\-full\-history\fR و/یا بازنویسی والدین (از طریق \fB\-\-parents\fR یا \fB\-\-children\fR) استفاده شده باشد، کامیت‌ها را شامل یا مستثنی می‌سازد\&. تنظیمات زیر در دسترس هستند\&. .PP حالت پیش‌فرض (Default mode) .RS 4 کامیت‌ها در صورتی که نسبت به هیچ والدی TREESAME نباشند گنجانده می‌شوند (اگرچه این قابل تغییر است، \fB\-\-sparse\fR را در ادامه ببینید)\&. اگر کامیت یک ادغام باشد و نسبت به یک والد TREESAME باشد، تنها همان والد را دنبال می‌کند\&. (حتی اگر چندین والد TREESAME وجود داشته باشد، فقط یکی از آن‌ها دنبال می‌شود\&.) در غیر این صورت، تمام والدین دنبال می‌شوند\&. .sp این منجر به نتیجه زیر می‌شود: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-N\-\-\-O / / / I\-\-\-\-\-\-\-\-\-D .fi .if n \{\ .RE .\} .sp توجه کنید چگونه قاعده دنبال کردن تنها والد TREESAME (در صورت وجود)، \fBB\fR را کاملاً از بررسی حذف کرد\&. \fBC\fR از طریق \fBN\fR بررسی شد، اما وضعیت TREESAME داشت\&. کامیت‌های ریشه با یک درخت خالی مقایسه می‌شوند، بنابراین \fBI\fR دارای وضعیت !TREESAME است\&. .sp روابط والد/فرزند تنها با \fB\-\-parents\fR قابل مشاهده هستند، اما این موضوع بر کامیت‌های انتخاب‌شده در حالت پیش‌فرض تأثیری ندارد، بنابراین ما خطوط والدین را نمایش داده‌ایم\&. .RE .PP \fB\-\-full\-history\fR بدون بازنویسی والدین .RS 4 این حالت با حالت پیش‌فرض در یک نکته تفاوت دارد: همیشه تمام والدین یک ادغام را دنبال می‌کند، حتی اگر نسبت به یکی از آن‌ها TREESAME باشد\&. حتی اگر بیش از یک سمت ادغام دارای کامیت‌های گنجانده‌شده باشد، این بدان معنا نیست که خود ادغام نیز شامل شده است! در مثال، به این نتیجه می‌رسیم: .sp .if n \{\ .RS 4 .\} .nf I A B N D O P Q .fi .if n \{\ .RE .\} .sp \fBM\fR حذف شد زیرا نسبت به هر دو والد وضعیت TREESAME داشت\&. \fBE\fR, \fBC\fR و \fBB\fR همگی پیمایش شدند، اما تنها \fBB\fR دارای وضعیت !TREESAME بود، بنابراین بقیه ظاهر نمی‌شوند\&. .sp توجه داشته باشید که بدون بازنویسی والدین، عملاً امکان صحبت در مورد روابط والد/فرزند میان کامیت‌ها وجود ندارد، از این رو آن‌ها را به صورت گسسته نشان می‌دهیم\&. .RE .PP \fB\-\-full\-history\fR با بازنویسی والدین .RS 4 کامیت‌های عادی تنها در صورتی گنجانده می‌شوند که وضعیت !TREESAME داشته باشند (اگرچه این قابل تغییر است، \fB\-\-sparse\fR را در ادامه ببینید)\&. .sp ادغام‌ها همیشه گنجانده می‌شوند\&. با این حال، فهرست والدین آن‌ها بازنویسی می‌شود: در امتداد هر والد، کامیت‌هایی را که خودشان گنجانده نشده‌اند هرس می‌کند\&. این به نتیجه زیر می‌انجامد: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-M\-\-\-N\-\-\-O\-\-\-P\-\-\-Q / / / / / I B / D / \e / / / / `\-\-\-\-\-\-\-\-\-\-\-\-\-\*(Aq .fi .if n \{\ .RE .\} .sp با \fB\-\-full\-history\fR بدون بازنویسی در بالا مقایسه کنید\&. توجه داشته باشید که \fBE\fR هرس شد زیرا TREESAME بود، اما فهرست والدین P بازنویسی شد تا شامل والد \fBE\fR یعنی \fBI\fR باشد\&. همین اتفاق برای \fBC\fR و \fBN\fR, و برای \fBX\fR, \fBY\fR و \fBQ\fR نیز رخ داد\&. .RE .sp علاوه بر تنظیمات فوق، می‌توانید تغییر دهید که آیا وضعیت TREESAME بر گنجاندن تأثیر بگذارد یا خیر: .PP \fB\-\-dense\fR .RS 4 کامیت‌های پیمایش‌شده در صورتی گنجانده می‌شوند که نسبت به هیچ والدی TREESAME نباشند\&. .RE .PP \fB\-\-sparse\fR .RS 4 تمام کامیت‌هایی که پیمایش می‌شوند گنجانده خواهند شد\&. .sp توجه داشته باشید که بدون \fB\-\-full\-history\fR, این گزینه همچنان ادغام‌ها را ساده‌سازی می‌کند: اگر یکی از والدین TREESAME باشد، ما تنها همان یکی را دنبال می‌کنیم، بنابراین سمت‌های دیگر ادغام هرگز پیمایش نمی‌شوند\&. .RE .PP \fB\-\-simplify\-merges\fR .RS 4 نخست، یک گراف تاریخچه را به همان روشی که \fB\-\-full\-history\fR با بازنویسی والدین انجام می‌دهد می‌سازد (بالا را ببینید)\&. .sp سپس هر کامیت \fBC\fR را به جایگزین آن \fBC\fR\*(Aq در تاریخچه نهایی بر اساس قوانین زیر ساده می‌کند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مقدار \fBC\fR\*(Aq را روی \fBC\fR تنظیم کنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} هر والد \fBP\fR از \fBC\fR\*(Aq را با نسخه ساده‌شده‌اش \fBP\fR\*(Aq جایگزین کنید\&. در این فرایند، والدینی را که نیاکان سایر والدین هستند یا کامیت‌های ریشه‌ای هستند که نسبت به یک درخت خالی وضعیت TREESAME دارند حذف کرده و موارد تکراری را بزدایید، اما دقت کنید که هرگز تمام والدینی را که نسبت به آن‌ها TREESAME هستیم حذف نکنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} اگر پس از این بازنویسی والدین، \fBC\fR\*(Aq یک کامیت ریشه یا ادغام باشد (دارای ۰ یا بیش از ۱ والد باشد)، یک کامیت مرزی باشد، یا !TREESAME باشد، باقی می‌ماند\&. در غیر این صورت، با تنها والد خود جایگزین می‌شود\&. .RE .sp تأثیر این کار به بهترین شکل با مقایسه آن با \fB\-\-full\-history\fR همراه با بازنویسی والدین نشان داده می‌شود\&. مثال به صورت زیر درمی‌آید: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-M\-\-\-N\-\-\-O / / / I B D \e / / `\-\-\-\-\-\-\-\-\-\*(Aq .fi .if n \{\ .RE .\} .sp تفاوت‌های عمده در \fBN\fR, \fBP\fR, و \fBQ\fR را نسبت به \fB\-\-full\-history\fR ملاحظه فرمایید: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} از فهرست والدین \fBN\fR\*(Aqs کامیت \fBI\fR حذف شد، زیرا نیاکان والد دیگر یعنی \fBM\fR است\&. با این وجود، \fBN\fR باقی ماند زیرا وضعیت !TREESAME دارد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} از فهرست والدین \fBP\fR\*(Aqs نیز مشابهاً \fBI\fR حذف گردید\&. سپس \fBP\fR به‌طور کامل حذف شد، زیرا یک والد داشت و وضعیت TREESAME داشت\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} فهرست والدین \fBQ\fR\*(Aqs کامیت \fBY\fR را به \fBX\fR ساده کرد\&. سپس \fBX\fR حذف شد، چرا که یک ریشه با وضعیت TREESAME بود\&. \fBQ\fR سپس به‌طور کامل حذف شد، زیرا یک والد داشت و وضعیت TREESAME داشت\&. .RE .RE .sp حالت ساده‌سازی دیگری نیز در دسترس است: .PP \fB\-\-ancestry\-path\fR[\fB=\fR\fI\fR] .RS 4 کامیت‌های نمایش‌داده‌شده را به مواردی محدود می‌کند که نیاکان \fI\fR, نوادگان \fI\fR, یا خود \fI\fR باشند\&. .sp به‌عنوان یک نمونه کاربرد، تاریخچه کامیت زیر را در نظر بگیرید: .sp .if n \{\ .RS 4 .\} .nf D\-\-\-E\-\-\-\-\-\-\-F / \e \e B\-\-\-C\-\-\-G\-\-\-H\-\-\-I\-\-\-J / \e A\-\-\-\-\-\-\-K\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-L\-\-M .fi .if n \{\ .RE .\} .sp یک عبارت معمولی \fID\&.\&.M\fR مجموعه کامیت‌هایی را محاسبه می‌کند که نیاکان \fBM\fR هستند، اما مواردی را که نیاکان \fBD\fR می‌باشند مستثنی می‌سازد\&. این برای مشاهده آنچه برای تاریخچه منتهی به \fBM\fR از زمان \fBD\fR رخ داده مفید است، به این معنی که « \fBM\fR چه چیزی دارد که در \fBD\fR وجود نداشت»\&. نتیجه در این مثال تمام کامیت‌ها خواهد بود، به جز \fBA\fR و \fBB\fR (و البته خود \fBD\fR)\&. .sp اما هنگامی که بخواهیم بدانیم چه کامیت‌هایی در \fBM\fR به باگ معرفی‌شده توسط \fBD\fR آلوده شده‌اند و نیاز به رفع دارند، ممکن است بخواهیم تنها زیرمجموعه‌ای از \fBD\fR\fB\&.\&.\fR\fBM\fR را مشاهده کنیم که واقعاً از نوادگان \fBD\fR هستند، یعنی مستثنی کردن \fBC\fR و \fBK\fR\&. این دقیقاً همان کاری است که گزینه \fB\-\-ancestry\-path\fR انجام می‌دهد\&. اعمال آن روی محدوده \fBD\fR\fB\&.\&.\fR\fBM\fR به نتیجه زیر می‌انجامد: .sp .if n \{\ .RS 4 .\} .nf E\-\-\-\-\-\-\-F \e \e G\-\-\-H\-\-\-I\-\-\-J \e L\-\-M .fi .if n \{\ .RE .\} .sp ما همچنین می‌توانیم از \fB\-\-ancestry\-path=D\fR به‌جای \fB\-\-ancestry\-path\fR استفاده کنیم که هنگام اعمال روی محدوده \fBD\fR\fB\&.\&.\fR\fBM\fR معنای یکسانی دارد اما صریح‌تر است\&. .sp اگر در عوض به یک موضوع خاص در این محدوده و تمام کامیت‌های متأثر از آن موضوع علاقه‌مند باشیم، ممکن است تنها بخواهیم زیرمجموعه‌ای از \fBD\fR\fB\&.\&.\fR\fBM\fR را مشاهده کنیم که آن موضوع را در مسیر نیاکان خود دارند\&. بنابراین، برای مثال استفاده از \fB\-\-ancestry\-path=H\fR \fBD\fR\fB\&.\&.\fR\fBM\fR به نتیجه زیر می‌انجامد: .sp .if n \{\ .RS 4 .\} .nf E \e C\-\-\-G\-\-\-H\-\-\-I\-\-\-J \e L\-\-M .fi .if n \{\ .RE .\} .sp در حالی که \fB\-\-ancestry\-path=K\fR \fBD\fR\fB\&.\&.\fR\fBM\fR به این نتیجه منجر می‌شود: .sp .if n \{\ .RS 4 .\} .nf K\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-L\-\-M .fi .if n \{\ .RE .\} .sp .RE .sp پیش از بحث درباره گزینه دیگر، یعنی \fB\-\-show\-pulls\fR, لازم است یک تاریخچه نمونه جدید بسازیم\&. .sp یک مشکل رایج که کاربران هنگام مشاهده تاریخچه ساده‌سازی‌شده با آن مواجه می‌شوند این است که کامیتی که می‌دانند فایلی را تغییر داده است به نوعی در تاریخچه ساده‌شده فایل ظاهر نمی‌شود\&. بیایید یک مثال جدید را نشان دهیم و بررسی کنیم که گزینه‌هایی مانند \fB\-\-full\-history\fR و \fB\-\-simplify\-merges\fR در چنین حالتی چگونه کار می‌کنند: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-M\-\-\-\-\-C\-\-N\-\-\-O\-\-\-P / / \e \e \e/ / / I B \e R\-\*(Aq`\-Z\*(Aq / \e / \e/ / \e / /\e / `\-\-\-X\-\-\*(Aq `\-\-\-Y\-\-\*(Aq .fi .if n \{\ .RE .\} .sp .sp برای این مثال، فرض کنید \fBI\fR فایل \fBfile\&.txt\fR را ایجاد کرد که توسط \fBA\fR, \fBB\fR, و \fBX\fR به روش‌های متفاوتی اصلاح شد\&. کامیت‌های تک‌والدی \fBC\fR, \fBZ\fR, و \fBY\fR تغییری در \fBfile\&.txt\fR ایجاد نمی‌کنند\&. کامیت ادغام \fBM\fR با حل تعارض ادغام برای گنجاندن هر دو تغییر از \fBA\fR و \fBB\fR ایجاد شد و بنابراین نسبت به هیچ‌کدام TREESAME نیست\&. اما کامیت ادغام \fBR\fR با نادیده گرفتن محتویات \fBfile\&.txt\fR در \fBM\fR و گرفتن تنها محتویات \fBfile\&.txt\fR در \fBX\fR ایجاد گردید\&. از این رو، \fBR\fR نسبت به \fBX\fR دارای وضعیت TREESAME است اما نسبت به \fBM\fR نیست\&. در نهایت، تفکیک طبیعی ادغام برای ایجاد \fBN\fR گرفتن محتویات \fBfile\&.txt\fR در \fBR\fR است، بنابراین \fBN\fR نسبت به \fBR\fR وضعیت TREESAME دارد اما نسبت به \fBC\fR ندارد\&. کامیت‌های ادغام \fBO\fR و \fBP\fR نسبت به والدین اول خود وضعیت TREESAME دارند، اما به ترتیب نسبت به والدین دوم خود یعنی \fBZ\fR و \fBY\fR وضعیت TREESAME ندارند\&. .sp هنگام استفاده از حالت پیش‌فرض، \fBN\fR و \fBR\fR هر دو دارای یک والد TREESAME هستند، بنابراین آن یال‌ها پیمایش شده و بقیه نادیده گرفته می‌شوند\&. گراف تاریخچه حاصل به صورت زیر است: .sp .if n \{\ .RS 4 .\} .nf I\-\-\-X .fi .if n \{\ .RE .\} .sp .sp هنگام استفاده از \fB\-\-full\-history\fR, گیت تمام یال‌ها را پیمایش می‌کند\&. این کار کامیت‌های \fBA\fR و \fBB\fR و ادغام \fBM\fR را آشکار می‌سازد، اما کامیت‌های ادغام \fBO\fR و \fBP\fR را نیز نمایان می‌کند\&. با بازنویسی والدین، گراف حاصل به شکل زیر خواهد بود: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-M\-\-\-\-\-\-\-\-N\-\-\-O\-\-\-P / / \e \e \e/ / / I B \e R\-\*(Aq`\-\-\*(Aq / \e / \e/ / \e / /\e / `\-\-\-X\-\-\*(Aq `\-\-\-\-\-\-\*(Aq .fi .if n \{\ .RE .\} .sp .sp در اینجا، کامیت‌های ادغام \fBO\fR و \fBP\fR نویز اضافی ایجاد می‌کنند، زیرا در واقع تغییری در \fBfile\&.txt\fR ایجاد نکرده‌اند\&. آن‌ها تنها موضوعی را ادغام کرده‌اند که بر پایه نسخه قدیمی‌تری از \fBfile\&.txt\fR بنا شده بود\&. این یک مسئله رایج در مخازنی است که از گردش کاری با مشارکت‌کنندگان موازی زیاد استفاده می‌کنند که شاخه‌های موضوعی خود را در طول یک تنه اصلی ادغام می‌نمایند: ادغام‌های نامرتبط زیادی در نتایج \fB\-\-full\-history\fR ظاهر می‌شوند\&. .sp هنگام استفاده از گزینه \fB\-\-simplify\-merges\fR, کامیت‌های \fBO\fR و \fBP\fR از نتایج ناپدید می‌شوند\&. دلیل آن این است که والدین دوم بازنویسی‌شده \fBO\fR و \fBP\fR از والدین اول آن‌ها قابل دسترسی هستند\&. آن یال‌ها حذف می‌شوند و سپس کامیت‌ها مانند کامیت‌های تک‌والدی به نظر می‌رسند که نسبت به والد خود TREESAME هستند\&. این اتفاق برای کامیت \fBN\fR نیز رخ می‌دهد و نمایی از تاریخچه به صورت زیر ایجاد می‌کند: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-M\-\-\&. / / \e I B R \e / / \e / / `\-\-\-X\-\-\*(Aq .fi .if n \{\ .RE .\} .sp .sp در این نما، ما تمام تغییرات تک‌والدی مهم از \fBA\fR, \fBB\fR, و \fBX\fR را می‌بینیم\&. همچنین ادغام با دقت حل‌شده \fBM\fR و ادغام نه‌چندان با دقت حل‌شده \fBR\fR را مشاهده می‌کنیم\&. این معمولاً اطلاعات کافی برای تعیین اینکه چرا کامیت‌های \fBA\fR و \fBB\fR در نمای پیش‌فرض از تاریخچه «ناپدید شدند» را فراهم می‌سازد\&. با این حال، چند مشکل در این رویکرد وجود دارد\&. .sp مشکل نخست کارایی است\&. برخلاف هر گزینه قبلی، گزینه \fB\-\-simplify\-merges\fR مستلزم پیمایش کل تاریخچه کامیت پیش از بازگرداندن حتی یک نتیجه است\&. این می‌تواند استفاده از این گزینه را برای مخازن بسیار بزرگ دشوار سازد\&. .sp مشکل دوم موضوع حسابرسی (auditing) است\&. هنگامی که مشارکت‌کنندگان زیادی روی یک مخزن کار می‌کنند، مهم است که کدام کامیت‌های ادغام تغییری را وارد یک شاخه مهم کرده‌اند\&. ادغام مشکل‌ساز \fBR\fR در بالا احتمالاً آن کامیت ادغامی نبوده است که برای ادغام در یک شاخه مهم استفاده شده است\&. در عوض، ادغام \fBN\fR برای ادغام \fBR\fR و \fBX\fR در شاخه مهم به کار رفته است\&. این کامیت ممکن است اطلاعاتی درباره اینکه چرا تغییر \fBX\fR جایگزین تغییرات \fBA\fR و \fBB\fR شد در پیام کامیت خود داشته باشد\&. .PP \fB\-\-show\-pulls\fR .RS 4 علاوه بر کامیت‌های نمایش‌داده‌شده در تاریخچه پیش‌فرض، هر کامیت ادغامی را که نسبت به والد نخست خود TREESAME نیست اما نسبت به والد بعدی TREESAME است نمایش می‌دهد\&. .sp هنگامی که یک کامیت ادغام توسط \fB\-\-show\-pulls\fR گنجانده می‌شود، با ادغام به‌گونه‌ای رفتار می‌شود که گویی تغییر را از شاخه دیگری «کشیده» (pull) است\&. هنگام استفاده از \fB\-\-show\-pulls\fR در این مثال (و بدون گزینه‌های دیگر) گراف حاصل عبارت است از: .sp .if n \{\ .RS 4 .\} .nf I\-\-\-X\-\-\-R\-\-\-N .fi .if n \{\ .RE .\} .sp در اینجا، کامیت‌های ادغام \fBR\fR و \fBN\fR گنجانده شده‌اند زیرا آن‌ها به ترتیب کامیت‌های \fBX\fR و \fBR\fR را به شاخه پایه وارد کردند\&. این ادغام‌ها دلیلی هستند که کامیت‌های \fBA\fR و \fBB\fR در تاریخچه پیش‌فرض ظاهر نمی‌شوند\&. .sp هنگامی که \fB\-\-show\-pulls\fR همراه با \fB\-\-simplify\-merges\fR استفاده شود، گراف شامل تمام اطلاعات لازم خواهد بود: .sp .if n \{\ .RS 4 .\} .nf \&.\-A\-\-\-M\-\-\&. N / / \e / I B R \e / / \e / / `\-\-\-X\-\-\*(Aq .fi .if n \{\ .RE .\} .sp توجه داشته باشید از آنجا که \fBM\fR از \fBR\fR قابل دسترسی است، یال از \fBN\fR به \fBM\fR با ساده‌سازی حذف شد\&. با این حال، \fBN\fR همچنان به‌عنوان یک کامیت مهم در تاریخچه ظاهر می‌شود زیرا تغییر \fBR\fR را به شاخه اصلی «کشیده» است\&. .RE .sp گزینه \fB\-\-simplify\-by\-decoration\fR به شما امکان می‌دهد تنها نمای کلی از توپولوژی تاریخچه را با حذف کامیت‌هایی که توسط برچسب‌ها ارجاع داده نشده‌اند مشاهده کنید\&. کامیت‌ها در صورتی به‌عنوان !TREESAME علامت‌گذاری می‌شوند (به عبارت دیگر، پس از قوانین ساده‌سازی تاریخچه توضیح داده‌شده در بالا حفظ می‌شوند) که (۱) توسط برچسب‌ها ارجاع داده شده باشند، یا (۲) محتویات مسیرهای داده‌شده در خط فرمان را تغییر دهند\&. تمام کامیت‌های دیگر به‌عنوان TREESAME علامت‌گذاری می‌شوند (مشمول حذف از طریق ساده‌سازی)\&. .SH "نگاشت نویسندگان (MAPPING AUTHORS)" .sp \fBgitmailmap\fR(5) را ببینید\&. .sp توجه داشته باشید که اگر \fBgit\fR \fBshortlog\fR خارج از یک مخزن اجرا شود (برای پردازش محتوای لاگ در ورودی استاندارد)، به دنبال یک فایل \fB\&.mailmap\fR در دایرکتوری جاری خواهد گشت\&. .SH "گیت (GIT)" .sp بخشی از مجموعه \fBgit\fR(1)