Documentation/technical: signed tag format
Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Michael J Gruber committed
Jun 17, 2016 at 09:46 UTC
5f1abfeb69bd9984aabd91d69bfe8a9adb7d9dec
1 file changed
+47
Documentation/technical/signature-format.txt
+47
@@ -15,3 +15,50 @@ produce RFC1991 signatures which use `MESSAGE` instead of `SIGNATURE`.
15
16
The signed payload and the way the signature is embedded depends
17
on the type of the object resp. transaction.
18
+
19
+== Tag signatures
20
+
21
+- created by: `git tag -s`
22
+- payload: annotated tag object
23
+- embedding: append the signature to the unsigned tag object
24
+- example: tag `signedtag` with subject `signed tag`
25
+
26
+----
27
+object 04b871796dc0420f8e7561a895b52484b701d51a
28
+type commit
29
+tag signedtag
30
+tagger C O Mitter <committer@example.com> 1465981006 +0000
31
+
32
+signed tag
33
+
34
+signed tag message body
35
+-----BEGIN PGP SIGNATURE-----
36
+Version: GnuPG v1
37
+
38
+iQEcBAABAgAGBQJXYRhOAAoJEGEJLoW3InGJklkIAIcnhL7RwEb/+QeX9enkXhxn
39
+rxfdqrvWd1K80sl2TOt8Bg/NYwrUBw/RWJ+sg/hhHp4WtvE1HDGHlkEz3y11Lkuh
40
+8tSxS3qKTxXUGozyPGuE90sJfExhZlW4knIQ1wt/yWqM+33E9pN4hzPqLwyrdods
41
+q8FWEqPPUbSJXoMbRPw04S5jrLtZSsUWbRYjmJCHzlhSfFWW4eFd37uquIaLUBS0
42
+rkC3Jrx7420jkIpgFcTI2s60uhSQLzgcCwdA2ukSYIRnjg/zDkj8+3h/GaROJ72x
43
+lZyI6HWixKJkWw8lE9aAOD9TmTW9sFJwcVAzmAuFX2kUreDUKMZduGcoRYGpD7E=
44
+=jpXa
45
+-----END PGP SIGNATURE-----
46
+----
47
+
48
+- verify with: `git verify-tag [-v]` or `git tag -v`
49
+
50
+----
51
+gpg: Signature made Wed Jun 15 10:56:46 2016 CEST using RSA key ID B7227189
52
+gpg: Good signature from "Eris Discordia <discord@example.net>"
53
+gpg: WARNING: This key is not certified with a trusted signature!
54
+gpg: There is no indication that the signature belongs to the owner.
55
+Primary key fingerprint: D4BE 2231 1AD3 131E 5EDA 29A4 6109 2E85 B722 7189
56
+object 04b871796dc0420f8e7561a895b52484b701d51a
57
+type commit
58
+tag signedtag
59
+tagger C O Mitter <committer@example.com> 1465981006 +0000
60
+
61
+signed tag
62
+
63
+signed tag message body
64
+----