* doc/automake.texi (Scripts): Update the example about automake.
authorAlexandre Duret-Lutz <adl@gnu.org>
Fri, 26 Sep 2003 17:35:08 +0000 (17:35 +0000)
committerAlexandre Duret-Lutz <adl@gnu.org>
Fri, 26 Sep 2003 17:35:08 +0000 (17:35 +0000)
Mention `dist_' for distributed scripts.

ChangeLog
doc/automake.texi
doc/stamp-vti
doc/version.texi

index 0fdcf2a..3a6cfaf 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2003-09-26  Alexandre Duret-Lutz  <adl@gnu.org>
 
+       * doc/automake.texi (Scripts): Update the example about automake.
+       Mention `dist_' for distributed scripts.
+
        * lib/mkinstalldirs: Clean up after NextStep and OpenStep mkdir.
        Suggested by Eric Sunshine.
 
index 785acba..33038f1 100644 (file)
@@ -3961,16 +3961,34 @@ should include the appropriate rules.
 Automake does not assume that scripts are derived objects; such objects
 must be deleted by hand (@pxref{Clean}).
 
-The @code{automake} program itself is a Perl script that is generated at
-configure time from @file{automake.in}.  Here is how this is handled:
+The @code{automake} program itself is a Perl script that is generated
+from @file{automake.in}.  Here is how this is handled:
 
 @example
 bin_SCRIPTS = automake
+CLEANFILES = $(bin_SCRIPTS)
+
+do_subst = sed -e 's,[@@]datadir[@@],$(datadir),g' \
+            -e 's,[@@]PERL[@@],$(PERL),g' \
+            -e 's,[@@]PACKAGE[@@],$(PACKAGE),g' \
+            -e 's,[@@]VERSION[@@],$(VERSION),g' \
+            @dots{}
+
+automake: automake.in Makefile
+        $(do_subst) < $(srcdir)/automake.in > automake
+        chmod +x automake
 @end example
 
-Since @code{automake} appears in the @code{AC_OUTPUT} macro, a target
-for it is automatically generated, and it is also automatically cleaned
-(despite the fact it's a script).
+Because---as we have just seen---scripts can be built, they are not
+distributed by default.  Scripts that should be distributed can be
+specified using a @code{dist_} prefix as in other primaries.  For
+instance the following @file{Makefile.am} declares that
+@file{my_script} should be distributed and installed in
+@code{$(sbindir)}.
+
+@example
+dist_sbin_SCRIPTS = my_script
+@end example
 
 @cindex SCRIPTS, installation directories
 @cindex Installing scripts
index 7f9e704..e8c195b 100644 (file)
@@ -1,4 +1,4 @@
-@set UPDATED 24 September 2003
+@set UPDATED 26 September 2003
 @set UPDATED-MONTH September 2003
 @set EDITION 1.7a
 @set VERSION 1.7a
index 7f9e704..e8c195b 100644 (file)
@@ -1,4 +1,4 @@
-@set UPDATED 24 September 2003
+@set UPDATED 26 September 2003
 @set UPDATED-MONTH September 2003
 @set EDITION 1.7a
 @set VERSION 1.7a