.IP
\fIENCODING\fR defines the encoding of filenames in this collection.
For \fBfs\fR this would be the encoding you use for filenames.
-Examples might be \fBiso-8859-1\fR or \fButf-8\fR.
+Examples might be \fBiso\-8859\-1\fR or \fButf\-8\fR.
If no encoding is specified then the current locale's character encoding
is used.
.IP
passed to the plugin module.
It must be an absolute path and should not end with a "/".
.TP
+.B cookie_key_lifetime \fISECONDS\fR
+Lifetime of the signing key used in constructing cookies. The default is one
+week.
+.TP
+.B cookie_login_lifetime \fISECONDS\fR
+Lifetime of a cookie enforced by the server. When the cookie expires the user
+will have to log in again even if their browser has remembered the cookie that
+long. The default is one day.
+.TP
.B default_rights \fIRIGHTS\fR
Defines the set of rights given to new users.
The argument is a comma-separated list of rights.
.B gap \fISECONDS\fR
Specifies the number of seconds to leave between tracks.
The default is 0.
+.IP
+NB this option currently DOES NOT WORK. If there is genuine demand it might be
+reinstated.
.TP
.B history \fIINTEGER\fR
Specifies the number of recently played tracks to remember (including
tracks.
The default is 31.
.TP
-.B player \fIPATTERN\fR \fIMODULE\fR [\fIOPTIONS.. [\fB--\fR]] \fIARGS\fR...
+.B player \fIPATTERN\fR \fIMODULE\fR [\fIOPTIONS.. [\fB\-\-\fR]] \fIARGS\fR...
Specifies the player for files matching the glob \fIPATTERN\fR.
\fIMODULE\fR specifies which plugin module to use.
.IP
The following options are supported:
.RS
.TP
-.B --wait-for-device\fR[\fB=\fIDEVICE\fR]
+.B \-\-wait\-for\-device\fR[\fB=\fIDEVICE\fR]
Waits (for up to a couple of seconds) for the default, or specified, libao
device to become openable.
.TP
-.B --
+.B \-\-
Defines the end of the list of options.
-Needed if the first argument to the plugin starts with a "-".
+Needed if the first argument to the plugin starts with a "\-".
.RE
.IP
The following are the standard modules:
The minimum number of seconds that must elapse between password reminders.
The default is 600, i.e. 10 minutes.
.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
+0 then there is no limit, though current \fBdisorder-choose\fR will not pick
+anything currently listed in the recently-played list.
+.TP
.B sample_format \fIBITS\fB/\fIRATE\fB/\fICHANNELS
Describes the sample format expected by the \fBspeaker_command\fR (below).
The components of the format specification are as follows:
or \fBInterrupted\fR or whatever.
.TP
.B sox_generation \fB0\fR|\fB1
-Determines whether calls to \fBsox\fR(1) should use \fB-b\fR, \fB-x\fR, etc (if
-the generation is 0) or \fB-\fIbits\fR, \fB-L\fR etc (if it is 1).
+Determines whether calls to \fBsox\fR(1) should use \fB\-b\fR, \fB\-x\fR, etc (if
+the generation is 0) or \fB\-\fIbits\fR, \fB\-L\fR etc (if it is 1).
See the documentation for your installed copy of \fBsox\fR to determine
which you need.
The default is 0.
Specify username.
The default is taken from the environment variable \fBLOGNAME\fR.
.SH "GLOBAL PREFERENCES"
-These are the values set with \fBset-global\fR.
+These are the values set with \fBset\-global\fR.
.TP
-.B required-tags
+.B required\-tags
If this is set an nonempty then randomly played tracks will always have at
least one of the listed tags.
.TP
-.B prohibited-tags
+.B prohibited\-tags
If this is set an nonempty then randomly played tracks will never have any of
the listed tags.
.TP
Otherwise it is disabled.
Use \fBdisable\fR rather than setting it directly.
.TP
-.B random-play
+.B random\-play
If unset or \fByes\fR then random play is enabled.
Otherwise it is disabled.
Use \fBdisable\fR rather than setting it directly.
the current track.
The track at the head of the queue comes first.
.TP
-.B @random-enabled@
+.B @random\-enabled@
Expands to \fBtrue\fR if random play is currently enabled, otherwise to
\fBfalse\fR.
.TP
If you use \fBsort\fR for artist and album then you are likely to get
strange effects.
.TP
-.B @server-version@
+.B @server\-version@
Expands to the server's version string.
.TP
.B @shell{\fICOMMAND\fB}@
.IP
This is the default if \fBaction\fR is missing.
.TP
-.B "random-disable"
+.B "random\-disable"
Disables random play.
.TP
-.B "random-enable"
+.B "random\-enable"
Enables random play.
.TP
.B "disable"
name and \fBext\fR which is the filename extension, including the initial dot
(or the empty string if there is not extension).
.SH "SEE ALSO"
-\fBdisorder\fR(1), \fBsox\fR(1), \fBdisorderd\fR(8), \fBdisorder-dump\fR(8),
+\fBdisorder\fR(1), \fBsox\fR(1), \fBdisorderd\fR(8), \fBdisorder\-dump\fR(8),
\fBpcrepattern\fR(3)
.\" Local Variables:
.\" mode:nroff