Merge branch 'improve-release-process' into maint
[automake.git] / Makefile.am
blob22a8fbd1491a5470684bdbf605a96ea583dd77d6
1 ## Process this file with automake to create Makefile.in
3 ## Makefile for Automake.
5 # Copyright (C) 1995-2012 Free Software Foundation, Inc.
7 # This program is free software; you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 2, or (at your option)
10 # any later version.
12 # This program is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
20 ## Might be updated later.
21 CLEANFILES =
22 DISTCLEANFILES =
23 MAINTAINERCLEANFILES =
24 EXTRA_DIST =
26 ## ------------ ##
27 ##  Top level.  ##
28 ## ------------ ##
30 # We want a handful of substitutions to be fully-expanded by make;
31 # then use config.status to substitute the remainder where a single
32 # expansion is sufficient.  We use a funny notation here to avoid
33 # configure substitutions in our text.
34 do_subst = ( sed \
35   -e "s,[@]configure_input[@],Generated from $$in; do not edit by hand.,g" \
36   -e 's,[@]datadir[@],$(datadir),g' \
37   -e 's,[@]amdir[@],$(amdir),g' \
38   -e 's,[@]bindir[@],$(bindir),g' \
39   -e 's,[@]docdir[@],$(docdir),g' \
40   -e 's,[@]pkgvdatadir[@],$(pkgvdatadir),g' \
41   -e 's,[@]scriptdir[@],$(scriptdir),g' \
42   -e 's,[@]automake_acdir[@],$(automake_acdir),g' \
43   -e 's,[@]system_acdir[@],$(system_acdir),g' \
44 ## Hack to avoid a spurious substitution in the Automake script (part 1).
45   -e 's,[@]am__isrc[@],!!@!!am__isrc!!@!!,g' \
46   | $(SHELL) ./config.status --file=- \
47 ## Hack to avoid a spurious substitution in the Automake script (part 2).
48   | sed -e 's,!!@!!am__isrc!!@!!,@''am__isrc@,g' \
49   )
51 # Generated  files shouldn't contain unexpanded '@substitutions@', and
52 # should be made read-only, to prevent them from being edited by mistake
53 # instead of the file the are generated from.
54 generated_file_finalize = $(AM_V_at) \
55   if LC_ALL=C grep '@[a-zA-Z0-9_][a-zA-Z0-9_]*@' $@-t; then \
56     echo "$@ contains unexpanded substitution (see lines above)"; \
57     exit 1; \
58   fi; \
59   chmod a-w $@-t && mv -f $@-t $@
61 bin_SCRIPTS = automake aclocal
63 CLEANFILES += $(bin_SCRIPTS)
64 AUTOMAKESOURCES = automake.in aclocal.in
66 TAGS_FILES = $(AUTOMAKESOURCES)
68 EXTRA_DIST += \
69   $(AUTOMAKESOURCES) \
70   bootstrap.sh \
71   GNUmakefile \
72   syntax-checks.mk \
73   HACKING
75 ## Make versioned links.  We only run the transform on the root name;
76 ## then we make a versioned link with the transformed base name.  This
77 ## seemed like the most reasonable approach.
78 install-exec-hook:
79         @$(POST_INSTALL)
80         @for p in $(bin_SCRIPTS); do \
81           f="`echo $$p|sed '$(transform)'`"; \
82           fv="$$f-$(APIVERSION)"; \
83           rm -f "$(DESTDIR)$(bindir)/$$fv"; \
84           echo " $(LN) '$(DESTDIR)$(bindir)/$$f' '$(DESTDIR)$(bindir)/$$fv'"; \
85           $(LN) "$(DESTDIR)$(bindir)/$$f" "$(DESTDIR)$(bindir)/$$fv"; \
86         done
88 uninstall-hook:
89         @for p in $(bin_SCRIPTS); do \
90           f="`echo $$p|sed '$(transform)'`"; \
91           fv="$$f-$(APIVERSION)"; \
92           rm -f "$(DESTDIR)$(bindir)/$$fv"; \
93         done
95 ## These files depend on Makefile so they are rebuilt if $(VERSION),
96 ## $(datadir) or other do_subst'ituted variables change.
97 automake: automake.in
98 aclocal: aclocal.in
99 automake aclocal: Makefile
100         $(AM_V_at)rm -f $@ $@-t
101         $(AM_V_GEN)in=$@.in; $(do_subst) <$(srcdir)/$@.in >$@-t
102 ## We can't use '$(generated_file_finalize)' here, because currently
103 ## Automake contains occurrences of unexpanded @substitutions@ in
104 ## comments, and that is perfectly legit.
105         $(AM_V_at)chmod a+x,a-w $@-t && mv -f $@-t $@
107 ## The master location for INSTALL is lib/INSTALL.
108 ## This is where "make fetch" will install new versions.
109 ## Make sure we also update this copy.
110 INSTALL: lib/INSTALL
111         $(AM_V_GEN)cp $(srcdir)/lib/INSTALL $@
113 # We don't use the default name for the autom4te cache directory,
114 # so we need this.
115 maintainer-clean-local:
116         rm -rf .autom4te.cache
119 ## -------------------------------------------------------------------- ##
120 ##  Auxiliary scripts and files for use with "automake --add-missing".  ##
121 ## -------------------------------------------------------------------- ##
123 dist_pkgvdata_DATA = \
124   lib/COPYING \
125   lib/INSTALL \
126   lib/texinfo.tex
128 ## These must all be executable when installed.  However, if we use
129 ## _SCRIPTS, then the program transform will be applied, which is not
130 ## what we want.  So we make them executable by hand.
131 dist_script_DATA = \
132   lib/config.guess \
133   lib/config.sub \
134   lib/install-sh \
135   lib/mdate-sh \
136   lib/missing \
137   lib/mkinstalldirs \
138   lib/elisp-comp \
139   lib/ylwrap \
140   lib/depcomp \
141   lib/compile \
142   lib/py-compile \
143   lib/ar-lib \
144   lib/test-driver \
145   lib/tap-driver.sh \
146   lib/tap-driver.pl
148 install-data-hook:
149         @$(POST_INSTALL)
150         @for f in $(dist_script_DATA); do echo $$f; done \
151           | sed 's,^lib/,,' \
152           | ( st=0; \
153               while read f; do \
154                 echo " chmod +x '$(DESTDIR)$(scriptdir)/$$f'"; \
155                 chmod +x "$(DESTDIR)$(scriptdir)/$$f" || st=1; \
156               done; \
157               exit $$st )
159 installcheck-local: installcheck-executable-scripts
160 installcheck-executable-scripts:
161         @for f in $(dist_script_DATA); do echo $$f; done \
162           | sed 's,^lib/,,' \
163           | while read f; do \
164               path="$(pkgvdatadir)/$$f"; \
165               test -x "$$path" || echo $$path; \
166             done \
167           | sed 's/$$/: not executable/' \
168           | grep . 1>&2 && exit 1; exit 0
171 ## ---------------------------------------------------- ##
172 ##  Private perl modules used by automake and aclocal.  ##
173 ## ---------------------------------------------------- ##
175 perllibdir = $(pkgvdatadir)/Automake
176 dist_perllib_DATA = \
177   lib/Automake/ChannelDefs.pm \
178   lib/Automake/Channels.pm \
179   lib/Automake/Condition.pm \
180   lib/Automake/Configure_ac.pm \
181   lib/Automake/DisjConditions.pm \
182   lib/Automake/FileUtils.pm \
183   lib/Automake/General.pm \
184   lib/Automake/Getopt.pm \
185   lib/Automake/Item.pm \
186   lib/Automake/ItemDef.pm \
187   lib/Automake/Location.pm \
188   lib/Automake/Options.pm \
189   lib/Automake/Rule.pm \
190   lib/Automake/RuleDef.pm \
191   lib/Automake/Variable.pm \
192   lib/Automake/VarDef.pm \
193   lib/Automake/Version.pm \
194   lib/Automake/XFile.pm \
195   lib/Automake/Wrap.pm
197 nodist_perllib_DATA = lib/Automake/Config.pm
198 CLEANFILES += $(nodist_perllib_DATA)
200 lib/Automake/Config.pm: lib/Automake/Config.in Makefile
201         $(AM_V_at)rm -f $@ $@-t
202         $(AM_V_at)test -d lib/Automake || $(MKDIR_P) lib/Automake
203         $(AM_V_GEN)in=Config.in \
204           && $(do_subst) <$(srcdir)/lib/Automake/Config.in >$@-t
205         $(generated_file_finalize)
206 EXTRA_DIST += lib/Automake/Config.in
209 ## --------------------- ##
210 ##  Makefile fragments.  ##
211 ## --------------------- ##
213 dist_am_DATA = \
214   lib/am/check.am \
215   lib/am/check2.am \
216   lib/am/clean-hdr.am \
217   lib/am/clean.am \
218   lib/am/compile.am \
219   lib/am/configure.am \
220   lib/am/data.am \
221   lib/am/dejagnu.am \
222   lib/am/depend.am \
223   lib/am/depend2.am \
224   lib/am/distdir.am \
225   lib/am/footer.am \
226   lib/am/header-vars.am \
227   lib/am/header.am \
228   lib/am/install.am \
229   lib/am/inst-vars.am \
230   lib/am/java.am \
231   lib/am/lang-compile.am \
232   lib/am/lex.am \
233   lib/am/library.am \
234   lib/am/libs.am \
235   lib/am/libtool.am \
236   lib/am/lisp.am \
237   lib/am/ltlib.am \
238   lib/am/ltlibrary.am \
239   lib/am/mans-vars.am \
240   lib/am/mans.am \
241   lib/am/program.am \
242   lib/am/progs.am \
243   lib/am/python.am \
244   lib/am/remake-hdr.am \
245   lib/am/scripts.am \
246   lib/am/subdirs.am \
247   lib/am/tags.am \
248   lib/am/texi-vers.am \
249   lib/am/texibuild.am \
250   lib/am/texinfos.am \
251   lib/am/vala.am \
252   lib/am/yacc.am
255 ## ------------------------------ ##
256 ##  Automake-provided m4 macros.  ##
257 ## ------------------------------ ##
259 dist_automake_ac_DATA = \
260   m4/amversion.m4 \
261   m4/ar-lib.m4 \
262   m4/as.m4 \
263   m4/auxdir.m4 \
264   m4/ccstdc.m4 \
265   m4/cond.m4 \
266   m4/cond-if.m4 \
267   m4/depend.m4 \
268   m4/depout.m4 \
269   m4/dmalloc.m4 \
270   m4/gcj.m4 \
271   m4/header.m4 \
272   m4/init.m4 \
273   m4/install-sh.m4 \
274   m4/lead-dot.m4 \
275   m4/lex.m4 \
276   m4/lispdir.m4 \
277   m4/maintainer.m4 \
278   m4/make.m4 \
279   m4/minuso.m4 \
280   m4/missing.m4 \
281   m4/mkdirp.m4 \
282   m4/obsol-gt.m4 \
283   m4/obsol-lt.m4 \
284   m4/obsolete.m4 \
285   m4/options.m4 \
286   m4/protos.m4 \
287   m4/python.m4 \
288   m4/runlog.m4 \
289   m4/sanity.m4 \
290   m4/silent.m4 \
291   m4/strip.m4 \
292   m4/substnot.m4 \
293   m4/tar.m4 \
294   m4/upc.m4 \
295   m4/vala.m4
297 dist_system_ac_DATA = m4/acdir/README
299 # We build amversion.m4 here, instead of from config.status,
300 # because config.status is rerun each time one of configure's
301 # dependencies change and amversion.m4 happens to be a configure
302 # dependency.  configure and amversion.m4 would be rebuilt in
303 # loop otherwise.
304 # Use '$(top_srcdir)/m4' for the benefit of non-GNU makes: this is
305 # how amversion.m4 appears in our dependencies.
306 $(top_srcdir)/m4/amversion.m4: $(srcdir)/configure.ac $(srcdir)/m4/amversion.in
307         $(AM_V_at)rm -f $@-t $@
308         $(AM_V_GEN)in=amversion.in \
309           && $(do_subst) <$(srcdir)/m4/amversion.in >$@-t
310         $(generated_file_finalize)
311 EXTRA_DIST += m4/amversion.in
314 ## ------------ ##
315 ##  Testsuite.  ##
316 ## ------------ ##
318 # Run the tests with a proper shell detected at configure time.
319 LOG_COMPILER = $(AM_TEST_RUNNER_SHELL)
321 TEST_EXTENSIONS = .pl .sh .tap
322 SH_LOG_COMPILER = $(LOG_COMPILER)
323 TAP_LOG_COMPILER = $(LOG_COMPILER)
324 PL_LOG_COMPILER = $(PERL)
325 AM_PL_LOG_FLAGS = -Mstrict -I $(builddir)/lib -I $(srcdir)/lib -w
327 TAP_LOG_DRIVER = AM_TAP_AWK='$(AWK)' $(SHELL) $(srcdir)/lib/tap-driver.sh
329 AM_TAP_LOG_DRIVER_FLAGS = --merge
331 EXTRA_DIST += t/README t/ax/is t/ax/is_newest
333 TESTS = ## Will be updated later.
335 # Some testsuite-influential variables should be overridable from the
336 # test scripts, but not from the environment.
337 # Keep this in sync with the similar list in 'runtest.in'.
338 AM_TESTS_ENVIRONMENT = \
339   for v in \
340     required \
341     am_test_protocol \
342     am_serial_tests \
343     am_test_prefer_config_shell \
344     am_original_AUTOMAKE \
345     am_original_ACLOCAL \
346     am_test_lib_sourced \
347     test_lib_sourced \
348   ; do \
349     eval test x"\$${$$v}" = x || unset $$v; \
350   done;
351 # We want warning messages and explanations for skipped tests to go to
352 # the console if possible, so set up 'stderr_fileno_' properly.
353 AM_TESTS_FD_REDIRECT = 9>&2
354 AM_TESTS_ENVIRONMENT += stderr_fileno_=9; export stderr_fileno_;
356 # For sourcing of extra "shell libraries" by our test scripts.  As per
357 # POSIX, sourcing a file with '.' will cause it to be looked up in $PATH
358 # in case it is given with a relative name containing no slashes.
359 AM_TESTS_ENVIRONMENT += \
360   if test $(srcdir) != .; then \
361     PATH='$(abs_srcdir)/t/ax'$(PATH_SEPARATOR)$$PATH; \
362   fi; \
363   PATH='$(abs_builddir)/t/ax'$(PATH_SEPARATOR)$$PATH; \
364   export PATH;
366 # Hand-written tests.
368 include $(srcdir)/t/list-of-tests.mk
370 TESTS += $(handwritten_TESTS)
371 EXTRA_DIST += $(handwritten_TESTS)
373 # Automatically-generated tests wrapping hand-written ones.
374 # Also, automatically-computed dependencies for tests.
376 include $(srcdir)/t/testsuite-part.am
378 TESTS += $(generated_TESTS)
379 EXTRA_DIST += $(generated_TESTS)
381 $(srcdir)/t/testsuite-part.am:
382         $(AM_V_at)rm -f t/testsuite-part.tmp $@
383         $(AM_V_GEN)$(PERL) $(srcdir)/gen-testsuite-part \
384           --srcdir $(srcdir) > t/testsuite-part.tmp
385         $(AM_V_at)chmod a-w t/testsuite-part.tmp
386         $(AM_V_at)mv -f t/testsuite-part.tmp $@
387 EXTRA_DIST += gen-testsuite-part
389 ## The dependecies declared here are not truly complete, but such
390 ## completeness would cause more issues than it would solve.  See
391 ## automake bug#11347.
392 $(generated_TESTS): $(srcdir)/gen-testsuite-part
393 $(srcdir)/t/testsuite-part.am: $(srcdir)/gen-testsuite-part Makefile.am
395 # Static dependencies valid for each test case (also further
396 # extended later).  Note that use 'noinst_' rather than 'check_'
397 # as the prefix, because we really want them to be built by
398 # "make all".  This makes it easier to run the test cases by
399 # hand after having simply configured and built the package.
401 nodist_noinst_SCRIPTS = \
402   t/wrap/aclocal-$(APIVERSION) \
403   t/wrap/automake-$(APIVERSION)
405 dist_noinst_DATA = \
406   t/ax/test-init.sh \
407   t/ax/test-lib.sh \
408   t/ax/am-test-lib.sh \
409   t/ax/tap-functions.sh
411 # Few more static dependencies.
412 t/distcheck-missing-m4.log: t/ax/distcheck-hook-m4.am
413 t/distcheck-outdated-m4.log: t/ax/distcheck-hook-m4.am
414 EXTRA_DIST += t/ax/distcheck-hook-m4.am
416 t/ax/test-defs.sh: t/ax/test-defs.in Makefile
417         $(AM_V_at)rm -f $@ $@-t
418         $(AM_V_at)$(MKDIR_P) t/ax
419         $(AM_V_GEN)in=t/ax/test-defs.in \
420           && $(do_subst) <$(srcdir)/$$in >$@-t
421         $(generated_file_finalize)
422 EXTRA_DIST += t/ax/test-defs.in
423 CLEANFILES += t/ax/test-defs.sh
424 nodist_noinst_DATA = t/ax/test-defs.sh
426 noinst_SCRIPTS = # Will be updated soon.
428 t/ax/shell-no-trail-bslash: t/ax/shell-no-trail-bslash.in Makefile
429         $(AM_V_at)rm -f $@ $@-t
430         $(AM_V_GEN)in=t/ax/shell-no-trail-bslash.in \
431           && $(MKDIR_P) t/ax \
432           && $(do_subst) <$(srcdir)/$$in >$@-t \
433           && chmod a+x $@-t
434         $(generated_file_finalize)
435 EXTRA_DIST += t/ax/shell-no-trail-bslash.in
436 CLEANFILES += t/ax/shell-no-trail-bslash
437 noinst_SCRIPTS += t/ax/shell-no-trail-bslash
439 runtest: runtest.in Makefile
440         $(AM_V_at)rm -f $@ $@-t
441         $(AM_V_GEN)in=runtest.in \
442           && $(MKDIR_P) t/ax \
443           && $(do_subst) <$(srcdir)/runtest.in >$@-t \
444           && chmod a+x $@-t
445         $(generated_file_finalize)
446 EXTRA_DIST += runtest.in
447 CLEANFILES += runtest
448 noinst_SCRIPTS += runtest
450 # If two test scripts have the same basename, they will end up sharing
451 # the same log file, leading to all sort of undefined and undesired
452 # behaviours.
453 check-no-repeated-test-name:
454         @LC_ALL=C; export LC_ALL; \
455          lst='$(TEST_LOGS)'; for log in $$lst; do echo $$log; done \
456            | sort | uniq -c | awk '($$1 > 1) { print }' \
457            | sed 's/\.log$$//' | grep . >&2 \
458            && { \
459              echo $@: test names listed above are duplicated >&2; \
460              exit 1; \
461            }; :
462 check-local: check-no-repeated-test-name
463 .PHONY: check-no-repeated-test-name
465 # Check that our test cases are syntactically correct.
466 # See automake bug#11898.
467 check-tests-syntax:
468         @st=0; \
469         err () { echo "$@: $$*" >&2; st=1; }; \
470 ## The user might do something like "make check TESTS=t/foo" or
471 ## "make check TESTS_LOGS=t/foo.log" and expect (say) the test
472 ## 't/foo.sh' to be run; this has worked well until today, and
473 ## we want to continue supporting this use case.
474         bases=`for log in : $(TEST_LOGS); do echo $$log; done \
475           | sed -e '/^:$$/d' -e 's/\.log$$//'`; \
476         for bas in $$bases; do \
477           for suf in sh tap pl; do \
478             tst=$$bas.$$suf; \
479 ## Emulate VPATH search.
480             if test -f $$tst; then \
481               break; \
482             elif test -f $(srcdir)/$$tst; then \
483               tst=$(srcdir)/$$tst; \
484               break; \
485             else \
486               tst=''; \
487             fi; \
488           done; \
489           test -n "$$tst" || err "couldn't find test '$$bas'"; \
490 ## Don't check that perl tests are valid shell scripts!
491           test $$suf = pl && continue; \
492           $(AM_V_P) && echo " $(AM_TEST_RUNNER_SHELL) -n $$tst"; \
493           $(AM_TEST_RUNNER_SHELL) -n "$$tst" \
494             || err "test '$$tst' syntactically invalid"; \
495         done; \
496         exit $$st
497 check-local: check-tests-syntax
498 .PHONY: check-tests-syntax
500 # Recipes with a trailing backslash character (possibly followed by
501 # blank characters only) can cause spurious syntax errors with at
502 # least older bash versions (e.g., bash 2.05b), and can be potentially
503 # be unportable to other weaker shells.  Run the testsuite in a way
504 # that helps catching such problems in Automake-generated recipes.
505 # See automake bug#10436.
506 check-no-trailing-backslash-in-recipes:
507         $(AM_V_at)$(MAKE) $(AM_MAKEFLAGS) check \
508           CONFIG_SHELL='$(abs_top_builddir)/t/ax/shell-no-trail-bslash'
509 .PHONY: check-no-trailing-backslash-in-recipes
511 ## Checking the list of tests.
512 test_subdirs = t t/pm
513 include $(srcdir)/t/CheckListOfTests.am
515 # Run the testsuite with the installed aclocal and automake.
516 installcheck-local: installcheck-testsuite
517 installcheck-testsuite:
518         am_running_installcheck=yes $(MAKE) $(AM_MAKEFLAGS) check
520 # Performance tests.
521 .PHONY: perf
522 perf: all
523         $(MAKE) $(AM_MAKEFLAGS) TEST_SUITE_LOG='$(PERF_TEST_SUITE_LOG)' \
524                                 TESTS='$(perf_TESTS)' check
525 PERF_TEST_SUITE_LOG = t/perf/test-suite.log
526 CLEANFILES += $(PERF_TEST_SUITE_LOG)
527 EXTRA_DIST += $(perf_TESTS)
529 clean-local: clean-local-check
530 .PHONY: clean-local-check
531 clean-local-check:
532         -set x t/*.dir; shift; \
533          if test "$$#,$$1" = "1,*.dir"; then \
534            : there is no test directory to clean; \
535          else \
536            find "$$@" -type d ! -perm -700 -exec chmod u+rwx {} ';'; \
537            rm -rf "$$@"; \
538          fi;
541 ## ---------------- ##
542 ##  Documentation.  ##
543 ## ---------------- ##
545 info_TEXINFOS = doc/automake.texi doc/automake-history.texi
546 doc_automake_TEXINFOS = doc/fdl.texi
547 doc_automake_history_TEXINFOS = doc/fdl.texi
549 man1_MANS = \
550   doc/aclocal.1 \
551   doc/automake.1 \
552   doc/aclocal-$(APIVERSION).1 \
553   doc/automake-$(APIVERSION).1
555 $(man1_MANS): $(srcdir)/configure.ac
557 CLEANFILES += $(man1_MANS)
558 EXTRA_DIST += doc/help2man
560 update_mans = \
561   $(AM_V_GEN): \
562     && $(MKDIR_P) doc \
563     && PATH="$(abs_builddir)/t/wrap$(PATH_SEPARATOR)$$PATH" \
564     && export PATH \
565     && $(PERL) $(srcdir)/doc/help2man --output=$@
567 doc/aclocal.1 doc/automake.1:
568         $(AM_V_GEN): \
569           && $(MKDIR_P) doc \
570           && f=`echo $@ | sed 's|.*/||; s|\.1$$||; $(transform)'` \
571           && echo ".so man1/$$f-$(APIVERSION).1" > $@
573 doc/aclocal-$(APIVERSION).1: aclocal.in aclocal lib/Automake/Config.pm
574         $(update_mans) aclocal-$(APIVERSION)
575 doc/automake-$(APIVERSION).1: automake.in automake lib/Automake/Config.pm
576         $(update_mans) automake-$(APIVERSION)
579 ## ---------------------------- ##
580 ##  Example package "amhello".  ##
581 ## ---------------------------- ##
583 amhello_sources = \
584   doc/amhello/configure.ac \
585   doc/amhello/Makefile.am \
586   doc/amhello/README \
587   doc/amhello/src/main.c \
588   doc/amhello/src/Makefile.am
590 amhello_configury = \
591   aclocal.m4 \
592   autom4te.cache \
593   Makefile.in \
594   config.h.in \
595   configure \
596   depcomp \
597   install-sh \
598   missing \
599   src/Makefile.in
601 dist_noinst_DATA += $(amhello_sources)
602 dist_doc_DATA = $(srcdir)/doc/amhello-1.0.tar.gz
604 # We depend on configure.ac so that we regenerate the tarball
605 # whenever the Automake version changes.
606 # aclocal-$(APIVERSION) and automake-$(APIVERSION) are generated by
607 # configure in 't/wrap'.
608 $(srcdir)/doc/amhello-1.0.tar.gz: $(amhello_sources) $(srcdir)/configure.ac
609         $(AM_V_GEN): \
610           && PATH="$(abs_top_builddir)/t/wrap$(PATH_SEPARATOR)$$PATH" \
611           && export PATH \
612           && $(am__cd) $(srcdir)/doc/amhello \
613           && ACLOCAL=aclocal-$(APIVERSION) && export ACLOCAL \
614           && AUTOMAKE=automake-$(APIVERSION) && export AUTOMAKE \
615           && AUTOCONF='$(am_AUTOCONF)' && export AUTOCONF \
616           && AUTOM4TE='$(am_AUTOM4TE)' && export AUTOM4TE \
617           && AUTORECONF='$(am_AUTORECONF)' && export AUTORECONF \
618           && AUTOHEADER='$(am_AUTOHEADER)' && export AUTOHEADER \
619           && AUTOUPDATE='$(am_AUTOUPDATE)' && export AUTOUPDATE \
620           && $(am_AUTORECONF) -vfi \
621           && ./configure \
622           && $(MAKE) $(AM_MAKEFLAGS) distcheck \
623           && $(MAKE) $(AM_MAKEFLAGS) distclean \
624           && rm -rf $(amhello_configury) \
625           && mv -f amhello-1.0.tar.gz ..
628 ## ------------------------------------------------- ##
629 ##  Third-party, obsolescent or experimental stuff.  ##
630 ## ------------------------------------------------- ##
632 EXTRA_DIST += \
633   contrib/check-html.am \
634   contrib/multilib/README \
635   contrib/multilib/config-ml.in \
636   contrib/multilib/symlink-tree \
637   contrib/multilib/multilib.am \
638   contrib/multilib/multi.m4 \
639   contrib/README
642 ## --------------------------------------------------- ##
643 ##  Older files, kept mostly for historical interest.  ##
644 ## --------------------------------------------------- ##
646 EXTRA_DIST += \
647   old/ChangeLog-tests \
648   old/ChangeLog.96 \
649   old/ChangeLog.98 \
650   old/ChangeLog.00 \
651   old/ChangeLog.01 \
652   old/ChangeLog.02 \
653   old/ChangeLog.03 \
654   old/ChangeLog.04 \
655   old/ChangeLog.09 \
656   old/ChangeLog.11 \
657   old/TODO
660 ##########################################################################
662 ## Everything past here is useful to the maintainer, but probably not
663 ## to anybody else.
665 ##########################################################################
668 ## --------------------------------------------------------- ##
669 ##  Automatic generation of the ChangeLog from git history.  ##
670 ## --------------------------------------------------------- ##
672 gitlog_to_changelog_command = $(PERL) $(srcdir)/lib/gitlog-to-changelog
673 gitlog_to_changelog_fixes = $(srcdir)/.git-log-fix
674 gitlog_to_changelog_options = --amend=$(gitlog_to_changelog_fixes) \
675                               --since='2011-12-28 00:00:00' \
676                               --no-cluster --format '%s%n%n%b'
678 EXTRA_DIST += lib/gitlog-to-changelog
679 EXTRA_DIST += $(gitlog_to_changelog_fixes)
681 # When executed from a git checkout, generate the ChangeLog from the git
682 # history.  When executed from an extracted distribution tarball, just
683 # copy the distributed ChangeLog in the build directory (and if this
684 # fails, or if no distributed ChangeLog file is present, complain and
685 # give an error).
687 # We need the apparently useless dependency from another .PHONY target
688 # 'am--changelog-regen-hook' to work around a bug of Solaris make, which
689 # doesn't execute the recipe of a target named as an existing file, even
690 # if such target is declared '.PHONY' (yikes!)
692 .PHONY: am--changelog-regen-hook
693 am--changelog-regen-hook:
694 ChangeLog: am--changelog-regen-hook
695         $(AM_V_GEN)set -e; set -u; \
696 ## The ChangeLog should be regenerated unconditionally when working from
697 ## checked-out sources; otherwise, if we're working from a distribution
698 ## tarball, we expect the ChangeLog to be distributed, so check that it
699 ## is indeed present in the source directory.
700         if test -d $(srcdir)/.git; then \
701           rm -f $@-t \
702             && $(gitlog_to_changelog_command) \
703                $(gitlog_to_changelog_options) >$@-t \
704             && chmod a-w $@-t \
705             && mv -f $@-t $@ \
706             || exit 1; \
707         elif test ! -f $(srcdir)/$@; then \
708           echo "Source tree is not a git checkout, and no pre-existent" \
709                "$@ file has been found there" >&2; \
710           exit 1; \
711         fi
714 ## --------------------------- ##
715 ##  Perl coverage statistics.  ##
716 ## --------------------------- ##
718 PERL_COVERAGE_DB = $(abs_top_builddir)/cover_db
719 PERL_COVERAGE_FLAGS = -MDevel::Cover=-db,$(PERL_COVERAGE_DB),-silent,on,-summary,off
720 PERL_COVER = cover
722 check-coverage-run recheck-coverage-run: all
723         $(mkinstalldirs) $(PERL_COVERAGE_DB)
724         PERL5OPT="$$PERL5OPT $(PERL_COVERAGE_FLAGS)"; export PERL5OPT; \
725         WANT_NO_THREADS=yes; export WANT_NO_THREADS; unset AUTOMAKE_JOBS; \
726         $(MAKE) $(AM_MAKEFLAGS) `echo $@ | sed 's/-coverage-run//'`
728 check-coverage-report:
729         @if test ! -d "$(PERL_COVERAGE_DB)"; then \
730           echo "No coverage database found in '$(PERL_COVERAGE_DB)'." >&2; \
731           echo "Please run \"make check-coverage\" first" >&2; \
732           exit 1; \
733         fi
734         $(PERL_COVER) $(PERL_COVER_FLAGS) "$(PERL_COVERAGE_DB)"
736 # We don't use direct dependencies here because we'd like to be able
737 # to invoke the report even after interrupted check-coverage.
738 check-coverage: check-coverage-run
739         $(MAKE) $(AM_MAKEFLAGS) check-coverage-report
741 recheck-coverage: recheck-coverage-run
742         $(MAKE) $(AM_MAKEFLAGS) check-coverage-report
744 clean-coverage:
745         rm -rf "$(PERL_COVERAGE_DB)"
746 clean-local: clean-coverage
748 .PHONY: check-coverage recheck-coverage check-coverage-run \
749         recheck-coverage-run check-coverage-report clean-coverage
752 ## ---------------------------------------------------- ##
753 ##  Tagging and/or uploading stable and beta releases.  ##
754 ## ---------------------------------------------------- ##
756 GIT = git
758 EXTRA_DIST += lib/gnupload
760 base_version_rx = ^[1-9][0-9]*\.[0-9][0-9]*
761 stable_major_version_rx = $(base_version_rx)$$
762 stable_minor_version_rx = $(base_version_rx)\.[0-9][0-9]*$$
763 beta_version_rx = $(base_version_rx)(\.[0-9][0-9]*)?[bdfhjlnprtvxz]$$
764 match_version = echo "$(VERSION)" | $(EGREP) >/dev/null
766 ## Check that we don't have uncommitted or unstaged changes.
767 ## TODO: Maybe the git suite already offers a shortcut to verify if the
768 ## TODO: working directory is "clean" or not?  If yes, use that instead
769 ## TODO: of duplicating the logic here.
770 git_must_have_clean_workdir = \
771   $(GIT) rev-parse --verify HEAD >/dev/null \
772     && $(GIT) update-index -q --refresh \
773     && $(GIT) diff-files --quiet \
774     && $(GIT) diff-index --quiet --cached HEAD \
775     || fatal "you have uncommitted or unstaged changes"
777 determine_release_type = \
778   if $(match_version) '$(stable_major_version_rx)'; then \
779     release_type='Major release'; \
780     announcement_type='major release'; \
781     dest=ftp; \
782   elif $(match_version) '$(stable_minor_version_rx)'; then \
783     release_type='Minor release'; \
784     announcement_type='maintenance release'; \
785     dest=ftp; \
786   elif $(match_version) '$(beta_version_rx)'; then \
787     release_type='Beta release'; \
788     announcement_type='test release'; \
789     dest=alpha; \
790   else \
791     fatal "invalid version '$(VERSION)' for a release"; \
792   fi
794 # Help the debugging of $(determine_release_type) and related code.
795 print-release-type:
796         @set -e -u \
797           && fatal () { echo "$@: $$*"; exit 0; } \
798           && $(determine_release_type) \
799           && echo "$$release_type $(VERSION);" \
800                   "it will be announced as a $$announcement_type"
802 git-tag-release: maintainer-check
803         @set -e; set -u; \
804         fatal () { echo "$@: $$*; not tagging" >&2; exit 1; }; \
805         case '$(AM_TAG_DRYRUN)' in \
806           ""|[nN]|[nN]o|NO) run="";; \
807           *) run="echo Running:";; \
808         esac; \
809         $(determine_release_type); \
810         $(git_must_have_clean_workdir); \
811 ## If all was successful, tag the release in the local repository.
812         $$run $(GIT) tag -s "v$(VERSION)" -m "$$release_type $(VERSION)"
814 git-upload-release:
815         @set -e; set -u; \
816         fatal () { echo "$@: $$*; not releasing" >&2; exit 1; }; \
817         $(determine_release_type); \
818         dest=$$dest.gnu.org:automake; \
819         $(git_must_have_clean_workdir); \
820 ## Check that we are releasing from a valid tag.
821         tag=`$(GIT) describe` \
822           && case $$tag in "v$(VERSION)") true;; *) false;; esac \
823           || fatal "you can only create a release from a tagged version"; \
824 ## Build and upload the distribution tarball(s).
825         $(MAKE) $(AM_MAKEFLAGS) dist || exit 1; \
826         echo Will upload to $$dest: $(DIST_ARCHIVES); \
827         $(srcdir)/lib/gnupload $(GNUPLOADFLAGS) --to $$dest $(DIST_ARCHIVES)
829 .PHONY: print-release-type git-upload-release git-tag-release
832 ## ------------------------------------------------------------------ ##
833 ##  Explore differences of autogenerated files in different commits.  ##
834 ## ------------------------------------------------------------------ ##
836 ## Visually comparing differences between the Makefile.in files in
837 ## automake's own build system as generated in two different branches
838 ## might help to catch bugs and blunders.  This has already happened a
839 ## few times in the past, when we used to version-control Makefile.in.
840 autodiffs:
841         @set -u; \
842          NEW_COMMIT=$${NEW_COMMIT-"HEAD"}; \
843          OLD_COMMIT=$${OLD_COMMIT-"HEAD~1"}; \
844          am_gitdir='$(abs_top_srcdir)/.git'; \
845          get_autofiles_from_rev () \
846          { \
847              rev=$$1 dir=$$2 \
848                && echo "$@: will get files from revision $$rev" \
849                && $(GIT) clone -q --depth 1 "$$am_gitdir" tmp \
850                && $(am__cd) tmp \
851                && $(GIT) checkout -q "$$rev" \
852                && echo "$@: bootstrapping $$rev" \
853                && $(SHELL) ./bootstrap.sh \
854                && echo "$@: copying files from $$rev" \
855                && makefile_ins=`find . -name Makefile.in` \
856                && (tar cf - configure aclocal.m4 $$makefile_ins) | \
857                   (cd .. && $(am__cd) "$$dir" && tar xf -) \
858                && cd .. \
859                && rm -rf tmp; \
860          }; \
861          outdir=$@.dir \
862 ## Before proceeding, ensure the specified revisions truly exist.
863            && $(GIT) --git-dir="$$am_gitdir" describe $$OLD_COMMIT >/dev/null \
864            && $(GIT) --git-dir="$$am_gitdir" describe $$NEW_COMMIT >/dev/null \
865            && rm -rf $$outdir \
866            && mkdir $$outdir \
867            && $(am__cd) $$outdir \
868            && mkdir new old \
869            && get_autofiles_from_rev $$OLD_COMMIT old \
870            && get_autofiles_from_rev $$NEW_COMMIT new \
871            && exit 0
873 ## With lots of eye candy; we like our developers pampered and spoiled :-)
874 compare-autodiffs: autodiffs
875         @set -u; \
876         : $${COLORDIFF=colordiff} $${DIFF=diff}; \
877         dir=autodiffs.dir; \
878         if test ! -d "$$dir"; then \
879           echo "$@: $$dir: Not a directory" >&2; \
880           exit 1; \
881         fi; \
882         mydiff=false mypager=false; \
883         if test -t 1; then \
884           if ($$COLORDIFF -r . .) </dev/null >/dev/null 2>&1; then \
885             mydiff=$$COLORDIFF; \
886             mypager="less -R"; \
887           else \
888             mypager=less; \
889           fi; \
890         else \
891           mypager=cat; \
892         fi; \
893         if test "$$mydiff" = false; then \
894           if ($$DIFF -r -u . .); then \
895             mydiff=$$DIFF; \
896           else \
897             echo "$@: no good-enough diff program specified" >&2; \
898             exit 1; \
899           fi; \
900         fi; \
901         st=0; $$mydiff -r -u $$dir/old $$dir/new | $$mypager || st=$$?; \
902         rm -rf $$dir; \
903         exit $$st
904 .PHONY: autodiffs compare-autodiffs
906 ## ---------------------------------------------- ##
907 ##  Help writing the announcement for a release.  ##
908 ## ---------------------------------------------- ##
910 PACKAGE_MAILINGLIST = automake@gnu.org
912 announcement: NEWS
913         $(AM_V_GEN): \
914           && rm -f $@ $@-t \
915           && fatal () { echo "$@: $$*" >&2; exit 1; } \
916           && $(determine_release_type) \
917           && ftp_base="ftp://$$dest.gnu.org/gnu/$(PACKAGE)" \
918           && X () { printf '%s\n' "$$*" >> $@-t; } \
919           && X "We are pleased to announce the $(PACKAGE_NAME) $(VERSION)" \
920                "$$announcement_type." \
921           && X \
922           && X "**TODO** Brief description of the release here." \
923           && X \
924           && X "**TODO** This description can span multiple paragraphs." \
925           && X \
926           && X "See below for the detailed list of changes since the" \
927           && X "previous version, as summarized by the NEWS file." \
928           && X \
929           && X "Download here:" \
930           && X \
931           && X "  $$ftp_base/$(PACKAGE)-$(VERSION).tar.gz" \
932           && X "  $$ftp_base/$(PACKAGE)-$(VERSION).tar.xz" \
933           && X \
934           && X "Please report bugs and problems to" \
935                "<$(PACKAGE_BUGREPORT)>," \
936           && X "and send general comments and feedback to" \
937                "<$(PACKAGE_MAILINGLIST)>." \
938           && X \
939           && X "Thanks to everyone who has reported problems, contributed" \
940           && X "patches, and helped testing Automake!" \
941           && X \
942           && X "-*-*-*-" \
943           && X \
944           && sed -n -e '/^~~~/q' -e p $(srcdir)/NEWS >> $@-t \
945           && mv -f $@-t $@
946 .PHONY: announcement
947 CLEANFILES += announcement
949 ## --------------------------------------------------------------------- ##
950 ##  Synchronize third-party files that are committed in our repository.  ##
951 ## --------------------------------------------------------------------- ##
953 # Program to use to fetch files.
954 WGET = wget
956 # Some repositories we sync files from.
957 SV_CVS    = 'http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/'
958 SV_GIT_CF = 'http://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;hb=HEAD;f='
959 SV_GIT_AC = 'http://git.savannah.gnu.org/gitweb/?p=autoconf.git;a=blob_plain;hb=HEAD;f='
960 SV_GIT_GL = 'http://git.savannah.gnu.org/gitweb/?p=gnulib.git;a=blob_plain;hb=HEAD;f='
962 # Files that we fetch and which we compare against.
963 # Note that the 'lib/COPYING' file must still be synced by hand.
964 FETCHFILES = \
965   $(SV_GIT_CF)config.guess \
966   $(SV_GIT_CF)config.sub \
967   $(SV_CVS)texinfo/texinfo/doc/texinfo.tex \
968   $(SV_CVS)texinfo/texinfo/util/gendocs.sh \
969   $(SV_CVS)texinfo/texinfo/util/gendocs_template \
970   $(SV_GIT_GL)build-aux/gitlog-to-changelog \
971   $(SV_GIT_GL)build-aux/gnupload \
972   $(SV_GIT_GL)build-aux/update-copyright \
973   $(SV_GIT_GL)doc/INSTALL
975 # Fetch the latest versions of few scripts and files we care about.
976 fetch:
977         $(AM_V_at)rm -rf Fetchdir
978         $(AM_V_at)mkdir Fetchdir
979         $(AM_V_GEN)set -e; \
980         if $(AM_V_P); then wget_opts=; else wget_opts=-nv; fi; \
981         for url in $(FETCHFILES); do \
982            file=`printf '%s\n' "$$url" | sed 's|^.*/||; s|^.*=||'`; \
983 ## A retrieval failure usually means a serious problem.  Just bail out.
984            $(WGET) $$wget_opts "$$url" -O Fetchdir/$$file || exit 1; \
985            if cmp Fetchdir/$$file $(srcdir)/lib/$$file >/dev/null; then \
986              : Nothing to do; \
987            else \
988              echo "$@: updating file $$file"; \
989 ## Ditto for a copying failure.
990              cp Fetchdir/$$file $(srcdir)/lib/$$file || exit 1; \
991            fi; \
992         done
993         $(AM_V_at)rm -rf Fetchdir
994 .PHONY: fetch
996 ## --------------------------------------------------------------------- ##
997 ##  Generate manuals in several formats, for upload on the GNU website.  ##
998 ## --------------------------------------------------------------------- ##
1000 # The gendocs.sh script sadly leaves TeX and Texinfo auxiliary files
1001 # in the directory where it's invoked.
1002 clean_texinfo_clutter_cmd = \
1003   $(am__cd) doc && rm -f *.ac *.aux *.cm *.cp *.cps *.fn *.fns *.ky \
1004                          *.log *.op *.pg *.toc *.tp *.tr *.vr *.vrs
1006 clean-web-manuals:
1007         $(AM_V_at)rm -rf doc/web-manuals
1008 clean-texinfo-clutter:
1009         $(AM_V_at)$(clean_texinfo_clutter_cmd)
1010 clean-local: clean-web-manuals clean-texinfo-clutter
1011 .PHONY: clean-web-manuals clean-texinfo-clutter
1013 web-manuals:
1014         $(AM_V_at)rm -rf doc/web-manuals
1015         $(AM_V_GEN): \
1016 ## The gendocs.sh script only works from the srcdir, sadly.
1017           && $(am__cd) $(srcdir)/doc \
1018           && GENDOCS_TEMPLATE_DIR=../lib \
1019           && export GENDOCS_TEMPLATE_DIR \
1020 ## Try to respect silent rules.
1021           && if $(AM_V_P); then :; else exec >/dev/null 2>&1; fi \
1022 ## Finally generate the manual in several formats.
1023           && $(SHELL) ../lib/gendocs.sh -o web-manuals \
1024              --email $(PACKAGE_BUGREPORT) $(PACKAGE) '$(PACKAGE_NAME)'
1025         $(AM_V_at)$(clean_texinfo_clutter_cmd)
1026         $(AM_V_at)if $(AM_V_P); then ls -l doc/web-manuals; else :; fi
1027 .PHONY: web-manuals
1029 EXTRA_DIST += lib/gendocs.sh lib/gendocs_template
1031 ## ------------------------------------------------ ##
1032 ##  Update copyright years of all committed files.  ##
1033 ## ------------------------------------------------ ##
1035 EXTRA_DIST += lib/update-copyright
1037 update_copyright_env = \
1038   UPDATE_COPYRIGHT_FORCE=1 \
1039   UPDATE_COPYRIGHT_USE_INTERVALS=2
1041 .PHONY: update-copyright
1042 update-copyright:
1043         $(AM_V_GEN)set -e; \
1044         current_year=`date +%Y` && test -n "$$current_year" \
1045           || { echo "$@: cannot get current year" >&2; exit 1; }; \
1046         sed -i "/^RELEASE_YEAR=/s/=.*$$/=$$current_year/" \
1047           bootstrap.sh configure.ac; \
1048         excluded_re=`echo $(FETCHFILES) \
1049           | sed -e 's|^.*/|lib/|' -e 's| | lib/|g' -e 's, ,|,g'`; \
1050         $(GIT) ls-files \
1051           | grep -Ev '^(lib/)?(COPYING|INSTALL)$$' \
1052           | grep -Ev "^($$excluded_re)$$" \
1053           | $(update_copyright_env) xargs $(srcdir)/lib/$@