subdirmk: Merge new version and fix everything

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

diff --git a/subdirmk/clean.sd.mk b/subdirmk/clean.sd.mk
index 017de63b01b111cc7b95a02471ac7a3569e2a304..a38fb221e2a09ee45672c3e313483613c92f7aec 100644 (file)
--- a/subdirmk/clean.sd.mk
+++ b/subdirmk/clean.sd.mk
@@ -1,9 +1,26 @@
-&CLEAN += & *~ *.tmp
+# subdirmk - useful rules for clean target
+#  Copyright 2019 Mark Wooding
+#  Copyright 2019 Ian Jackson
+# SPDX-License-Identifier: LGPL-2.0-or-later
+# There is NO WARRANTY.
+
+&# Usage:
+&#   &:include subdirmk/clean.sd.mk
+&# (probably in Suffix.sd.mk)
+&#
+&# Provides a per-directory `clean' target, which deletes all the files
+&# in &CLEAN.  &OBJECTS, &DEPFILES and &TARGETS are automatically deleted.
+&#
+&# If you want to delete a directory, extend the target with
+&#   &/clean::
+&#     $(RM) -r somethingn
+&# ($(RM) conventionally contains `-f'.)
+
+&CLEAN += & *~ .*~ *.tmp
 &CLEAN += $(&OBJECTS)
-&CLEAN += $(&DEPFILES)
 &CLEAN += $(&TARGETS)
 
-# &TARGETS_clean
+&TARGETS_clean +=
 
 &/clean::
        $(RM) $(&CLEAN)