git/Documentation/git-mktag.txt

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

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


SYNOPSIS
--------
[verse]
'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
[PATCH 1/4] split core-git.txt and update Split the core-git.txt file Formatting fix to the diff-format.txt Signed-off-by: David Greaves <david@dgreaves.com> 2005-05-10 21:32:30 +00:00			`git-mktag(1)`
			`============`

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


			`SYNOPSIS`
			`--------`
Documentation: use [verse] for SYNOPSIS sections The SYNOPSIS sections of most commands that span several lines already use [verse] to retain line breaks. Most commands that don't span several lines seem not to use [verse]. In the HTML output, [verse] does not only preserve line breaks, but also makes the section indented, which causes a slight inconsistency between commands that use [verse] and those that don't. Use [verse] in all SYNOPSIS sections for consistency. Also remove the blank lines from git-fetch.txt and git-rebase.txt to align with the other man pages. In the case of git-rebase.txt, which already uses [verse], the blank line makes the [verse] not apply to the last line, so removing the blank line also makes the formatting within the document more consistent. While at it, add single quotes to 'git cvsimport' for consistency with other commands. Signed-off-by: Martin von Zweigbergk <martin.von.zweigbergk@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2011-07-02 02:38:26 +00:00			`[verse]`
Documentation: be consistent about "git-" versus "git " Since the git-* commands are not installed in $(bindir), using "git-command <parameters>" in examples in the documentation is not a good idea. On the other hand, it is nice to be able to refer to each command using one hyphenated word. (There is no escaping it, anyway: man page names cannot have spaces in them.) This patch retains the dash in naming an operation, command, program, process, or action. Complete command lines that can be entered at a shell (i.e., without options omitted) are made to use the dashless form. The changes consist only of replacing some spaces with hyphens and vice versa. After a "s/ /-/g", the unpatched and patched versions are identical. Signed-off-by: Jonathan Nieder <jrnieder@uchicago.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-06-30 06:09:04 +00:00			`'git mktag' < signature_file`
[PATCH 1/4] split core-git.txt and update Split the core-git.txt file Formatting fix to the diff-format.txt Signed-off-by: David Greaves <david@dgreaves.com> 2005-05-10 21:32:30 +00:00
			`DESCRIPTION`
			`-----------`
[PATCH 3/4] split core-git.txt and update Update git environment variable docs Update first section of command docs (Manipulation commands section) Signed-off-by: David Greaves <david@dgreaves.com> 2005-05-10 21:32:38 +00:00			`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`
			`----------`
mktag: minimally update the description. It lacked a description for the (historically) optional tagger header line. Signed-off-by: Junio C Hamano <gitster@pobox.com> 2007-06-10 23:00:36 +00:00			`A tag signature file has a very simple fixed format: four lines of`
[PATCH 3/4] split core-git.txt and update Update git environment variable docs Update first section of command docs (Manipulation commands section) Signed-off-by: David Greaves <david@dgreaves.com> 2005-05-10 21:32:38 +00:00
			`object <sha1>`
			`type <typename>`
			`tag <tagname>`
mktag: minimally update the description. It lacked a description for the (historically) optional tagger header line. Signed-off-by: Junio C Hamano <gitster@pobox.com> 2007-06-10 23:00:36 +00:00			`tagger <tagger>`
[PATCH 3/4] split core-git.txt and update Update git environment variable docs Update first section of command docs (Manipulation commands section) Signed-off-by: David Greaves <david@dgreaves.com> 2005-05-10 21:32:38 +00:00
mktag: minimally update the description. It lacked a description for the (historically) optional tagger header line. Signed-off-by: Junio C Hamano <gitster@pobox.com> 2007-06-10 23:00:36 +00:00			`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.`
[PATCH 1/4] split core-git.txt and update Split the core-git.txt file Formatting fix to the diff-format.txt Signed-off-by: David Greaves <david@dgreaves.com> 2005-05-10 21:32:30 +00:00
			`GIT`
			`---`
documentation: move git(7) to git(1) As the "git" man page describes the "git" command at the end-user level, it seems better to move it to man section 1. Signed-off-by: Christian Couder <chriscool@tuxfamily.org> Signed-off-by: Junio C Hamano <gitster@pobox.com> 2008-06-06 07:07:32 +00:00			`Part of the linkgit:git[1] suite`