X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/blobdiff_plain/ab23e130f24181de7018be283ddb10de1bfaea82..4a4c673c7705370b080f225d959293b845168a0c:/doc/disobedience.1.in

diff --git a/doc/disobedience.1.in b/doc/disobedience.1.in
index b871061..cc17756 100644
--- a/doc/disobedience.1.in
+++ b/doc/disobedience.1.in
@@ -44,6 +44,23 @@ Select all tracks in whichever of the Queue or Recent tabs are showing.
 Edit the details of the selected tracks.  See
 .B "Properties Window"
 below.
+.SS "Control Menu"
+This has the following options:
+.TP
+.B Scratch
+Interrupts the currently playing track.
+.TP
+.B Playing
+Pause and resume the current track.
+.TP
+.B "Random play"
+Enable and disable random play.  Does not take effect until the currently
+playing track finishes.
+.TP
+.B "Network player"
+Enables or disables network play.  See
+.B "NETWORK PLAY"
+below.
 .SS "Help Menu"
 This has only one option, "About DisOrder", which pops up a box giving the
 name, author and version number of the software.
@@ -65,14 +82,9 @@ The play button controls whether tracks will be played at all.  As above it
 does not take effect until the currently playing track finishes.
 .TP
 .B "Network play button"
-The network play buttons enables or disables a background
-.BR disorder-playrtp (1)
-process.  If you quit Disobedience the player will continue playing and can be
-disabled from a later run of Disobedience.
-.IP
-The player will log to
-.I ~/.disorder/HOSTNAME-rtp.log
-so look there if it does not seem to be working.
+The network play buttons enables or disables network play.  See
+.B "NETWORK PLAY"
+below.
 .TP
 .B "Volume slider"
 The volume slider indicates the current volume level and can be used to adjust
@@ -250,6 +262,18 @@ Brings up the \fBLogin Details Window\fR.
 .TP
 .B CTRL+Q
 Quit.
+.SH "NETWORK PLAY"
+Network play uses a background
+.BR disorder-playrtp (1)
+process.  If you quit Disobedience the player will continue playing and can be
+disabled from a later run of Disobedience.
+.PP
+The player will log to
+.I ~/.disorder/HOSTNAME-rtp.log
+so look there if it does not seem to be working.
+.PP
+You can stop it without running Disobedience by the command
+.BR "killall disorder-playrtp" .
 .SH OPTIONS
 .TP
 .B --config \fIPATH\fR, \fB-c \fIPATH
@@ -277,29 +301,6 @@ The screen number to use.
 .\" .TP
 .\" .B --sync
 .\" Make all X requests synchronously.
-.SH "GTK+ RESOURCES"
-You can override these resources in order to customize the appearance of
-Disobedience.
-.\" TODO example that actually works.
-.SS "Widget Names"
-.TP
-.B disobedience.*.choose
-This is the panel containing the track choice tree.
-.TP
-.B disobedience.*.queue
-This is the panel displaying the queue.
-.TP
-.B disobedience.*.choose
-This is the panel listing recently played tracks.
-.TP
-.B disobedience.*.row-playing
-This is the row listing the currently playing track.
-.TP
-.B disobedience.*.row-odd
-This an odd-numbered row in the queue or recently played track list.
-.TP
-.B disobedience.*.row-even
-This an even-numbered row in the queue or recently played track list.
 .SH CONFIGURATION
 If you are using
 .B disobedience
@@ -315,6 +316,13 @@ The other clients read their configuration from the same location so after
 setting up with Disobedience, tools such as
 .BR disorder (1)
 should work as well.
+.SH BUGS
+Disobedience is newly introduced with DisOrder 2.0.  There are bound to be
+bugs.  Please send feedback.
+.PP
+There is no particular provision for multiple users of the same computer
+sharing a single \fBdisorder-playrtp\fR process.  This shouldn't be too much of
+a problem in practice but something could perhaps be done given demand.
 .SH FILES
 .TP
 .I ~/.disorder/HOSTNAME-rtp