commit 4659994cff5efe649166090831dd07a35b8f240b773df2220abc59fadaf87e0c from: Stefan Sperling date: Wed Jul 16 13:48:03 2025 UTC document restrictions imposed on reference names in gotsys.conf commit - 357e978e25ac6113ea8a581bbac1ea8685d6a58c55043f90753f993d37dd6da9 commit + 4659994cff5efe649166090831dd07a35b8f240b773df2220abc59fadaf87e0c blob - 9e34dd1d0fd3026765dd36d0cfc48618c59e84bd8ff3c344994c026e03bceefa blob + 53adc987f8baf28c210fec5a79a9b137fccfd706b10cbd3a39920b06595a32d2 --- gotsys/gotsys.conf.5 +++ gotsys/gotsys.conf.5 @@ -253,6 +253,30 @@ Multiple access rules can be specified, and the last m 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 .It Ic head Ar branch