Documentation for clean.sd.mk and cdeps.sd.mk

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

diff --git a/subdirmk/clean.sd.mk b/subdirmk/clean.sd.mk
index e235fcd8e251bbf8a45b9ac073b3e1415ccd0b91..08f8dcc61e5cd584618e97a8d81b696f0dfd50ca 100644 (file)
--- a/subdirmk/clean.sd.mk
+++ b/subdirmk/clean.sd.mk
@@ -3,6 +3,18 @@
 #  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 += $(&TARGETS)