Show how to extract single substitutions from config.status.

* doc/autoconf.texi (config.status Invocation): Show example
using `--file=-'.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>

diff --git a/ChangeLog b/ChangeLog
index 79100bc2219484ff998e1daa29e4acade4f74c6a..f2c336eacb278613f5acfd23b27b3a84fcc58cdc 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2008-10-18  Ralf Wildenhues  <Ralf.Wildenhues@gmx.de>
+
+       Show how to extract single substitutions from config.status.
+       * doc/autoconf.texi (config.status Invocation): Show example
+       using `--file=-'.
+
 2008-10-17  Eric Blake  <ebb9@byu.net>
 
        Add m4_curry.

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 3078869a33691d67805fc90ed573841e756e4958..a6bcb34124faaa9b997b9dd3b68fcf8c672280ce 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -19100,7 +19100,14 @@ Doing so can be useful if some of the packages need a superset of the
 features that one of them, perhaps a common library, does.  These
 options allow a @file{config.status} file to create files other than the
 ones that its @file{configure.ac} specifies, so it can be used for a
-different package.
+different package, or for extracting a subset of values.  For example,
+
+@example
+echo '@@CC@@' | ./config.status --file=-
+@end example
+
+@noindent
+provides the value of @code{@@CC@@} on standard output.
 
 @item --header=@var{file}[:@var{template}]
 Same as @option{--file} above, but with @samp{AC_CONFIG_HEADERS}.