Improve and clarify `config.status' usage documentation.

* doc/autoconf.texi (config.status Invocation): Fix markup in
synopsis.  Use `tag' instead of `file' notation for the
non-option arguments, to be consistent with the documentation
of the AC_CONFIG_* macros.
* lib/autoconf/status.m4 (_AC_OUTPUT_CONFIG_STATUS): Likewise,
use `tag' notation for non-option arguments.
Report by John Calcote.

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

diff --git a/ChangeLog b/ChangeLog
index b7dd8f64101cba06363e6b0bd6f35aeb866e9615..587b873238ce018a35dba47bee5a74ecc85e9502 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2009-04-19  Ralf Wildenhues  <Ralf.Wildenhues@gmx.de>
+
+       Improve and clarify `config.status' usage documentation.
+       * doc/autoconf.texi (config.status Invocation): Fix markup in
+       synopsis.  Use `tag' instead of `file' notation for the
+       non-option arguments, to be consistent with the documentation
+       of the AC_CONFIG_* macros.
+       * lib/autoconf/status.m4 (_AC_OUTPUT_CONFIG_STATUS): Likewise,
+       use `tag' notation for non-option arguments.
+       Report by John Calcote.
+
 2009-04-15  Eric Blake  <ebb9@byu.net>
 
        Test that autotest handles binary output.

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index e565dbf93980821f4370e32875bf1b2a8485fe80..b0e758efd536c87f15df4f7a9e5359af5b5ec49f 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -20047,12 +20047,14 @@ package was last configured in case reconfiguring is needed.
 
 Synopsis:
 @example
-./config.status @var{option}@dots{} [@var{file}@dots{}]
+./config.status @ovar{option}@dots{} @ovar{tag}@dots{}
 @end example
 
-It configures the @var{files}; if none are specified, all the templates
-are instantiated.  The files must be specified without their
-dependencies, as in
+It configures each @var{tag}; if none are specified, all the templates
+are instantiated.  A @var{tag} refers to a file or other tag associated
+with a configuration action, as specified by a @code{AC_CONFIG_FOOS}
+macro (@pxref{Configuration Actions}).  The files must be specified
+without their dependencies, as in
 
 @example
 ./config.status foobar

diff --git a/lib/autoconf/status.m4 b/lib/autoconf/status.m4
index 72e6893cc7e40accd52ef3c052705effc6780b1d..a8ab3e24551a31a5fc3376c07f78080590066234 100644 (file)
--- a/lib/autoconf/status.m4
+++ b/lib/autoconf/status.m4
@@ -1395,10 +1395,11 @@ _ACEOF
 
 cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
 ac_cs_usage="\
-\`$as_me' instantiates files from templates according to the
-current configuration.
+\`$as_me' instantiates files and other configuration actions
+from templates according to the current configuration.  Unless the files
+and actions are specified as TAGs, all are instantiated by default.
 
-Usage: $[0] [[OPTION]]... [[FILE]]...
+Usage: $[0] [[OPTION]]... [[TAG]]...
 
   -h, --help       print this help, then exit
   -V, --version    print version number and configuration settings, then exit