chiark / gitweb /
remove obsolete stuff about authentication
[disorder] / doc / disobedience.1.in
index 912a9c66bca5112b3432654587b9d5d2b4ebd972..cc177566fbaf799194c34ccd493983afaa14f2d3 100644 (file)
@@ -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.
@@ -64,6 +81,11 @@ not take effect until the currently playing track finishes.
 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 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
 it.  0 is silent and 10 is maximum volume.
@@ -240,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
@@ -267,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
@@ -305,7 +316,22 @@ 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
+Socket for communication with RTP player.
+.TP
+.I ~/.disorder/HOSTNAME-rtp.log
+Log file for RTP player.
 .SH "SEE ALSO"
+.BR disorder-playrtp (1),
 .BR disorder_config (5)
 .PP
 .B http://www.greenend.org.uk/rjk/disorder/