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>

2 files changed, 14 insertions, 1 deletions

diff --git a/ChangeLog b/ChangeLog
index 79100bc2..f2c336ea 100644
--- 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 3078869a..a6bcb341 100644
--- 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}.