git-show

Имена отображаемых объектов (по умолчанию — HEAD). Полный список способов указания имён объектов см. в разделе «УКАЗАНИЕ РЕВИЗИЙ» на странице gitrevisions[7].

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

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

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

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

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

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

В объектах коммитов кодировка, использованная для сообщения журнала, указывается в заголовке кодировки; этот параметр позволяет указать команде перекодировать сообщение журнала коммита в кодировку, предпочитаемую пользователем. Для команд, не относящихся к низкоуровневым, по умолчанию используется 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.

По умолчанию показываются примечания из ссылок notes, перечисленных в переменных 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, из которых показываются примечания. Параметры обрабатываются в том порядке, в котором они указаны в командной строке, поэтому, например, «--notes --notes=foo --no-notes --notes=bar» покажет примечания только из refs/notes/bar.

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

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

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

<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 показывают настоящие родительские коммиты, не учитывая grafts или упрощение истории. Обратите внимание: этот формат влияет на отображение коммитов, но не на отображение diff, например при использовании git log --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

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

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

Показывать различия для коммитов слияния в формате по умолчанию. Это похоже на --diff-merges=on, за исключением того, что -m не выведет ничего, если также не задан параметр -p.

Создать объединённый вывод различий для коммитов слияния. Сокращение для --diff-merges=combined -p.

Создать плотный объединённый вывод различий для коммитов слияния. Сокращение для --diff-merges=dense-combined -p.

Создать различия относительно первого родителя как для коммитов слияния, так и для обычных коммитов. Сокращение для --diff-merges=first-parent -p.

Создать вывод remerge-diff для коммитов слияния. Сокращение для --diff-merges=remerge -p.

Синоним для --diff-merges=off.

Указать формат различий для коммитов слияния. По умолчанию используется `dense-combined`, если не задействован --first-parent; в этом случае по умолчанию используется first-parent.

Поддерживаются следующие форматы:

Вывод, создаваемый при использовании этого параметра, может измениться; то же относится и к его взаимодействию с другими параметрами (если иное не указано явно).

Включить в объединённые различия (используемые для коммитов слияния) имена файлов из всех родителей. Поэтому этот параметр действует только при использовании --diff-merges=[dense-]combined и, вероятно, полезен только при обнаружении изменений имён файлов (то есть, если включено обнаружение переименований или копирований).

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

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

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

Для каждого коммита показывать сводку изменений в исходном формате различий. См. раздел «ФОРМАТ НЕОБРАБОТАННОГО ВЫВОДА» в git-diff[1]. Это отличается от вывода самого журнала в необработанном формате, который можно получить с помощью --format=raw.

Синоним для -p --raw.

Показывать объекты деревьев в выводе различий.

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

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

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

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

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

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

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

Если строка есть и в исходном, и в целевом файле, встречается только один раз и начинается с <text>, этот алгоритм пытается не допустить её появления в выводе в качестве удалённой или добавленной. Внутри он использует алгоритм «patience 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.

Разделять коммиты символами NUL, а не символами новой строки.

Кроме того, если задан параметр --raw или --numstat, не изменять имена путей и использовать символы 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.submodule или формат short, если параметр конфигурации не задан.

Показывать цветные различия. --color (то есть без =<when>) эквивалентен --color=always. Значением <when> может быть always, never или auto.

Отключить цветной вывод различий. Эквивалентен --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>.

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

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

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

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

При создании вывода в формате patch вместо первых нескольких символов показывать полные имена объектов-блобов до и после изменения в строке "index".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поиск выполняется и в бинарных файлах.

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

Чтобы показать разницу между -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, patch бинарных файлов без фильтра textconv будут игнорироваться.

Дополнительные сведения см. в разделе pickaxe документации gitdiffcore[7].

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

Объектом может быть блоб или коммит подмодуля. Этот параметр подразумевает параметр -t в git-log, чтобы также находить деревья.

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

Обрабатывать <string>, переданное параметру -S, как расширенное регулярное выражение 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>. Этот параметр можно указывать несколько раз.

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

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

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

Запретить использование внешних драйверов diff.

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

Игнорировать изменения подмодулей при создании diff. По умолчанию используется 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. Это позволяет ограничить глубину, запрашивая при этом подмножество элементов верхнего уровня.

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

Показывает тег v1.0.0 вместе с объектом, на который указывает тег.

Показывает дерево, на которое указывает тег v1.0.0.

Показывает тему коммита, на который указывает тег v1.0.0.

Показывает содержимое файла Documentation/README в том виде, в каком оно было в десятом коммите от конца ветки next.

Объединяет содержимое указанных Makefile из вершины ветки master.