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

Ævar Arnfjörð Bjarmason  [off-list ref] 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.