com_cs: Return a syntax error if argc > 2.
[paraslash.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 9d82c9b..04bf53f 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -76,28 +76,29 @@ example) and try
 to retrieve the list of available commands and some server info.
 
 
-Choose your database tool (dbtool)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-You have two options:
+Choose an audio file selector
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+paraslash has three different audio file selectors: random (default),
+playlist and mysql.
 
-       1. Use the mysql dbtool which comes with paraslash and requires
-       mysql.
+       The random selector chooses files randomly from the given
+       directory.
 
-       2. If you can not use the mysql dbtool and you just want
-       to quickly make paraslash working, use the random dbtool.
-       The directory which is searched for audio files can be given
-       via the server option --random_dbtool_dir.
+       The playlist selector allows to send a playlist to para_server
+       via the lpl (load playlist) command. para_server will choose
+       files from the loaded playlist in sequential order.
 
-       Note, however, that this database tool is really dopey. It
-       scans the given directory on every audio file change and
-       chooses one randomly. There is no further functionality.
+       The mysql selector stores information about your audio
+       files in a mysql database. It is much more involved than
+       the other two selectors and lets you chose files in many
+       interesting ways. If you like to use the mysql selector,
+       read README.mysql and follow the instructions given there.
+       Return to this document when ready.
 
-The current database tool can be changed at runtime via
+The current audio file selector can be changed at runtime via
 
-       para_client cdt new_dbtool
+       para_client cdt new_selector
 
-If you have choosen 1. above, read README.mysql and follow the
-instructions given there.  Return to this document when ready.
 
 
 Start streaming manually
@@ -115,19 +116,19 @@ on client_host:
 
        mp3:
 
-               para_recv -r http:-i:server_host | para_filter -f mp3 -f wav | para_play
-               or
-               mpg123 http://server_host:8000/
-               or
-               xmms http://server_host:8000/
+       para_recv -r 'http -i server_host' | para_filter -f mp3dec -f wav | para_play
+       or
+       mpg123 http://server_host:8000/
+       or
+       xmms http://server_host:8000/
 
        ogg:
 
-               para_recv -r http:-i:server_host | para_filter -f ogg -f wav | para_play
+       para_recv -r 'http -i server_host' | para_filter -f oggdec -f wav | para_play
 
 If this works, proceede. Otherwise doublecheck what is logged by
-para_server and use the --loglevel option of para_recv to increase
-verbosity.
+para_server and use the --loglevel option of para_recv, para_filter
+to increase verbosity.
 
 Configure para_audiod
 ~~~~~~~~~~~~~~~~~~~~~
@@ -142,7 +143,7 @@ the audio stream. Try
 for help. Usually you have to specify at least server_host as the
 receiver specifier, like this:
 
-       -r http:-i:server_host
+       -r 'mp3:http -i server_host'
 
 The prefered way to use para_audiod is to run it once at system start
 as an unprivileged user. para_audiod needs to create a "well-known"