Debian Codegraph @

GNUmakefile

raw
1 # Having a separate GNUmakefile lets me 'include' the dynamically
2 # generated rules created via cfg.mk (package-local configuration)
3 # as well as maint.mk (generic maintainer rules).
4 # This makefile is used only if you run GNU Make.
5 # It is necessary if you want to build targets usually of interest
6 # only to the maintainer.
7
8 # Copyright (C) 2001, 2003, 2006-2026 Free Software Foundation, Inc.
9
10 # This program is free software: you can redistribute it and/or modify
11 # it under the terms of the GNU General Public License as published by
12 # the Free Software Foundation, either version 3 of the License, or
13 # (at your option) any later version.
14
15 # This program is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 # GNU General Public License for more details.
19
20 # You should have received a copy of the GNU General Public License
21 # along with this program. If not, see <https://www.gnu.org/licenses/>.
22
23 # If the user runs GNU make but has not yet run ./configure,
24 # give them a diagnostic.
25 _gl-Makefile := $(wildcard [M]akefile)
26 ifneq ($(_gl-Makefile),)
27
28 # Make tar archive easier to reproduce.
29 export TAR_OPTIONS = --owner=0 --group=0 --numeric-owner --sort=name
30
31 # Allow the user to add to this in the Makefile.
32 ALL_RECURSIVE_TARGETS =
33
34 include Makefile
35
36 # Some projects override e.g., _autoreconf here.
37 -include $(srcdir)/cfg.mk
38
39 # Allow cfg.mk to override these.
40 _build-aux ?= build-aux
41 _autoreconf ?= autoreconf -v
42
43 include $(srcdir)/maint.mk
44
45 # Ensure that $(VERSION) is up to date for dist-related targets, but not
46 # for others: rerunning autoreconf and recompiling everything isn't cheap.
47 # This is not part of the essential workflow with .tarball-version. Rather,
48 # it is meant to help the maintainer who has changed the current version
49 # but not done a "make distclean".
50 _have-git-version-gen := \
51 $(shell test -f $(srcdir)/$(_build-aux)/git-version-gen && echo yes)
52 ifeq ($(_have-git-version-gen)0,yes$(MAKELEVEL))
53 _is-dist-target ?= $(filter-out %clean, \
54 $(filter maintainer-% dist% alpha beta stable,$(MAKECMDGOALS)))
55 _is-install-target ?= $(filter-out %check, $(filter install%,$(MAKECMDGOALS)))
56 ifneq (,$(_is-dist-target)$(_is-install-target))
57 _curr-ver := $(shell cd $(srcdir) \
58 && $(_build-aux)/git-version-gen \
59 .tarball-version \
60 $(git-version-gen-tag-sed-script))
61 ifneq ($(_curr-ver),$(VERSION))
62 ifeq ($(_curr-ver),UNKNOWN)
63 $(info WARNING: unable to verify if $(VERSION) is the correct version)
64 else
65 ifneq (,$(_is-install-target))
66 # GNU Coding Standards state that 'make install' should not cause
67 # recompilation after 'make all'. But as long as changing the version
68 # string alters config.h, the cost of having 'make all' always have an
69 # up-to-date version is prohibitive. So, as a compromise, we merely
70 # warn when installing a version string that is out of date; the user
71 # should run 'autoreconf' (or something like 'make distcheck') to
72 # fix the version, 'make all' to propagate it, then 'make install'.
73 $(info WARNING: version string $(VERSION) is out of date;)
74 $(info run '$(MAKE) _version' to fix it)
75 else
76 $(info INFO: running autoreconf for new version string: $(_curr-ver))
77 GNUmakefile: _version
78 touch GNUmakefile
79 endif
80 endif
81 endif
82 endif
83 endif
84
85 .PHONY: _version
86 _version:
87 cd $(srcdir) && rm -rf autom4te.cache .version && $(_autoreconf)
88 $(MAKE) $(AM_MAKEFLAGS) Makefile
89
90 else
91
92 .DEFAULT_GOAL := abort-due-to-no-makefile
93 srcdir = .
94
95 # The package can override .DEFAULT_GOAL to run actions like autoreconf.
96 -include ./cfg.mk
97
98 # Allow cfg.mk to override these.
99 _build-aux ?= build-aux
100 _autoreconf ?= autoreconf -v
101
102 include ./maint.mk
103
104 ifeq ($(.DEFAULT_GOAL),abort-due-to-no-makefile)
105 $(MAKECMDGOALS): abort-due-to-no-makefile
106 endif
107
108 abort-due-to-no-makefile:
109 @echo There seems to be no Makefile in this directory. 1>&2
110 @echo "You must run ./configure before running '$(MAKE)'." 1>&2
111 @exit 1
112
113 endif
114
115 # Tell version 3.79 and up of GNU make to not build goals in this
116 # directory in parallel, in case someone tries to build multiple
117 # targets, and one of them can cause a recursive target to be invoked.
118
119 # Only set this if Automake doesn't provide it.
120 AM_RECURSIVE_TARGETS ?= $(RECURSIVE_TARGETS:-recursive=) \
121 $(RECURSIVE_CLEAN_TARGETS:-recursive=) \
122 dist distcheck tags ctags
123
124 ALL_RECURSIVE_TARGETS += $(AM_RECURSIVE_TARGETS)
125
126 ifneq ($(word 2, $(MAKECMDGOALS)), )
127 ifneq ($(filter $(ALL_RECURSIVE_TARGETS), $(MAKECMDGOALS)), )
128 .NOTPARALLEL:
129 endif
130 endif