commit 59d7decb8c1564998e913d8ea3ddb85dc7a254c6
from: Stefan Sperling <stsp@stsp.name>
date: Wed Jul 16 13:48:03 2025 UTC

document restrictions imposed on reference names in gotsys.conf

commit - 00fc2bb90963db33831c38e507e38a9391a433ea
commit + 59d7decb8c1564998e913d8ea3ddb85dc7a254c6
blob - 40ab2cfbf39d2ba36307f2e0b0cd80d31af840b0
blob + ef50d4397db523880b04c798f4aa21619f7875d9
--- gotsys/gotsys.conf.5
+++ gotsys/gotsys.conf.5
@@ -252,6 +252,30 @@ configuration directives.
 Multiple access rules can be specified, and the last matching rule
 determines the action taken.
 If no rule matches, access to the repository is denied.
+.Pp
+Reference and branch names specified in
+.Nm
+are non-empty UTF-8 strings with the following disallowed characters:
+.Sq \ \&
+(space, tab, formfeed, newline, carriage return),
+\(a~ (tilde),
+\(a^ (caret),
+: (colon),
+? (question mark),
+* (asterisk),
+[ (opening square bracket),
+\\ (backslash),
+" (double quote),
+\' (single quote),
+{ (opening curly brace),
+} (closing curly brace),
+= (equal sign).
+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
 The available repository configuration directives are as follows:
 .Bl -tag -width Ds