README in autobuild-0.1 vs README in autobuild-0.2
- old
+ new
@@ -98,16 +98,18 @@
<b>autobuild-config</b>:: main autobuild configuration. See <b>Autobuild configuration</b> below
*programs*:: the programs used by importers and builders. See each tool
documentation for the list of used options
*packages*:: the list of packages to build. See <b>Package configuration</b> below
+*defines*:: this is used for variable interpolation. Any key/value pair defined in
+ this section can be used later in other parts of the config files using
+ the $key or ${key} notation
-
== Autobuild configuration (<tt>autobuild-config</tt>)
=== Misc options
-*noupdate*:: if true, do not update the packages that are already imported (default: false). You
- can also add the <tt>--noupdate</tt> on the command line
+*update*:: if false, do not update the packages that are already imported (default: true). You
+ can also use the <tt>--no-update</tt> on the command line
=== Directories (<tt>autobuild-config/srcdir</tt>, <tt>autobuild-config/prefix</tt> and <tt>autobuild-config/logdir</tt>)
*srcdir*:: the path where programs are to be imported. See <b>Packages configuration</b> for
more information on how this option is used.
*prefix*:: the path where programs are to be installed. See <b>Packages configuration</b> for more
@@ -191,11 +193,11 @@
the importer type. For now, only +cvs+ and +svn+ are available. See the <b>Available importers</b>
section.
<b>importer/source</b>::
where the importer should get the sources. The format of this options depends on
- the importer used.
+ the importer used. See Available importers.
*prefix*:: where the program is to be installed. If this is a relative path, it is relative to the global
<tt>/autobuild-config/prefix</tt> option. Otherwise, the absolute path is used. If no prefix
is given, the package name is used, so that the default install dir is
<em>global prefix</em>/<em>package name</em>
@@ -232,11 +234,11 @@
packages:
bar:
type: import
import: cvs
source: [ *my_repository, "bar" ]
- srcdir: &bar_srcdir bar
+ srcdir: bar
=== Autotools (<tt>type: autotools</tt>)
Use this to build GNU autotools-based packages. This handles autoconf-only packages as
well as automake-based packages.
@@ -247,13 +249,14 @@
programs:
automake: automake-1.9
Autobuild tries to detect what tools it should run
-* +aclocal+ and +autoheader+ are always used
-* +autoconf+ is used if there is <tt>configure.ac</tt> or <tt>configure.in</tt> in the import dir
-* +automake+ is used if there is a <tt>Makefile.am</tt> file in the import dir
+* +autoheader+ is never used by default
+* +autoconf+ is used if there is <tt>configure.ac</tt> or <tt>configure.in</tt> in the imported dir
+* +aclocal+ is used if +autoconf+ is enabled (either explicitely or by autodetection)
+* +automake+ is used if there is a <tt>Makefile.am</tt> file in the imported dir
* you can force to enable or disable any of these four tools in each package config by setting the tool
flag to true or false. For instance, if you don't want package +foo+ to use automake, you say
packages:
foo:
@@ -267,17 +270,16 @@
make: gnumake
==== Other options
*builddir*:: the directory where the build takes place. For now, it has to be a relative path,
which is added to the import dir. The default value is "build"
-*configureflags*:: array of options to add to the +configure+ command line. To ease the reuse of
- Yaml references (the <tt>*label</tt> form), you can use an array of arrays, in which
- case the second array levels are joined using ''. For example if our +foo+ package
- needs the source of the +bar+ package we added as an import package earlier,
-
- configureflags: [ [ --with-bar-source=, *srcdir, '/', *bar_srcdir ] ]
+*configureflags*:: array of options to add to the +configure+ command line
+ configureflags: [ --with-bar-source=$srcdir/$bar_srcdir ]
depends: bar
+= Running autobuild in daemon mode
+The <tt>--daemon</tt> command line options makes autobuild go into daemon mode.
+
= Copyright and license
Author:: Sylvain Joyeux <sylvain.joyeux@m4x.org>
Copyright:: Copyright (c) 2005 Sylvain Joyeux
License:: GPL