* mkv: fix a double delete.

[vlc] / HACKING

diff --git a/HACKING b/HACKING
index ea15ab723abd2ce8c93776919ba253970ef88761..2ee0317201355f16e634f3e9619b146379a76fda 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -1,13 +1,18 @@
-$Id: HACKING,v 1.1 2002/08/25 23:18:04 sam Exp $
+$Id: HACKING,v 1.7 2003/06/21 17:04:20 sam Exp $
 
 Hacking vlc
 ===========
 
+Requirements
+------------
+
 You will need the following tools if you plan to use the CVS version of vlc:
 
- - autoconf version 2.13 or later
- - automake version 1.4 or later
- - gettext version 0.11.5 or later
+ - autoconf version 2.50 or later
+
+ - automake version 1.5 (but 1.6 or later is recommended)
+
+ - gettext version 0.10.40 (but 0.11.3 or later is recommended)
 
 After retrieving the CVS tree, you need to run the bootstrap script to
 generate all the files needed to build vlc. You can then run configure.
@@ -18,3 +23,43 @@ you can check out a CVS tree on an OS that provides these tools (such
 as a recent Linux distribution), run bootstrap, and then copy the whole
 tree to your retarded OS.
 
+There is a possibility that, at some point, automake might segfault. The
+reason is unsufficient stack size, and can be easily fixed with the
+`ulimit` command (or an equivalent) available in most shells. For instance
+on bash 2.0, the following command solves the automake crash on Mac OS X :
+ulimit -s 20000
+
+
+The bootstrap sequence
+----------------------
+
+The bootstrap script does the following actions:
+
+ - browse the modules/ directory for all available modules. A module "foo"
+   exists if there is a Modules.am file in the modules/ directory which
+   defines SOURCES_foo.
+
+ - create a top-level Modules.am file (which will be included by Makefile.am)
+   which contains additional build rules for modules, and includes all the
+   Modules.am files that were found in modules/
+
+ - create an m4/vlc.m4 from configure.ac, generating the AC_SUBST and
+   AM_CONDITIONAL rules that will be needed by configure.ac.
+
+ - run autopoint (previously gettextize) to create an intl/ directory,
+   needed when libgettext is not available.
+
+ - run the usual aclocal, autoheader, automake and autoconf, which create
+   the various Makefile.in files from the corresponding Makefile.am and the
+   configure script from configure.ac.
+
+ - fix a few files in the vlc repository that may have been altered.
+
+
+How to add a module
+-------------------
+
+To add a module to the repository, just add its sources to a Modules.am
+file. If you create a new Modules.am, do not forget to add a corresponding
+line to modules/Makefile.am.
+