var doc: advertise current DEFAULT_PAGER and DEFAULT_EDITOR settings
[alt-git.git] / Documentation / git-mktag.txt
blob65e167a5c580c694a66cbb391938359a38ddd3e0
1 git-mktag(1)
2 ============
4 NAME
5 ----
6 git-mktag - Creates a tag object
9 SYNOPSIS
10 --------
11 [verse]
12 'git mktag' < signature_file
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.
19 The output is the new tag's <object> identifier.
21 Tag Format
22 ----------
23 A tag signature file has a very simple fixed format: four lines of
25   object <sha1>
26   type <typename>
27   tag <tagname>
28   tagger <tagger>
30 followed by some 'optional' free-form message (some tags created
31 by older git may not have `tagger` line).  The message, when
32 exists, is separated by a blank line from the header.  The
33 message part may contain a signature that git itself doesn't
34 care about, but that can be verified with gpg.
36 GIT
37 ---
38 Part of the linkgit:git[1] suite