* automake.texi (Dist): Updated to mention caveat of putting

	directory in EXTRA_DIST and also providing a nice example of
	removing the CVS dir.
	From Ganesan Rajagopal.

diff --git a/ChangeLog b/ChangeLog
index 1355eb2..7c9aafe 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2001-02-03  Tom Tromey  <tromey@redhat.com>
 
+       * automake.texi (Dist): Updated to mention caveat of putting
+       directory in EXTRA_DIST and also providing a nice example of
+       removing the CVS dir.
+       From Ganesan Rajagopal.
+
        * m4/depend.m4 (depcpp): Run tests in a subdir.  Fixes report from
        Bob Proulx.
 

diff --git a/automake.texi b/automake.texi
index f87928c..db2e413 100644 (file)
--- a/automake.texi
+++ b/automake.texi
@@ -2981,7 +2981,10 @@ are not covered in the automatic rules.  These files should be listed in
 the @code{EXTRA_DIST} variable.  You can mention files from
 subdirectories in @code{EXTRA_DIST}.  You can also mention a directory
 there; in this case the entire directory will be recursively copied into
-the distribution.
+the distribution.  Please note that this will also copy
+@emph{everything} in the directory, including CVS/RCS version control
+files.
+
 @vindex EXTRA_DIST
 
 Sometimes you need tighter control over what does @emph{not} go into the
@@ -3004,6 +3007,16 @@ bin_PROGRAMS = foo
 nodist_foo_SOURCES = do-not-distribute.c
 @end example
 
+Another way to to use this is for removing unnecessary files that get
+recursively included by specifying a directory in EXTRA_DIST:
+
+@example
+EXTRA_DIST = doc
+
+dist-hook:
+       rm -rf `find $(distdir)/doc -name CVS`
+@end example
+
 If you define @code{SUBDIRS}, Automake will recursively include the
 subdirectories in the distribution.  If @code{SUBDIRS} is defined
 conditionally (@pxref{Conditionals}), Automake will normally include all