$ git log foo bar ^baz

$ git log origin..HEAD
$ git log HEAD ^origin

$ git log A B --not $(git merge-base --all A B)
$ git log A...B

short

full

auto

گزینه --decorate حالت کوتاه‌نویسی برای --decorate=short است. در صورت پیکربندی، به‌طور پیش‌فرض از مقدار پیکربندی log.decorate استفاده می‌کند، در غیر این صورت مقدار auto به کار می‌رود.

اگر هیچ‌یک از این گزینه‌ها یا تنظیمات پیکربندی داده نشود، ارجاع‌ها در صورتی به‌عنوان تزیین استفاده می‌شوند که با HEAD, refs/heads/, refs/remotes/, refs/stash/, یا refs/tags/ مطابقت داشته باشند.

توجه داشته باشید که این گزینه بر همه انواع خروجی‌های مبتنی بر تفاوت تأثیر می‌گذارد، مانند خروجی‌های تولیدشده توسط --stat و غیره.

گزینه‌های قالب‌بندی وصله مانند --word-diff, --color-moved, --no-prefix, و گزینه‌های فاصله خالی (-w, -b) پشتیبانی می‌شوند، همچنین گزینه‌های کلنگ (-S, -G) و --diff-filter.

<start> و <end> می‌توانند یکی از این شکل‌ها را داشته باشند:

اگر :<funcname> به‌جای <start> و <end> داده شود، یک عبارت باقاعده است که محدوده را از نخستین خط نام تابع منطبق با <funcname> تا خط نام تابع بعدی مشخص می‌سازد. :<funcname> از انتهای محدوده قبلی -L (در صورت وجود) جستجو می‌کند، در غیر این صورت از ابتدای فایل جستجو خواهد کرد. ^:<funcname> از ابتدای فایل جستجو می‌کند. نام‌های توابع به همان شیوه‌ای تعیین می‌شوند که git diff سرفصل‌های قطعه وصله (patch hunk headers) را محاسبه می‌کند (به Defining a custom hunk-header در gitattributes(5) مراجعه فرمایید).

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

<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 ارسال کنید، و این کار را ادامه دهید تا به نخستین نسخه بلوک برسید.

فایل‌های باینری نیز جستجو می‌شوند.

برای نشان دادن تفاوت بین -S<regex> --pickaxe-regex و -G<regex>, کامیتی با diff زیر را در همان فایل در نظر بگیرید:

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

در حالی که دستور git log -G"frotz\(nitfol" این کامیت را نشان می‌دهد، دستور git log -S"frotz\(nitfol" --pickaxe-regex آن را نشان نخواهد داد (زیرا تعداد رخدادهای آن رشته تغییری نکرده است).

مگر اینکه --text ارائه شود، وصله‌های فایل‌های باینری بدون فیلتر textconv نادیده گرفته می‌شوند.

برای اطلاعات بیشتر به مدخل pickaxe در gitdiffcore(7) مراجعه کنید.

شیء می‌تواند یک blob یا کامیت زیرماژول باشد. این گزینه مستلزم گزینه -t در git-log است تا درخت‌ها را نیز پیدا کند.

ترتیب خروجی بر اساس ترتیب الگوهای glob در <orderfile> تعیین می‌شود. تمام فایل‌هایی که نام مسیر آن‌ها با الگوی نخست مطابقت دارد ابتدا خروجی داده می‌شوند، سپس تمام فایل‌های منطبق با الگوی دوم (اما نه اولی) خروجی داده می‌شوند و به همین ترتیب. تمام فایل‌هایی که با هیچ الگویی مطابقت ندارند در پایان خروجی داده می‌شوند، به‌گونه‌ای که گویی یک الگوی ضمنی match-all در انتهای فایل وجود داشته است. اگر چند نام مسیر رتبه یکسانی داشته باشند (با همان الگو مطابقت داشته باشند اما با الگوهای قبلی تطابق نداشته باشند)، ترتیب خروجی آن‌ها نسبت به یکدیگر همان ترتیب عادی خواهد بود.

فایل <orderfile> به شرح زیر تجزیه می‌شود:

الگوها همان نحو و معناشناسی الگوهای استفاده‌شده برای fnmatch(3) بدون پرچم FNM_PATHNAME را دارند، به جز اینکه اگر حذف هر تعداد از مؤلفه‌های نهایی نام مسیر با الگو مطابقت داشته باشد، آن نام مسیر نیز با الگو تطابق دارد. برای نمونه، الگوی "foo*bar" با "fooasdfbar" و "foo/bar/baz/asdf" مطابقت دارد اما با "foobarx" مطابقت ندارد.

اگر هیچ الگوی مسیری داده نشود، عمق به‌گونه‌ای سنجیده می‌شود که گویی تمام مدخل‌های سطح بالا مشخص شده‌اند. توجه داشته باشید که این با اندازه‌گیری از ریشه متفاوت است، از این جهت که --max-depth=0 همچنان foo را بازمی‌گرداند. این به شما امکان می‌دهد همچنان عمق را محدود کنید در حالی که زیرمجموعه‌ای از مدخل‌های سطح بالا را درخواست می‌نمایید.

توجه داشته باشید که این گزینه تنها برای تفاوت میان اشیای درخت پشتیبانی می‌شود، نه در برابر ایندکس یا درخت کاری.

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/ نیستند.

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

خط 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 به‌جای آن استفاده می‌شود.

اگر قالب روی "auto:foo" تنظیم شده باشد و صفحه‌بندی (pager) در حال استفاده باشد، قالب "foo" برای قالب تاریخ استفاده خواهد شد. در غیر این صورت، از "default" استفاده می‌شود.

short

full

auto

این معادل گزینه --decorate از git log است.

این تنظیم را می‌توان با ارسال گزینه --strategy به git-notes(1) بازنویسی کرد.

این تنظیم را می‌توان با متغیر محیطی GIT_NOTES_DISPLAY_REF که باید فهرستی از ارجاع‌ها یا globهای جداشده با دو نقطه باشد بازنویسی کرد.

برای ارجاع‌هایی که وجود ندارند هشداری صادر می‌شود، اما الگوی glob که با هیچ ارجاعی تطابق نداشته باشد بدون هشدار نادیده گرفته می‌شود.

این تنظیم را می‌توان با گزینه --no-notes برای خانواده دستورات git-log(1) یا با گزینه --notes=<ref> پذیرفته‌شده توسط آن دستورات غیرفعال کرد.

مقدار مؤثر core.notesRef (که احتمالاً توسط GIT_NOTES_REF بازنویسی شده است) نیز به‌طور ضمنی به فهرست ارجاع‌های نمایش‌داده‌شده اضافه می‌شود.

این تنظیم را می‌توان با متغیر محیطی GIT_NOTES_REWRITE_REF که باید فهرستی از ارجاع‌ها یا globهای جداشده با دو نقطه باشد بازنویسی کرد.

این تنظیم را می‌توان با متغیر محیطی GIT_NOTES_REWRITE_MODE بازنویسی کرد.

مقدار پیش‌فرض ندارد؛ برای فعال‌سازی بازنویسی یادداشت باید این متغیر را پیکربندی کنید. برای فعال کردن بازنویسی برای یادداشت‌های کامیت پیش‌فرض، آن را روی refs/notes/commits تنظیم فرمایید.

می‌تواند با متغیر محیطی GIT_NOTES_REWRITE_REF بازنویسی شود. برای شرح بیشتر قالب آن به notes.rewrite.<command> در بالا مراجعه کنید.