git-mktag

git-mktag - Создаёт объект тега с дополнительной валидацией

Считывает содержимое тега со стандартного ввода и создаёт объект тега. Вывод — идентификатор нового объекта тега <object>.

Эта команда в основном эквивалентна команде git-hash-object[1], вызванной с -t tag -w --stdin. То есть, обе эти команды создадут и запишут тег, найденный в my-tag.

git mktag <my-tag
git hash-object -t tag -w --stdin <my-tag

Разница в том, что команда mktag завершится ошибкой, прежде чем записать тег, если тег не пройдёт проверку git-fsck[1].

Проверка "fsck", выполняемая командой mktag, более строгая, чем та, что выполняется командой git-fsck[1] по умолчанию, в том смысле, что все сообщения fsck.<msg-id> повышаются со статуса предупреждений до статуса ошибок (например, отсутствие строки "tagger" — это ошибка).

Дополнительные заголовки в объекте также являются ошибкой при использовании mktag, но игнорируются командой git-fsck[1]. Эту дополнительную проверку можно отключить, установив соответствующую переменную fsck.<msg-id>.

git -c fsck.extraHeaderEntry=ignore mktag <my-tag-with-headers

Файл подписи тега, который должен быть передан на стандартный ввод этой команде, имеет очень простой фиксированный формат: четыре строки

object <hash>
type <typename>
tag <tagname>
tagger <tagger>

за которыми следует некоторое optional сообщение произвольной формы (некоторые теги, созданные более старыми версиями Git, могут не иметь строки tagger). Сообщение, если оно существует, отделяется от заголовка пустой строкой. Часть сообщения может содержать подпись, которой Git не интересуется, но которую можно проверить с помощью gpg.