برای جزئیات بیشتر درباره هر قالب، بخش «PRETTY FORMATS» را ببینید. هنگامی که بخش =<format> حذف شود، مقدار پیش‌فرض medium خواهد بود.

این گزینه باید خوانایی --pretty=oneline را برای افرادی که از ترمینال‌های ۸۰ ستونی استفاده می‌کنند به مراتب بهتر کند.

به‌طور پیش‌فرض، تب‌ها در قالب‌های زیبایی که پیام لاگ را ۴ فاصله تورفتگی می‌دهند (یعنی medium که پیش‌فرض است، full, و fuller) گسترش می‌یابند.

به‌طور پیش‌فرض، یادداشت‌های نمایش‌داده‌شده از ارجاع‌های یادداشت فهرست‌شده در متغیرهای core.notesRef و notes.displayRef (یا بازنویسی‌های متغیرهای محیطی متناظر) برگرفته می‌شوند. برای جزئیات بیشتر به git-config(1) مراجعه کنید.

با یک آرگومان اختیاری <ref>, از آن ارجاع برای یافتن یادداشت‌ها جهت نمایش استفاده می‌کند. ارجاع می‌تواند نام کامل ارجاع را هنگامی که با refs/notes/ آغاز می‌شود مشخص کند؛ هنگامی که با notes/ آغاز شود، پیشوند refs/ و در غیر این صورت refs/notes/ برای تشکیل نام کامل ارجاع اضافه می‌گردد.

می‌توان چندین گزینه --notes را با هم ترکیب کرد تا مشخص شود چه یادداشت‌هایی نمایش داده می‌شوند. مثال‌ها: "--notes=foo" تنها یادداشت‌های refs/notes/foo را نشان می‌دهد؛ "--notes=foo --notes" هم یادداشت‌های "refs/notes/foo" و هم یادداشت‌های ارجاع(های) یادداشت پیش‌فرض را نشان می‌دهد.

<hash> <title-line>

این قالب به‌گونه‌ای طراحی شده است که تا حد امکان فشرده باشد.

<abbrev-hash> (<title-line>, <short-author-date>)

این قالب برای ارجاع به یک کامیت دیگر در پیام کامیت استفاده می‌شود و مشابه --pretty='format:%C(auto)%h (%s, %ad)' است. به‌طور پیش‌فرض، تاریخ با --date=short قالب‌بندی می‌شود مگر اینکه گزینه --date دیگری صراحتاً مشخص شده باشد. همانند هر format: دارای جانگهدارنده‌های قالب، خروجی آن تحت تأثیر گزینه‌های دیگری مانند --decorate و --walk-reflogs قرار نمی‌گیرد.

برای نمونه، format:"The author of %h was %an, %ar%nThe title was >>%s<<%n" خروجی شبیه به این نمایش می‌دهد:

The author of fe6e0ee was Junio C Hamano, 23 hours ago
The title was >>t4119: test autocomputing -p<n> for traditional diff input.<<

جانگهدارنده‌ها (placeholders) عبارتند از:

%(decorate:prefix=,suffix=,tag=,separator= )

$ git log -2 --pretty=format:%h 4da45bef \
  | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/'
4da45be
7134973 -- NO NEWLINE
$ git log -2 --pretty=tformat:%h 4da45bef \
  | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/'
4da45be
7134973

علاوه بر این، هر رشته ناشناخته‌ای که شامل یک % باشد به‌گونه‌ای تفسیر می‌شود که گویی tformat: در ابتدای آن قرار دارد. برای نمونه، این دو مورد معادل هستند:

$ git log -2 --pretty=tformat:%h 4da45bef
$ git log -2 --pretty=%h 4da45bef

قالب‌های زیر پشتیبانی می‌شوند:

off, none

on, m

first-parent, 1

separate

combined, c

dense-combined, cc

remerge, r

خروجی صادرشده در هنگام استفاده از این گزینه، و همچنین تعامل آن با سایر گزینه‌ها (مگر در مواردی که صراحتاً مستند شده باشد) ممکن است دستخوش تغییر شود.

این گزینه ممکن است بیش از یک بار مشخص شود.

اگر خطی هم در مبدأ و هم در مقصد وجود داشته باشد، فقط یک بار تکرار شده باشد، و با <text> شروع شود، این الگوریتم تلاش می‌کند تا از نمایش آن به‌عنوان حذف یا اضافه در خروجی جلوگیری کند. این الگوریتم در درون خود از الگوریتم «patience diff» استفاده می‌کند.

default, myers

minimal

patience

histogram

برای نمونه، اگر متغیر diff.algorithm را روی مقداری غیرپیش‌فرض تنظیم کرده‌اید و می‌خواهید از مقدار پیش‌فرض استفاده کنید، باید از گزینه‌ی --diff-algorithm=default استفاده نمایید.

این پارامترها را می‌توان به‌طور جداگانه با --stat-width=<width>، --stat-name-width=<name-width> و --stat-count=<count> نیز تنظیم کرد.

changes

lines

files

cumulative

<limit>

مثال: دستور زیر فایل‌های تغییریافته را می‌شمارد، در حالی که دایرکتوری‌های با کمتر از ۱۰٪ از کل فایل‌های تغییریافته را نادیده می‌گیرد و شمارش دایرکتوری فرزند را در دایرکتوری‌های والد تجمیع می‌کند: --dirstat=files,10,cumulative.

همچنین هنگامی که --raw یا --numstat داده شده باشد، نام مسیرها را دستکاری نکرده و از NUL به‌عنوان پایان‌بخش فیلدهای خروجی استفاده می‌کند.

بدون این گزینه، نام مسیرهای دارای نویسه‌های «نامعمول» طبق آنچه برای متغیر پیکربندی core.quotePath توضیح داده شده است نقل‌قول می‌شوند (نگاه کنید به git-config(1)).

no

default

plain

blocks

zebra

dimmed-zebra

no

ignore-space-at-eol

ignore-space-change

ignore-all-space

allow-indentation-change

color

plain

porcelain

none

توجه داشته باشید که علیرغم نام حالت اول، در صورت فعال بودن رنگ، در تمام حالت‌ها از رنگ برای برجسته کردن بخش‌های تغییریافته استفاده می‌شود.

گزینه --word-diff با گرفتن همان diff خط به خط تولیدشده بدون این گزینه و محاسبه تغییرات کلمه به کلمه در هر قطعه عمل می‌کند. این ممکن است تفاوتی بزرگتر از آنچه یک ابزار اختصاصی word-diff تولید می‌کند ایجاد کند. اگر گیت در آینده پیاده‌سازی متفاوتی به دست آورد، ممکن است خروجی تغییر کند. توجه داشته باشید که این مشابه گزینه --diff-algorithm است که ممکن است خروجی را نیز تغییر دهد.

هر تطابق غیرهمپوشان از <regex> یک کلمه تلقی می‌شود. هر چیزی بین این تطابق‌ها فاصله خالی در نظر گرفته شده و به منظور یافتن تفاوت‌ها نادیده گرفته می‌شود(!). ممکن است بخواهید |[^[:space:]] را به عبارت باقاعده خود اضافه کنید تا مطمئن شوید با تمام نویسه‌های غیرفاصله خالی تطابق دارد. تطابقی که حاوی یک خط جدید باشد، بدون اعلام خطا در محل خط جدید کوتاه می‌شود(!).

برای نمونه، --word-diff-regex=. با هر نویسه مانند یک کلمه رفتار می‌کند و متناظراً تفاوت‌ها را نویسه به نویسه نشان می‌دهد.

عبارت باقاعده را می‌توان از طریق درایور diff یا گزینه پیکربندی نیز تنظیم کرد، به gitattributes(5) یا git-config(1) مراجعه کنید. تعیین صریح آن بر هر درایور diff یا تنظیم پیکربندی اولویت دارد. درایورهای diff بر تنظیمات پیکربندی اولویت دارند.

بر نحوه نمایش تغییری که معادل یک بازنویسی کامل از یک فایل است تأثیر می‌گذارد تا به‌جای مجموعه‌ای از حذف‌ها و درج‌های درهم‌آمیخته با تعداد بسیار کمی از خطوط که تصادفاً از نظر متنی به‌عنوان متن پیرامون تطابق دارند، به‌عنوان یک حذف منفرد از همه‌چیزهای قدیمی و به دنبال آن یک درج منفرد از همه‌چیزهای جدید نمایش داده شود؛ عدد <m> این جنبه از گزینه -B را کنترل می‌کند (پیش‌فرض ۶۰٪ است). -B/70% مشخص می‌کند که کمتر از ۳۰٪ از نسخه اصلی باید در نتیجه باقی بماند تا گیت آن را یک بازنویسی کامل در نظر بگیرد (در غیر این صورت وصله حاصل مجموعه‌ای از حذف و درج‌های مخلوط با خطوط زمینه خواهد بود).

هنگام استفاده همراه با -M، یک فایل کاملاً بازنویسی‌شده به‌عنوان مبدأ تغییر نام نیز در نظر گرفته می‌شود (معمولاً -M تنها فایلی را که ناپدید شده است به‌عنوان مبدأ تغییر نام در نظر می‌گیرد)، و عدد <n> این جنبه از گزینه -B را کنترل می‌نماید (پیش‌فرض ۵۰٪ است). -B20% مشخص می‌کند که تغییری با افزودن و حذف در مقایسه با ۲۰٪ یا بیشتر از اندازه فایل، واجد شرایط انتخاب به‌عنوان مبدأ احتمالی تغییر نام به فایلی دیگر است.

هنگامی که همراه با -B استفاده شود، تصویر پیشین را در بخش حذف یک جفت حذف/ایجاد نیز حذف می‌کند.

همچنین، این حروف بزرگ را می‌توان با حروف کوچک برای استثنا کردن نوشت. برای نمونه --diff-filter=ad مسیرهای افزوده‌شده و حذف‌شده را مستثنی می‌سازد.

توجه داشته باشید که همه diffها نمی‌توانند تمام انواع را نشان دهند. برای مثال، ورودی‌های رونوشت‌برداری‌شده و تغییرنام‌یافته در صورتی که تشخیص برای آن انواع غیرفعال باشد نمی‌توانند ظاهر شوند.

زمانی مفید است که به دنبال یک بلوک دقیق از کد (مانند یک struct) می‌گردید و می‌خواهید تاریخچه آن بلوک را از زمان ایجاد اولیه بدانید: از این ویژگی به‌صورت تکراری استفاده کنید تا بلوک مورد نظر در تصویر پیشین را مجدداً به -S ارسال کنید، و این کار را ادامه دهید تا به نخستین نسخه بلوک برسید.

فایل‌های باینری نیز جستجو می‌شوند. -G<regex>

+    return frotz(nitfol, two->ptr, 1, 0);
...
-    hit = frotz(nitfol, mf2.ptr, 1, 0);

--find-object=<object-id>

--pickaxe-all

--pickaxe-regex

-O<orderfile>

--skip-to=<file>, --rotate-to=<file>

-R

--relative[=<path>], --no-relative

-a, --text

--ignore-cr-at-eol

--ignore-space-at-eol

-b, --ignore-space-change

-w, --ignore-all-space

--ignore-blank-lines

-I<regex>, --ignore-matching-lines=<regex>

--inter-hunk-context=<number>

-W, --function-context

--ext-diff

--no-ext-diff

--textconv, --no-textconv

--ignore-submodules[=(none|untracked|dirty|all)]

--src-prefix=<prefix>

--dst-prefix=<prefix>

--no-prefix

--default-prefix

--line-prefix=<prefix>

--ita-invisible-in-index

--max-depth=<depth>

برای توضیحات دقیق‌تر درباره این گزینه‌های مشترک، به gitdiffcore(7) نیز مراجعه کنید.

diff --git a/file1 b/file2

نام پرونده‌های a/ و b/ یکسان هستند مگر اینکه تغییر نام یا رونوشت در کار باشد. به‌ویژه، حتی برای ایجاد یا حذف یک پرونده، /dev/null به جای نام پرونده‌های a/ یا b/ استفاده نمی‌شود.

هنگامی که تغییر نام یا رونوشت در میان باشد، file1 و file2 به ترتیب نام پرونده مبدا تغییر نام/رونوشت و نام پرونده‌ای را که تغییر نام/رونوشت تولید می‌کند نشان می‌دهند.

old mode <mode>
new mode <mode>
deleted file mode <mode>
new file mode <mode>
copy from <path>
copy to <path>
rename from <path>
rename to <path>
similarity index <number>
dissimilarity index <number>
index <hash>..<hash> <mode>

حالت‌های پرونده <mode> به عنوان اعداد اکتال ۶ رقمی شامل نوع پرونده و بیت‌های مجوز پرونده چاپ می‌شوند.

نام مسیرها در هدرهای گسترده شامل پیشوندهای a/ و b/ نیستند.

شاخص شباهت (similarity index) درصد خطوط تغییرنیافته و شاخص عدم شباهت (dissimilarity index) درصد خطوط تغییریافته است. این مقدار یک عدد صحیح گرد شده به سمت پایین است که پس از آن علامت درصد می‌آید. بنابراین مقدار شاخص شباهت ۱۰۰٪ برای دو پرونده یکسان اختصاص دارد، در حالی که ۱۰۰٪ عدم شباهت بدین معنی است که هیچ خطی از پرونده قدیمی به پرونده جدید راه نیافته است.

خط index شامل نام اشیاء blob قبل و بعد از تغییر است. اگر حالت پرونده تغییر نکند، <mode> گنجانده می‌شود؛ در غیر این صورت، خطوط جداگانه حالت قدیمی و جدید را مشخص می‌کنند.

diff --combined describe.c
index fabadb8,cc95eb0..4866510
--- a/describe.c
+++ b/describe.c
@@@ -98,20 -98,12 +98,20 @@@
        return (a_date > b_date) ? -1 : (a_date == b_date) ? 0 : 1;
  }
- static void describe(char *arg)
 -static void describe(struct commit *cmit, int last_one)
++static void describe(char *arg, int last_one)
  {
 +      unsigned char sha1[20];
 +      struct commit *cmit;
        struct commit_list *list;
        static int initialized = 0;
        struct commit_name *n;
 +      if (get_sha1(arg, sha1) < 0)
 +              usage(describe_usage);
 +      cmit = lookup_commit_reference(sha1);
 +      if (!cmit)
 +              usage(describe_usage);
 +
        if (!initialized) {
                initialized = 1;
                for_each_ref(get_name);

diff --combined file

یا شبیه به این (زمانی که گزینه --cc استفاده شود):

diff --cc file

index <hash>,<hash>..<hash>
mode <mode>,<mode>..<mode>
new file mode <mode>
deleted file mode <mode>,<mode>

خط mode <mode>,<mode>..<mode> تنها زمانی ظاهر می‌شود که دست‌کم یکی از <mode>ها با بقیه متفاوت باشد. هدرهای گسترده با اطلاعات مربوط به جابه‌جایی محتوای شناسایی‌شده (تشخیص تغییر نام و رونوشت) برای کار با تفاضل دو <tree-ish> طراحی شده‌اند و در قالب تفاضل ترکیبی استفاده نمی‌شوند.

--- a/file
+++ b/file

مشابه با هدر دوخطی برای قالب سنتی تفاضل یکپارچه (unified)، از /dev/null برای نشان دادن پرونده‌های ایجادشده یا حذف‌شده استفاده می‌شود.

با این حال، اگر گزینه --combined-all-paths ارائه شده باشد، به جای یک هدر دوخطی from-file/to-file، یک هدر N+1 خطی from-file/to-file دریافت می‌کنید، که در آن N تعداد والدهای موجود در کامیت ادغام است:

--- a/file
--- a/file
--- a/file
+++ b/file

این قالب گسترده می‌تواند در صورت فعال بودن تشخیص تغییر نام یا رونوشت سودمند باشد، تا به شما اجازه دهد نام اصلی پرونده را در والدهای گوناگون ببینید.

@@@ <from-file-range> <from-file-range> <to-file-range> @@@

در هدر قطعه برای قالب تفاضل ترکیبی تعداد (تعداد والدها + ۱) نویسه @ وجود دارد.

توجه داشته باشید که گیت در سطح هسته با نام مسیرها صرفاً به عنوان توالی‌هایی از بایت‌های غیر NUL رفتار می‌کند؛ هیچ تبدیل کدگذاری برای نام مسیرها وجود ندارد (به جز در مک و ویندوز). بنابراین، استفاده از نام مسیرهای غیر ASCII حتی روی پلتفرم‌ها و سیستم‌های پرونده‌ای که از کدگذاری‌های قدیمی ASCII توسعه‌یافته استفاده می‌کنند، عمدتاً کار خواهد کرد. با این حال، مخازن ایجادشده روی چنین سیستم‌هایی روی سیستم‌های مبتنی بر UTF-8 (مانند لینوکس، مک، ویندوز) به درستی کار نخواهند کرد و بالعکس. علاوه بر این، بسیاری از ابزارهای مبتنی بر گیت صرفاً فرض می‌کنند که نام مسیرها UTF-8 هستند و در نمایش صحیح سایر کدگذاری‌ها ناموفق خواهند بود.

[i18n]
        commitEncoding = ISO-8859-1

اشیای کامیت ایجادشده با تنظیمات فوق، مقدار i18n.commitEncoding را در هدر encoding خود ثبت می‌کنند. این کار برای کمک به دیگرانی است که بعداً به آن‌ها نگاه می‌کنند. نبود این هدر نشان‌دهنده این است که پیام لاگ کامیت با UTF-8 کدگذاری شده است.

[i18n]
        logOutputEncoding = ISO-8859-1

اگر این متغیر پیکربندی را نداشته باشید، مقدار i18n.commitEncoding به جای آن استفاده می‌شود.