X-Git-Url: https://git.distorted.org.uk/~mdw/disorder/blobdiff_plain/a8161466d71d155152affeb9bf5c3ffa2cdbdb0d..ca83183166cfcc9e6cfa412a2d870746e9dad5ae:/doc/disobedience.1.in diff --git a/doc/disobedience.1.in b/doc/disobedience.1.in index e989c61..7c66b57 100644 --- a/doc/disobedience.1.in +++ b/doc/disobedience.1.in @@ -1,5 +1,5 @@ .\" -.\" Copyright (C) 2004, 2005, 2006 Richard Kettlewell +.\" Copyright (C) 2004, 2005, 2006, 2007 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 @@ -24,36 +24,7 @@ disobedience \- GUI client for DisOrder jukebox .RI [ OPTIONS ] .SH DESCRIPTION .B disobedience -is a graphical client for DisOrder. It is a work in progress and many features -are not implemented yet. However everything in this man page is either -implemented or marked as missing. -.SH OPTIONS -.TP -.B --config \fIPATH\fR, \fB-c \fIPATH -Set the configuration file. The default is -.IR pkgconfdir/config . -.TP -.B --debug\fR, \fB-d -Enable debugging. -.TP -.B --help\fR, \fB-h -Display a usage message. -.TP -.B --version\fR, \fB-V -Display version number. -.SS "GTK+ Options" -Additional options are supported by the GTK+ library. Refer to GTK+ -documentation for further information. Under X11 they include: -.TP -.B --display \fIDISPLAY\fR -The X display to use. -.TP -.B --screen \fISCREEN\fR -The screen number to use. -.\" If know enough to use it you know enough to find it -.\" .TP -.\" .B --sync -.\" Make all X requests synchronously. +is a graphical client for DisOrder. .SH "WINDOWS AND ICONS" .SS "File Menu" This only has one option, "Quit", which terminates the program. @@ -64,7 +35,9 @@ This has the following options: Select all tracks in whichever of the Queue or Recent tabs are showing. .TP .B Properties -Edit the details of the selected tracks. +Edit the details of the selected tracks. See +.B "Properties Window" +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. @@ -148,22 +121,57 @@ Left clicking on a file will select it. As with the queue tab you can use SHIFT and CTRL to select multiple files. .PP The text box at the top is a search form. If you enter search terms here then -the display will be limited to tracks containing all those words. You can also +tracks containing all those words will be highlighted. You can also limit the results to tracks with particular tags, by including \fBtag:\fITAG\fR for each tag. .PP To start a new search just edit the contents of the search box. The cancel button to its right clears the current search. .PP -Right clicking will pop up a menu with the following options: +Right clicking over a track will pop up a menu with the following options: .TP .B Play Play selected tracks. .TP .B Properties -Edit properties of selected tracks. +Edit properties of selected tracks. See +.B "Properties Window" +below. +.PP +A middle click on a track will add it to the queue. +.PP +Right clicking over a directory will pop up a menu with the following options: +.TP +.B "Play all tracks" +Play all the tracks in the directory, in the order they appear on screen. +.TP +.B "Track properties" +Edit properties of all tracks in the directory. +.TP +.B "Select all tracks" +Select all the tracks in the directory (and deselect everything else). +.PP +Note that these options do not apply recursively - only the tracks in the +relevant directory are affected, not those in its subdirectories. +.SS "Added Tab" +This displays a list of tracks recently added to the server's database. The +most recently added track is at the top. +.PP +Left clicking a track will select it. CTRL and SHIFT work as above to select +muliple files. .PP -A middle click on a file will add it to the queue. +Right clicking over a track will pop up a menu with the following options: +.TP +.B "Track properties" +Edit properties of selected tracks. See +.B "Properties Window" +below. +.TP +.B "Play track" +Play selected tracks. +.TP +.B "Select All Tracks" +Select all tracks. .SS "Properties Window" This window contains details of one or more tracks and allows them to be edited. @@ -178,6 +186,11 @@ The Random checkbox determines whether the track will be picked at random. Random play is enabled for every track by default, but it can be turned off here. .PP +The double-headed arrow to the right of each preference will propagate its +value to all the other tracks in the window. For instance, this can be used to +efficiently correct the artist or album fields, or bulk-disable random play for +many tracks. +.PP Press "OK" to confirm all changes and close the window, "Apply" to confirm changes but keep the window open and "Cancel" to close the window and discard all changes. @@ -188,9 +201,37 @@ Select all tracks (queue/recent) .TP .B CTRL+Q Quit. +.SH OPTIONS +.TP +.B --config \fIPATH\fR, \fB-c \fIPATH +Set the configuration file. The default is +.IR pkgconfdir/config . +.TP +.B --debug\fR, \fB-d +Enable debugging. +.TP +.B --help\fR, \fB-h +Display a usage message. +.TP +.B --version\fR, \fB-V +Display version number. +.SS "GTK+ Options" +Additional options are supported by the GTK+ library. Refer to GTK+ +documentation for further information. Under X11 they include: +.TP +.B --display \fIDISPLAY\fR +The X display to use. +.TP +.B --screen \fISCREEN\fR +The screen number to use. +.\" If know enough to use it you know enough to find it +.\" .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. +Disobedience. +.\" TODO example that actually works. .SS "Widget Names" .TP .B disobedience.*.choose @@ -224,9 +265,26 @@ directive. Also the client will need user passwords, either in .IR pkgconfdir/config. USER or .IR ~ USER /.disorder.passwd . +.PP +You might use commands such as the following to set up a standalone instance of +Disobedience: +.PP +.RS +.nf +cd +mkdir .disorder +echo password > .disorder/passwd +echo connect >> .disorder/passwd +chmod 600 .disorder/passwd +.fi +.RE .SH "SEE ALSO" .BR disorder_config (5) .PP +.B http://www.greenend.org.uk/rjk/disorder/ +.br +- DisOrder home page +.PP .B http://www.gtk.org/api/2.6/gtk/gtk-x11.html .br - Using GTK+ on the X Window System