X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/blobdiff_plain/601b42c1d28069afd8a8ba694baefb76e6ea5171..30d855885418ebe3e7bf76fd800909cdf7bb178a:/doc/disorder_config.5.in diff --git a/doc/disorder_config.5.in b/doc/disorder_config.5.in index b0f20ae..c9b2061 100644 --- a/doc/disorder_config.5.in +++ b/doc/disorder_config.5.in @@ -214,12 +214,12 @@ Configuration files are read in the following order: Should be readable only by the jukebox group. Not really useful any more and will be abolished in future. .TP -.I ~\fRUSER\fI/.disorder/passwd +.I ~\fRUSERNAME\fI/.disorder/passwd Per-user client configuration. Optional but if it exists must be readable only by the relevant user. Would normally contain a \fBpassword\fR directive. .TP -.I pkgconfdir/config.\fRUSER +.I pkgconfdir/config.\fRUSERNAME Per-user system-controlled client configuration. Optional but if it exists must be readable only by the relevant user. Would normally contain a \fBpassword\fR directive. @@ -593,6 +593,10 @@ The default is 10. The minimum number of seconds that must elapse between password reminders. The default is 600, i.e. 10 minutes. .TP +.B remote_userman yes\fR|\fBno +User management over TCP connection is only allowed if this is set to +\fByes\fR. By default it is set to \fBno\fR. +.TP .B replay_min \fISECONDS\fR The minimum number of seconds that must elapse after a track has been played before it can be picked at random. The default is 8 hours. If this is set to @@ -691,7 +695,7 @@ Specifies the module used to calculate the length of files matching If \fBtracklength\fR is used without arguments then the list of modules is cleared. .TP -.B user \fIUSER\fR +.B user \fIUSERNAME\fR Specifies the user to run as. Only makes sense if invoked as root (or the target user). .SS "Client Configuration" @@ -768,8 +772,9 @@ longer needs to be specified. This must be the full URL, e.g. \fBhttp://myhost/cgi-bin/jukebox\fR and not \fB/cgi-bin/jukebox\fR. .SS "Authentication Configuration" -These options would normally be used in \fI~\fRUSER\fI/.disorder/passwd\fR or -\fIpkgconfdir/config.\fRUSER. +These options would normally be used in \fI~\fRUSERNAME\fI/.disorder/passwd\fR +or +\fIpkgconfdir/config.\fRUSERNAME. .TP .B password \fIPASSWORD\fR Specify password. @@ -902,14 +907,20 @@ character reference, e.g. \fBý\fR. Use \fB@\fR to insert a literal \fB@\fR without falling foul of the expansion syntax. .SS "Expansion Syntax" -Expansions are surrounded by at ("@") symbols take the form of a keyword -followed by zero or more arguments. -Arguments may either be quoted by curly brackets ("{" and "}") or separated +An expansion starts with an at ("@") symbol and takes the form of an expansion +name followed by zero or more arguments. +.PP +Arguments can be quoted by curly brackets ("{" and "}") or separated by colons (":"). Both kinds may be mixed in a single expansion, though doing so seems likely to cause confusion. The descriptions below contain suggested forms for each expansion. .PP +An expansion is terminated by another "@" symbol, but this is optional in the +specific case that the last argument is quoted by curly brackets and it is +followed by whitespace and then some character that is not "{" (since that +could be interpreted as a further argument). +.PP Leading and trailing whitespace in unquoted arguments is ignored, as is whitespace (including newlines) following a close bracket ("}"). .PP