[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
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	--------
7791a1d9	11	[verse]
33e8fc87	12	'git mktag'
2cf565c5 DG	13
	14	DESCRIPTION
	15	-----------
c1bdacf9 DG	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	----------
33e8fc87 JH	23	A tag signature file, to be fed to this command's standard input,
33e8fc87 JH	24	has a very simple fixed format: four lines of
c1bdacf9 DG	25
	26	object <sha1>
	27	type <typename>
	28	tag <tagname>
6cfec036	29	tagger <tagger>
c1bdacf9	30
6cfec036	31	followed by some 'optional' free-form message (some tags created
2de9b711	32	by older Git may not have `tagger` line). The message, when
6cfec036	33	exists, is separated by a blank line from the header. The
2de9b711	34	message part may contain a signature that Git itself doesn't
6cfec036	35	care about, but that can be verified with gpg.
2cf565c5	36
2cf565c5 DG	37	GIT
2cf565c5 DG	38	---
9e1f0a85	39	Part of the linkgit:git[1] suite