X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-tag.txt;h=990ae4f948920477500b6a19a2350a61cbd7c3cd;hb=10455d2a955a29db1809be139177e4e298771eb0;hp=70235e8ddb3e43805d699dd0bf264f585409697e;hpb=3eee9c6dbebcf6341ad202f7dd4d416ef3fcba5e;p=git.git diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index 70235e8dd..990ae4f94 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -9,9 +9,10 @@ git-tag - Create, list, delete or verify a tag object signed with GPG SYNOPSIS -------- [verse] -'git-tag' [-a | -s | -u ] [-f | -v] [-m | -F ] [] +'git-tag' [-a | -s | -u ] [-f] [-m | -F ] [] 'git-tag' -d ... -'git-tag' -l [] +'git-tag' [-n []] -l [] +'git-tag' -v ... DESCRIPTION ----------- @@ -22,7 +23,7 @@ Unless `-f` is given, the tag must not yet exist in If one of `-a`, `-s`, or `-u ` is passed, the command creates a 'tag' object, and requires the tag message. Unless -`-m ` is given, an editor is started for the user to type +`-m ` or `-F ` is given, an editor is started for the user to type in the tag message. Otherwise just the SHA1 object name of the commit object is @@ -33,13 +34,6 @@ A GnuPG signed tag object will be created when `-s` or `-u committer identity for the current user is used to find the GnuPG key for signing. -`-d ` deletes the tag. - -`-v ` verifies the gpg signature of the tag. - -`-l ` lists tags that match the given pattern (or all -if no pattern is given). - OPTIONS ------- -a:: @@ -58,10 +52,17 @@ OPTIONS Delete existing tags with the given names. -v:: - Verify the gpg signature of given the tag + Verify the gpg signature of the given tag names. + +-n :: + specifies how many lines from the annotation, if any, + are printed when using -l. + The default is not to print any annotation lines. + If no number is given to `-n`, only the first line is printed. -l :: - List tags that match the given pattern (or all if no pattern is given). + List tags with names that match the given pattern (or all if no pattern is given). + Typing "git tag" without arguments, also lists all tags. -m :: Use the given tag message (instead of prompting) @@ -77,8 +78,10 @@ committer identity (of the form "Your Name ") to find a key. If you want to use a different default key, you can specify it in the repository configuration as follows: +------------------------------------- [user] signingkey = +------------------------------------- DISCUSSION