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

document restrictions imposed on reference names in gotsys.conf

commit - 076101f2df32331f84fa9fe38d8394716e955814
commit + 54eb751b188b2a7b07d1d4ffe4d9ccb7bccbf7f7
blob - 1e966a7f3ba4625149bbe0046ca1df8bb112bde0
blob + cec65eda82e8d094fe8f08ce8e1d20cca8bcc38b
--- gotsys/gotsys.conf.5
+++ gotsys/gotsys.conf.5
@@ -254,6 +254,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