Realign the test docs with reality
[elinks.git] / Makefile.lib
blob7faa06f0953402bfc4dfba98778748c044552bfe
1 ### The build commands and verbosity
3 # If we are verbose, we will show commands prefixed by $(Q) (which acts as
4 # @ in the non-verbose mode), and we will show the "real" cmds instead of
5 # their quiet versions (which are used in the non-verbose mode).
6 # Inspired by the Linux kernel build system.
7 ifdef V
8         Q =
9         quiet =
10         mquiet = masq_
11 else
12         Q = @
13         quiet = quiet_
14         mquiet = quiet_
15 endif
17 # Colorize the build.
18 ifdef MAKE_COLOR
19         INFO_COLOR    = $(shell tput setaf 5)
20         CC_COLOR      = $(shell tput setaf 6)
21         LD_COLOR      = $(shell tput setaf 2)
22         PO_COLOR      = $(shell tput setaf 6)
23         LINK_COLOR    = $(shell tput bold;tput setaf 4)
24         INSTALL_COLOR = $(shell tput setaf 3)
25         END_COLOR     = $(shell tput sgr0)
26 endif
28 # Show the command (quiet or non-quiet version based on the assignment
29 # just above) and then execute it.
30 ncmd = $(if $($(quiet)cmd_$(1)),echo $($(quiet)cmd_$(1)) &&) $(cmd_$(1))
31 cmd = @$(if $($(quiet)cmd_$(1)),echo $($(quiet)cmd_$(1)) &&) $(cmd_$(1))
32 mcmd = @$(if $($(mquiet)cmd_$(1)),echo $($(mquiet)cmd_$(1)) &&) $(cmd_$(1))
33 ecmd = @$(if $($(mquiet)cmd_$(1)),printf "%-38s " $($(mquiet)cmd_$(1)) &&) $(cmd_$(1))
35 quiet_cmd_compile = '      [$(CC_COLOR)CC$(END_COLOR)]   $(RELPATH)$@'
36  masq_cmd_compile = $(COMPILE) -c $<
37       cmd_compile = $(COMPILE) -Wp,-MD,.deps/$(*F).pp -c $<
39 # Rule to compile a set of .o files into one .o file
40 quiet_cmd_ld_objs = "      [$(LD_COLOR)LD$(END_COLOR)]   $(RELPATH)$@"
41       cmd_ld_objs = $(LD) -r -o $@ $(filter $(OBJS), $^) \
42                     $(foreach subdir,$(sort $(filter-out src,$(SUBDIRS))), \
43                             `test -e $(subdir)/lib.o && echo $(subdir)/lib.o`)
45    quiet_cmd_link = '    [$(LINK_COLOR)LINK$(END_COLOR)]   $(RELPATH)$@'
46          cmd_link = $(CC) $(CFLAGS) $(LDFLAGS) -o $@ $^ $(LIBS)
48  quiet_cmd_sparse = '    [SPARSE]   $(RELPATH)$(2)'
49        cmd_sparse = $(SPARSE) $(DEFS) $(INCLUDES) $(AM_CFLAGS) $(CFLAGS) $(SPARSE_FLAGS) $(2)
51 # Recursive make
52 quiet_cmd_recmake = "[$(INFO_COLOR)MAKE $(3)$(END_COLOR)]   $(RELPATH)$(2)"
53       cmd_recmake = $(MAKE) -C $(2) $(3)
55 quiet_cmd_installdata = "     [$(INSTALL_COLOR)INSTALL$(END_COLOR)]   $(RELPATH)$(2) -> $(3)"
56       cmd_installdata = $(INSTALL_DATA) $(2) $(3)
58 quiet_cmd_installprog = "     [$(INSTALL_COLOR)INSTALL$(END_COLOR)]   $(RELPATH)$(2) -> $(3)"
59       cmd_installprog = $(INSTALL_PROGRAM) $(2) $(3)
62 ### Internal build rules
64 DEP_FILES_1 = $(foreach src,$(OBJS),.deps/$(src))
65 DEP_FILES = $(DEP_FILES_1:%.o=%.P)
67 DEPS_MAGIC := $(shell mkdir .deps > /dev/null 2>&1 || :)
69 ifdef OBJS
70 -include $(DEP_FILES)
71 endif
73 %.o: $(srcdir)%.c
74         $(call mcmd,compile)
75         @-cp .deps/$(*F).pp .deps/$(*F).P; \
76                 tr ' ' '\012' < .deps/$(*F).pp \
77                         | sed -e 's/^\\$$//' -e '/^$$/ d' -e '/:$$/ d' -e 's/$$/ :/' \
78                         >> .deps/$(*F).P; \
79                 rm .deps/$(*F).pp
81 ifdef SUBDIRS-yes
82 SUBDIRS += $(SUBDIRS-yes)
83 endif
85 ifdef OBJS-yes
86 OBJS += $(OBJS-yes)
87 endif
89 ifneq ($(findstring cleanall,$(MAKECMDGOALS)),)
90 INCLUDE_ALL=1
91 endif
93 ifneq ($(findstring init,$(MAKECMDGOALS)),)
94 # FIXME: Detect when $(subdir)/Makefile is $(srcdir)/$(subdir)/Makefile
95 # and error out so the user won't overwrite the 'master' Makefiles.
96 INCLUDE_ALL=1
97 endif
99 ifdef INCLUDE_ALL
100 ifdef SUBDIRS-no
101 SUBDIRS += $(SUBDIRS-no)
102 endif
103 ifdef SUBDIRS-
104 SUBDIRS += $(SUBDIRS-)
105 endif
106 ifdef OBJS-no
107 OBJS += $(OBJS-no)
108 endif
109 ifdef OBJS-
110 OBJS += $(OBJS-)
111 endif
113 endif
116 ifdef OBJS
117 lib.o: $(sort $(OBJS)) $(foreach subdir,$(sort $(filter-out src,$(SUBDIRS))), $(wildcard $(subdir)/lib.o))
118         $(call cmd,ld_objs)
120 LIB_O = lib.o
121 CLEAN += $(OBJS) $(LIB_O)
122 endif
124 CLEAN += $(PROG)
126 all-default: $(LIB_O) $(PROGS) $(MAN1) $(MAN5)
128 init-default:
129         @$(foreach subdir,$(sort $(SUBDIRS)), \
130                 $(MKINSTALLDIRS) $(subdir) >/dev/null; \
131                 echo 'include $(SRC)/$(RELPATH)/$(subdir)/Makefile' > $(subdir)/Makefile;)
133 clean-default: clean-test
134         @-test -z "$(CLEAN)" || $(RM) $(CLEAN)
136 cleanall-default: clean-default
138 check-default:
139 ifneq ($(SPARSE),)
140         @$(foreach file, $(wildcard *.c), \
141                 $(call ncmd,sparse,$(file));)
142 endif
144 ##############################################################################
146 # Auto-testing infrastructure
149 clean-test:
150 test-default:
152 ifdef TEST_PROGS
153 TESTDEPS += $(TESTDEPS-yes)
155 $(TEST_PROGS): $(TESTDEPS) $$@.o
156         $(call cmd,link)
158 TESTS = $(wildcard $(srcdir)test-*)
160 $(TESTS): $(TEST_PROGS)
161         @echo "*** $(notdir $@) ***"; \
162         $(call shellquote,$(SHELL)) $@ $(TEST_OPTS)
164 test-default: $(TESTS)
166 clean-test:
167         @rm -fr trash
169 CLEAN += $(TEST_PROGS) $(patsubst %,%.o,$(TEST_PROGS))
170 endif
172 .PHONY: $(TESTS)
173 .NOPARALLEL:
175 # sparse is architecture-neutral, which means that we need to tell it
176 # explicitly what architecture to check for. Fix this up for yours..
177 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
178 install-default: all-default
179 ifdef PROGS
180         @$(MKINSTALLDIRS) $(DESTDIR)$(bindir)
181         @$(foreach file,$(PROGS), \
182                 $(call ncmd,installprog,$(file),$(DESTDIR)$(bindir));)
183 endif
184 ifdef MAN1
185         @$(MKINSTALLDIRS) $(DESTDIR)$(mandir)/man1
186         @$(foreach file,$(MAN1), \
187                 $(call ncmd,installdata,$(file),$(DESTDIR)$(mandir)/man1);)
188 endif
189 ifdef MAN5
190         @$(MKINSTALLDIRS) $(DESTDIR)$(mandir)/man5
191         @$(foreach file,$(MAN5), \
192                 $(call ncmd,installdata,$(file),$(DESTDIR)$(mandir)/man5);)
193 endif
195 # Recursion:
197 .PHONY: all-recursive install-recursive clean-recursive cleanall-recursive init-recursive check-recursive test-recursive
199 all-recursive install-recursive clean-recursive cleanall-recursive init-recursive check-recursive test-recursive:
200 ifdef SUBDIRS
201         @$(foreach subdir,$(sort $(SUBDIRS)), \
202                 $(call ncmd,recmake,$(subdir),$(subst -recursive,,$@)) || exit 1;)
203 endif
205 all: all-recursive all-default all-local
206 install: install-recursive install-default install-local
207 check: check-recursive check-default check-local
208 clean: clean-recursive clean-default clean-local
209 test: test-recursive test-default test-local
211 cleanall: cleanall-recursive cleanall-default
212 init: init-default init-recursive
214 all-local:
215 install-local:
216 clean-local:
217 check-local:
218 test-local:
220 # Tell versions [3.59,3.63) of GNU make to not export all variables.
221 # Otherwise a system limit (for SysV at least) may be exceeded.
222 .NOEXPORT:
224 # Shell quote;
225 # Result of this needs to be placed inside ''
226 # XXX: Placed here because Vim cannot highlight things right afterwards
227 shq = $(subst ','\'',$(1))
228 # This has surrounding ''
229 shellquote = '$(call shq,$(1))'
231 # vim:syntax=make