gitrevisions

Полное имя объекта SHA-1 (40-символьная шестнадцатеричная строка) или его уникальная подстрока в репозитории. Например, dae86e1950b1277e545cee180551750029cfe735 и dae86e обозначают один и тот же объект коммита, если в репозитории нет другого объекта, имя которого начинается с dae86e.

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

Символическое имя ссылки. Например, master обычно означает объект коммита, на который ссылается refs/heads/master. Если у вас есть и heads/master, и tags/master, вы можете явно указать heads/master, чтобы Git понял, о каком из них идёт речь. В случае неоднозначности <refname> разрешается путём выбора первого соответствия в следующих правилах:

Обратите внимание, что любой из вышеперечисленных refs/* случаев может быть получен из директории $GIT_DIR/refs или из файла $GIT_DIR/packed-refs. Хотя кодировка имён ссылок не специфицирована, предпочтительно UTF-8, так как некоторые операции по обработке вывода предполагают использование UTF-8 для имён ссылок.

@ в одиночку является сокращением для HEAD.

Ссылка, за которой следует постфикс @ со спецификацией даты в фигурных скобках (например, {yesterday}, {1 month 2 weeks 3 days 1 hour 1 second ago} или {1979-02-26 18:30:00}), указывает значение ссылки в предыдущий момент времени. Этот постфикс может использоваться только сразу после имени ссылки, и ссылка должна иметь существующий журнал ($GIT_DIR/logs/<ref>). Обратите внимание, что это ищет состояние вашей локальной ссылки в заданное время; например, какое было в вашей локальной ветви master на прошлой неделе. Если вам нужно просмотреть коммиты, созданные в определённые временные промежутки, см. --since и --until.

Ссылка, за которой следует постфикс @ со спецификацией порядкового номера в фигурных скобках (например, {1}, {15}). Например, master@{1} — это предыдущее значение master, а master@{5} — пятое предыдущее значение master. Этот постфикс может использоваться только сразу после имени ссылки, и ссылка должна иметь существующий журнал ($GIT_DIR/logs/<refname>).

Конструкцию @ с пустой частью имени ссылки можно использовать для получения записи журнала текущей ветви. Например, если вы находитесь на ветви blabla, то @{1} означает то же самое, что и blabla@{1}.

Конструкция @{-<n>} означает <n>-ую ветвь/коммит, проверенную до текущей.

Ветвь B может быть настроена для работы над ветвью X (настроенной с branch.<name>.merge в удалённом репозитории R (настроенной с branch.<name>.remote). B@{u} относится к удалённой ветви отслеживания для ветви X, взятой из удалённого репозитория R, обычно находящейся по адресу refs/remotes/R/X.

Постфикс @{push} отображает ветвь "куда мы будем делать push", если git push был запущен, когда была выбрана ветвь branchname (или текущая HEAD , если имя ветви не указано). Как и в случае с @{upstream}, мы отображаем ветвь удалённого отслеживания, соответствующую этой ветви в удалённом репозитории.

Вот пример для большей ясности:

$ git config push.default current
$ git config remote.pushdefault myfork
$ git switch -c mybranch origin/master

$ git rev-parse --symbolic-full-name @{upstream}
refs/remotes/origin/master

$ git rev-parse --symbolic-full-name @{push}
refs/remotes/myfork/mybranch

Обратите внимание в примере, что мы создали треугольную схему работы, где получаем данные из одного места, а отправляем в другое. В нетреугольной схеме работы @{push} равно @{upstream}, и в ней нет необходимости.

Этот постфикс также принимается в верхнем регистре и означает то же самое независимо от регистра.

Постфикс ^ к параметру пересмотра означает первого родителя объекта коммита. ^<n> означает <n>-го родителя (т.е. <rev>^ эквивалентно <rev>^1). Как особое правило, <rev>^0 означает сам коммит и используется, когда <rev> — имя объекта тега, который ссылается на объект коммита.

Постфикс ~ к параметру пересмотра означает первого родителя объекта коммита. Постфикс ~<n> к параметру пересмотра означает объект коммита, который является <n>-ым предком указанного объекта коммита, следуя только первым родителям. То есть <rev>~3 эквивалентно <rev>^^^, что эквивалентно <rev>^1^1^1. См. ниже пример использования этой формы.

Постфикс ^ с именем типа объекта в фигурных скобках означает рекурсивное разыменование объекта в <rev> до тех пор, пока не будет найден объект типа <type> или объект больше не может быть разыменён (в этом случае, ошибка). Например, если <rev> — это объект коммита, <rev>^{commit} описывает соответствующий объект коммита. Аналогично, если <rev> — это объект дерева, <rev>^{tree} описывает соответствующий объект дерева. <rev>^0 — это сокращение для <rev>^{commit}.

<rev>^{object} можно использовать для проверки того, что <rev> называет существующий объект, без требования к <rev> быть тегом и без разыменования <rev>; так как тег уже является объектом, он не должен разыменовываться даже один раз, чтобы получить объект.

<rev>^{tag} можно использовать для проверки того, что <rev> идентифицирует существующий объект тега.

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

Суффикс ^ к параметру пересмотра, за которым следует пара фигурных скобок, содержащая текст, предваряемый косой чертой, эквивалентен синтаксису :/fix nasty bug ниже, за исключением того, что он возвращает самую последнюю соответствующую коммитацию, которая доступна от <rev> до ^.

Двоеточие, за которым следуют косые черты и текст, задаёт коммитацию, сообщение которой соответствует указанному регулярному выражению. Это имя возвращает самую последнюю соответствующую коммитацию, доступную от любого ref, включая HEAD. Регулярное выражение может соответствовать любой части сообщения о коммитации. Для соответствия сообщениям, начинающимся с строки, можно использовать, например, :/^foo. Специальная последовательность :/! зарезервирована для модификаторов того, что соответствует. :/!-foo выполняет отрицательное соответствие, а :/!!foo соответствует литеральному ! символу, за которым следует foo. Любая другая последовательность, начинающаяся с :/!, зарезервирована на данный момент. В зависимости от заданного текста, правила разделения слов оболочки могут потребовать дополнительной кавычки.

Суффикс :, за которым следует путь, задаёт объект blob или tree по указанному пути в объекте tree-ish, названном частью перед двоеточием. Путь, начинающийся с ./ или ../ относительный к текущей рабочей директории. Указанный путь будет преобразован для относительности к корневой директории рабочей области. Это наиболее полезно для обращения к blob или tree из коммита или дерева, имеющего ту же структуру дерева, что и рабочая область.

Двоеточие, необязательно за которым следует номер стадии (от 0 до 3) и двоеточие, за которыми следует путь, задаёт объект blob в индексе по указанному пути. Отсутствие номера стадии (и двоеточия, которое следует за ним) задаёт запись стадии 0. Во время слияния стадия 1 — это общий предок, стадия 2 — версия целевой ветви (обычно текущая ветвь), а стадия 3 — версия из ветви, которая сливается.