From: Akim Demaille Date: Wed, 9 Feb 2000 18:19:58 +0000 (+0000) Subject: Resynchronize `INSTALL' with the current `configure', and X-Git-Tag: autoconf-2.50~1172 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c60a188814192a7229f1dc7203bb1339119eedc8;p=thirdparty%2Fautoconf.git Resynchronize `INSTALL' with the current `configure', and conversely... * acgeneral.m4 (AC_INIT_PARSE_ARGS): Let `configure' support `-h = --help' and `-n = --no-create'. Document -h, -n and -q in configure's help message. * install.texi (Operation Controls): Formatting changes. Document `configure -h'. --- diff --git a/ChangeLog b/ChangeLog index 34c9d9e2b..d22d1d3f3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2000-02-09 Akim Demaille + + Resynchronize `INSTALL' with the current `configure', and + conversely... + + * acgeneral.m4 (AC_INIT_PARSE_ARGS): Let `configure' support `-h = + --help' and `-n = --no-create'. + Document -h, -n and -q in configure's help message. + * install.texi (Operation Controls): Formatting changes. + Document `configure -h'. + 2000-02-09 Akim Demaille * README: Updated. diff --git a/acgeneral.m4 b/acgeneral.m4 index 3b4f18419..7b812803a 100644 --- a/acgeneral.m4 +++ b/acgeneral.m4 @@ -700,7 +700,7 @@ changequote([, ])dnl # Obsolete; use --with-gas. with_gas=yes ;; - -help | --help | --hel | --he) + -help | --help | --hel | --he | -h) # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. changequote(, )dnl @@ -716,11 +716,11 @@ CFLAGS...), give to `configure' the definition as VAR=VALUE. Defaults for the options are specified in brackets. Configuration: - --cache-file=FILE cache test results in FILE - --help print this message - --no-create do not create output files - --quiet, --silent do not print \`checking...' messages - --version print the version of autoconf that created configure + -h, --help print this message + --version print the version of autoconf that created configure + -q, --quiet, --silent do not print \`checking...' messages + --cache-file=FILE cache test results in FILE + -n, --no-create do not create output files Directories: --prefix=PREFIX install architecture-independent files in PREFIX diff --git a/doc/install.texi b/doc/install.texi index 7b7119ecb..c2764a769 100644 --- a/doc/install.texi +++ b/doc/install.texi @@ -92,7 +92,7 @@ and run the @code{configure} script. @code{configure} automatically checks for the source code in the directory that @code{configure} is in and in @file{..}. -If you have to use a @code{make} that does not supports the @code{VPATH} +If you have to use a @code{make} that does not support the @code{VPATH} variable, you have to compile the package for one architecture at a time in the source code directory. After you have installed the package for one architecture, use @samp{make distclean} before reconfiguring for @@ -156,9 +156,9 @@ If @file{config.sub} isn't included in this package, then this package doesn't need to know the host type. If you are building compiler tools for cross-compiling, you can also use -the @samp{--target=@var{type}} option to select the type of system -they will produce code for and the @samp{--build=@var{type}} option -to select the type of system on which you are compiling the package. +the @samp{--target=@var{type}} option to select the type of system they +will produce code for and the @samp{--build=@var{type}} option to select +the type of system on which you are compiling the package. @node Sharing Defaults @section Sharing Defaults @@ -168,9 +168,10 @@ you can create a site shell script called @file{config.site} that gives default values for variables like @code{CC}, @code{cache_file}, and @code{prefix}. @code{configure} looks for @file{@var{prefix}/share/config.site} if it exists, then -@file{@var{prefix}/etc/config.site} if it exists. Or, you can set -the @code{CONFIG_SITE} environment variable to the location of the site -script. A warning: not all @code{configure} scripts look for a site script. +@file{@var{prefix}/etc/config.site} if it exists. Or, you can set the +@code{CONFIG_SITE} environment variable to the location of the site +script. A warning: not all @code{configure} scripts look for a site +script. @node Environment Variables @section Environment Variables @@ -181,20 +182,29 @@ configure again during the build, and the customized values of these variables may be lost. In order to avoid this problem, you should set them in the @code{configure} command line, using @samp{VAR=value}. For example: + @example ./configure CC=/usr/local2/bin/gcc @end example + +@noindent will cause the specified gcc to be used as the C compiler (unless it is overridden in the site shell script). Please, note that the former interface: + @example CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure @end example + +@noindent or + @example env CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure @end example + +@noindent should be avoided. @@ -205,29 +215,32 @@ should be avoided. operates. @table @code +@item --help +@itemx -h +Print a summary of the options to @code{configure}, and exit. + +@item --version +Print the version of Autoconf used to generate the @code{configure} +script, and exit. + @item --cache-file=@var{file} +@cindex Cache, disabling Use and save the results of the tests in @var{file} instead of @file{./config.cache}. Set @var{file} to @file{/dev/null} to disable caching, for debugging @code{configure}. -@item --help -Print a summary of the options to @code{configure}, and exit. - @item --quiet @itemx --silent @itemx -q -Do not print messages saying which checks are being made. -To suppress all normal output, redirect it to @file{/dev/null} -(any error messages will still be shown). +Do not print messages saying which checks are being made. To suppress +all normal output, redirect it to @file{/dev/null} (any error messages +will still be shown). @item --srcdir=@var{dir} Look for the package's source code in directory @var{dir}. Usually @code{configure} can determine that directory automatically. - -@item --version -Print the version of Autoconf used to generate the @code{configure} -script, and exit. @end table @noindent @code{configure} also accepts some other, not widely useful, options. +Run @samp{configure --help} for more details. diff --git a/install.texi b/install.texi index 7b7119ecb..c2764a769 100644 --- a/install.texi +++ b/install.texi @@ -92,7 +92,7 @@ and run the @code{configure} script. @code{configure} automatically checks for the source code in the directory that @code{configure} is in and in @file{..}. -If you have to use a @code{make} that does not supports the @code{VPATH} +If you have to use a @code{make} that does not support the @code{VPATH} variable, you have to compile the package for one architecture at a time in the source code directory. After you have installed the package for one architecture, use @samp{make distclean} before reconfiguring for @@ -156,9 +156,9 @@ If @file{config.sub} isn't included in this package, then this package doesn't need to know the host type. If you are building compiler tools for cross-compiling, you can also use -the @samp{--target=@var{type}} option to select the type of system -they will produce code for and the @samp{--build=@var{type}} option -to select the type of system on which you are compiling the package. +the @samp{--target=@var{type}} option to select the type of system they +will produce code for and the @samp{--build=@var{type}} option to select +the type of system on which you are compiling the package. @node Sharing Defaults @section Sharing Defaults @@ -168,9 +168,10 @@ you can create a site shell script called @file{config.site} that gives default values for variables like @code{CC}, @code{cache_file}, and @code{prefix}. @code{configure} looks for @file{@var{prefix}/share/config.site} if it exists, then -@file{@var{prefix}/etc/config.site} if it exists. Or, you can set -the @code{CONFIG_SITE} environment variable to the location of the site -script. A warning: not all @code{configure} scripts look for a site script. +@file{@var{prefix}/etc/config.site} if it exists. Or, you can set the +@code{CONFIG_SITE} environment variable to the location of the site +script. A warning: not all @code{configure} scripts look for a site +script. @node Environment Variables @section Environment Variables @@ -181,20 +182,29 @@ configure again during the build, and the customized values of these variables may be lost. In order to avoid this problem, you should set them in the @code{configure} command line, using @samp{VAR=value}. For example: + @example ./configure CC=/usr/local2/bin/gcc @end example + +@noindent will cause the specified gcc to be used as the C compiler (unless it is overridden in the site shell script). Please, note that the former interface: + @example CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure @end example + +@noindent or + @example env CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure @end example + +@noindent should be avoided. @@ -205,29 +215,32 @@ should be avoided. operates. @table @code +@item --help +@itemx -h +Print a summary of the options to @code{configure}, and exit. + +@item --version +Print the version of Autoconf used to generate the @code{configure} +script, and exit. + @item --cache-file=@var{file} +@cindex Cache, disabling Use and save the results of the tests in @var{file} instead of @file{./config.cache}. Set @var{file} to @file{/dev/null} to disable caching, for debugging @code{configure}. -@item --help -Print a summary of the options to @code{configure}, and exit. - @item --quiet @itemx --silent @itemx -q -Do not print messages saying which checks are being made. -To suppress all normal output, redirect it to @file{/dev/null} -(any error messages will still be shown). +Do not print messages saying which checks are being made. To suppress +all normal output, redirect it to @file{/dev/null} (any error messages +will still be shown). @item --srcdir=@var{dir} Look for the package's source code in directory @var{dir}. Usually @code{configure} can determine that directory automatically. - -@item --version -Print the version of Autoconf used to generate the @code{configure} -script, and exit. @end table @noindent @code{configure} also accepts some other, not widely useful, options. +Run @samp{configure --help} for more details. diff --git a/lib/autoconf/general.m4 b/lib/autoconf/general.m4 index 3b4f18419..7b812803a 100644 --- a/lib/autoconf/general.m4 +++ b/lib/autoconf/general.m4 @@ -700,7 +700,7 @@ changequote([, ])dnl # Obsolete; use --with-gas. with_gas=yes ;; - -help | --help | --hel | --he) + -help | --help | --hel | --he | -h) # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. changequote(, )dnl @@ -716,11 +716,11 @@ CFLAGS...), give to `configure' the definition as VAR=VALUE. Defaults for the options are specified in brackets. Configuration: - --cache-file=FILE cache test results in FILE - --help print this message - --no-create do not create output files - --quiet, --silent do not print \`checking...' messages - --version print the version of autoconf that created configure + -h, --help print this message + --version print the version of autoconf that created configure + -q, --quiet, --silent do not print \`checking...' messages + --cache-file=FILE cache test results in FILE + -n, --no-create do not create output files Directories: --prefix=PREFIX install architecture-independent files in PREFIX