X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=REQUIREMENTS;h=a9aedcda7aa95eaaf510a2c8414f8e8fb781bc9e;hp=ca5040a0d3c2053c2968a61319bd0ac2c3502b7a;hb=a4f75cecaaee538edb7aae3f0ff19168a1dab59d;hpb=b7dff48534d5f909d846e1fa40fa0d4467322bc3

diff --git a/REQUIREMENTS b/REQUIREMENTS
index ca5040a0..a9aedcda 100644
--- a/REQUIREMENTS
+++ b/REQUIREMENTS
@@ -1,45 +1,61 @@
 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/.
 	  The corresponding Debian packages are called libogg-dev
 	  libvorbis-dev, other distributors chose similar names.
-	  The source of these is also available at
 
 	- *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/
-	- 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/