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

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

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


SYNOPSIS
--------
'git mktag' < signature_file

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