From: Ralf Wildenhues Date: Sat, 18 Apr 2009 23:12:43 +0000 (+0200) Subject: Improve and clarify `config.status' usage documentation. X-Git-Tag: v2.64~77 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e7c7a4735fcc714ac9607fa680c72cbe6fd868bc;p=thirdparty%2Fautoconf.git 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 --- diff --git a/ChangeLog b/ChangeLog index b7dd8f641..587b87323 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2009-04-19 Ralf Wildenhues + + 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 Test that autotest handles binary output. diff --git a/doc/autoconf.texi b/doc/autoconf.texi index e565dbf93..b0e758efd 100644 --- 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 72e6893cc..a8ab3e245 100644 --- 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