* doc/automake.texi (Clean): Document -local targets.

diff --git a/ChangeLog b/ChangeLog
index eeabaa8..6d29a1c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2004-09-25  Alexandre Duret-Lutz  <adl@gnu.org>
+
+       * doc/automake.texi (Clean): Document -local targets.
+
 2004-09-25  Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
 
        * doc/automake.texi: Typos.

diff --git a/doc/automake.texi b/doc/automake.texi
index 5862ee8..3390f08 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -5543,9 +5543,26 @@ be defined to specify additional files to clean.  These variables are
 @vindex DISTCLEANFILES
 @vindex MAINTAINERCLEANFILES
 
-As the GNU Standards aren't always explicit as to which files should be
-removed by which rule, we've adopted a heuristic which we believe was
-first formulated by Fran@,{c}ois Pinard:
+@trindex mostlyclean-local
+@trindex clean-local
+@trindex distclean-local
+@trindex maintainerclean-local
+When cleaning involves more than deleting some hard-coded list of
+files, it is also possible to supplement the cleaning rules with your
+own commands.  Simply define a rule for any of the
+@code{mostlyclean-local}, @code{clean-local}, @code{distclean-local},
+or @code{maintainerclean-local} targets (@pxref{Extending}).  A common
+case is deleting a directory, for instance a directory created by the
+test suite:
+
+@example
+clean-local:
+        -rm -rf testSubDir
+@end example
+
+As the GNU Standards aren't always explicit as to which files should
+be removed by which rule, we've adopted a heuristic which we believe
+was first formulated by Fran@,{c}ois Pinard:
 
 @itemize @bullet
 @item