Merge subdirmk

[secnet.git] / subdirmk / cdeps.sd.mk

diff --git a/subdirmk/cdeps.sd.mk b/subdirmk/cdeps.sd.mk
index c898cc09d1c6e3337364b824a6b5af2f1260245d..5a2bfb28df5bf2737c2c556eac31b1090c7b41db 100644 (file)
--- a/subdirmk/cdeps.sd.mk
+++ b/subdirmk/cdeps.sd.mk
@@ -3,7 +3,24 @@
 #  Copyright 2019 Ian Jackson
 # SPDX-License-Identifier: LGPL-2.0-or-later
 
-&DEPFILES += $(foreach b,$(patsubst %.o,%,$(&OBJECTS)), \
+&# Usage:
+&#   &:include subdirmk/cdeps.sd.mk
+&# (probably in Perdir.sd.mk)
+&#
+&# Arranges for automatic #include dependency tracking for
+&# C compilation.  The compiler is asked to write the dependencies to
+&#  .*.d and these are automatically included.
+&#
+&# There is a bug: if a #included file is deleted and all references
+&# in .c files to it removed, `make' will complain that it is needed
+&# and can't be built.  `make clean' will fix this.
+
+CDEPS_CFLAGS ?= -MD -MF $(*D)/.$(*F).d
+
+&CDEPS_OBJECTS += $(&OBJECTS)
+
+&DEPFILES += $(foreach b,$(patsubst %.o,%,$(&CDEPS_OBJECTS)), \
                $(dir $b).$(notdir $b).d)
 -include $(&DEPFILES)
 
+&CLEAN += $(&DEPFILES)