git-shortlog

Ограничить вывод первыми <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).

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

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

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

Считать, что ошибочная ссылка двоичного поиска refs/bisect/bad была указана, а за ней в командной строке следовали --not и корректные ссылки двоичного поиска refs/bisect/good-*.

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

Аналогично параметру --cherry-pick (см. ниже), но эквивалентные коммиты помечаются символом =, а не исключаются, а неэквивалентные — символом +.

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

Например, если у вас есть две ветки, A и B, обычно все коммиты, присутствующие только в одной из них, перечисляют с помощью --left-right (см. пример ниже в описании параметра --left-right). Однако при этом выводятся коммиты, перенесённые выборочно из другой ветки (например, «3rd on 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. Работает только при наличии неслитых записей в индексе. Этот параметр можно использовать для показа релевантных коммитов при разрешении конфликтов трёхстороннего слияния.

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

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

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

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

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

То же, что и режим по умолчанию, но некоторые части истории не удаляются.

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

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

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

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

Коммиты включаются, если они не являются TREESAME ни относительно одного из родителей (это можно изменить; см. ниже --sparse). Если коммит является слиянием и 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 был переписан так, чтобы включить родителя I коммита E. То же самое произошло с 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 в основную ветку.