From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 23 Mar 2017 17:16:41 GMT
Subject: Re: [PATCH v3 11/16] tag: change misleading --list <pattern> documentation
Message-ID: <xmqqpoh7eww6.fsf@gitster.mtv.corp.google.com>
In-Reply-To: <20170323130529.11361-12-avarab@gmail.com>

Ævar Arnfjörð Bjarmason  <avarab@gmail.com> writes:

> --l <pattern>::
> ---list <pattern>::
> -	List tags with names that match the given pattern (or all if no
> -	pattern is given).  Running "git tag" without arguments also
> -	lists all tags. The pattern is a shell wildcard (i.e., matched
> -	using fnmatch(3)).  Multiple patterns may be given; if any of
> -	them matches, the tag is shown.
> +-l::
> +--list::
> +	Activate the list mode. `git tag <tagname>` would try to
> +	create a tag, use `git tag --list <pattern>...` to list
> +	matching branches, (or all if no pattern is given).
> ++
> +Running "git tag" without arguments also lists all tags. The pattern
> +is a shell wildcard (i.e., matched using fnmatch(3)). Multiple
> +patterns may be given; if any of them matches, the tag is shown.

Reads much easier, especially with two separate paragraphs.  The
first one may want to match what I suggested for the "branch"
update, though.

Thanks.