X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=web%2Fmanual.m4;h=0a5f580a79d4fbe603aa87c90c959e90b4d089ce;hb=56d75bd90d78cf44cd3984ce2a45627ef5646d38;hp=42021c423ed64611c9facbe99d514707315fe982;hpb=abfb661f35e99e99c09a94d84839356d905af080;p=paraslash.git diff --git a/web/manual.m4 b/web/manual.m4 index 42021c42..0a5f580a 100644 --- a/web/manual.m4 +++ b/web/manual.m4 @@ -298,35 +298,14 @@ Optional: Installation ~~~~~~~~~~~~ +To build the sources from a tarball, execute -First make sure all non-optional packages listed in the section on -REFERENCE(Requirements, required software) are installed on your -system. + ./configure && make -You don't need everything listed there. In particular, MP3, OGG/Vorbis, -OGG/Speex and AAC support are all optional. The configure script 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 decoder library (not even the MP3 decoding library -libmad) is needed for para_server if you only want to stream MP3 or WMA -files. Also, it's fine to use para_server on a box without sound card. - -Next, install the paraslash package on all machines, you'd like this -software to run on. If you compile from a released tarball, execute - - (./configure && make) > /dev/null - -When compiling from git or from snapshots downloaded via gitweb, -the above command will not work because the configure script is not -included in the git repository. In this case the following command -should be used instead: +To build from git or a gitweb snapshot, run this command instead: ./autogen.sh -This runs autoconf to generate the configure script, then runs it as -above. Therefore you'll need autoconf for this to work. - There should be no errors but probably some warnings about missing packages which usually implies that not all audio formats will be supported. If headers or libs are installed at unusual locations you @@ -374,18 +353,11 @@ following commands: Next, change to the "bar" account on client_host and generate the key pair with the commands - ssh-keygen -t rsa -b 2048 - # hit enter twice to create a key with no passphrase - -This generates the two files id_rsa and id_rsa.pub in ~/.ssh. Note -that paraslash can also read keys generated by the "openssl genrsa" -command. However, since keys created with ssh-keygen can also be used -for ssh, this method is recommended. + ssh-keygen -q -t rsa -b 2048 -N '' -f $key -Note that para_server refuses to use a key if it is shorter than 2048 -bits. In particular, the RSA keys of paraslash 0.3.x will not work -with version 0.4.x. Moreover, para_client refuses to use a (private) -key which is world-readable. +This generates the two files id_rsa and id_rsa.pub in ~/.ssh. Note +that para_server won't accept keys shorter than 2048 bits. Moreover, +para_client rejects private keys which are world-readable. para_server only needs to know the public key of the key pair just created. Copy this public key to server_host: @@ -1188,7 +1160,7 @@ is composed of superframes, each containing one or more frames of The Free Lossless Audio Codec (FLAC) compresses audio without quality loss. It gives better compression ratios than a general purpose compressor like zip or bzip2 because FLAC is designed specifically -for audio. A FLAC-encoded file consits of frames of varying size, up +for audio. A FLAC-encoded file consists of frames of varying size, up to 16K. Each frame starts with a header that contains all information necessary to decode the frame.