'\" t .\" Title: git-replay .\" 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\-REPLAY" "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-replay \- بازپخش کامیت‌ها بر روی پایه‌ای جدید (آزمایشی و سازگار با مخازن bare) .SH "خلاصه دستور (SYNOPSIS)" .sp .nf (آزمایشی!) \fIgit replay\fR ([\-\-\contained] \-\-\onto= | \-\-\advance= | \-\-\revert=) [\-\-\ref=] [\-\-\ref\-action=] .fi .sp .SH "توضیحات (DESCRIPTION)" .sp محدوده‌ای از کامیت‌ها را گرفته و آن‌ها را در مکانی جدید بازپخش (replay) می‌کند\&. درخت کاری (working tree) و نمایه (index) را دست‌نخورده باقی می‌گذارد\&. به طور پیش‌فرض، مراجع مربوطه را با استفاده از یک تراکنش اتمیک به‌روزرسانی می‌کند (یا همه مراجع به‌روزرسانی می‌شوند یا هیچ‌کدام)\&. برای جلوگیری از به‌روزرسانی خودکار مراجع و در عوض دریافت دستورات به‌روزرسانی که بتوان آن‌ها را به \fBgit\fR \fBupdate\-ref\fR \fB\-\-\stdin\fR لوله‌کشی کرد، از \fB\-\-\ref\-action=print\fR استفاده کنید (بخش خروجی (OUTPUT) در زیر را ببینید)\&. .sp این دستور آزمایشی است\&. رفتار آن ممکن است در آینده تغییر کند\&. .SH "گزینه‌ها (OPTIONS)" .PP \-\-\onto= .RS 4 نقطه شروع برای ایجاد کامیت‌های جدید\&. می‌تواند هر کامیت معتبری باشد و لزوماً نباید نام یک شاخه موجود باشد\&. .sp هنگامی که \fB\-\-\onto\fR مشخص شود، شاخه(های) موجود در محدوده بازنگری به‌روزرسانی می‌شوند تا به کامیت‌های جدید اشاره کنند، مشابه روشی که \fBgit\fR \fBrebase\fR \fB\-\-\update\-refs\fR چندین شاخه را در محدوده تحت تأثیر به‌روزرسانی می‌کند\&. .RE .PP \-\-\advance= .RS 4 نقطه شروع برای ایجاد کامیت‌های جدید؛ باید نام یک شاخه باشد\&. .sp تاریخچه بر روی بازپخش می‌شود و به‌روزرسانی می‌گردد تا به نوک تاریخچه حاصل اشاره کند\&. این با \fB\-\-\onto\fR متفاوت است که تنها از هدف به عنوان نقطه شروع استفاده می‌کند بدون اینکه آن را به‌روزرسانی کند\&. .RE .PP \-\-\revert= .RS 4 نقطه شروع برای ایجاد کامیت‌های بازگردانی‌شده (reverted)؛ باید نام یک شاخه باشد\&. .sp هنگامی که \fB\-\-\revert\fR مشخص شود، کامیت‌های موجود در محدوده بازنگری بازگردانی می‌شوند (تغییرات آن‌ها باطل می‌شود) و کامیت‌های بازگردانی‌شده بر روی ایجاد می‌گردند\&. سپس به‌روزرسانی می‌شود تا به کامیت‌های جدید اشاره کند\&. این کار مشابه اجرای دستور \fBgit\fR \fBrevert\fR \fI\fR است، اما درخت کاری را به‌روزرسانی نمی‌کند\&. .sp پیام‌های کامیت از قراردادهای \fBgit\fR \fBrevert\fR پیروی می‌کنند: آن‌ها با پیشوند "Revert" آغاز شده و عبارت "This reverts commit \&." را در بر دارند\&. هنگام بازگردانی کامیتی که پیام آن با "Revert" شروع شده است، پیام جدید در عوض از "Reapply" استفاده می‌کند\&. برخلاف cherry\-pick که نویسنده اصلی را حفظ می‌کند، کامیت‌های بازگردانی از کاربر جاری به عنوان نویسنده استفاده می‌کنند که با رفتار \fBgit\fR \fBrevert\fR مطابقت دارد\&. .sp این گزینه با \fB\-\-\onto\fR و \fB\-\-\advance\fR مانعة‌الجمع است\&. همچنین با \fB\-\-\contained\fR (که تنها اصلاح‌کننده‌ای برای \fB\-\-\onto\fR است) ناسازگار می‌باشد\&. .RE .PP \-\-\contained .RS 4 تمام شاخه‌هایی را که به کامیت‌های موجود در اشاره دارند به‌روزرسانی می‌کند\&. نیازمند \fB\-\-\onto\fR است\&. .RE .PP \-\-\ref= .RS 4 مرجعی را که با نتیجه بازپخش به‌روزرسانی می‌شود جایگزین می‌کند\&. مرجع باید به طور کامل واجد شرایط باشد\&. هنگامی که با \fB\-\-\onto\fR استفاده شود، \fI\fR باید دارای یک نوک واحد باشد و تنها مرجع مشخص‌شده به‌روزرسانی می‌شود به جای اینکه مراجع از روی محدوده بازنگری استنتاج شوند\&. هنگامی که با \fB\-\-\advance\fR یا \fB\-\-\revert\fR استفاده شود، مرجع مشخص‌شده به جای شاخه ارائه‌شده به آن گزینه‌ها به‌روزرسانی می‌گردد\&. این گزینه با \fB\-\-\contained\fR ناسازگار است\&. .RE .PP \-\-\ref\-action[=] .RS 4 چگونگی به‌روزرسانی مراجع را کنترل می‌کند\&. این حالت می‌تواند یکی از موارد زیر باشد: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBupdate\fR (پیش‌فرض): مراجع را مستقیماً با استفاده از یک تراکنش اتمیک به‌روزرسانی می‌کند\&. همه مراجع به‌روزرسانی می‌شوند یا هیچ‌کدام (رفتار همه یا هیچ)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBprint\fR: دستورات update\-ref را برای استفاده در خط لوله (pipeline) خروجی می‌دهد\&. این رفتار سنتی است که در آن خروجی را می‌توان به \fBgit\fR \fBupdate\-ref\fR \fB\-\-\stdin\fR لوله‌کشی کرد\&. .RE .sp حالت پیش‌فرض را می‌توان از طریق متغیر پیکربندی \fBreplay\&.refAction\fR تنظیم نمود\&. .RE .PP .RS 4 محدوده‌ای از کامیت‌ها برای بازپخش؛ به بخش "Specifying Ranges" در \fBgit-rev-parse\fR(1) مراجعه کنید\&. در حالت \fB\-\-\advance=\fR\fI\fR یا \fB\-\-\revert=\fR\fI\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 الگوهای محدودکننده را به‌عنوان عبارات باقاعده پایه (Basic Regular Expressions) در نظر می‌گیرد؛ این رفتار پیش‌فرض است\&. .RE .PP \fB\-E\fR, \fB\-\-extended\-regexp\fR .RS 4 الگوهای محدودکننده را به‌جای عبارات باقاعده پایه پیش‌فرض، به‌عنوان عبارات باقاعده گسترش‌یافته (Extended Regular Expressions) در نظر می‌گیرد\&. .RE .PP \fB\-F\fR, \fB\-\-fixed\-strings\fR .RS 4 الگوهای محدودکننده را به‌عنوان رشته‌های ثابت در نظر می‌گیرد (الگو را به‌عنوان یک عبارت باقاعده تفسیر نمی‌کند)\&. .RE .PP \fB\-P\fR, \fB\-\-perl\-regexp\fR .RS 4 الگوهای محدودکننده را به‌عنوان عبارات باقاعده سازگار با پرل (Perl-compatible regular expressions) در نظر می‌گیرد\&. .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 تمام ادغام‌های اختاپوسی (octopus merges) را نشان می‌دهد\&. .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 هنگام یافتن کامیت‌ها برای گنجاندن در خروجی، به محض مواجهه با یک کامیت ادغام، تنها کامیت والد نخست را دنبال می‌کند\&. این گزینه می‌تواند دید کلی بهتری در هنگام مشاهده سیر تکامل یک شاخه موضوعی (topic branch) خاص فراهم سازد، زیرا ادغام‌ها در یک شاخه موضوعی معمولاً تنها برای هماهنگ شدن دوره‌ای با بالادست به‌روزشده هستند و این گزینه به شما امکان می‌دهد کامیت‌های جداگانه‌ای را که توسط چنین ادغامی وارد تاریخچه شده‌اند نادیده بگیرید\&. .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 داده شود، شاخه‌ها را به موارد منطبق با الگوی پوسته (shell glob) داده‌شده محدود می‌کند\&. اگر \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 علامت‌گذاری می‌شوند (مشمول حذف از طریق ساده‌سازی)\&. .SS "ترتیب کامیت‌ها (Commit Ordering)" .sp به‌طور پیش‌فرض، کامیت‌ها به ترتیب معکوس زمانی نمایش داده می‌شوند\&. .PP \fB\-\-date\-order\fR .RS 4 هیچ والدی را پیش از نمایش تمام فرزندانش نشان نمی‌دهد، اما در غیر این صورت کامیت‌ها را به ترتیب برچسب زمان کامیت نمایش می‌دهد\&. .RE .PP \fB\-\-author\-date\-order\fR .RS 4 هیچ والدی را پیش از نمایش تمام فرزندانش نشان نمی‌دهد، اما در غیر این صورت کامیت‌ها را به ترتیب برچسب زمان نویسنده نمایش می‌دهد\&. .RE .PP \fB\-\-topo\-order\fR .RS 4 هیچ والدی را پیش از نمایش تمام فرزندانش نشان نمی‌دهد، و از نمایش درهم‌آمیخته کامیت‌ها در خطوط تاریخچه چندگانه جلوگیری می‌کند\&. .sp برای نمونه، در یک تاریخچه کامیت مانند این: .sp .if n \{\ .RS 4 .\} .nf \-\-\-1\-\-\-\-2\-\-\-\-4\-\-\-\-7 \e \e 3\-\-\-\-5\-\-\-\-6\-\-\-\-8\-\-\- .fi .if n \{\ .RE .\} .sp که در آن اعداد نشان‌دهنده ترتیب برچسب‌های زمان کامیت هستند، دستور \fBgit\fR \fBrev\-list\fR و دستورات مشابه همراه با \fB\-\-date\-order\fR کامیت‌ها را به ترتیب برچسب زمان نمایش می‌دهند: 8 7 6 5 4 3 2 1\&. .sp با \fB\-\-topo\-order\fR, آن‌ها به صورت 8 6 5 3 7 4 2 1 (یا 8 7 4 2 6 5 3 1) نمایش داده می‌شوند؛ برخی از کامیت‌های قدیمی‌تر قبل از کامیت‌های جدیدتر نشان داده می‌شوند تا از مخلوط شدن کامیت‌های دو مسیر توسعه موازی جلوگیری شود\&. .RE .PP \fB\-\-reverse\fR .RS 4 کامیت‌های انتخاب‌شده برای نمایش را (به بخش \fICommit Limiting\fR در بالا مراجعه کنید) به ترتیب معکوس خروجی می‌دهد\&. با \fB\-\-walk\-reflogs\fR قابل ترکیب نیست\&. .RE .SS "پیمایش شیء (Object Traversal)" .sp این گزینه‌ها بیشتر برای بسته‌بندی مخازن گیت هدف‌گذاری شده‌اند\&. .PP \fB\-\-no\-walk\fR[\fB=\fR(\fBsorted\fR|\fBunsorted\fR)] .RS 4 تنها کامیت‌های ارائه‌شده را نشان می‌دهد، اما نیاکان آن‌ها را پیمایش نمی‌کند\&. اگر محدوده‌ای مشخص شده باشد، این گزینه هیچ تأثیری ندارد\&. اگر آرگومان \fBunsorted\fR داده شود، کامیت‌ها به ترتیبی که در خط فرمان وارد شده‌اند نمایش می‌یابند\&. در غیر این صورت (اگر \fBsorted\fR یا هیچ آرگومانی داده نشده باشد)، کامیت‌ها به ترتیب معکوس زمانی بر اساس زمان کامیت نمایش داده می‌شوند\&. با \fB\-\-graph\fR قابل ترکیب نیست\&. .RE .PP \fB\-\-do\-walk\fR .RS 4 گزینه قبلی \fB\-\-no\-walk\fR را لغو می‌کند\&. .RE .SH "خروجی (OUTPUT)" .sp به طور پیش‌فرض، یا با \fB\-\-\ref\-action=update\fR، این دستور در صورت موفقیت هیچ خروجی‌ای تولید نمی‌کند، زیرا مراجع مستقیماً با استفاده از یک تراکنش اتمیک به‌روزرسانی می‌شوند\&. .sp هنگام استفاده از \fB\-\-\ref\-action=print\fR، خروجی به عنوان ورودی برای \fBgit\fR \fBupdate\-ref\fR \fB\-\-\stdin\fR قابل استفاده است\&. خروجی به شکل زیر خواهد بود: .sp .if n \{\ .RS 4 .\} .nf update refs/heads/branch1 ${NEW_branch1_HASH} ${OLD_branch1_HASH} update refs/heads/branch2 ${NEW_branch2_HASH} ${OLD_branch2_HASH} update refs/heads/branch3 ${NEW_branch3_HASH} ${OLD_branch3_HASH} .fi .if n \{\ .RE .\} .sp که در آن تعداد مراجع به‌روزرسانی‌شده به آرگومان‌های ارائه‌شده و ساختار تاریخچه‌ای که بازپخش می‌شود بستگی دارد\&. هنگام استفاده از \fB\-\-\advance\fR یا \fB\-\-\revert\fR، تعداد مراجع به‌روزرسانی‌شده همواره یکی است، اما برای \fB\-\-\onto\fR می‌تواند یک یا چند مورد باشد (بیس‌دهی مجدد چندین شاخه به طور هم‌زمان پشتیبانی می‌شود)\&. .sp در صورت بروز تداخل هیچ خروجی خطایی روی stderr وجود ندارد؛ بخش وضعیت خروج را در زیر ببینید\&. .SH "وضعیت خروج (EXIT STATUS)" .sp برای یک بازپخش موفقیت‌آمیز و بدون تداخل، وضعیت خروج 0 است\&. هنگامی که بازپخش با تداخل مواجه شود، وضعیت خروج 1 خواهد بود\&. اگر بازپخش به دلیل نوعی خطا نتواند شروع شده یا به پایان برسد، وضعیت خروج مقداری غیر از 0 یا 1 خواهد بود\&. .SH "مثال‌ها (EXAMPLES)" .sp برای بازپایه (rebase) کردن ساده شاخه \fBmybranch\fR بر روی \fBtarget\fR: .sp .if n \{\ .RS 4 .\} .nf $ git replay \-\-\onto=target origin/main\&.\&.mybranch .fi .if n \{\ .RE .\} .sp .sp مراجع به صورت اتمیک به‌روزرسانی می‌شوند و در صورت موفقیت هیچ خروجی‌ای تولید نمی‌شود\&. .sp برای مشاهده آنچه به‌روزرسانی خواهد شد بدون انجام به‌روزرسانی واقعی: .sp .if n \{\ .RS 4 .\} .nf $ git replay \-\-\ref\-action=print \-\-\onto=target origin/main\&.\&.mybranch update refs/heads/mybranch ${NEW_mybranch_HASH} ${OLD_mybranch_HASH} .fi .if n \{\ .RE .\} .sp .sp برای چری‌پیک (cherry\-pick) کردن کامیت‌ها از mybranch بر روی target: .sp .if n \{\ .RS 4 .\} .nf $ git replay \-\-\advance=target origin/main\&.\&.mybranch .fi .if n \{\ .RE .\} .sp .sp توجه داشته باشید که دو مثال نخست دقیقاً همان کامیت‌ها را و بر روی دقیقاً همان پایه جدید بازپخش می‌کنند؛ تفاوت آن‌ها تنها در این است که مثال نخست mybranch را به‌روزرسانی می‌کند تا به کامیت‌های جدید اشاره کند و مثال دوم target را به‌روزرسانی می‌کند تا به آن‌ها اشاره نماید\&. .sp اگر پشته‌ای از شاخه‌ها داشته باشید که یکی به دیگری وابسته است و بخواهید کل مجموعه را بازپایه کنید چه باید کرد؟ .sp .if n \{\ .RS 4 .\} .nf $ git replay \-\-\contained \-\-\onto=origin/main origin/main\&.\&.tipbranch .fi .if n \{\ .RE .\} .sp .sp هر سه شاخه (\fBbranch1\fR، \fBbranch2\fR و \fBtipbranch\fR) به صورت اتمیک به‌روزرسانی می‌شوند\&. .sp هنگام فراخوانی \fBgit\fR \fBreplay\fR نیازی نیست محدوده کامیت‌ها برای بازپخش را با استفاده از نحو \fBA\fR\fB\&.\&.\fR\fBB\fR مشخص کنید؛ هر عبارت تعیین محدوده‌ای پذیرفته می‌شود: .sp .if n \{\ .RS 4 .\} .nf $ git replay \-\-\onto=origin/main ^base branch1 branch2 branch3 .fi .if n \{\ .RE .\} .sp .sp این دستور هم‌زمان شاخه‌های \fBbranch1\fR، \fBbranch2\fR و \fBbranch3\fR (تمام کامیت‌هایی که پس از \fBbase\fR دارند) را بر روی \fBorigin/main\fR بازپایه و بازپخش می‌کند\&. این سه شاخه ممکن است کامیت‌های مشترکی پس از \fBbase\fR داشته باشند، اما این امر الزامی نیست\&. .sp برای بازگردانی (revert) کامیت‌ها در یک شاخه: .sp .if n \{\ .RS 4 .\} .nf $ git replay \-\-\revert=main topic~2\&.\&.topic .fi .if n \{\ .RE .\} .sp .sp این دستور دو کامیت آخر از \fBtopic\fR را بازگردانی کرده و کامیت‌های بازگردانی را بر روی \fBmain\fR ایجاد می‌کند، و \fBmain\fR را به‌روزرسانی می‌نماید تا به نتیجه اشاره کند\&. این کار زمانی سودمند است که کامیت‌های \fBtopic\fR پیش‌تر در \fBmain\fR ادغام یا چری‌پیک شده باشند و نیاز به باطل کردن آن‌ها باشد\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br .sp برای بازگردانی یک درخواست ادغام (merge request) به طور کامل در قالب یک کامیت واحد (به جای بازگردانی کامیت‌به‌کامیت)، استفاده از \fBgit\fR \fBmerge\-tree\fR \fB\-\-\merge\-base\fR \fB$TIP\fR \fBHEAD\fR \fB$BASE\fR را در نظر بگیرید که می‌تواند از تداخل‌های ادغام غیرضروری جلوگیری کند\&. .sp .5v .RE .sp برای بازپخش بر روی یک کامیت خاص و هم‌زمان به‌روزرسانی مرجعی متفاوت: .sp .if n \{\ .RS 4 .\} .nf $ git replay \-\-\onto=112233 \-\-\ref=refs/heads/mybranch aabbcc\&.\&.ddeeff .fi .if n \{\ .RE .\} .sp .sp این دستور محدوده \fBaabbcc\fR\fB\&.\&.\fR\fBddeeff\fR را بر روی کامیت \fB112233\fR بازپخش کرده و \fBrefs/heads/mybranch\fR را به‌روزرسانی می‌کند تا به نتیجه اشاره کند\&. این روش زمانی سودمند است که بخواهید از شناسه‌های هش کامیت خام به جای نام شاخه‌ها استفاده نمایید\&. .SH "گیت (GIT)" .sp بخشی از مجموعه \fBgit\fR(1)