+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:
+
+ - parse configure.ac for all Makefiles in the modules/ directory that need
+ to be generated, and look for available modules in the corresponding
+ Modules.am file. 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/private.m4 from configure.ac, generating m4 macros that will
+ be needed by configure.ac.
+
+ - create a Makefile.am file for each Modules.am file found in modules/ .
+
+ - 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 add a new directory you will need to create a new Modules.am,
+inside that directory. Do not forget to add a corresponding
+Makefile line at the end of configure.ac for this new Modules.am file.
+
+To have the module built, you need to add a call to VLC_ADD_PLUGIN or
+VLC_ADD_BUILTINS to configure.ac with your new module name as argument.
+Look at other modules for guidelines on how to add build and linkage options.
+
+After changing configure.ac you will always need to rerun bootstrap and
+configure.
+
+VLC keeps a cache of its modules (in ~/.cache/vlc/ on Linux), so you'll have to
+delete it (or use vlc --reset-plugins-cache). Then use vlc -vvv --color --list
+to check that your plugin is seen by VLC.
+