X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ian/git?p=subdirmk.git;a=blobdiff_plain;f=subdirmk%2Fclean.sd.mk;h=08f8dcc61e5cd584618e97a8d81b696f0dfd50ca;hp=accb2f5b3ad41b91cf4d55434d18f1d51c3e4efb;hb=41682cf1c6108dce44a3e7a57eaacec0c0b058bd;hpb=7e1f352747ae8256f549becda8df9c9447ef1d5e

diff --git a/subdirmk/clean.sd.mk b/subdirmk/clean.sd.mk
index accb2f5..08f8dcc 100644
--- a/subdirmk/clean.sd.mk
+++ b/subdirmk/clean.sd.mk
@@ -1,9 +1,25 @@
+# subdirmk - useful rules for clean target
+#  Copyright 2019 Mark Wooding
+#  Copyright 2019 Ian Jackson
+# SPDX-License-Identifier: LGPL-2.0-or-later
+
+&# Usage:
+&#   &:include subdirmk/clean.sd.mk
+&# (probably in Perdir.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
 
-&/clean:
+&/clean::
 	$(RM) $(&CLEAN)