git-describe - Интернет в облаке

ПРОГРАММА:

ИМЯ

git-describe - Опишите фиксацию, используя самый последний доступный из нее тег

СИНТАКСИС

мерзавец описывать [--all] [--tags] [--contains] [--abbrev = ] [ ...]
мерзавец описывать [--all] [--tags] [--contains] [--abbrev = ] --dirty [= ]

ОПИСАНИЕ

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

По умолчанию (без --all или --tags) git describe показывает только аннотированные теги. Для большего
информацию о создании аннотированных тегов см. параметры -a и -s для git-тег(1).

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

...
Имена объектов фиксации для описания. Если не указано иное, по умолчанию используется HEAD.

- грязный [= ]
Опишите рабочее дерево. Это означает описание HEAD и добавление (-грязный
по умолчанию), если рабочее дерево грязное.

--все
Вместо использования только аннотированных тегов используйте любую ссылку из refs / namespace. Этот
опция позволяет сопоставить любую известную ветвь, ветку удаленного отслеживания или облегченный тег.

- теги
Вместо использования только аннотированных тегов используйте любой тег из пространства имен refs / tags.
Эта опция позволяет сопоставить легкий (не аннотированный) тег.

--содержит
Вместо того, чтобы искать тег, предшествующий фиксации, найдите тег, который идет после
commit и, таким образом, содержит его. Автоматически подразумевает --tags.

--abbrev =
Вместо использования 7 шестнадцатеричных цифр по умолчанию в качестве сокращенного имени объекта используйте
цифр или столько цифр, сколько необходимо для формирования уникального имени объекта. An из 0 будет
подавить длинный формат, показывая только ближайший тег.

--candidates =
Вместо того, чтобы рассматривать только 10 последних тегов в качестве кандидатов для описания
вводить коммит-иш считать до кандидаты. Увеличение выше 10 займет
немного длиннее, но может дать более точный результат. An из 0 вызовет только
точные совпадения для вывода.

--точное совпадение
Выводить только точные совпадения (тег напрямую ссылается на предоставленную фиксацию). Это
синоним --candidates = 0.

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

--длинный
Всегда выводите длинный формат (тег, количество коммитов и сокращенное
имя фиксации), даже если оно соответствует тегу. Это полезно, когда вы хотите увидеть части
имя объекта фиксации в выводе «описать», даже если происходит фиксация, о которой идет речь
чтобы быть версией с тегами. Вместо того, чтобы просто выдавать имя тега, он будет описывать такой
совершить как v1.2-0-gdeadbee (0-я фиксация с момента тега v1.2, который указывает на объект
тупица ....).

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

--всегда
Показывать однозначно сокращенный объект фиксации как резервный.

- первый родитель
Следуйте только за первой родительской фиксацией, увидев фиксацию слияния. Это полезно, когда
вы не хотите, чтобы теги в ветках были объединены в историю целевого коммита.

ПРИМЕРЫ

С чем-то вроде текущего дерева git.git я получаю:

[torvalds @ g5 git] $ git описывает родителя
v1.0.4-14-g2414721

т.е. текущая глава моей "родительской" ветки основана на версии 1.0.4, но поскольку в ней есть несколько
коммитов вдобавок к этому, description добавил количество дополнительных коммитов ("14") и
сокращенное имя объекта для самого коммита («2414721») в конце.

Количество дополнительных коммитов - это количество коммитов, которое будет отображаться "git
log v1.0.4..parent ". Суффикс хэша" -g "+ аббревиатура из 7 символов для совершения фиксации
родительский (который был 2414721b194453f058079d897d13c4e377f92dc6). Префикс "g" означает
"git" и используется для описания версии программного обеспечения в зависимости от SCM,
программное обеспечение управляется с помощью. Это полезно в среде, где люди могут использовать разные
СКМ.

Делать мерзавец описывать на имени тега будет отображаться только имя тега:

[torvalds @ g5 git] $ git describe v1.0.4
v1.0.4

С --all команда может использовать заголовки ветвей в качестве ссылок, поэтому вывод показывает
также ссылочный путь:

[torvalds @ g5 git] $ git describe --all --abbrev = 4 v1.0.5 ^ 2
теги / v1.0.0-21-g975b

[torvalds @ g5 git] $ git describe --all --abbrev = 4 HEAD ^
головки / lt / описать-7-g975b

Если --abbrev установлено в 0, команду можно использовать для поиска ближайшего тэга без каких-либо
суффикс:

[torvalds @ g5 git] $ git describe --abbrev = 0 v1.0.5 ^ 2
теги / v1.0.0

Обратите внимание, что суффикс, который вы получите, если вы введете эти команды сегодня, может быть длиннее, чем
Линус видел выше, когда запускал эти команды, поскольку в вашем репозитории Git могут быть новые коммиты.
чьи имена объектов начинаются с 975b, которого тогда не было, и только суффикс "-g975b"
может быть недостаточно для устранения неоднозначности этих коммитов.

ПОИСК Стратегия

Для каждой предоставленной фиксации мерзавец описывать сначала будет искать тег, который именно теги
это коммит. Аннотированные теги всегда будут предпочтительнее легких тегов, а теги с
более новые даты всегда будут предпочтительнее тегов со старыми датами. Если точное совпадение
найдено, будет выведено его имя и поиск будет остановлен.

Если точное совпадение не найдено, мерзавец описывать вернется через историю коммитов к
найдите коммит предка, который был помечен. Тег предка будет выводиться вместе
с аббревиатурой SHA-1 входного коммита. Если - первый родитель было указано тогда
прогулка будет учитывать только первого родителя каждой фиксации.

Если во время обхода было найдено несколько тегов, то тег с наименьшим количеством коммитов
отличное от входного, будет выбрано и выведено фиксация. Здесь меньше всего коммитов
различное определяется как количество коммитов, которое будет показано git log tag..input
будет наименьшим возможным количеством коммитов.

GIT

Часть мерзавец(1) люкс

Используйте git-describe в Интернете с помощью сервисов onworks.net