#756775 git: git tag does not tell one which chars are valid in tag names

Package:
git-man
Source:
git
Submitter:
Thorsten Glaser
Date:
2014-08-01 20:33:11 UTC
Severity:
minor
#756775#5
Date:
2014-08-01 15:50:55 UTC
From:
To:
Hi,

this is a usability bug:

fatal: 'versions/SimKolab-3~beta8' is not a valid tag name.

Nowhere in “git help tag” is said what is.
#756775#10
Date:
2014-08-01 16:21:53 UTC
From:
To:
reassign 756775 git-man 1:2.0.1-1
# documentation
severity 756775 minor
quit

Hi Thorsten,

Thorsten Glaser wrote:

Thanks for reporting.  "git help tag" says

	<tagname>
		The name of the tag to create, delete, or describe.
		The new tag name must pass all checks defined by
		git-check-ref-format(1). Some of these checks may
		restrict the characters allowed in a tag name.

and 'man 1 git check-ref-format' says

	4. They cannot have ASCII control characters (i.e. bytes whose
	   values are lower than \040, or \177 DEL), space, tilde ~,
	   caret ^, or colon : anywhere.

Any ideas for improving the wording in Documentation/git-tag.txt?
E.g., should it have a note in the DESCRIPTION section, or should it
use the word "valid" to make searching within the file easier?

Thanks,
Jonathan
#756775#23
Date:
2014-08-01 20:29:46 UTC
From:
To:
Jonathan Nieder dixit:

Aaaaaah!

Hm… will have to think about it.

I searched for that and “a-z”, yes, that would help, also
maybe a regexp.

bye,
//mirabilos