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)
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.
23 MAINTAINERCLEANFILES =
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.
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' \
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)"; \
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)
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.
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"; \
89 @for p in $(bin_SCRIPTS); do \
90 f="`echo $$p|sed '$(transform)'`"; \
91 fv="$$f-$(APIVERSION)"; \
92 rm -f "$(DESTDIR)$(bindir)/$$fv"; \
95 ## These files depend on Makefile so they are rebuilt if $(VERSION),
96 ## $(datadir) or other do_subst'ituted variables change.
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.
111 $(AM_V_GEN)cp $(srcdir)/lib/INSTALL $@
113 # We don't use the default name for the autom4te cache directory,
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 = \
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.
150 @for f in $(dist_script_DATA); do echo $$f; done \
154 echo " chmod +x '$(DESTDIR)$(scriptdir)/$$f'"; \
155 chmod +x "$(DESTDIR)$(scriptdir)/$$f" || st=1; \
159 installcheck-local: installcheck-executable-scripts
160 installcheck-executable-scripts:
161 @for f in $(dist_script_DATA); do echo $$f; done \
164 path="$(pkgvdatadir)/$$f"; \
165 test -x "$$path" || echo $$path; \
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 \
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 ## --------------------- ##
216 lib/am/clean-hdr.am \
219 lib/am/configure.am \
226 lib/am/header-vars.am \
229 lib/am/inst-vars.am \
231 lib/am/lang-compile.am \
238 lib/am/ltlibrary.am \
239 lib/am/mans-vars.am \
244 lib/am/remake-hdr.am \
248 lib/am/texi-vers.am \
249 lib/am/texibuild.am \
255 ## ------------------------------ ##
256 ## Automake-provided m4 macros. ##
257 ## ------------------------------ ##
259 dist_automake_ac_DATA = \
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
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
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 = \
343 am_test_prefer_config_shell \
344 am_original_AUTOMAKE \
345 am_original_ACLOCAL \
346 am_test_lib_sourced \
349 eval test x"\$${$$v}" = x || unset $$v; \
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; \
363 PATH='$(abs_builddir)/t/ax'$(PATH_SEPARATOR)$$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)
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 \
432 && $(do_subst) <$(srcdir)/$$in >$@-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 \
443 && $(do_subst) <$(srcdir)/runtest.in >$@-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
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 \
459 echo $@: test names listed above are duplicated >&2; \
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.
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 \
479 ## Emulate VPATH search.
480 if test -f $$tst; then \
482 elif test -f $(srcdir)/$$tst; then \
483 tst=$(srcdir)/$$tst; \
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"; \
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
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
532 -set x t/*.dir; shift; \
533 if test "$$#,$$1" = "1,*.dir"; then \
534 : there is no test directory to clean; \
536 find "$$@" -type d ! -perm -700 -exec chmod u+rwx {} ';'; \
541 ## ---------------- ##
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
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
563 && PATH="$(abs_builddir)/t/wrap$(PATH_SEPARATOR)$$PATH" \
565 && $(PERL) $(srcdir)/doc/help2man --output=$@
567 doc/aclocal.1 doc/automake.1:
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 ## ---------------------------- ##
584 doc/amhello/configure.ac \
585 doc/amhello/Makefile.am \
587 doc/amhello/src/main.c \
588 doc/amhello/src/Makefile.am
590 amhello_configury = \
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
610 && PATH="$(abs_top_builddir)/t/wrap$(PATH_SEPARATOR)$$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 \
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 ## ------------------------------------------------- ##
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 \
642 ## --------------------------------------------------- ##
643 ## Older files, kept mostly for historical interest. ##
644 ## --------------------------------------------------- ##
647 old/ChangeLog-tests \
660 ##########################################################################
662 ## Everything past here is useful to the maintainer, but probably not
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
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 \
702 && $(gitlog_to_changelog_command) \
703 $(gitlog_to_changelog_options) >$@-t \
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; \
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
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; \
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
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 ## ---------------------------------------------------- ##
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'; \
782 elif $(match_version) '$(stable_minor_version_rx)'; then \
783 release_type='Minor release'; \
784 announcement_type='maintenance release'; \
786 elif $(match_version) '$(beta_version_rx)'; then \
787 release_type='Beta release'; \
788 announcement_type='test release'; \
791 fatal "invalid version '$(VERSION)' for a release"; \
794 # Help the debugging of $(determine_release_type) and related code.
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
804 fatal () { echo "$@: $$*; not tagging" >&2; exit 1; }; \
805 case '$(AM_TAG_DRYRUN)' in \
806 ""|[nN]|[nN]o|NO) run="";; \
807 *) run="echo Running:";; \
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)"
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.
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 () \
848 && echo "$@: will get files from revision $$rev" \
849 && $(GIT) clone -q --depth 1 "$$am_gitdir" 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 -) \
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 \
867 && $(am__cd) $$outdir \
869 && get_autofiles_from_rev $$OLD_COMMIT old \
870 && get_autofiles_from_rev $$NEW_COMMIT new \
873 ## With lots of eye candy; we like our developers pampered and spoiled :-)
874 compare-autodiffs: autodiffs
876 : $${COLORDIFF=colordiff} $${DIFF=diff}; \
878 if test ! -d "$$dir"; then \
879 echo "$@: $$dir: Not a directory" >&2; \
882 mydiff=false mypager=false; \
884 if ($$COLORDIFF -r . .) </dev/null >/dev/null 2>&1; then \
885 mydiff=$$COLORDIFF; \
893 if test "$$mydiff" = false; then \
894 if ($$DIFF -r -u . .); then \
897 echo "$@: no good-enough diff program specified" >&2; \
901 st=0; $$mydiff -r -u $$dir/old $$dir/new | $$mypager || st=$$?; \
904 .PHONY: autodiffs compare-autodiffs
906 ## ---------------------------------------------- ##
907 ## Help writing the announcement for a release. ##
908 ## ---------------------------------------------- ##
910 PACKAGE_MAILINGLIST = automake@gnu.org
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." \
922 && X "**TODO** Brief description of the release here." \
924 && X "**TODO** This description can span multiple paragraphs." \
926 && X "See below for the detailed list of changes since the" \
927 && X "previous version, as summarized by the NEWS file." \
929 && X "Download here:" \
931 && X " $$ftp_base/$(PACKAGE)-$(VERSION).tar.gz" \
932 && X " $$ftp_base/$(PACKAGE)-$(VERSION).tar.xz" \
934 && X "Please report bugs and problems to" \
935 "<$(PACKAGE_BUGREPORT)>," \
936 && X "and send general comments and feedback to" \
937 "<$(PACKAGE_MAILINGLIST)>." \
939 && X "Thanks to everyone who has reported problems, contributed" \
940 && X "patches, and helped testing Automake!" \
944 && sed -n -e '/^~~~/q' -e p $(srcdir)/NEWS >> $@-t \
947 CLEANFILES += announcement
949 ## --------------------------------------------------------------------- ##
950 ## Synchronize third-party files that are committed in our repository. ##
951 ## --------------------------------------------------------------------- ##
953 # Program to use to fetch files.
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.
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.
977 $(AM_V_at)rm -rf Fetchdir
978 $(AM_V_at)mkdir Fetchdir
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 \
988 echo "$@: updating file $$file"; \
989 ## Ditto for a copying failure.
990 cp Fetchdir/$$file $(srcdir)/lib/$$file || exit 1; \
993 $(AM_V_at)rm -rf Fetchdir
996 ## ---------------------------------------------------------------------- ##
997 ## Generate and upload manuals in several formats, for the GNU website. ##
998 ## ---------------------------------------------------------------------- ##
1000 web_manual_dir = doc/web-manual
1006 WEBCVS_ROOT = cvs.savannah.gnu.org:/web
1009 $(AM_V_at)rm -rf $(web_manual_dir)
1010 $(AM_V_GEN)tmp=$@.dir \
1013 && $(am__cd) $$tmp \
1014 && GENDOCS_TEMPLATE_DIR='$(abs_srcdir)/lib' \
1015 && export GENDOCS_TEMPLATE_DIR \
1016 ## Needed to pacify extra checks from gendocs.sh.
1017 && $(LN_S) '$(abs_srcdir)/doc/$(PACKAGE).texi' . \
1018 ## Try to respect silent rules.
1019 && if $(AM_V_P); then :; else exec >/dev/null 2>&1; fi \
1020 ## Finally generate the manual in several formats.
1021 && $(SHELL) '$(abs_srcdir)/lib/gendocs.sh' \
1022 -I '$(abs_srcdir)/doc' --email $(PACKAGE_BUGREPORT) \
1023 $(PACKAGE) '$(PACKAGE_NAME)'
1024 $(AM_V_at)tmp=$@.dir \
1025 && mkdir $(web_manual_dir) \
1026 && mv -f $$tmp/manual/* $(web_manual_dir) \
1028 && { ! $(AM_V_P) || ls -l $(web_manual_dir); }
1032 $(AM_V_at)fatal () { echo "$@: $$*" >&2; exit 1; }; \
1033 $(determine_release_type); \
1034 case $$release_type in \
1035 [Mm]ajor\ release|[Mm]inor\ release);; \
1036 *) echo "Cannot upload manuals from a \"$$release_type\"" >&2; \
1039 $(AM_V_at)test -f $(web_manual_dir)/$(PACKAGE).html || { \
1040 echo 'You have to run "$(MAKE) web-manuals" before' \
1041 'invoking "$(MAKE) $@"' >&2; \
1045 && CVS_RSH=ssh && export CVS_RSH=ssh \
1049 && $(am__cd) $$tmp \
1050 && $(CVS) -z3 -d :ext:$(CVS_USER)@$(WEBCVS_ROOT)/$(PACKAGE) \
1053 ## According to the rsync manpage, "a trailing slash on the source [...]
1054 ## avoids creating an additional directory level at the destination".
1055 ## So the trailing '/' after '$(web_manual_dir)' below is intended.
1056 && $(RSYNC) -avP $(web_manual_dir)/ $$tmp/$(PACKAGE)/manual \
1058 cd $$tmp/$(PACKAGE)/manual \
1059 && new_files=`$(CVSU) --types='?'` \
1060 && new_files=`echo "$$new_files" | sed s/^..//` \
1061 && { test -z "$$new_files" || $(CVS) add -ko $$new_files; } \
1062 && $(CVS) ci -m $(VERSION) \
1065 .PHONY: web-manual-update
1068 $(AM_V_at)rm -rf $(web_manual_dir)
1069 .PHONY: clean-web-manual
1070 clean-local: clean-web-manual
1072 EXTRA_DIST += lib/gendocs.sh lib/gendocs_template
1074 ## ------------------------------------------------ ##
1075 ## Update copyright years of all committed files. ##
1076 ## ------------------------------------------------ ##
1078 EXTRA_DIST += lib/update-copyright
1080 update_copyright_env = \
1081 UPDATE_COPYRIGHT_FORCE=1 \
1082 UPDATE_COPYRIGHT_USE_INTERVALS=2
1084 .PHONY: update-copyright
1086 $(AM_V_GEN)set -e; \
1087 current_year=`date +%Y` && test -n "$$current_year" \
1088 || { echo "$@: cannot get current year" >&2; exit 1; }; \
1089 sed -i "/^RELEASE_YEAR=/s/=.*$$/=$$current_year/" \
1090 bootstrap.sh configure.ac; \
1091 excluded_re=`echo $(FETCHFILES) \
1092 | sed -e 's|^.*/|lib/|' -e 's| | lib/|g' -e 's, ,|,g'`; \
1094 | grep -Ev '^(lib/)?(COPYING|INSTALL)$$' \
1095 | grep -Ev "^($$excluded_re)$$" \
1096 | $(update_copyright_env) xargs $(srcdir)/lib/$@