git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
blob 3ba15072df3abd1398dc4d3c67a0b26b3ef895ae 1509 bytes (raw)
name: Documentation/git-mktag.txt 	 # note: path name is non-authoritative(*)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
 
git-mktag(1)
============

NAME
----
git-mktag - Creates a tag object with extra validation


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

DESCRIPTION
-----------

Reads a tag contents on standard input and creates a tag object. The
output is the new tag's <object> identifier.

This command accepts a subset of what linkgit:git-hash-object[1] would
accept with `-t tag --stdin`. I.e. both of these work:

    git mktag <my-tag
    git hash-object -t tag --stdin <my-tag

The difference between the two is that mktag does the equivalent of a
linkgit:git-fsck(1) check on its input, and furthermore disallows some
thing linkgit:git-hash-object[1] would pass, e.g. extra headers in the
object before the message.

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 <hash>
  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.

HISTORY
-------

In versions of Git before v2.30.0 the "mktag" command's validation
logic was subtly different than that of linkgit:git-fsck[1]. It is now
a strict superset of linkgit:git-fsck[1]'s validation logic.

SEE ALSO
--------
linkgit:git-hash-object[1],

GIT
---
Part of the linkgit:git[1] suite

debug log:

solving 3ba15072df ...
found 3ba15072df in https://public-inbox.org/git/20201126012854.399-12-avarab@gmail.com/ ||
	https://public-inbox.org/git/20201126222257.5629-11-avarab@gmail.com/
found 11ce8e4bb4 in https://public-inbox.org/git/20201126012854.399-11-avarab@gmail.com/
found fa6a756123 in https://80x24.org/mirrors/git.git
preparing index
index prepared:
100644 fa6a7561236f70808994cf63c37b400b6e337318	Documentation/git-mktag.txt

applying [1/2] https://public-inbox.org/git/20201126012854.399-11-avarab@gmail.com/
diff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt
index fa6a756123..11ce8e4bb4 100644


applying [2/2] https://public-inbox.org/git/20201126012854.399-12-avarab@gmail.com/
diff --git a/Documentation/git-mktag.txt b/Documentation/git-mktag.txt
index 11ce8e4bb4..3ba15072df 100644

Checking patch Documentation/git-mktag.txt...
Applied patch Documentation/git-mktag.txt cleanly.
Checking patch Documentation/git-mktag.txt...
Applied patch Documentation/git-mktag.txt cleanly.

skipping https://public-inbox.org/git/20201126222257.5629-11-avarab@gmail.com/ for 3ba15072df
index at:
100644 3ba15072df3abd1398dc4d3c67a0b26b3ef895ae	Documentation/git-mktag.txt

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).