Files
magic/rules.mak
T
Darryl L. MilesandClaude Opus 4.8 1bc8537b5d build: per-file automatic dependencies (.deps), retire the Depend/sed machinery
Replace the monolithic per-directory `Depend` file -- generated by a separate,
serial `make depend` pass (one `gcc -MM` over all sources) and post-processed by
sed -- with automake-style per-file dependency fragments produced as a side
effect of each compile.

rules.mak's %.o rule now adds, when the compiler supports it,
  -MMD -MP -MF .deps/<stem>.d
so every object records the (non-system) headers it used.  Those fragments are
`-include`d best-effort: absent on a first build, present and correct after.
Benefits:
  * self-maintaining -- no explicit depend step; deps refresh on every compile;
  * parallel -- generated during the (already parallel) compile, no barrier;
  * -MMD already drops system headers (what the sed did) and -MP tolerates a
    removed/renamed header, so the sed post-processing is gone;
  * fixes out-of-tree incremental header tracking: with an absolute srcdir the
    old sed stripped the now-absolute *local* header paths too, silently losing
    them; the .d files keep them.

configure probes `-MMD -MP` (AUTODEP_FLAGS; empty and best-effort-skipped if the
compiler cannot).  clean/distclean remove .deps (rm -r); .gitignore replaces the
obsolete */Depend with .deps/.  `make depend` is kept as a no-op for callers that
still invoke it (e.g. the WASM build script).

Verified out-of-tree (--disable-ccache): 324 .d files, 0 Depend files, a header
touch recompiles its dependents, no-op rebuild is idle, clean clears .deps.  (The
top-level depend phase still runs here as a no-op; removed next.)

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
2026-07-26 14:54:11 -04:00

58 lines
2.1 KiB
Makefile

# You shouldn't need to edit this file, see the defs.mak file
module: lib${MODULE}.o
# Dependencies are now generated automatically as a side effect of each compile
# (see the %.o rule below); "make depend" is a no-op kept only so scripts/habits
# that still invoke it do not error.
.PHONY: depend
depend:
# Compile a source into an object. When the compiler supports it
# (AUTODEP_FLAGS = "-MMD -MP"), also write .deps/<stem>.d listing the non-system
# headers this object used -- generated as a side effect of the compile, so there
# is no separate serial "make depend" pass and it parallelises for free. -MMD
# already drops system headers (the job the old sed did), and -MP adds a phony
# target per header so a later removed/renamed header does not break the build.
%.o: %.c
@echo --- compiling ${MODULE}/$*.o
@test -z "${AUTODEP_FLAGS}" || mkdir -p .deps
${RM} $*.o
${CC} ${CFLAGS} ${CPPFLAGS} ${DFLAGS} ${AUTODEP_FLAGS} $(if ${AUTODEP_FLAGS},-MF .deps/$*.d) -c $< -o $@
lib${MODULE}.o: ${OBJS}
@echo --- linking lib${MODULE}.o
${RM} lib${MODULE}.o
${LINK} ${OBJS} -o lib${MODULE}.o ${EXTERN_LIBS}
lib: lib${MODULE}.a
lib${MODULE}.a: ${OBJS} ${LIB_OBJS}
@echo --- archiving lib${MODULE}.a
${RM} lib${MODULE}.a
${AR} ${ARFLAGS} lib${MODULE}.a ${OBJS} ${LIB_OBJS}
${RANLIB} lib${MODULE}.a
${MODULE}: lib${MODULE}.o ${EXTRA_LIBS}
@echo --- building main ${MODULE}
${RM} ${MODULE}
${CC} ${CFLAGS} ${CPPFLAGS} ${DFLAGS} lib${MODULE}.o ${EXTRA_LIBS} -o ${MODULE} ${LIBS}
${DESTDIR}${BINDIR}/${MODULE}${EXEEXT}: ${MODULE}${EXEEXT}
${RM} ${DESTDIR}${BINDIR}/${MODULE}${EXEEXT}
${CP} ${MODULE}${EXEEXT} ${DESTDIR}${BINDIR}
.PHONY: clean
clean:
${RM} ${CLEANS}
${RM} -r .deps
tags: ${SRCS} ${LIB_SRCS}
ctags $(addprefix $(srcdir)/,${SRCS} ${LIB_SRCS})
# Per-file dependency fragments written by the %.o rule above. Best effort: none
# exist on a first build (everything compiles anyway); on later builds they cause
# a recompile when a used header changes. `-include` tolerates their absence and
# the `-MP` phony header targets tolerate a removed/renamed header.
-include $(wildcard .deps/*.d)