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 <akim@epita.fr>
+
+ 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 <akim@epita.fr>
* README: Updated.
# 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
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
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
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
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
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.
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.
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
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
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
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.
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.
# 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
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