[thirdparty/git.git] / Documentation / git-mktag.txt

git-mktag(1)
============

NAME
----
git-mktag - Creates a tag object


SYNOPSIS
--------
[verse]
'git mktag'

DESCRIPTION
-----------
Reads a tag contents on standard input and creates a tag object
that can also be used to sign other objects.

The output is the new tag's <object> identifier.

Tag Format
----------
A tag signature file, to be fed to this command's standard input,
has a very simple fixed format: four lines of

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

followed by some 'optional' free-form message (some tags created
by older Git may not have `tagger` line).  The message, when
exists, is separated by a blank line from the header.  The
message part may contain a signature that Git itself doesn't
care about, but that can be verified with gpg.

GIT
---
Part of the linkgit:git[1] suite
Commit	Line	Data
	1	git-mktag(1)
	2	============
	3
	4	NAME
	5	----
	6	git-mktag - Creates a tag object
	7
	8
	9	SYNOPSIS
	10	--------
	11	[verse]
	12	'git mktag'
	13
	14	DESCRIPTION
	15	-----------
	16	Reads a tag contents on standard input and creates a tag object
	17	that can also be used to sign other objects.
	18
	19	The output is the new tag's <object> identifier.
	20
	21	Tag Format
	22	----------
	23	A tag signature file, to be fed to this command's standard input,
	24	has a very simple fixed format: four lines of
	25
	26	object <sha1>
	27	type <typename>
	28	tag <tagname>
	29	tagger <tagger>
	30
	31	followed by some 'optional' free-form message (some tags created
	32	by older Git may not have `tagger` line). The message, when
	33	exists, is separated by a blank line from the header. The
	34	message part may contain a signature that Git itself doesn't
	35	care about, but that can be verified with gpg.
	36
	37	GIT
	38	---
	39	Part of the linkgit:git[1] suite