git-for-each-ref

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

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

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

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

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

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

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

Выводить только ссылки, указывающие на заданный объект.

Выводить только ссылки, вершины которых достижимы из указанного коммита (если он не задан, используется HEAD).

Выводить только ссылки, вершины которых недостижимы из <object> (если он не задан, используется HEAD).

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

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

Сортировать и фильтровать ссылки без учета регистра.

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

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

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

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

Имя ссылки (часть после $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>. Ни один из этих случаев не считается ошибкой.

strip можно использовать как синоним lstrip.

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

Размер объекта (тот же, что сообщает git cat-file -s). Добавьте :disk, чтобы получить размер объекта в байтах на диске. См. примечание о размерах на диске в разделе CAVEATS ниже.

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

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

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

Для любой ветки отслеживания удалённого репозитория %(upstream), %(upstream:remotename) и %(upstream:remoteref) относятся соответственно к имени удалённого репозитория и имени отслеживаемой ссылки удалённого репозитория. Иными словами, ветку отслеживания удалённого репозитория можно обновить явно и отдельно, используя спецификацию ссылки %(upstream:remoteref):%(upstream) для получения данных из %(upstream:remotename).

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

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

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

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

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

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

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

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

Выводит

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

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

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

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

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

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

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

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

Например, рассмотрим следующий рисунок историй по первым родителям нескольких ссылок:

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

Здесь, если A, B и C — отфильтрованные ссылки, а строка формата — %(refname):%(is-base:D), то результат будет таким:

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

Это объясняется тем, что история по первым родителям ссылки D впервые пересекается с историями по первым родителям отфильтрованных ссылок в общем предке по первым родителям ссылок B и C; при равенстве выбирается ссылка, стоящая раньше в отсортированном порядке.

Обратите внимание: этот токен не появится, если история по первым родителям <commit-ish> не пересекается с историями по первым родителям отфильтрованных ссылок.

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

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

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

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

Остаток сообщения коммита или тега после «темы».

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

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