git-diff-tree

Создать патч (см. Создание текста патча с помощью -p).

Подавить весь вывод механизма diff. Полезно для таких команд, как git show, которые по умолчанию показывают патч, чтобы подавить их вывод, либо отменить действие таких параметров, как --patch, --stat, указанных ранее в командной строке в псевдониме.

Создать diff с <n> строками контекста. По умолчанию количество строк контекста равно diff.context или 3, если переменная конфигурации не задана. (-U без <n> без предупреждения принимается как синоним -p из-за исторической случайности). Подразумевает --patch.

Выводить данные в указанный файл вместо стандартного вывода.

Указать символы, используемые для обозначения новых строк, старых строк или строк контекста в созданном патче. Обычно это +, - и ' ' соответственно.

Создать diff в необработанном формате. Это поведение по умолчанию.

Синоним -p --raw.

Включить эвристику, которая сдвигает границы фрагментов diff, чтобы патчи было легче читать. Это поведение по умолчанию.

Отключить эвристику отступов.

Потратить дополнительное время, чтобы гарантировать создание diff минимально возможного размера.

Создать diff с помощью алгоритма «patience diff».

Создать diff с помощью алгоритма «histogram diff».

Создать diff с помощью алгоритма «anchored diff».

Этот параметр можно указать несколько раз.

Если строка присутствует и в источнике, и в целевом объекте, встречается только один раз и начинается с <text>, этот алгоритм пытается не допустить ее появления в выводе как удаленной или добавленной. Внутри используется алгоритм «patience diff».

Выбрать алгоритм diff. Доступны следующие варианты:

Например, если для переменной diff.algorithm задано нестандартное значение, а нужно использовать значение по умолчанию, следует указать параметр --diff-algorithm=default.

Создать diffstat. По умолчанию для имени файла используется столько места, сколько необходимо, а оставшееся — для графика. Максимальная ширина по умолчанию равна ширине терминала или 80 столбцам, если вывод не подключен к терминалу; ее можно переопределить с помощью <width>. Ширину части с именем файла можно ограничить, указав после запятой другое значение ширины <name-width> или задав diff.statNameWidth=<name-width>. Ширину графической части можно ограничить с помощью --stat-graph-width=<graph-width> или задав diff.statGraphWidth=<graph-width>. Использование --stat или --stat-graph-width влияет на все команды, создающие график статистики, тогда как настройка diff.statNameWidth или diff.statGraphWidth не влияет на git format-patch. Указав третий параметр <count>, можно ограничить вывод первыми <count> строками; если строк больше, после них выводится ....

Эти параметры также можно задавать по отдельности с помощью --stat-width=<width>, --stat-name-width=<name-width> и --stat-count=<count>.

Вывести краткую сводку расширенной информации заголовка, например о создании или удалении файлов («new» или «gone», при необходимости +l для символической ссылки) и изменениях режима (+x или -x для добавления или удаления бита исполнения соответственно) в diffstat. Эта информация помещается между частью с именами файлов и графической частью. Подразумевает --stat.

Похоже на --stat, но показывает количество добавленных и удаленных строк в десятичной системе счисления, а также полный путь к файлу без сокращений, что удобнее для машинной обработки. Для двоичных файлов вместо сообщения 0 0 выводятся два значения -.

Вывести только последнюю строку формата --stat, содержащую общее количество измененных файлов, а также количество добавленных и удаленных строк.

Вывести распределение относительного объема изменений по каждому подкаталогу. Поведение --dirstat можно настроить, передав ему список параметров, разделенных запятыми. Значения по умолчанию задаются переменной конфигурации diff.dirstat (см. git-config[1]). Доступны следующие параметры:

Пример: следующая команда подсчитает измененные файлы, игнорируя каталоги, на которые приходится менее 10% от общего числа измененных файлов, и суммируя количество файлов в дочерних каталогах для родительских каталогов: --dirstat=files,10,cumulative.

Синоним --dirstat=cumulative.

Синоним --dirstat=files,<param>,....

Вывести краткую сводку расширенной информации заголовка, например о создании, переименовании и изменении режима файлов.

Синоним -p --stat.

Если указан параметр --raw, --numstat, --name-only или --name-status, не преобразовывать имена путей и использовать NUL в качестве разделителей полей вывода.

Без этого параметра имена путей с «нестандартными» символами заключаются в кавычки, как описано для переменной конфигурации core.quotePath (см. git-config[1]).

Показывать только имя каждого измененного файла в дереве после изменений. Имена файлов часто кодируются в UTF-8. Дополнительные сведения см. в обсуждении кодировок на странице руководства git-log[1].

Показывать только имена и состояние каждого измененного файла. Описание значения букв, обозначающих состояние, см. в описании параметра --diff-filter. Как и при использовании --name-only, имена файлов часто кодируются в UTF-8.

Указать способ отображения различий в подмодулях. Если указано значение --submodule=short, используется формат short. В этом формате отображаются только имена коммитов в начале и конце диапазона. Если указано значение --submodule или --submodule=log, используется формат log. В этом формате перечисляются коммиты в диапазоне, как это делает команда summary из git-submodule[1]. Если указано значение --submodule=diff, используется формат diff. В этом формате встроенный diff показывает изменения содержимого подмодуля в диапазоне коммитов. По умолчанию используется diff.submodule или формат short, если параметр конфигурации не задан.

Показывать цветной diff. --color (то есть без =<when>) означает то же, что и --color=always. Значение <when> может быть одним из следующих: always, never или auto.

Отключить цветное отображение diff. То же, что и --color=never.

Перемещенные строки кода окрашиваются иначе. Если параметр не указан, <mode> по умолчанию равен no; если параметр указан без режима — zebra. Режим должен быть одним из следующих:

Отключить обнаружение перемещений. Этот параметр можно использовать для переопределения настроек конфигурации. То же, что и --color-moved=no.

Настраивает игнорирование пробельных символов при обнаружении перемещений для параметра --color-moved. Эти режимы можно указать в виде списка, разделенного запятыми:

Не игнорировать пробельные символы при обнаружении перемещений. Этот параметр можно использовать для переопределения настроек конфигурации. То же, что и --color-moved-ws=no.

По умолчанию слова разделяются пробельными символами; см. описание --word-diff-regex ниже. <mode> по умолчанию равен plain и должен быть одним из следующих значений:

Обратите внимание: несмотря на название первого режима, во всех режимах для выделения измененных частей используется цвет, если он включен.

Параметр --word-diff берет тот же построчный diff, который создается без этого параметра, и вычисляет изменения пословно внутри каждого фрагмента. Это может привести к diff большего размера, чем при использовании специальной утилиты для сравнения слов. Если в будущем Git получит другую реализацию, вывод может измениться. Обратите внимание, что это похоже на параметр --diff-algorithm, который также может изменить вывод.

Использовать <regex> для определения слова вместо того, чтобы считать словом последовательность символов без пробелов. Также подразумевает --word-diff, если этот параметр еще не включен.

Каждое неперекрывающееся совпадение с <regex> считается словом. Все, что находится между такими совпадениями, считается пробельными символами и игнорируется (!) при поиске различий. Возможно, потребуется добавить |[^[:space:]] к регулярному выражению, чтобы оно совпадало со всеми символами, кроме пробельных. Совпадение, содержащее символ новой строки, без предупреждения обрезается (!) на этом символе.

Например, --word-diff-regex=. будет считать каждый символ отдельным словом и, соответственно, показывать различия посимвольно.

Регулярное выражение также можно задать с помощью драйвера diff или параметра конфигурации; см. gitattributes[5] или git-config[1]. Явно заданное выражение переопределяет любые настройки драйвера diff или конфигурации. Драйверы diff переопределяют настройки конфигурации.

Эквивалентно --word-diff=color и, если указано регулярное выражение, --word-diff-regex=<regex>.

Отключить обнаружение переименований, даже если в файле конфигурации оно включено по умолчанию.

Определяет, следует ли использовать пустые blob-объекты в качестве источника переименования.

Предупреждать, если изменения вносят маркеры конфликтов или ошибки в пробелах. То, что считается ошибками в пробелах, определяется конфигурацией core.whitespace. По умолчанию ошибками в пробелах считаются конечные пробелы (включая строки, состоящие только из пробелов), а также пробел, за которым непосредственно следует символ табуляции внутри начального отступа строки. Завершать работу с ненулевым кодом, если обнаружены проблемы. Несовместимо с --exit-code.

Подсвечивать ошибки в пробелах в строках context, old или new разностного файла. Несколько значений разделяются запятыми, none сбрасывает предыдущие значения, default сбрасывает список до new, а all — это сокращение для old,new,context. Если этот параметр не указан и переменная конфигурации diff.wsErrorHighlight не задана, подсвечиваются только ошибки в пробелах в строках new. Ошибки в пробелах выделяются цветом color.diff.whitespace.

При создании вывода в формате патча показывать в строке «index» полные имена объектов blob до и после изменения вместо первых нескольких символов.

В дополнение к --full-index выводить двоичную разность, которую можно применить с помощью git-apply. Подразумевает --patch.

Вместо полного 40-байтового шестнадцатеричного имени объекта в выводе формата diff-raw и строках заголовка diff-tree показывать кратчайший префикс длиной не менее <n> шестнадцатеричных цифр, однозначно указывающий на объект. В формате вывода diff-patch параметр --full-index имеет более высокий приоритет: если указан --full-index, будут показаны полные имена blob независимо от --abbrev. Число цифр, отличное от значения по умолчанию, можно задать с помощью --abbrev=<n>.

Разбивать полные перезаписи на пары удаления и создания. Это нужно для двух целей:

Параметр влияет на то, как представляется изменение, равносильное полной перезаписи файла: не как последовательность перемешанных удалений и вставок с несколькими строками, случайно совпадающими текстуально и используемыми в качестве контекста, а как одно удаление всего старого содержимого с последующей вставкой всего нового. Число <m> управляет этим аспектом параметра -B (по умолчанию 60%). Значение -B/70% означает, что для того, чтобы Git счёл изменение полной перезаписью, в результате должно остаться менее 30% исходного содержимого (в противном случае результирующий патч будет представлять собой последовательность перемешанных удалений и вставок со строками контекста).

При использовании вместе с -M полностью перезаписанный файл также считается источником переименования (обычно -M считает источником переименования только исчезнувший файл), а число <n> управляет этим аспектом параметра -B (по умолчанию 50%). Значение -B20% означает, что изменение, при котором добавления и удаления затрагивают 20% или более размера файла, может быть выбрано в качестве возможного источника переименования в другой файл.

Обнаруживать переименования. Если задано <n>, оно определяет порог индекса сходства (то есть объём добавлений и удалений относительно размера файла). Например, -M90% означает, что Git должен считать пару удаление/добавление переименованием, если более 90% файла не изменилось. Если знак % отсутствует, число следует читать как дробь с десятичной точкой перед ним. То есть -M5 становится 0.5 и, таким образом, эквивалентно -M50%. Аналогично, -M05 эквивалентно -M5%. Чтобы ограничить обнаружение только точными переименованиями, используйте -M100%. Индекс сходства по умолчанию равен 50%.

Обнаруживать копирования, а также переименования. См. также --find-copies-harder. Если задано <n>, оно имеет то же значение, что и для -M<n>.

Для повышения производительности по умолчанию параметр -C обнаруживает копирования только в том случае, если исходный файл копии был изменён в том же наборе изменений. Этот флаг заставляет команду проверять неизменённые файлы на предмет возможного источника копирования. Для больших проектов эта операция обходится очень дорого, поэтому используйте её с осторожностью. Несколько указаний параметра -C имеют тот же эффект.

Не выводить исходное содержимое для удалений, то есть печатать только заголовок, но не разность между исходным содержимым и /dev/null. Полученный патч не предназначен для применения с помощью patch или git apply; этот параметр нужен только тем, кто хочет сосредоточиться на просмотре текста после изменения. Кроме того, в выводе заведомо недостаточно информации для применения такого патча в обратном порядке, даже вручную, отсюда и название параметра.

При использовании вместе с -B не выводить также исходное содержимое в части удаления пары удаление/создание.

Параметры -M и -C включают некоторые предварительные этапы, позволяющие с небольшими затратами обнаружить отдельные переименования и копирования, после чего выполняется исчерпывающая проверка: все оставшиеся несопоставленные файлы назначения сравниваются со всеми подходящими источниками. (Для переименований подходят только оставшиеся несопоставленные источники; для копирований подходят все исходные источники.) Для N источников и назначений такая исчерпывающая проверка имеет сложность O(N^2). Этот параметр предотвращает запуск исчерпывающей части обнаружения переименований и копирований, если количество задействованных файлов-источников и файлов-назначений превышает указанное значение. По умолчанию используется diff.renameLimit. Обратите внимание: значение 0 трактуется как отсутствие ограничений.

Выбирать только файлы, которые были добавлены (A), скопированы (C), удалены (D), изменены (M), переименованы (R), чей тип (то есть обычный файл, символическая ссылка, подмодуль и т. д.) изменился (T), не объединены (U), имеют неизвестный статус (X) или чьё сопоставление было нарушено (B). Можно использовать любую комбинацию символов фильтра (в том числе пустую). Если к комбинации добавлен * (все или ни одного), выбираются все пути, если при сравнении найдётся хотя бы один файл, соответствующий другим критериям; если таких файлов нет, не выбирается ничего.

Кроме того, эти заглавные буквы можно заменить строчными, чтобы исключить соответствующие типы. Например, --diff-filter=ad исключает добавленные и удалённые пути.

Обратите внимание, что в некоторых разностях могут присутствовать не все типы. Например, записи о копировании и переименовании не могут появиться, если обнаружение этих типов отключено.

Искать различия, изменяющие количество вхождений указанной <string> (то есть добавления или удаления) в файле. Предназначено для использования в скриптах.

Это полезно, если вы ищете точный блок кода (например, структуру) и хотите узнать историю этого блока с момента его появления: используйте эту возможность итеративно, передавая интересующий блок из исходного содержимого обратно в -S, и продолжайте, пока не получите самую первую версию блока.

Поиск выполняется также в двоичных файлах.

Искать различия, в тексте патча которых есть добавленные или удалённые строки, соответствующие <regex>.

Чтобы показать разницу между -S<regex> --pickaxe-regex и -G<regex>, рассмотрим коммит со следующей разностью в том же файле:

+    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].

Искать различия, изменяющие количество вхождений указанного объекта. Аналогично -S, но аргумент отличается: поиск выполняется не по конкретной строке, а по идентификатору конкретного объекта.

Объектом может быть blob или коммит подмодуля. В параметре git-log подразумевается параметр -t, позволяющий также находить деревья.

Если -S или -G обнаруживает изменение, показывать все изменения в этом наборе изменений, а не только файлы, содержащие изменение в <string>.

Рассматривать переданный параметру -S аргумент <string> как расширенное регулярное выражение POSIX для поиска совпадений.

Управлять порядком файлов в выводе. Этот параметр переопределяет переменную конфигурации diff.orderFile (см. git-config[1]). Чтобы отменить действие diff.orderFile, используйте -O/dev/null.

Порядок вывода определяется порядком шаблонов glob в <orderfile>. Сначала выводятся все файлы, имена путей которых соответствуют первому шаблону, затем — все файлы, имена путей которых соответствуют второму шаблону (но не первому), и так далее. В конце выводятся все файлы, имена путей которых не соответствуют ни одному шаблону, как если бы в конце файла находился неявный шаблон, соответствующий всему. Если несколько имён путей имеют одинаковый приоритет (соответствуют одному и тому же шаблону, но не более ранним шаблонам), относительный порядок их вывода остаётся обычным.

Файл <orderfile> разбирается следующим образом:

Шаблоны имеют тот же синтаксис и семантику, что и шаблоны для fnmatch(3) без флага FNM_PATHNAME, за исключением того, что имя пути также соответствует шаблону, если после удаления любого количества конечных компонентов пути оно соответствует этому шаблону. Например, шаблон «foo*bar» соответствует «fooasdfbar» и «foo/bar/baz/asdf», но не «foobarx».

Исключать из вывода файлы, предшествующие указанному <file> (то есть skip to), или перемещать их в конец вывода (то есть rotate to). Эти параметры были созданы главным образом для команды git difftool и вряд ли будут полезны в других случаях.

Менять местами два входных аргумента, то есть показывать различия между индексом или файлом на диске и содержимым дерева.

При запуске из подкаталога проекта этот параметр позволяет исключить изменения за его пределами и выводить имена путей относительно него. Если вы находитесь не в подкаталоге (например, в голом репозитории), можно указать подкаталог, относительно которого следует формировать вывод, передав <path> в качестве аргумента. Параметр --no-relative позволяет отменить действие как параметра конфигурации diff.relative, так и предыдущего параметра --relative.

Считать все файлы текстовыми.

При сравнении игнорировать возврат каретки в конце строки.

Игнорировать изменения пробелов в конце строки.

Игнорировать изменения количества пробельных символов. При этом игнорируются пробелы в конце строки, а все остальные последовательности из одного или нескольких пробельных символов считаются эквивалентными.

Игнорировать пробелы при сравнении строк. Различия игнорируются, даже если в одной строке есть пробельные символы, а в другой их нет.

Игнорировать изменения, все строки которых пусты.

Игнорировать изменения, если все их строки соответствуют <regex>. Этот параметр можно указывать несколько раз.

Показывать контекст между фрагментами разности, не более указанного <number> строк, объединяя тем самым близко расположенные фрагменты. По умолчанию используется diff.interHunkContext или 0, если параметр конфигурации не задан.

Показывать всю функцию в качестве строк контекста для каждого изменения. Имена функций определяются так же, как git diff формирует заголовки фрагментов патча (см. раздел «Определение пользовательского заголовка фрагмента» в gitattributes[5]).

Завершать работу программы с кодами, аналогичными кодам diff(1). То есть возвращать 1, если обнаружены различия, и 0, если различий нет.

Отключить весь вывод программы. Подразумевает --exit-code. Запрещает выполнение внешних помощников для сравнения, коду завершения которых нельзя доверять, то есть если соответствующий параметр конфигурации diff.trustExitCode или diff.<driver>.trustExitCode либо переменная среды GIT_EXTERNAL_DIFF_TRUST_EXIT_CODE имеет значение false.

Разрешить запуск внешнего помощника для сравнения. Если вы задали внешний драйвер сравнения с помощью gitattributes[5], этот параметр нужно использовать с git-log[1] и аналогичными командами.

Запретить внешние драйверы сравнения.

Разрешить (или запретить) запуск внешних фильтров преобразования текста при сравнении двоичных файлов. Подробнее см. в gitattributes[5]. Поскольку фильтры textconv обычно выполняют одностороннее преобразование, полученная разность удобна для чтения человеком, но не может быть применена. По этой причине фильтры textconv по умолчанию включены только для git-diff[1] и git-log[1], но не для git-format-patch[1] или низкоуровневых команд для работы с разностями.

Игнорировать изменения подмодулей при создании разности. Значение all используется по умолчанию. При использовании none подмодуль считается изменённым, если он содержит неотслеживаемые или изменённые файлы либо его HEAD отличается от коммита, записанного в суперпроекте; этот параметр можно использовать для переопределения любых настроек параметра ignore в git-config[1] или gitmodules[5]. При использовании untracked подмодули не считаются изменёнными, если содержат только неотслеживаемое содержимое (однако проверка на наличие изменённого содержимого всё равно выполняется). При использовании dirty игнорируются все изменения рабочего дерева подмодулей, и отображаются только изменения коммитов, сохранённых в суперпроекте (такое поведение использовалось до версии 1.7.0). При использовании all скрываются все изменения подмодулей.

Показывать указанный префикс источника <prefix> вместо «a/».

Показывать указанный префикс назначения <prefix> вместо «b/».

Не показывать префиксы источника и назначения.

Использовать стандартные префиксы источника и назначения («a/» и «b/»). Переопределяет такие переменные конфигурации, как diff.noprefix, diff.srcPrefix, diff.dstPrefix и diff.mnemonicPrefix (см. git-config[1]).

Добавлять указанный <prefix> в начало каждой строки вывода.

По умолчанию записи, добавленные командой git add -N, отображаются как существующий пустой файл в git diff и как новый файл в git diff --cached. Этот параметр заставляет отображать запись как новый файл в git diff и как несуществующую в git diff --cached. Это поведение можно отменить с помощью --ita-visible-in-index. Оба параметра являются экспериментальными и могут быть удалены в будущем.

Для каждого pathspec, указанного в командной строке, спускаться не более чем на <depth> уровней каталогов. Значение -1 означает отсутствие ограничений. Нельзя сочетать с подстановочными знаками в pathspec. Для дерева, содержащего foo/bar/baz, в следующем списке показаны совпадения, полученные для каждого набора параметров:

Если pathspec не указан, глубина измеряется так, как если бы были заданы все записи верхнего уровня. Обратите внимание, что это отличается от измерения от корня: --max-depth=0 по-прежнему вернёт foo. Это позволяет ограничить глубину, запрашивая подмножество записей верхнего уровня.

Обратите внимание, что этот параметр поддерживается только для различий между объектами дерева, но не для сравнения с индексом или рабочим деревом.

Идентификатор объекта дерева.

Если задан, результаты ограничиваются подмножеством файлов, соответствующих одному из указанных pathspec.

Рекурсивно обходить поддеревья.

Показывать саму запись дерева, а также поддеревья. Подразумевает -r.

Если указан --root, начальный коммит будет показан как крупное событие создания. Это эквивалентно сравнению с NULL-деревом.

Вместо непосредственного сравнения <tree-ish> используется база слияния двух <tree-ish> в качестве стороны «до». Необходимо указать два <tree-ish>, и оба должны быть коммитами.

Если указан --stdin, команда не принимает аргументы <tree-ish> из командной строки. Вместо этого она считывает из стандартного ввода строки, содержащие либо два <tree>, либо один <commit>, либо список <commit>. (В качестве разделителя используется один пробел.)

Если указаны два дерева, команда сравнивает первое дерево со вторым. Если указан один коммит, команда сравнивает коммит с его родителями. Остальные указанные коммиты используются так, как если бы они были родителями первого коммита.

При сравнении двух деревьев перед различиями выводятся идентификаторы обоих деревьев (разделённые пробелом и завершаемые символом новой строки). При сравнении коммитов выводится идентификатор первого (или единственного) коммита, за которым следует символ новой строки.

Следующие флаги дополнительно влияют на поведение при сравнении коммитов (но не деревьев).

По умолчанию git diff-tree --stdin не показывает различия для коммитов слияния. С этим флагом показываются различия между данным коммитом и каждым из его родителей. См. также -c.

По умолчанию git diff-tree --stdin показывает различия: либо в машиночитаемом формате (без -p), либо в виде патча (с -p). Этот вывод можно подавить. Он полезен только с флагом -v.

Этот флаг заставляет git diff-tree --stdin также показывать сообщение коммита перед различиями.

Выводить содержимое журналов коммитов в заданном формате; <format> может принимать одно из значений: oneline, short, medium, full, fuller, reference, email, raw, format:<string> и tformat:<string>. Если <format> не соответствует ни одному из перечисленных значений и содержит %<placeholder>, он действует так, как если бы было задано --pretty=tformat:<format>.

Дополнительные сведения о каждом формате см. в разделе «ФОРМАТЫ ВЫВОДА». Если часть =<format> опущена, по умолчанию используется medium.

Вместо полного 40-байтового шестнадцатеричного имени объекта коммита показывать префикс, однозначно идентифицирующий объект. Параметр --abbrev=<n> (который также изменяет вывод различий, если он отображается) позволяет указать минимальную длину префикса.

Это должно сделать вывод --pretty=oneline гораздо более удобным для чтения на терминалах шириной 80 столбцов.

Показывать полное 40-байтовое шестнадцатеричное имя объекта коммита. Этот параметр отменяет действие --abbrev-commit, заданного явно или подразумеваемого другими параметрами, например --oneline. Он также переопределяет переменную log.abbrevCommit.

Это сокращение для совместного использования --pretty=oneline --abbrev-commit.

В объектах коммитов в заголовке кодировки записывается кодировка символов, использованная для сообщения журнала; этот параметр позволяет указать команде перекодировать сообщение журнала коммита в кодировку, предпочитаемую пользователем. Для неп plumbing-команд по умолчанию используется UTF-8. Обратите внимание: если объект объявлен закодированным в X, а вывод выполняется в X, объект будет выведен без изменений; это означает, что недопустимые последовательности исходного коммита могут попасть в вывод. Аналогично, если iconv(3) не сможет преобразовать коммит, исходный объект будет выведен без изменений и без сообщения об ошибке.

Перед выводом сообщения журнала выполнять раскрытие табуляции (заменять каждый символ табуляции достаточным количеством пробелов, чтобы перейти к следующему столбцу отображения, кратному <n>). --expand-tabs — сокращение для --expand-tabs=8, а --no-expand-tabs — сокращение для --expand-tabs=0, отключающего раскрытие табуляции.

По умолчанию символы табуляции раскрываются в форматах вывода, которые добавляют к сообщению журнала отступ в 4 пробела (т. е. в medium, используемом по умолчанию, full и fuller).

Показывать заметки (см. git-notes[1]), аннотированные к коммиту, при выводе сообщения журнала коммита. Это поведение по умолчанию для команд git log, git show и git whatchanged, если в командной строке не задан параметр --pretty, --format или --oneline.

По умолчанию показываются заметки из ссылок на заметки, перечисленных в переменных 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», так и из ссылок на заметки по умолчанию.

Не показывать заметки. Этот параметр отменяет действие указанного выше параметра --notes, сбрасывая список ссылок на заметки, из которых они выводятся. Параметры обрабатываются в порядке, заданном в командной строке, поэтому, например, «--notes --notes=foo --no-notes --notes=bar» покажет заметки только из refs/notes/bar.

Показывать заметки по умолчанию, если не заданы параметры для отображения определённых заметок.

Эти параметры устарели. Вместо них используйте указанные выше параметры --notes/--no-notes.

Проверить корректность подписанного объекта коммита, передав подпись команде gpg --verify, и показать результат.

Когда это применимо, git diff-tree выводит строку с идентификатором коммита. Этот флаг подавляет вывод идентификатора коммита.

Этот флаг изменяет способ отображения коммита слияния (поэтому он полезен только тогда, когда команде передан один <tree-ish> или --stdin). Он одновременно показывает различия между результатом слияния и каждым из родителей, вместо того чтобы поочерёдно показывать попарные различия между родителем и результатом (так работает параметр -m). Кроме того, выводятся только файлы, изменённые относительно всех родителей.

Этот флаг изменяет способ отображения патча коммита слияния аналогично параметру -c. Он подразумевает параметры -c и -p, а также дополнительно сжимает вывод патча, опуская несущественные фрагменты, содержимое которых у родителей имеет только два варианта, а результат слияния без изменений выбирает один из них. Если все фрагменты несущественны, сам коммит и сообщение журнала коммита не показываются, как и в любом другом случае «пустого различия».

Этот флаг заставляет объединённые различия (используемые для коммитов слияния) выводить имя файла для всех родителей. Поэтому он действует только при указании -c или --cc и, вероятно, полезен только при обнаружении изменений имён файлов (то есть если запрошено обнаружение переименований или копирований).

Показывать сам коммит и сообщение журнала коммита, даже если различия отсутствуют.

<hash> <title-line>

Этот формат разработан так, чтобы быть как можно более компактным.

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

Этот формат используется для ссылки на другой коммит в сообщении коммита и совпадает с --pretty='format:%C(auto)%h (%s, %ad). По умолчанию дата форматируется с помощью --date=short, если явно не задан другой параметр --date. Как и в случае с любым format: с заполнителями формата, на вывод не влияют другие параметры, такие как --decorate и --walk-reflogs.

Как и email, но строки сообщения коммита, начинающиеся с "From " (с нулём или несколькими символами ">" перед ними), цитируются с помощью ">", чтобы их не приняли за начало нового коммита.

Формат raw показывает коммит целиком, в точности так, как он хранится в объекте коммита. В частности, хеши выводятся полностью независимо от того, используются ли --abbrev или --no-abbrev, а сведения parents показывают фактические родительские коммиты, не учитывая подмены истории или её упрощение. Обратите внимание, что этот формат влияет на способ отображения коммитов, но не на способ отображения разницы, например с помощью git log --raw. Чтобы получить полные имена объектов в формате raw diff, используйте --no-abbrev.

Формат format:<format-string> позволяет указать, какие сведения требуется показать. Он работает примерно как формат printf, за заметным исключением: вместо \n для перехода на новую строку используется %n.

Например, 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.<<

Доступны следующие заполнители:

Формат tformat: работает точно так же, как format:, за исключением того, что вместо семантики «разделителя» используется семантика «терминатора». Иными словами, к каждому коммиту добавляется символ-терминатор сообщения (обычно перевод строки), а не разделитель между записями. Это означает, что последняя запись однострочного формата будет корректно завершена переводом строки, как и в формате «oneline». Например:

$ 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

сравнивает <tree-ish> и файлы в файловой системе.

сравнивает <tree-ish> и индекс.

сравнивает деревья, указанные двумя аргументами.

сравнивает индекс и файлы в файловой системе.