Если указан один или несколько параметров <шаблон>, отображаются только ссылки, соответствующие хотя бы одному шаблону, либо с использованием fnmatch(3), либо буквально, в последнем случае совпадение должно быть полным или с начала до косой черты.

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

Остановиться после отображения <число> ссылок.

Сортировать по имени поля <ключ>. Префикс - для сортировки по убыванию значения. Если не указано, используется refname. Вы можете использовать опцию --sort=<ключ> несколько раз, и в этом случае последний ключ станет основным ключом сортировки.

Строка, которая интерполирует %(имя_поля) из отображаемой ссылки и объекта, на который она указывает. Кроме того, строковый литерал %% отображается как %, а %xx — где xx шестнадцатеричные цифры — отображается как символ с шестнадцатеричным кодом xx. Например, %00 интерполируется в \0 (NUL), %09 в \t (TAB), а %0a в \n (LF).

Учитывать любые цвета, указанные в опции --format. Поле <когда> должно быть одним из always, never или auto (если <when> отсутствует, вести себя так, как если бы было указано always).

Если указано, строки, заменяющие заполнители %(fieldname), заключаются в кавычки как строковые литералы, подходящие для указанного языка хоста. Это предназначено для создания скриплета, который можно напрямую выполнить с помощью "eval".

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

Перечислять только ссылки, концы которых доступны из указанного коммита (HEAD, если не указано).

Перечислять только ссылки, концы которых недоступны из <object>(HEAD, если не указано).

Перечислять только ссылки, которые содержат <object>(HEAD, если не указано).

Перечислять только ссылки, которые не содержат <object> (HEAD, если не указано).

Сортировка и фильтрация не зависят от регистра.

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

Если указана одна или несколько опций --exclude, отображаются только ссылки, которые не соответствуют ни одному параметру <исключающий_шаблон>. Сопоставление выполняется по тем же правилам, что и для <шаблон> выше.

Выводит корневые ссылки (HEAD и псевдо-ссылки) отдельно от обычных ссылок.

Позволяет разбивать вывод на страницы, пропуская ссылки вплоть до указанного маркера включительно. При разбиении на страницы следует отметить, что ссылки могут быть удалены, изменены или добавлены между вызовами. Вывод будет содержать только те ссылки, которые следуют за маркером в лексикографическом порядке. Вывод начинается с первой ссылки, которая идёт после маркера в алфавитном порядке. Нельзя использовать с опциями --sort=<ключ> или --stdin, или с аргументами <шаблон> для ограничения ссылок.

Имя ссылки (часть после $GIT_DIR/). Для неоднозначного краткого имени ссылки добавьте :short. Параметр core.warnAmbiguousRefs используется для выбора строгого режима сокращения. Если добавлено lstrip=<n> (rstrip=<n>), удалить <n> компонентов пути, разделённых косой чертой, из начала (конца) имени ссылки (например, %(refname:lstrip=2) превращает refs/tags/foo в foo, а %(refname:rstrip=2) превращает refs/tags/foo в refs). Если <n> — отрицательное число, удалить столько компонентов пути, сколько необходимо, с указанного конца, чтобы оставить -<n> компонентов пути (например, %(refname:lstrip=-2) превращает refs/tags/foo в tags/foo, а %(refname:rstrip=-1) превращает refs/tags/foo в refs). Когда у ссылки недостаточно компонентов, результат становится пустой строкой при удалении с положительным <n> или полным именем ссылки при удалении с отрицательным <N>. Ни то, ни другое не является ошибкой.

Тип объекта (blob, tree, commit, tag).

Размер объекта (тот же, который сообщает git cat-file -s). Добавьте :disk, чтобы получить размер в байтах, который объект занимает на диске. См. примечание о размерах на диске в разделе «ПРЕДОСТЕРЕЖЕНИЯ» ниже.

Имя объекта (также известное как SHA-1). Для неоднозначного сокращения имени объекта добавьте :short. Для сокращения имени объекта желаемой длины добавьте :short=<длина>, где минимальная длина — MINIMUM_ABBREV. Длина может быть превышена, чтобы гарантировать уникальность имён объектов.

Раскрывается в имя объекта базы дельты для данного объекта, если он хранится как дельта. В противном случае раскрывается в нулевое имя объекта (все нули).

Имя локальной ссылки, которую можно считать «вышестоящей» (upstream) для отображаемой ссылки. Учитывает :short, :lstrip и :rstrip так же, как и refname выше. Также учитывает :track для отображения «[впереди N, позади M]» и :trackshort для отображения краткой версии: ">" (впереди), "<" (позади), "<>" (впереди и позади) или "=" (синхронно). :track также выводит «[gone]», когда встречается неизвестная вышестоящая ссылка. Добавьте :track,nobracket для отображения информации об отслеживании без скобок (т.е. «впереди N, позади M»).

Имя локальной ссылки, которая представляет местоположение @{push} для отображаемой ссылки. Учитывает параметры :short, :lstrip, :rstrip, :track, :trackshort, :remotename и :remoteref, как и upstream. Выдаёт пустую строку, если ссылка @{push} не настроена.

*, если HEAD совпадает с текущей ссылкой (переключённой веткой), в противном случае — пробел.

Изменить цвет вывода. За которым следует :<имя-цвета>, где имена цветов описаны в разделе «ФАЙЛ КОНФИГУРАЦИИ» в git-config[1] (в разделе Values). Например, %(color:bold red).

Выравнивает содержимое между %(align:...) и %(end) по левому, центральному или правому краю. После «align:» следуют width=<ширина> и position=<позиция> в любом порядке, разделённые запятой, где <позиция> может быть left, right или middle (по умолчанию left), а <ширина> — это общая длина выравниваемого содержимого. Для краткости префиксы «width=» и/или «position=» могут быть опущены, и вместо них используются просто <ширина> и <позиция>. Например, %(align:<ширина>,<позиция>). Если длина содержимого превышает ширину, выравнивание не выполняется. Если используется с --quote, всё между %(align:...) и %(end) заключается в кавычки, но при вложенности только самый верхний уровень выполняет цитирование.

Используется как %(if)...%(then)...%(end) или %(if)...%(then)...%(else)...%(end). Если после %(if) есть атом со значением или строковый литерал, то выводится всё после %(then), иначе, если используется атом %(else), выводится всё после %(else). Пробелы при вычислении строки перед %(then) игнорируются, это полезно, когда мы используем атом %(HEAD), который выводит либо «*», либо пробел, и мы хотим применить условие if только к ссылке HEAD. Добавьте ":equals=<строка>" или ":notequals=<строка>", чтобы сравнить значение между атомами %(if:...) и %(then) с заданной строкой.

Ссылка, на которую указывает данная символическая ссылка. Если это не символическая ссылка, ничего не выводится. Учитывает параметры :short, :lstrip и :rstrip так же, как и refname выше.

GPG-подпись коммита.

Показать

Подписавший GPG-подпись коммита.

Ключ GPG-подписи коммита.

Отпечаток GPG-подписи коммита.

Отпечаток основного ключа GPG-подписи коммита.

Уровень доверия GPG-подписи коммита. Возможные результаты: ultimate, fully, marginal, never и undefined.

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

Два целых числа, разделённых пробелом, показывающих количество коммитов впереди и позади соответственно при сравнении выходной ссылки с <указатель-на-коммит>, указанным в формате.

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

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
	*--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

Удобочитаемое имя, как в git-describe[1]; пустая строка для коммитов, которые нельзя описать. За строкой describe могут следовать двоеточие и один или несколько параметров, разделённых запятыми.

Размер необработанных данных объекта.

Размер в байтах сообщения коммита или метки.

Первый абзац сообщения, который обычно представляет собой одну строку, принимается за «тему» (subject) коммита или сообщения метки. Вместо contents:subject поле subject также можно использовать для получения тех же результатов. К subject можно добавить :sanitize для строки темы, подходящей для имени файла.

Остальная часть сообщения коммита или метки, следующая за «темой».

Необязательная GPG-подпись метки.

Первые <n> строк сообщения.