Changeset 6714

Timestamp:

07/02/09 10:00:49 (14 months ago)

Author:

dbaelde

Message:

Try to clarify the info on how to build the source. Add a note about
PACKAGES.default. Put the simple procedure upfront to not scare
people.

Files:

• trunk/liquidsoap/doc/content/build.txt (modified) (2 diffs)

trunk/liquidsoap/doc/content/build.txt

@@ -3 +3 @@
 h3. Building liquidsoap from source
 
+From every sub-project's directory (ocaml-vorbis, ocaml-dtools, liquidsoap, 
+etc.) you can build using <code>./bootstrap</code>, <code>./configure</code>, 
+<code>make</code> and optionally install using <code>make install</code>.
+
+If you are using the <code>liquidsoap-full</code> tarball,
+or the
+"SVN trunk":https://savonet.svn.sourceforge.net/svnroot/savonet/trunk,
+there is also a fast procedure for building liquidsoap
+that doesn't require installing the libraries provided by Savonet.
+The steps to follow are simple.
+
+First,
+you should choose which features you want to enable when building liquidsoap.
+Each shipped feature can be enabled/disabled by editing the
+<code>PACKAGE</code> file.
+Depending on your version you might have to first copy 
+<code>PACKAGES.default</code> to <code>PACKAGES</code>.
+
+Then run the usual commands from the toplevel directory, _above_ the
+sub-project's directories:
+%%
+# Edit PACKAGES to choose which feature you want
+
+# In the SVN tree you should bootstrap first.
+# No need with the tarballs.
+./bootstrap
+
+# Configure all libraries and packages.
+# You may pass extra options such as --enable-debugging,
+# --prefix, --sysconfdir, --localstatedir, etc.
+./configure
+
+# Now, build all libraries and liquidsoap
+make
+
+# To install liquidsoap,
+# you'll usually need to type the following as root
+make install
+%%
+
 h4. Dependencies
-
-You can choose which features you want to enable when building liquidsoap.
-If you use the -full tarball, each shipped feature can be enabled/disabled using the <code>PACKAGE</code> file.
 
 Here are liquidsoap's dependencies (all OCaml libraries are distributed by Savonet, except when linked):
@@ -45 +82 @@
 
 And other that you'll find on the project page, or in liquidsoap-full tarball.
-
-h4. Building the source
-
-From every sub-project's directory you can build and install the package using <code>./bootstrap</code>, <code>./configure</code>, <code>make</code> and optionally <code>make install</code>.
-
-From the toplevel savonet directory you can also directly build a vanilla liquidsoap. It's fast and doesn't require you to install the libraries. The steps to follow are simple:
-%%
-# Edit PACKAGES to choose which feature you want
-./configure
-make
-# To install liquidsoap,
-# you'll usually need to type the following as root
-make install
-%%