# [PATCH] git-tag.txt: <commit> for --contains is optional

2 messages from 2014-02-04 to 2014-02-04. Participants: Nguyễn Thái Ngọc Duy, Junio C Hamano.
Thread: https://gitlist.dev/t/35794

## Nguyễn Thái Ngọc Duy, 2014-02-04 02:56

Subject: [PATCH] git-tag.txt: <commit> for --contains is optional
Message-ID: <1391482586-26444-1-git-send-email-pclouds@gmail.com>
URL: https://gitlist.dev/e/1391482586-26444-1-git-send-email-pclouds%40gmail.com

```
This goes far back to e84fb2f (branch --contains: default to HEAD -
2008-07-08) where the same parsing code is shared with
builtin/tag.c. git-branch.txt correctly states that <commit> for
--contains is optional while git-tag.txt does not. Correct it.

Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
---
 Documentation/git-tag.txt | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
index c418c44..404257d 100644
--- a/Documentation/git-tag.txt
+++ b/Documentation/git-tag.txt
@@ -103,8 +103,9 @@ OPTIONS
 +
 This option is only applicable when listing tags without annotation lines.
 
---contains <commit>::
-	Only list tags which contain the specified commit.
+--contains [<commit>]::
+	Only list tags which contain the specified commit (HEAD if not
+	specified).
 
 --points-at <object>::
 	Only list tags of the given object.
-- 
1.8.5.2.240.g8478abd

```

## Junio C Hamano, 2014-02-04 18:36

Subject: Re: [PATCH] git-tag.txt: <commit> for --contains is optional
Message-ID: <xmqq8utqafoo.fsf@gitster.dls.corp.google.com>
URL: https://gitlist.dev/e/xmqq8utqafoo.fsf%40gitster.dls.corp.google.com
In-Reply-To: <1391482586-26444-1-git-send-email-pclouds@gmail.com>

```
Nguyễn Thái Ngọc Duy  <pclouds@gmail.com> writes:

> This goes far back to e84fb2f (branch --contains: default to HEAD -
> 2008-07-08) where the same parsing code is shared with
> builtin/tag.c. git-branch.txt correctly states that <commit> for
> --contains is optional while git-tag.txt does not. Correct it.
>
> Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
> ---
>  Documentation/git-tag.txt | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
> index c418c44..404257d 100644
> --- a/Documentation/git-tag.txt
> +++ b/Documentation/git-tag.txt
> @@ -103,8 +103,9 @@ OPTIONS
>  +
>  This option is only applicable when listing tags without annotation lines.
>  
> ---contains <commit>::
> -	Only list tags which contain the specified commit.
> +--contains [<commit>]::
> +	Only list tags which contain the specified commit (HEAD if not
> +	specified).

Thanks.

>  
>  --points-at <object>::
>  	Only list tags of the given object.

```