From 980ea5c5bb1dfbbf93b919942c703b9158c35968 Mon Sep 17 00:00:00 2001 From: Matthijs Melchior Date: Sun, 3 Jun 2007 02:05:39 +0200 Subject: Teach git-tag about showing tag annotations. The for -l is now a shell pattern, not a list of grep parameters. Option -l may be repeated with another . The new -n [] option specifies how many lines from the annotation are to be printed. Not specifieing -n or -n 0 will just produce the tag names Just -n or -n 1 will show the first line of the annotation on the tag line. Other valuse for -n will show that number of lines from the annotation. The exit code used to indicate if any tag was found. This is changed due to a different implementation. A good way to test a tag for existence is to use: git show-ref --quiet --verify refs/tags/$TAGNAME Signed-off-by: Matthijs Melchior Signed-off-by: Junio C Hamano --- Documentation/git-tag.txt | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'Documentation') diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index 4e3e02756..aee2c1bdc 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -11,7 +11,7 @@ SYNOPSIS [verse] 'git-tag' [-a | -s | -u ] [-f] [-m | -F ] [] 'git-tag' -d ... -'git-tag' -l [] +'git-tag' [-n []] -l [] 'git-tag' -v DESCRIPTION @@ -38,8 +38,8 @@ GnuPG key for signing. `-v ` verifies the gpg signature of the tag. -`-l ` lists tags that match the given pattern (or all -if no pattern is given). +`-l ` lists tags with names that match the given pattern +(or all if no pattern is given). OPTIONS ------- @@ -61,8 +61,13 @@ OPTIONS -v:: Verify the gpg signature of given the tag +-n :: + specifies how many lines from the annotation, if any, + are printed when using -l. + The default is not to print any annotation lines. + -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). -m :: Use the given tag message (instead of prompting) -- cgit v1.2.1