X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=REQUIREMENTS;h=a9aedcda7aa95eaaf510a2c8414f8e8fb781bc9e;hp=b8a09058c18a38751ebbe3cddf8b52066bc4fc99;hb=89fcd19c0b34164cfab4a97352cfab81e0aa5e0c;hpb=f491dc59b5eee838165b60e7815a06139fed7f74

diff --git a/REQUIREMENTS b/REQUIREMENTS
index b8a09058..a9aedcda 100644
--- a/REQUIREMENTS
+++ b/REQUIREMENTS
@@ -1,25 +1,41 @@
 Requirements
 ============
 
-In any case you need
+In any case you'll need
 
-	- gcc, the gnu compiler collection (shipped with distro): gcc-3.3
+	- *libosl*, the object storage layer: Used by para_server. It is
+	  available from http://git.tuebingen.mpg.de/osl. Alternatively,
+	  execute "git clone git://git.tuebingen.mpg.de/osl".
+
+	- *gcc*, the gnu compiler collection (shipped with distro): gcc-3.3
 	  or newer is required.
-	- gnu make (shipped with disto, might be called gmake)
-	- bash (most likely already installed)
-	- openssl (needed by server, client): usually shipped with
+
+	- *gnu make* (shipped with disto, might be called gmake on BSD systems)
+
+	- *bash* (most likely already installed)
+
+	- *openssl* (needed by server, client): usually shipped with
 	  distro, but you might have to install the "development package"
 	  (called libssl-dev on debian systems) as well:
 	  http://www.openssl.org/
-	- software mixing, e.g. ALSA and the direct mixing plugin (dmix)
+
+	- *help2man* (for man page creation) ftp://ftp.gnu.org/pub/gnu/help2man
 
 Optional features:
 
 	- *mp3*: The mp3 decoder of para_filter is based on libmad:
-	  http://www.underbit.com/products/mad/. If you prefer to use
-	  the libmad package provided by your distributor, make sure
-	  to install the corresponding development package as well.
-	  Note that libmad is not necessary for sending mp3 files.
+	  http://www.underbit.com/products/mad/. If you prefer to
+	  use the libmad package provided by your distributor, make
+	  sure to install the corresponding development package as
+	  well. It is called libmad0-dev on debian-based systems.
+	  Note that libmad is not necessary for the server side,
+	  i.e. for sending mp3 files.
+
+	- *id3 tags*:
+	  For version-2 id3 tag support, you'll need libid3tag which
+	  is also available through the above link (alternatively:
+	  install package libid3tag0-dev). Without libid3tag, only
+	  version one tags are recognized.
 
 	- *ogg vorbis*: For ogg vorbis streams you'll need libogg,
 	  libvorbis, libvorbisfile: http://www.xiph.org/downloads/.
@@ -28,18 +44,18 @@ Optional features:
 
 	- *aac*:
 	  For aac files (m4a) you'll need libfaad. Get it at
-	  http://www.audiocoding.com/modules/wiki/?page=AAC
+	  http://www.audiocoding.com/.
+	  Debian package: libfaad-dev.
 
-	- *ortp*:
-	  If you intend to use the optional ortp streamer, you'll
-	  need libortp: http://www.linphone.org/ortp/
+	- On Linux, you'll need to have ALSA's development package
+	  installed. The Debian package is called libasound2-dev.
 
 Hacking the source:
 
 	- gengetopt: ftp://ftp.gnu.org/pub/gnu/gengetopt/
 	- autoconf: ftp://ftp.gnu.org/pub/gnu/autoconf/
-	- git
-	- grutatxt
-	- help2man
-	- doxygen
-	- global
+	- git http://git.or.cz/
+	- grutatxt http://www.triptico.com/software/grutatxt.html
+	- doxygen http://www.stack.nl/~dimitri/doxygen/
+	- global ftp://ftp.gnu.org/pub/gnu/global
+	- m4: ftp://ftp.gnu.org/pub/gnu/m4/