commit 8cf450b47f5489f895c800af75e86f24f04107d4
from: Stefan Sperling <stsp@stsp.name>
via: Thomas Adam <thomas@xteddy.org>
date: Tue Jul 22 08:17:38 2025 UTC

document additional reference name restriction details in git-repository.5

commit - 54eb751b188b2a7b07d1d4ffe4d9ccb7bccbf7f7
commit + 8cf450b47f5489f895c800af75e86f24f04107d4
blob - 6ac425f1cbd5cb398c604daf96ca5d996cfb01cf
blob + 21ee1fc8083f73d551360ee010858019f021236c
--- got/git-repository.5
+++ got/git-repository.5
@@ -113,7 +113,7 @@ tip commit of a branch.
 Because references may point to arbitrary object IDs, their use
 is not limited to branches.
 .Pp
-The name is a UTF-8 string with the following disallowed characters:
+The name is a non-empty UTF-8 string with the following disallowed characters:
 .Sq \ \&
 (space),
 \(a~ (tilde),
@@ -123,6 +123,10 @@ The name is a UTF-8 string with the following disallow
 * (asterisk),
 [ (opening square bracket),
 \\ (backslash).
+The name may not be the string
+.Dq @ ,
+may not begin with a / (slash), and may not begin or end
+with a \. (period).
 Additionally, the name may not contain the two-character sequences
 //, .. , and @{.
 .Pp