* lib/am/distdir.am (distcheck): Honnor $(DISTCHECK_CONFIGURE_FLAGS).
Suggested by Merijn de Jonge.
+2001-12-05 Alexandre Duret-Lutz <duret_g@epita.fr>
+
+ * automake.texi (Dist): Document $(DISTCHECK_CONFIGURE_FLAGS).
+ * lib/am/distdir.am (distcheck): Honnor $(DISTCHECK_CONFIGURE_FLAGS).
+ Suggested by Merijn de Jonge.
+
2001-12-05 Alexandre Duret-Lutz <duret_g@epita.fr>
* lib/am/tags.am (ID): Search $(LISP) files in $(srcdir),
* The part of the distcheck target that checks whether distclean actually
cleans all built files has been moved in a separate target, distcleancheck,
so it can be overridden easily.
+* `make distcheck' will pass additional options defined in
+ $(DISTCHECK_CONFIGURE_FLAGS) to configure.
* Fixed CDPATH portability problems, in particular for MacOS X.
* Fixed handling of nobase_ targets.
* Fixed support of implicit rules leading to .lo objects.
Matthew D. Langston langston@SLAC.Stanford.EDU
Matthias Clasen clasen@mathematik.uni-freiburg.de
Maxim Sinev good@goods.ru
+Merijn de Jonge M.de.Jonge@cwi.nl
Michael Brantley Michael-Brantley@deshaw.com
Michel de Ruiter mdruiter@cs.vu.nl
Miles Bader miles@ccs.mt.nec.co.jp
arguments. You can do this by defining @code{ACLOCAL_AMFLAGS}; this
holds arguments which are passed verbatim to @code{aclocal}. This macro
is only useful in the top-level @file{Makefile.am}.
-@cindex ACLOCAL_AMFLAGS
+@vindex ACLOCAL_AMFLAGS
@node Programs, Other objects, Rebuilding, Top
Automake also generates a @code{distcheck} target which can be of help
to ensure that a given distribution will actually work.
-@code{distcheck} makes a distribution, and then tries to do a
-@code{VPATH} build.
+@code{distcheck} makes a distribution, then tries to do a @code{VPATH}
+build, run the testsuite, and finally make another tarfile to ensure the
+distribution is self-contained.
@trindex distcheck
+Building the package involves running @code{./configure}. If you need
+to supply additional flags to @code{configure}, define them in the
+@code{DISTCHECK_CONFIGURE_FLAGS} variable, either in your top-level
+@file{Makefile.am}, or on the commande line when invoking @code{make}.
+@vindex DISTCHECK_CONFIGURE_FLAGS
+
If the target @code{distcheck-hook} is defined in your
@file{Makefile.am}, then it will be invoked by @code{distcheck} after
the new distribution has been unpacked, but before the unpacked copy is
running @code{$(distcleancheck_listfiles)}. Usually this check will
find generated files that you forgot to add to the @code{DISTCLEANFILES}
variable (@pxref{Clean}).
+@trindex distcleancheck
The @code{distcleancheck} behaviour should be ok for most packages,
otherwise you have the possibility to override the definitition of
@code{$(distcleancheck_listfiles)} variable. For instance to disable
@code{distcleancheck} completely, add the following rule to your
top-level @file{Makefile.am}:
+@vindex distcleancheck_listfiles
@example
distcleancheck:
&& cd $(distdir)/=build \
&& ../configure --srcdir=.. --prefix=$$dc_install_base \
?GETTEXT? --with-included-gettext \
+## Additional flags for configure. Keep this last in the configure
+## invocation so the user can override previous options.
+ $(DISTCHECK_CONFIGURE_FLAGS) \
&& $(MAKE) $(AM_MAKEFLAGS) \
&& $(MAKE) $(AM_MAKEFLAGS) dvi \
&& $(MAKE) $(AM_MAKEFLAGS) check \
-@set UPDATED 26 November 2001
-@set UPDATED-MONTH November 2001
+@set UPDATED 5 December 2001
+@set UPDATED-MONTH December 2001
@set EDITION 1.5a
@set VERSION 1.5a
-@set UPDATED 26 November 2001
-@set UPDATED-MONTH November 2001
+@set UPDATED 5 December 2001
+@set UPDATED-MONTH December 2001
@set EDITION 1.5a
@set VERSION 1.5a