X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/blobdiff_plain/08ddd038f000d9e6a67a8f9a1bfdd3156c7becea..d5a2a8dd6fb3e848f0d2202ce1b631b32d204b16:/doc/disorderd.8.in

diff --git a/doc/disorderd.8.in b/doc/disorderd.8.in
index 7c708c2..b304e5a 100644
--- a/doc/disorderd.8.in
+++ b/doc/disorderd.8.in
@@ -1,5 +1,5 @@
 .\"
-.\" Copyright (C) 2004, 2005, 2007 Richard Kettlewell
+.\" Copyright (C) 2004, 2005, 2007, 2008 Richard Kettlewell
 .\"
 .\" This program is free software; you can redistribute it and/or modify
 .\" it under the terms of the GNU General Public License as published by
@@ -28,31 +28,34 @@ is a daemon which plays audio files and services requests from users
 concerning what is to be played.
 .SH OPTIONS
 .TP
-.B --config \fIPATH\fR, \fB-c \fIPATH
-Set the configuration file.  The default is
+.B \-\-config \fIPATH\fR, \fB\-c \fIPATH
+Set the configuration file.
+The default is
 .IR pkgconfdir/config .
 See
 .BR disorder_config (5)
 for further information.
 .TP
-.B --pidfile \fIPATH\fR, \fB-P \fIPATH
+.B \-\-pidfile \fIPATH\fR, \fB\-P \fIPATH
 Write a pidfile.
 .TP
-.B --foreground\fR, \fB-f
-Run in the foreground.  (By default,
+.B \-\-foreground\fR, \fB\-f
+Run in the foreground.
+(By default,
 .B disorderd
 detaches from its terminal and runs in the background.)
 .TP
-.B --syslog\fR, \fB-s
-Log to syslog.  This is the default if DisOrder runs in the background.
+.B \-\-syslog\fR, \fB\-s
+Log to syslog.
+This is the default if DisOrder runs in the background.
 .TP
-.B --debug\fR, \fB-d
+.B \-\-debug\fR, \fB\-d
 Enable debugging.
 .TP
-.B --help\fR, \fB-h
+.B \-\-help\fR, \fB\-h
 Display a usage message.
 .TP
-.B --version\fR, \fB-V
+.B \-\-version\fR, \fB\-V
 Display version number.
 .SH NOTES
 For configuration file documentation, see
@@ -60,32 +63,37 @@ For configuration file documentation, see
 .SS "Startup"
 The first time a new install of DisOrder is started it will run
 .B disorder-rescan
-to pick up new tracks.  On subsequent server restarts it will NOT do
+to pick up new tracks.
+On subsequent server restarts it will NOT do
 this automatically; if you want a rescan at every restart you must
 arrange that manually.
 .PP
 There is however an automatic rescan once every 24 hours.
 .PP
 A \fBroot\fR login is automatically created on startup if it does not
-exist.  If \fBdisorder\fR(1) is run as root on the same machine as the
+exist.
+If \fBdisorder\fR(1) is run as root on the same machine as the
 server it is capable of extracting the password from the database
 directly.
 .SS "Locales"
 .B disorderd
-is locale-aware.  If you do not set the locale correctly then it may
-not handle non-ASCII data properly.
+is locale-aware.
+If you do not set the locale correctly then it may not handle
+non-ASCII data properly.
 .PP
 Filenames and the configuration file are assumed to be encoded using the
-current locale.  Internally (within the server, in the database and in
+current locale.
+Internally (within the server, in the database and in
 communication between client and server) the UTF-8 encoding is used.
 .SS Backups
 DisOrder uses Berkeley DB but currently discards log files that are no longer
-in use.  This means that DB's catastrophic recovery cannot be used (normal
+in use.
+This means that DB's catastrophic recovery cannot be used (normal
 recovery can be used, and indeed the server does this automatically on
 startup).
 .PP
 It is suggested that instead you just back up the output of
-.BR disorder-dump (8),
+.BR disorder\-dump (8),
 which saves only the parts of the database that cannot be regenerated
 automatically, and thus has relatively modest storage requirements.
 .SH SIGNALS
@@ -104,7 +112,8 @@ It may be more convenient to perform these operations from the client
 .SH FILES
 .TP
 .I pkgconfdir/config
-Global configuration file.  See \fBdisorder_config\fR(5).
+Global configuration file.
+See \fBdisorder_config\fR(5).
 .TP
 .I pkgconfdir/config.private
 Private configuration (usernames and passwords).
@@ -113,7 +122,8 @@ Private configuration (usernames and passwords).
 Per-user password file.
 .TP
 .I pkgstatedir/queue
-Saved copy of queue.  Do not edit while the daemon is running.
+Saved copy of queue.
+Do not edit while the daemon is running.
 .TP
 .I pkgstatedir/recent
 Saved copy of recently played track list.
@@ -135,9 +145,10 @@ Tag lookup database.
 Tracks database.
 .TP
 .I pkgstatedir/DB_CONFIG
-Berkeley DB configuration file.  This may be used to override database
-settings without recompiling DisOrder.  See the Berkeley DB
-documention for further details.
+Berkeley DB configuration file.
+This may be used to override database settings without recompiling
+DisOrder.
+See the Berkeley DB documention for further details.
 .TP
 .I pkgstatedir/log.* \fRand \fIpkgstatedir/__db.*
 Database internal files.
@@ -146,14 +157,16 @@ Database internal files.
 Communication socket for \fBdisorder\fR(1).
 .TP
 .I pkgstatedir/lock
-Lockfile.  This prevents multiple instances of DisOrder running
-simultaneously.
+Lockfile.
+This prevents multiple instances of DisOrder running simultaneously.
 .SH ENVIRONMENT
 .TP
 .B LC_ALL\fR, \fBLANG\fR, etc
-Current locale.  See \fBlocale\fR(7).
+Current locale.
+See \fBlocale\fR(7).
 .SH "SEE ALSO"
-\fBdisorder\fR(1), \fBdisorder_config\fR(5), \fBdisorder-dump\fR(8)
+\fBdisorder\fR(1), \fBdisorder_config\fR(5), \fBdisorder\-dump\fR(8),
+\fBdisorder.cgi\fR(8)
 .\" Local Variables:
 .\" mode:nroff
 .\" End: