git-rev-list

Ограничить вывод первыми <number> коммитами, которые будут показаны.

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

Пропустить <number> коммитов перед началом вывода коммитов.

Показать коммиты, созданные позднее <date>. В особом случае today означает последние полночь.

Показать все коммиты, созданные позднее <date>. Будут просмотрены все коммиты в диапазоне, вместо того чтобы остановиться на первом коммите, созданном раньше <date>.

Показать коммиты, созданные раньше <date>.

Ограничить вывод коммитов указанным временным диапазоном.

Ограничить вывод коммитами, в строках заголовка автора/коммитера которых есть совпадение с регулярным выражением <pattern>. Если указано несколько --author=<pattern>, выбираются коммиты, автор которых совпадает с любым из <pattern> (аналогично для нескольких --committer=<pattern>).

Ограничить вывод коммитами, записи reflog которых соответствуют регулярному выражению <pattern>. Если указано несколько --grep-reflog, выбираются коммиты, сообщение reflog которых соответствует любому из заданных шаблонов. Ошибка возникает, если использовать этот параметр без --walk-reflogs.

Ограничить вывод коммитами, сообщение журнала которых соответствует регулярному выражению <pattern>. Если указано несколько --grep=<pattern>, выбираются коммиты, сообщение которых соответствует любому из <pattern> (но см. --all-match).

Ограничить вывод коммитами, соответствующими всем заданным --grep, а не только коммитами, соответствующими хотя бы одному из них.

Ограничить вывод коммитами, сообщение журнала которых не соответствует регулярному выражению <pattern>, заданному с помощью --grep=<pattern>.

Сопоставлять ограничивающие шаблоны регулярных выражений без учёта регистра.

Считать ограничивающие шаблоны базовыми регулярными выражениями; это поведение по умолчанию.

Считать ограничивающие шаблоны расширенными регулярными выражениями вместо базовых регулярных выражений, используемых по умолчанию.

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

Считать ограничивающие шаблоны регулярными выражениями, совместимыми с Perl.

Поддержка таких типов регулярных выражений является необязательной зависимостью на этапе компиляции. Если Git был скомпилирован без поддержки этих выражений, использование этого параметра приведёт к аварийному завершению.

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

Вывести только коммиты слияния. Это полностью эквивалентно --min-parents=2.

Не выводить коммиты более чем с одним родителем. Это полностью эквивалентно --max-parents=1.

Показывать только коммиты, у которых не меньше (или не больше) указанного числа родительских коммитов. В частности, --max-parents=1 эквивалентно --no-merges, а --min-parents=2 эквивалентно --merges. --max-parents=0 выводит все корневые коммиты, а --min-parents=3 — все коммиты осьминожьего слияния.

--no-min-parents и --no-max-parents снова сбрасывают эти ограничения (то есть снимают их). Эквивалентные формы: --min-parents=0 (у любого коммита может быть 0 или более родителей) и --max-parents=-1 (отрицательные числа означают отсутствие верхнего предела).

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

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

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

Меняет на противоположное значение префикса ^ (или его отсутствия) для всех последующих спецификаторов ревизий до следующего --not. Если этот параметр указан в командной строке перед --stdin, он не повлияет на ревизии, переданные через stdin. И наоборот, если параметр передан через стандартный ввод, он не повлияет на ревизии, переданные в командной строке.

Считать, что все ссылки в refs/, а также HEAD, указаны в командной строке как <commit>.

Считать, что все ссылки в refs/heads указаны в командной строке как <commit>. Если задан <pattern>, ограничить выбор ветками, соответствующими указанному глоб-шаблону оболочки. Если в <pattern> отсутствует ?, * или [, в конце подразумевается /*.

Считать, что все ссылки в refs/tags указаны в командной строке как <commit>. Если задан <pattern>, ограничить выбор тегами, соответствующими указанному глоб-шаблону оболочки. Если в шаблоне отсутствует ?, * или [, в конце подразумевается /*.

Считать, что все ссылки в refs/remotes указаны в командной строке как <commit>. Если задан <pattern>, ограничить выбор ветками отслеживания удалённых репозиториев, соответствующими указанному глоб-шаблону оболочки. Если в шаблоне отсутствует ?, * или [, в конце подразумевается /*.

Считать, что все ссылки, соответствующие глоб-шаблону оболочки <glob-pattern>, указаны в командной строке как <commit>. Если отсутствует начальный refs/, он добавляется автоматически. Если в шаблоне отсутствует ?, * или [, в конце подразумевается /*.

Не включать ссылки, соответствующие <glob-pattern>, которые в противном случае учитывались бы следующим параметром --all, --branches, --tags, --remotes или --glob. Повторные указания этого параметра накапливают шаблоны исключения до следующего параметра --all, --branches, --tags, --remotes или --glob (другие параметры или аргументы не сбрасывают накопленные шаблоны).

При применении к --branches, --tags или --remotes соответствующие шаблоны не должны начинаться с refs/heads, refs/tags или refs/remotes соответственно; при применении к --glob или --all они должны начинаться с refs/. Если требуется завершающий /*, его нужно указать явно.

Не включать ссылки, которые были бы скрыты параметрами git-fetch, git-receive-pack или git-upload-pack, проверяя соответствующие настройки fetch.hideRefs, receive.hideRefs или uploadpack.hideRefs, а также transfer.hideRefs (см. git-config[1]). Этот параметр влияет на следующий параметр псевдоссылки --all или --glob и сбрасывается после их обработки.

Считать, что все объекты, упомянутые в reflog, указаны в командной строке как <commit>.

Считать, что все объекты, упомянутые в качестве вершин ссылок альтернативных репозиториев, указаны в командной строке. Альтернативным является любой репозиторий, каталог объектов которого указан в objects/info/alternates. Набор включённых объектов может быть изменён с помощью core.alternateRefsCommand и т. д. См. git-config[1].

По умолчанию, если рабочих деревьев несколько (см. git-worktree[1]), следующие параметры проверяют их все: --all, --reflog и --indexed-objects. Этот параметр заставляет их проверять только текущее рабочее дерево.

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

Помимо аргументов командной строки, считывать аргументы также из стандартного ввода. Принимаются коммиты и псевдопараметры, такие как --all и --glob=. При обнаружении разделителя -- последующие входные данные рассматриваются как пути и используются для ограничения результата. Флаги, например --not, считываемые из стандартного ввода, учитываются только для аргументов, переданных тем же способом, и не влияют на последующие аргументы командной строки.

Ничего не выводить в стандартный вывод. Эта форма предназначена главным образом для того, чтобы вызывающая программа могла проверить код завершения и выяснить, полностью ли связана последовательность объектов. Она работает быстрее, чем перенаправление stdout в /dev/null, поскольку вывод не требуется форматировать.

Подавить обычный вывод; вместо него вывести суммарное количество байтов, занимаемых на диске выбранными коммитами или объектами. Это эквивалентно передаче вывода в конвейер команде git cat-file --batch-check='%(objectsize:disk), за исключением того, что выполняется гораздо быстрее (особенно с --use-bitmap-index). Ограничения значения термина «хранение на диске» описаны в разделе CAVEATS руководства git-cat-file[1]. Если указан необязательный параметр human, размер хранимых на диске данных выводится в удобочитаемом формате (например, 12.24 Kib, 3.50 Mib).

Подобно --cherry-pick (см. ниже), но помечает эквивалентные коммиты символом =, а не исключает их, и неэквивалентные — символом +.

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

Например, если есть две ветки, A и B, обычно для вывода коммитов, находящихся только в одной из них, используют --left-right (см. пример ниже в описании параметра --left-right). Однако команда покажет коммиты, перенесённые из другой ветки с помощью cherry-pick (например, «третий коммит в b» мог быть перенесён из ветки A). Этот параметр исключает такие пары коммитов из вывода.

Вывести только коммиты на соответствующей стороне симметрической разности, то есть только те, которые параметр --left-right пометил бы символом < или > соответственно.

Например, команда --cherry-pick --right-only A...B исключает из B коммиты, которые входят в A или эквивалентны по исправлению коммиту из A. Иными словами, она выводит коммиты + из git cherry A B. Точнее говоря, точный список формирует команда --cherry-pick --right-only --no-merges.

Синоним для --right-only --cherry-mark --no-merges; полезен для ограничения вывода коммитами с нашей стороны и пометки символом git log --cherry upstream...mybranch тех из них, которые были применены на другой стороне разветвлённой истории. Это похоже на git cherry upstream mybranch.

Вместо обхода цепочки предков коммитов обходить записи reflog от самой новой к более старым. При использовании этого параметра нельзя указывать исключаемые коммиты (то есть нельзя использовать обозначения ^<commit>, <commit1>..<commit2> и <commit1>...<commit2>).

Если формат --pretty отличается от oneline и reference (по очевидным причинам), в вывод добавляются две строки сведений из reflog. Обозначение reflog в выводе может иметь вид ref@{<Nth>} (где <Nth> — индекс записи в reflog в обратном хронологическом порядке) или ref@{<timestamp>} (с <timestamp> этой записи) в зависимости от нескольких правил:

В режиме --pretty=oneline это сведение добавляется перед сообщением коммита в той же строке. Этот параметр нельзя использовать вместе с --reverse. См. также git-reflog[1].

В режиме --pretty=reference это сведение не выводится.

Показать коммиты, затрагивающие конфликтующие пути в диапазоне HEAD...<other>, где <other> — первая существующая псевдоссылка из MERGE_HEAD, CHERRY_PICK_HEAD, REVERT_HEAD или REBASE_HEAD. Работает только тогда, когда в индексе есть неслитые записи. Этот параметр можно использовать для просмотра относящихся к делу коммитов при разрешении конфликтов трёхстороннего слияния.

Вывести исключённые граничные коммиты. Перед граничными коммитами ставится префикс -.

Попытаться ускорить обход с помощью битовой карты индекса pack (если она доступна). Обратите внимание: при обходе с параметром --objects связанные с деревьями и блобами пути не выводятся.

Выводить отчёты о ходе выполнения в stderr по мере обработки объектов. Текст <header> будет выводиться при каждом обновлении хода выполнения.

Вместо разделения переводами строки каждый выводимый объект и сопутствующие метаданные разделяются нулевыми байтами. Вывод имеет следующий формат:

<OID> NUL [<token>=<value> NUL]...

Дополнительные метаданные объектов, например пути объектов или граничные объекты, выводятся в формате <token>=<value>. Значения токенов выводятся как есть, без кодирования или усечения. Запись OID никогда не содержит символ = и потому используется для обозначения начала новой записи объекта. Примеры:

<OID> NUL
<OID> NUL path=<path> NUL
<OID> NUL boundary=yes NUL
<OID> NUL missing=yes NUL [<token>=<value> NUL]...

Этот режим совместим только с параметрами вывода --objects, --boundary и --missing.

Выбираются коммиты, изменяющие указанные <paths>.

Выбираются коммиты, на которые ссылается какая-либо ветка или тег.

Упрощает историю до простейшей истории, объясняющей конечное состояние дерева. Она простейшая, поскольку некоторые боковые ветви отсекаются, если конечный результат одинаков (то есть при слиянии ветвей с одинаковым содержимым).

Включает все коммиты из режима по умолчанию, а также все коммиты слияния, которые не являются TREESAME относительно первого родителя, но являются TREESAME относительно более позднего родителя. Этот режим удобен для отображения коммитов слияния, которые «впервые внесли» изменение в ветку.

То же, что и режим по умолчанию, но без отсечения части истории.

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

Отображаются все коммиты в упрощённой истории.

Дополнительный параметр для --full-history, удаляющий из результирующей истории некоторые ненужные слияния, поскольку ни один из выбранных коммитов не участвует в этом слиянии.

Если задан диапазон отображаемых коммитов (например, <commit1>..<commit2> или <commit2> ^<commit1>) и коммит <commit> из этого диапазона, отображаются только коммиты этого диапазона, которые являются предками <commit>, потомками <commit> или самим <commit>. Если коммит не указан, в качестве <commit> используется <commit1> (исключённая часть диапазона). Параметр можно указывать несколько раз; в этом случае коммит включается, если он является одним из указанных коммитов либо предком или потомком одного из них.

Коммиты включаются, если они не являются TREESAME ни относительно одного из родителей (это можно изменить, см. ниже --sparse). Если коммит является слиянием и TREESAME относительно одного из родителей, проход продолжается только по этому родителю. (Даже если есть несколько родителей TREESAME, проход продолжается только по одному из них.) В противном случае проход продолжается по всем родителям.

В результате получается:

          .-A---N---O
         /     /   /
        I---------D

Обратите внимание: правило, согласно которому проход продолжается только по родителю TREESAME, если таковой имеется, полностью исключило из рассмотрения B. C рассматривался через N, но он является TREESAME. Корневые коммиты сравниваются с пустым деревом, поэтому I является !TREESAME.

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

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

        I  A  B  N  D  O  P  Q

M исключён, поскольку он TREESAME относительно обоих родителей. Были пройдены E, C и B, но только B оказался !TREESAME, поэтому остальные не отображаются.

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

Обычные коммиты включаются, только если они !TREESAME (это можно изменить, см. ниже --sparse).

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

          .-A---M---N---O---P---Q
         /     /   /   /   /
        I     B   /   D   /
         \   /   /   /   /
          `-------------'

Сравните с режимом --full-history без переписывания, рассмотренным выше. Обратите внимание: E был отсечён, поскольку он TREESAME, но список родителей P был переписан так, чтобы включить родителя E — I. То же самое произошло с C и N, а также с X, Y и Q.

Пройденные коммиты включаются, если они не являются TREESAME ни относительно одного из родителей.

Включаются все пройденные коммиты.

Обратите внимание: без --full-history слияния всё равно упрощаются: если один из родителей TREESAME, проход продолжается только по нему, поэтому остальные стороны слияния никогда не обходятся.

Сначала строится граф истории так же, как в режиме --full-history с переписыванием родительских связей (см. выше).

Затем каждый коммит C упрощается до его замены C' в конечной истории согласно следующим правилам:

Лучше всего показать эффект этого режима, сравнив его с режимом --full-history с переписыванием родительских связей. Пример преобразуется в:

          .-A---M---N---O
         /     /       /
        I     B       D
         \   /       /
          `---------'

Обратите внимание на существенные отличия коммитов N, P и Q по сравнению с --full-history:

Ограничить отображаемые коммиты теми, которые являются предками <commit>, потомками <commit> или самим <commit>.

В качестве примера рассмотрим следующую историю коммитов:

            D---E-------F
           /     \       \
          B---C---G---H---I---J
         /                     \
        A-------K---------------L--M

Обычный D..M вычисляет набор коммитов, являющихся предками M, но исключает те, которые являются предками D. Это полезно, чтобы увидеть, что произошло в истории, ведущей к M, после D, то есть «что есть в M, чего не было в D». В этом примере результатом будут все коммиты, кроме A и B (и самого D, конечно).

Однако если мы хотим узнать, какие коммиты в M затронуты ошибкой, внесённой в D, и требуют исправления, может потребоваться просмотреть только подмножество D..M, действительно являющееся потомками D, то есть исключить C и K. Именно это делает параметр --ancestry-path. При применении к диапазону D..M получается:

                E-------F
                 \       \
                  G---H---I---J
                               \
                                L--M

Вместо --ancestry-path можно также использовать --ancestry-path=D: при применении к диапазону D..M они означают одно и то же, но второй вариант лишь более явный.

Если же нас интересует определённая тема в этом диапазоне и все затронутые ею коммиты, может потребоваться просмотреть только подмножество D..M, в цепочке предков которых присутствует эта тема. Например, использование --ancestry-path=H D..M даст следующий результат:

                E
                 \
              C---G---H---I---J
                               \
                                L--M

В то время как --ancestry-path=K D..M даст результат

                K---------------L--M

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

Когда коммит слияния включается благодаря параметру --show-pulls, считается, что слияние «подтянуло» изменение из другой ветки. При использовании --show-pulls в этом примере (без других параметров) получается следующий граф:

        I---X---R---N

Здесь включены коммиты слияния R и N, поскольку они соответственно подтянули коммиты X и R в основную ветку. Именно из-за этих слияний коммиты A и B не отображаются в истории по умолчанию.

Если использовать --show-pulls вместе с --simplify-merges, граф будет содержать всю необходимую информацию:

          .-A---M--.   N
         /     /    \ /
        I     B      R
         \   /      /
          \ /      /
           `---X--'

Обратите внимание: поскольку M достижим из R, связь от N к M была упрощена и удалена. Однако N по-прежнему отображается в истории как важный коммит, поскольку он «подтянул» изменение R в основную ветку.

Ограничить вывод одним объектом коммита, находящимся примерно посередине между включёнными и исключёнными коммитами. Обратите внимание, что ссылка на плохую бисекцию refs/bisect/bad добавляется к включённым коммитам (если она существует), а ссылки на хорошие бисекции refs/bisect/good-* добавляются к исключённым коммитам (если они существуют). Таким образом, если предположить, что в refs/bisect/ нет ссылок, то если

        $ git rev-list --bisect foo ^bar ^baz

выводит midpoint, вывод двух команд

        $ git rev-list foo ^midpoint
        $ git rev-list midpoint ^bar ^baz

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

Вычисляет то же, что и --bisect, за исключением того, что ссылки в refs/bisect/ не используются, а также выводится текст, готовый для вычисления оболочкой. Эти строки присвоят имя ревизии средней точки переменной bisect_rev, ожидаемое количество коммитов для проверки после проверки bisect_rev — переменной bisect_nr, ожидаемое количество коммитов для проверки, если bisect_rev окажется хорошим, — переменной bisect_good, ожидаемое количество коммитов для проверки, если bisect_rev окажется плохим, — переменной bisect_bad, а количество коммитов, для которых прямо сейчас выполняется бисекция, — переменной bisect_all.

Выводит все объекты коммитов между включёнными и исключёнными коммитами, упорядоченные по расстоянию до включённых и исключённых коммитов. Ссылки в refs/bisect/ не используются. Сначала отображается наиболее удалённый от них коммит. (Это единственный коммит, отображаемый командой --bisect.)

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

Этот параметр можно использовать вместе с --bisect-vars; в этом случае после всех отсортированных объектов коммитов будет выведен тот же текст, что и при использовании только --bisect-vars.

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

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

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

Например, в истории коммитов следующего вида:

    ---1----2----4----7
        \               \
         3----5----6----8---

где числа обозначают порядок временных меток коммитов, git rev-list и подобные команды с параметром --date-order показывают коммиты в порядке временных меток: 8 7 6 5 4 3 2 1.

С параметром --topo-order они покажут коммиты в порядке 8 6 5 3 7 4 2 1 (или 8 7 4 2 6 5 3 1); некоторые более старые коммиты отображаются раньше более новых, чтобы не смешивать коммиты из двух параллельных линий разработки.

Выводить выбранные для отображения коммиты (см. раздел Commit Limiting выше) в обратном порядке. Нельзя использовать вместе с --walk-reflogs.

Выводить идентификаторы объектов всех объектов, на которые ссылаются перечисленные коммиты. Таким образом, --objects foo ^bar означает «отправить мне все идентификаторы объектов, которые нужно загрузить, если у меня есть объект коммита bar, но нет foo». См. также раздел --object-names ниже.

Выводить идентификаторы деревьев и блобов в порядке коммитов. Идентификаторы деревьев и блобов выводятся после того, как на них впервые ссылается коммит.

Аналогично --objects, но также выводит идентификаторы исключённых коммитов с префиксом в виде символа «-». Команда git-pack-objects[1] использует это для создания «тонкого» пакета, в котором объекты записываются в дельта-форме на основе объектов, содержащихся в этих исключённых коммитах, чтобы сократить сетевой трафик.

Аналогично --objects-edge, но выполняет более тщательный поиск исключённых коммитов ценой увеличения времени работы. Используется вместо --objects-edge для создания «тонких» пакетов для неглубоких репозиториев.

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

Полезно только вместе с --objects; выводит идентификаторы объектов, не входящих в пакеты.

Полезно только вместе с --objects; выводит имена найденных идентификаторов объектов. Это поведение по умолчанию. Обратите внимание, что «имя» каждого объекта неоднозначно и предназначено главным образом как подсказка при упаковке объектов. В частности, имена тегов, деревьев и блобов не различаются; из имён путей могут удаляться символы новой строки; если объект встречается несколько раз под разными именами, отображается только одно имя.

Полезно только вместе с --objects; не выводит имена найденных идентификаторов объектов. Инвертирует действие --object-names. Этот флаг упрощает разбор вывода такими командами, как git-cat-file[1].

Полезно только вместе с одним из параметров --objects*; исключает объекты (обычно блобы) из списка выводимых объектов. <filter-spec> может иметь одно из следующих значений:

Форма --filter=blob:none исключает все блобы.

Форма --filter=blob:limit=<n>[kmg] исключает блобы размером не менее <n> байт или единиц. Значение <n> может быть равно нулю. Суффиксы k, m и g обозначают единицы измерения КиБ, МиБ и ГиБ. Например, blob:limit=1k эквивалентно blob:limit=1024.

Форма --filter=object:type=(tag|commit|tree|blob) исключает все объекты, тип которых не соответствует указанному. Обратите внимание, что явно указанные объекты игнорируют фильтры и всегда выводятся, если также не указан параметр --filter-provided-objects.

Форма --filter=sparse:oid=<blob-ish> использует спецификацию разреженного извлечения, содержащуюся в блобе (или выражении блоба) <blob-ish>, чтобы исключить блобы, которые не потребовались бы для разреженного извлечения указанных ссылок.

Форма --filter=tree:<depth> исключает все блобы и деревья, глубина которых от корневого дерева равна или больше <depth> (если объект расположен на нескольких уровнях в обходящихся коммитах, используется минимальная глубина). Значение <depth>=0 не включает деревья и блобы, если только они не указаны явно в командной строке (или в стандартном вводе при использовании --stdin). Значение <depth>=1 включает только дерево и блобы, на которые непосредственно ссылается коммит, достижимый из <commit>, либо явно указанный объект. Значение <depth>=2 аналогично <depth>=1, но также включает деревья и блобы, находящиеся ещё на один уровень дальше от явно указанного коммита или дерева.

Обратите внимание, что форма --filter=sparse:path=<path>, считывающая данные по произвольному пути в файловой системе, удалена по соображениям безопасности.

Для объединения фильтров можно указать несколько флагов --filter=. Включаются только объекты, удовлетворяющие каждому фильтру.

Форму --filter=combine:<filter1>+<filter2>+...<filterN> также можно использовать для объединения нескольких фильтров, но это сложнее, чем просто повторять флаг --filter, и обычно в этом нет необходимости. Фильтры разделяются символом +, а отдельные фильтры кодируются с помощью %-кодирования (то есть кодирования URL). Помимо символов + и %, зарезервированы и также должны быть закодированы следующие символы: ~!@#$^&*()[]{}\;",<>?'`, а также все символы с кодом ASCII меньше или равным 0x20, включая пробел и символ новой строки.

Можно также кодировать другие произвольные символы. Например, combine:tree:3+blob:none и combine:tree%3A3+blob%3Anone эквивалентны.

Отключить все предыдущие аргументы --filter=.

Фильтровать список явно указанных объектов, которые в противном случае всегда выводились бы, даже если не соответствуют ни одному фильтру. Полезно только вместе с --filter=.

Полезно только вместе с --filter=; выводит список объектов, исключённых фильтром. Идентификаторы объектов имеют префикс в виде символа «~».

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

Форма --missing=error указывает rev-list завершить работу с ошибкой при обнаружении отсутствующего объекта. Это действие используется по умолчанию.

Форма --missing=allow-any позволяет продолжить обход объектов при обнаружении отсутствующего объекта. Отсутствующие объекты незаметно исключаются из результатов.

Форма --missing=allow-promisor аналогична allow-any, но позволяет продолжить обход объектов только при ожидаемом отсутствии объектов, предоставляемых promisor. При неожиданном отсутствии объектов возникает ошибка.

Форма --missing=print аналогична allow-any, но также выводит список отсутствующих объектов. Идентификаторы объектов имеют префикс в виде символа «?».

Форма --missing=print-info аналогична print, но также выводит дополнительные сведения об отсутствующем объекте, полученные из содержащего его объекта. Все сведения выводятся в одной строке с идентификатором отсутствующего объекта в формате: ?<oid> [<token>=<value>].... Пары <token>=<value>, содержащие дополнительные сведения, разделяются символом SP. Значение кодируется способом, зависящим от токена, но символы SP или LF, содержащиеся в значении, всегда должны быть представлены так, чтобы в результате кодирования не возникало ни одного из этих двух проблемных байтов. Каждая пара <token>=<value> может иметь один из следующих видов:

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

(Только для внутреннего использования.) Предварительно фильтровать обход объектов на границе promisor. Используется при частичном клонировании. Этот параметр мощнее, чем --missing=allow-promisor, поскольку ограничивает обход, а не просто подавляет ошибки об отсутствующих объектах.

Показывать только указанные коммиты, не обходя их предков. Не действует, если задан диапазон. Если указан аргумент unsorted, коммиты отображаются в порядке их указания в командной строке. В противном случае (если указан аргумент sorted или аргумент не указан) коммиты отображаются в обратном хронологическом порядке по времени коммитов. Нельзя использовать вместе с --graph.

Отменяет ранее заданный параметр --no-walk.

Вывести содержимое журналов коммитов в заданном формате, где <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.

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

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

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

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

Синоним для --date=relative.

Влияет только на даты, отображаемые в удобочитаемом формате, например при использовании --pretty. Переменная конфигурации log.date задаёт значение по умолчанию для параметра --date команды log. По умолчанию даты отображаются в исходном часовом поясе (автора или коммитера). Если к формату добавить -local (например, iso-local), вместо него будет использоваться местный часовой пояс пользователя.

Вывести содержимое коммита в необработанном формате; записи разделяются символом NUL.

Не выводить строку заголовка с надписью «commit» и идентификатором объекта, которая предшествует указанному формату. Не влияет на встроенные форматы; учитывается только для пользовательских форматов.

Переопределяет ранее заданный --no-commit-header.

Также вывести родителей коммита (в виде «commit parent…​»). Включает переписывание родителей; см. выше History Simplification.

Также вывести потомков коммита (в виде «commit child…​»). Включает переписывание родителей; см. выше History Simplification.

Вывести исходную метку времени коммита.

Отметить, с какой стороны симметричной разности достижим коммит. Перед коммитами с левой стороны ставится префикс <, а с правой — >. Если этот параметр используется вместе с --boundary, перед такими коммитами ставится префикс -.

Например, если у вас такая топология:

             y---b---b  branch B
            / \ /
           /   .
          /   / \
         o---x---a---a  branch A

вы получите примерно такой вывод:

        $ git rev-list --left-right --boundary --pretty=oneline A...B

        >bbbbbbb... 3rd on b
        >bbbbbbb... 2nd on b
        <aaaaaaa... 3rd on a
        <aaaaaaa... 2nd on a
        -yyyyyyy... 1st on b
        -xxxxxxx... 1st on a

Нарисовать слева от вывода текстовое графическое представление истории коммитов. Для правильного отображения графа истории между коммитами могут выводиться дополнительные строки. Нельзя использовать вместе с --no-walk.

Включает переписывание родителей; см. выше History Simplification.

По умолчанию подразумевает параметр --topo-order, но также можно указать параметр --date-order.

Если параметр --graph не используется, все ветви истории сводятся в одну последовательность, из-за чего может быть трудно заметить, что два соседних коммита не относятся к одной линейной ветви. В этом случае данный параметр вставляет между ними разделитель. Если указан <barrier>, вместо разделителя по умолчанию будет выведена эта строка.

При использовании --graph ограничить количество отображаемых дорожек графа. Дорожки сверх лимита заменяются маркером усечения ~. По умолчанию значение равно 0 (без ограничений); нулевые и отрицательные значения игнорируются и трактуются как отсутствие ограничений.

Вывести число коммитов, которые были бы перечислены, и подавить весь остальной вывод. При использовании вместе с --left-right вместо этого вывести количество коммитов слева и справа, разделив их символом табуляции. При использовании вместе с --cherry-mark не учитывать в этих количествах коммиты, эквивалентные по патчу, и вывести количество эквивалентных коммитов, отделив его символом табуляции.