Re: [PATCH v3 11/16] tag: change misleading --list <pattern> documentation

From: Junio C Hamano <gitster@pobox.com>
Date: Mar 23, 2017, 17:16 UTC
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:

Show 16 quoted lines

> --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.