write_common.h: Kill an unused function declaration.

[paraslash.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index f593f7073c1ad50e8635fb7669fea14f3ad5eb0b..9cc36f41aca382ddcfde6dc45566cf33aa4cba92 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -7,14 +7,17 @@ Any knowledge of how to work with mouse and icons is not required.
 ---------------------------
 Install all needed packages
 ---------------------------
-
-See README for a list of required software. You don't need everything
-listed there. In particular, mp3, ogg vorbis and aac support is
+See
+<<
+<a href="REQUIREMENTS.html"> REQUIREMENTS </a>
+>>
+for a list of required software. You don't need everything listed
+there. In particular, mp3, ogg vorbis and aac, ortp support is
 optional. Autoconf will detect what is installed on your system
 and will only try to build those executables that can be built with
 your setup.
 
-Note that no special library (not even the mp3 decodong library libmad)
+Note that no special library (not even the mp3 decoding library libmad)
 is needed for para_server if you only want to stream mp3 files.
 Also, it's fine to use para_server on a box without sound card as
 para_server only sends the audio stream to connected clients.
@@ -53,24 +56,25 @@ as user foo, and that you want to connect from client_host as user bar.
 As foo@server_host, create ~/.paraslash/server.users by typing the
 following commands:
 
+       user=bar
        target=~/.paraslash/server.users
-       key=~/.paraslash/key.pub.bar
+       key=~/.paraslash/key.pub.$user
        perms=AFS_READ,AFS_WRITE,VSS_READ,VSS_WRITE
        mkdir -p ~/.paraslash
-       echo "user bar $key $perms" >> $target
+       echo "user $user $key $perms" >> $target
 
 This gives "bar" the full privileges.
 
 Change to the bar account on client_host and generate the key-pair
 with the commands
 
-       key=~/.paraslash/key.bar
+       key=~/.paraslash/key.$LOGNAME
        mkdir -p ~/.paraslash
        (umask 077 && openssl genrsa -out $key)
 
 Next, extract its public part:
 
-       pubkey=~/.paraslash/key.pub.bar
+       pubkey=~/.paraslash/key.pub.$LOGNAME
        openssl rsa -in $key -pubout -out $pubkey
 
 and copy the public key just created to server_host (you may
@@ -88,6 +92,14 @@ Finally, tell para_client to connect to server_host:
 Start para_server
 -----------------
 
+Before starting the server make sure you have write permissions to
+the directory /var/paraslash.
+
+       sudo chown $user /var/paraslash
+
+Alternatively, use the --afs_socket Option to specify a different
+location for the afs command socket.
+
 For this first try, we'll use a debug level of two to make the
 output of para_server more verbose.
 
@@ -136,8 +148,8 @@ Print a list of all audio files found with
 Start streaming manually
 ------------------------
 
-       para play
-       para stat 2
+       para_client play
+       para_client stat 2
 
 This starts streaming and dumps some information about the current
 audio file to stdout.
@@ -194,7 +206,7 @@ socket is
 
        /var/paraslash/audiod_socket.$HOSTNAME
 
-so the /var/paraslash directory should be owned by the user who
+so the /var/paraslash directory should be writable for the user who
 runs para_audiod.
 
 If you want to change the location of the socket, use the -s option
@@ -237,4 +249,7 @@ arbitrary commands. There are several flavours of key-bindings:
          command>" instead of "<specified command>".
 
 This concludes the installation notes. Next thing you might to have a look
-at is how to use paraslash's audio file selector. See README.afs.
+at is how to use paraslash's audio file selector. See
+<<
+<a href="README.afs.html"> README.afs</a>
+>>