git-log

Продолжать вывод истории файла после его переименования (работает только для одного файла).

Выводить имена ссылок для всех показываемых коммитов. Возможные значения:

Параметр --decorate является сокращением для --decorate=short. Если задано значение настройки log.decorate, оно используется по умолчанию; в противном случае используется auto.

Для каждой подходящей ссылки не использовать её для декорирования, если она соответствует любому из параметров <pattern>, переданных --decorate-refs-exclude, или не соответствует ни одному из параметров <pattern>, переданных --decorate-refs. Параметр настройки log.excludeDecoration позволяет исключать ссылки из декорирования, однако явно заданный шаблон --decorate-refs имеет приоритет над совпадением с log.excludeDecoration.

Если ни один из этих параметров или настроек не задан, ссылки используются для декорирования, если они соответствуют HEAD, refs/heads/, refs/remotes/, refs/stash/ или refs/tags/.

Если указан этот параметр, он сбрасывает все предыдущие параметры --decorate-refs или --decorate-refs-exclude и ослабляет фильтр декорирования по умолчанию, включая в него все ссылки. Этот параметр предполагается заданным, если для настройки log.initialDecorationSet установлено значение all.

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

Использовать файл mailmap для сопоставления имён и адресов электронной почты автора и коммитера с их каноническими настоящими именами и адресами электронной почты. См. git-shortlog[1].

Без этого флага git log -p <path>... показывает коммиты, затрагивающие указанные пути, и различия только для этих же путей. С этим флагом для коммитов, затрагивающих указанные пути, показывается полное сравнение; это означает, что «<path>...» ограничивает только список коммитов, но не вывод различий для этих коммитов.

Обратите внимание, что это влияет на все типы вывода, основанные на различиях, например создаваемые с помощью --stat и т. д.

Для каждого коммита включать в вывод строку log size <number>, где <number> — длина сообщения этого коммита в байтах. Предназначено для ускорения работы инструментов, считывающих сообщения журнала из вывода git log, позволяя им заранее выделять память.

Отслеживать историю заданного диапазона строк <start>,<end> или имени функции, заданного регулярным выражением <funcname>, в файле <file>. Указывать ограничители pathspec нельзя. В настоящее время поддерживается только обход, начинающийся с одной ревизии: можно указать ноль или один положительный аргумент-ревизию, а <start> и <end> (или <funcname>) должны существовать в начальной ревизии. Этот параметр можно указывать несколько раз. Подразумевает --patch. Вывод патчей можно отключить с помощью --no-patch. Поддерживаются форматы diff без патчей: --raw, --name-only, --name-status и --summary. Форматы статистики diff (--stat, --numstat, --shortstat, --dirstat) пока не реализованы.

Поддерживаются параметры форматирования патчей, такие как --word-diff, --color-moved, --no-prefix, и параметры обработки пробелов (-w, -b), а также параметры pickaxe (-S, -G) и --diff-filter.

<start> и <end> могут иметь один из следующих форматов:

Если вместо <start> и <end> указан :<funcname>, это регулярное выражение, задающее диапазон от первой строки с именем функции, соответствующей <funcname>, до следующей строки с именем функции. Поиск по :<funcname> выполняется от конца предыдущего диапазона -L, если он есть, иначе — от начала файла. Поиск по ^:<funcname> выполняется от начала файла. Имена функций определяются так же, как при формировании заголовков фрагментов патча с помощью git diff (см. Defining a custom hunk-header в gitattributes[5]).

Показывать только коммиты из указанного диапазона ревизий. Если <revision-range> не задан, по умолчанию используется HEAD (то есть вся история, ведущая к текущему коммиту). origin..HEAD задаёт все коммиты, достижимые от текущего коммита (то есть HEAD), но не от origin. Полный список способов записи <revision-range> см. в разделе Specifying Ranges страницы gitrevisions[7].

Показывать только коммиты, необходимые для объяснения того, как появились файлы, соответствующие указанным путям. Подробнее см. ниже в разделе History Simplification, где также описаны другие режимы упрощения.

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

<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. Чтобы получить полные имена объектов в формате необработанной разницы, используйте --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).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для каждого коммита показывать сводку изменений в формате raw diff. См. раздел «RAW OUTPUT FORMAT» в git-diff[1]. Это отличается от вывода самого журнала в формате raw, который можно получить с помощью --format=raw.

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

Показывать объекты дерева в выводе diff.

Включить эвристику, которая сдвигает границы фрагментов 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.

Разделять коммиты символами 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. В этом формате перечисляются коммиты в диапазоне, как это делает git-submodule[1] summary. Если указан --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>.

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

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

Предупреждать, если изменения добавляют маркеры конфликтов или ошибки в пробелах. Понятие ошибок в пробелах определяется настройкой 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 должен считать пару удаления/добавления переименованием, если более 90% файла не изменилось. Если перед числом нет знака %, его следует читать как дробь с десятичной точкой перед числом. То есть -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). Можно использовать любую комбинацию символов фильтра (включая пустую). Если к комбинации добавлено * (All-or-none), выбираются все пути, если в сравнении есть хотя бы один файл, соответствующий остальным критериям; если ни один файл не соответствует остальным критериям, ничего не выбирается.

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

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

Если команда запущена из подкаталога проекта, этот параметр позволяет исключить изменения за пределами каталога и показывать пути относительно него. Если вы находитесь не в подкаталоге (например, в bare-репозитории), можно указать подкаталог, относительно которого нужно формировать вывод, передав <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. Оба параметра являются экспериментальными и могут быть удалены в будущем.

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

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

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

Показать всю историю коммитов, пропуская слияния

Показать все коммиты начиная с версии v2.6.12, в которых изменялся какой-либо файл в подкаталогах include/scsi или drivers/scsi

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

Показать коммиты, которые есть в ветке «test», но ещё отсутствуют в ветке «release», а также список путей, изменённых каждым коммитом.

Показать коммиты, в которых изменялся builtin/rev-list.c, в том числе коммиты, созданные до того, как файлу присвоили его нынешнее имя.

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

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

Показать историю вместе с diff изменений, но только с точки зрения «основной ветки», пропуская коммиты из слитых веток и показывая полный diff изменений, внесённых слияниями. Это имеет смысл только при строгой политике слияния всех тематических веток, когда работа ведётся в одной интеграционной ветке.

Показать, как со временем менялась функция main() в файле main.c.

Ограничить количество отображаемых коммитов тремя.

Значение по умолчанию для параметра --format. (См. выше раздел Pretty Formats.) По умолчанию используется medium.

Кодировка, используемая при отображении журналов. (См. выше раздел Discussion.) По умолчанию используется значение i18n.commitEncoding, если оно задано, и UTF-8 в противном случае.

Если true, то git-log[1], git-show[1] и git-whatchanged[1] считают, что задано --abbrev-commit. Этот параметр можно переопределить с помощью --no-abbrev-commit.

Задаёт режим даты и времени по умолчанию для команды log. Задание значения для log.date аналогично использованию параметра git log --date. Подробности см. в git-log[1].

Если задан формат "auto:foo" и используется пейджер, для даты будет применён формат "foo". В противном случае будет использоваться "default".

Выводит имена ссылок для всех коммитов, отображаемых командой log. Возможные значения:

Это эквивалентно параметру --decorate команды git log.

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

Исключает указанные шаблоны из украшений журнала. Это похоже на параметр командной строки --decorate-refs-exclude, но параметр конфигурации можно переопределить параметром --decorate-refs.

Задаёт формат diff, используемый при указании --diff-merges=on; подробности см. в разделе --diff-merges в git-log[1]. По умолчанию используется separate.

Если true, git log будет вести себя так, как если бы был указан параметр --follow, когда задан один <path>. Это имеет те же ограничения, что и --follow: например, этот параметр нельзя использовать для отслеживания нескольких файлов, и он плохо работает с нелинейной историей.

Список цветов, разделённых запятыми, которые можно использовать для отрисовки линий истории в git log --graph.

Если значение истинно, начальный коммит будет показан как крупное событие создания. Это эквивалентно diff с пустым деревом. Такие инструменты, как git-log[1] или git-whatchanged[1], которые обычно скрывают корневой коммит, теперь будут его показывать. По умолчанию значение истинно.

Если значение истинно, команды git-log[1], git-show[1] и git-whatchanged[1] считают, что задано --show-signature.

Если значение истинно, команды git-log[1], git-show[1] и git-whatchanged[1] считают, что задано --use-mailmap, в противном случае — что задано --no-use-mailmap. По умолчанию значение истинно.

Стратегия слияния, выбираемая по умолчанию при разрешении конфликтов заметок. Должна быть одной из следующих: manual, ours, theirs, union или cat_sort_uniq. По умолчанию используется manual. Дополнительные сведения о каждой стратегии см. в разделе «СТРАТЕГИИ СЛИЯНИЯ ЗАМЕТОК» справки git-notes[1].

Эту настройку можно переопределить, передав параметр --strategy команде git-notes[1].

Стратегия слияния, выбираемая при слиянии заметок в refs/notes/<name>. Переопределяет более общую настройку notes.mergeStrategy. Дополнительные сведения о доступных стратегиях см. в разделе «СТРАТЕГИИ СЛИЯНИЯ ЗАМЕТОК» справки git-notes[1].

Ссылка (или ссылки, если задан шаблон glob или параметр указан несколько раз), из которой следует считывать заметки при отображении сообщений коммитов с помощью команд семейства git log, помимо набора по умолчанию, заданного параметром core.notesRef или GIT_NOTES_REF.

Эту настройку можно переопределить с помощью переменной окружения GIT_NOTES_DISPLAY_REF, значение которой должно быть списком ссылок или шаблонов glob, разделённых двоеточиями.

Для несуществующих ссылок будет выдано предупреждение, но шаблон glob, которому не соответствует ни одна ссылка, будет молча проигнорирован.

Эту настройку можно отключить параметром --no-notes команд семейства git-log[1] или параметром --notes=<ref>, принимаемым этими командами.

Действующее значение core.notesRef (возможно, переопределённое параметром GIT_NOTES_REF) также неявно добавляется в список отображаемых ссылок.

При переписывании коммитов с помощью <command> (в настоящее время amend или rebase), если этой переменной присвоено значение false, git не будет копировать заметки из исходного коммита в переписанный. По умолчанию используется true. См. также раздел notes.rewriteRef ниже.

Эту настройку можно переопределить с помощью переменной окружения GIT_NOTES_REWRITE_REF, значение которой должно быть списком ссылок или шаблонов glob, разделённых двоеточиями.

При копировании заметок во время переписывания (см. параметр notes.rewrite.<command>) определяет, что делать, если у целевого коммита уже есть заметка. Должно быть задано одно из значений: overwrite, concatenate, cat_sort_uniq или ignore. По умолчанию используется concatenate.

Эту настройку можно переопределить с помощью переменной окружения GIT_NOTES_REWRITE_MODE.

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

Значение по умолчанию отсутствует; чтобы включить переписывание заметок, необходимо настроить эту переменную. Задайте ей значение refs/notes/commits, чтобы включить переписывание заметок для коммитов по умолчанию.

Значение можно переопределить с помощью переменной окружения GIT_NOTES_REWRITE_REF. Дополнительное описание формата см. выше в разделе notes.rewrite.<command>.