autoconf/man/autoconf.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.25.
.TH AUTOCONF "1" "February 2002" "autoconf 2.52i" "User Commands"
.SH NAME
autoconf \- Generate configuration scripts
.SH SYNOPSIS
.B autoconf
[\fIOPTION\fR] ... [\fITEMPLATE-FILE\fR]
.SH DESCRIPTION
Generate a configuration script from a TEMPLATE-FILE if given, or
`configure.ac' if present, or else `configure.in'.  Output is sent
to the standard output if TEMPLATE-FILE is given, else into
`configure'.
.SS "Operation modes:"
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help, then exit
.TP
\fB\-V\fR, \fB\-\-version\fR
print version number, then exit
.TP
\fB\-v\fR, \fB\-\-verbose\fR
verbosely report processing
.TP
\fB\-d\fR, \fB\-\-debug\fR
don't remove temporary files
.TP
\fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR
look for input files in DIR (cumulative)
.TP
\fB\-f\fR, \fB\-\-force\fR
consider all files obsolete
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
save output in FILE (stdout is the default)
.TP
\fB\-W\fR, \fB\-\-warnings\fR=\fICATEGORY\fR
report the warnings falling in CATEGORY [syntax]
.SS "Warning categories include:"
.TP
`cross'
cross compilation issues
.TP
`obsolete'
obsolete constructs
.TP
`syntax'
dubious syntactic constructs
.TP
`all'
all the warnings
.TP
`no-CATEGORY'
turn off the warnings on CATEGORY
.TP
`none'
turn off all the warnings
.TP
`error'
warnings are error
.PP
The environment variable `WARNINGS' is honored.
.SS "Tracing:"
.TP
\fB\-t\fR, \fB\-\-trace\fR=\fIMACRO\fR
report the list of calls to MACRO
.TP
\fB\-i\fR, \fB\-\-initialization\fR
also trace Autoconf's initialization process
.PP
In tracing mode, no configuration script is created.
.SH AUTHOR
Written by David J. MacKenzie and Akim Demaille.
.PP
Copyright 1992, 1993, 1994, 1996, 1999, 2000, 2001
Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH "REPORTING BUGS"
Report bugs to <bug-autoconf@gnu.org>.
.SH "SEE ALSO"
.BR autoconf (1),
.BR automake (1),
.BR autoreconf (1),
.BR autoupdate (1),
.BR autoheader (1),
.BR autoscan (1),
.BR config.guess (1),
.BR config.sub (1),
.BR ifnames (1),
.BR libtool (1).
.PP
The full documentation for
.B autoconf
is maintained as a Texinfo manual.  If the
.B info
and
.B autoconf
programs are properly installed at your site, the command
.IP
.B info autoconf
.PP
should give you access to the complete manual.
* bin/autoheader.in, bin/autoconf.in, bin/autoscan.in, * doc/autoconf.texi: Finally add Akim as an author. 2002-01-25 02:41:16 +08:00			`.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.25.`
Version 2.52h. 2002-02-11 22:04:54 +08:00			`.TH AUTOCONF "1" "February 2002" "autoconf 2.52i" "User Commands"`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`.SH NAME`
			`autoconf \- Generate configuration scripts`
			`.SH SYNOPSIS`
			`.B autoconf`
			`[\fIOPTION\fR] ... [\fITEMPLATE-FILE\fR]`
			`.SH DESCRIPTION`
			`Generate a configuration script from a TEMPLATE-FILE if given, or`
* autoconf.sh: Promote `configure.ac' over `configure.in'. * autoreconf.sh: Likewise. * autoheader.sh: Ditto. * autoupdate.sh: Similarly. * doc/autoconf.texi: Adjust. * tests/atspecific.m4: Be sure to remove configure.in. Adjust the test suite to use `configure.ac'. 2000-12-23 18:11:57 +08:00			`configure.ac' if present, or else `configure.in'. Output is sent
			`to the standard output if TEMPLATE-FILE is given, else into`
			`configure'.
Provide a fine grained control over autoconf's warnings. * acgeneral.m4 (AC_WARNING_IFELSE, _AC_DIAGNOSE, AC_DIAGNOSE): New macros. (AC_DEFUN_ONCE, AC_OBSOLETE, AC_BEFORE, AU_DEFUN, AC_PREREQ, AC_WARNING, AC_FATAL, AC_TRY_RUN): Use AC_DIAGNOSE. * autoconf.sh: Provide support for `--warnings', `-W'. * doc/autoconf.texi (Invoking autoconf): Adjust. (Reporting Messages): New section. 2000-04-13 16:25:11 +08:00			`.SS "Operation modes:"`
1999-11-01 Akim Demaille <akim@epita.fr> Be kind to Automake: list the arguments of selected macros (for instance AC_SUBST will list each variable which may be substitued). * autoconf.sh (--trace, --output): New options. Implement tracing of macros. trap also on 0, so that there is no need to rm here and there. * autoconf.texi (Output): Document --trace and --output. 2000-01-29 17:22:53 +08:00			`.TP`
			`\fB\-h\fR, \fB\-\-help\fR`
			`print this help, then exit`
			`.TP`
The whole family supports -V = --version. * acgeneral.m4 (AC_INIT_PARSE_ARGS): Report and support -V. * autoconf.sh: Likewise. * autoreconf.sh: Likewise. * autoupdate.sh: Likewise. * autoheader.sh: Likewise. * autoscan.pl: Likewise. * ifnames.sh: Likewise. In addition, don't dump --help on invalid options. * doc/autoconf.texi: Adjusted. * doc/install.texi: Likewise. 2000-03-03 02:17:26 +08:00			`\fB\-V\fR, \fB\-\-version\fR`
1999-11-01 Akim Demaille <akim@epita.fr> Be kind to Automake: list the arguments of selected macros (for instance AC_SUBST will list each variable which may be substitued). * autoconf.sh (--trace, --output): New options. Implement tracing of macros. trap also on 0, so that there is no need to rm here and there. * autoconf.texi (Output): Document --trace and --output. 2000-01-29 17:22:53 +08:00			`print version number, then exit`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`.TP`
Introduce AC_SUBST(VAR, VAL). * acgeneral.m4 (_AC_INIT_PARSE_ARGS): Stop global double quoting, failed experiment. Merge all the var=val AC_SUBST(var) into AC_SUBST(var, val). (AC_SUBST): Implement support for 2nd arg. * doc/autoconf.texi (Setting Output Variables): Adjust. 2000-03-14 16:09:32 +08:00			`\fB\-v\fR, \fB\-\-verbose\fR`
			`verbosely report processing`
			`.TP`
			`\fB\-d\fR, \fB\-\-debug\fR`
			`don't remove temporary files`
			`.TP`
* bin/autoconf.in (--include, -I): New option. Map --localdir, --autoconf-dir onto it. Forward autom4te's options instead of interpreting them. * bin/autoconf.in, bin/autoheader.in (AC_MACRODIR, autoconf_dir): There is no such envvar since the inception of autom4te.cfg. * bin/autom4te.in (&parse_args): Uniquify `@include'. * bin/autoupdate.in: Adjust, and perform more control. * tests/atspecific.m4 (AT_CHECK_AUTOCONF): Adjust. * tests/autoconf: Dittowise. 2001-08-31 21:31:54 +08:00			`\fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR`
* Makefile.maint (AUTOM4TE): Neutralize autom4te. Suggested by Jim Meyering. 2001-09-22 00:17:38 +08:00			`look for input files in DIR (cumulative)`
* bin/autoconf.in (--include, -I): New option. Map --localdir, --autoconf-dir onto it. Forward autom4te's options instead of interpreting them. * bin/autoconf.in, bin/autoheader.in (AC_MACRODIR, autoconf_dir): There is no such envvar since the inception of autom4te.cfg. * bin/autom4te.in (&parse_args): Uniquify `@include'. * bin/autoupdate.in: Adjust, and perform more control. * tests/atspecific.m4 (AT_CHECK_AUTOCONF): Adjust. * tests/autoconf: Dittowise. 2001-08-31 21:31:54 +08:00			`.TP`
* bin/autoconf.in, bin/autoheader.in: --force, -f is a new option. 2001-08-07 15:55:07 +08:00			`\fB\-f\fR, \fB\-\-force\fR`
* Makefile.maint (AUTOM4TE): Neutralize autom4te. Suggested by Jim Meyering. 2001-09-22 00:17:38 +08:00			`consider all files obsolete`
* bin/autoconf.in, bin/autoheader.in: --force, -f is a new option. 2001-08-07 15:55:07 +08:00			`.TP`
Provide a fine grained control over autoconf's warnings. * acgeneral.m4 (AC_WARNING_IFELSE, _AC_DIAGNOSE, AC_DIAGNOSE): New macros. (AC_DEFUN_ONCE, AC_OBSOLETE, AC_BEFORE, AU_DEFUN, AC_PREREQ, AC_WARNING, AC_FATAL, AC_TRY_RUN): Use AC_DIAGNOSE. * autoconf.sh: Provide support for `--warnings', `-W'. * doc/autoconf.texi (Invoking autoconf): Adjust. (Reporting Messages): New section. 2000-04-13 16:25:11 +08:00			`\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR`
			`save output in FILE (stdout is the default)`
			`.TP`
			`\fB\-W\fR, \fB\-\-warnings\fR=\fICATEGORY\fR`
Stop being ridiculous :( acgeneral.m4 (AC_SHELL_DIRNAME): When using m4 the argument is named `$1' not `$dir'. When using m4 you ought to quote properly. When using m4, you should check that there are not too many shell quotes (inside the macro itself, and where it is called). When you do this, Autoconf, hm, works better. 2000-07-10 18:52:04 +08:00			`report the warnings falling in CATEGORY [syntax]`
Provide a fine grained control over autoconf's warnings. * acgeneral.m4 (AC_WARNING_IFELSE, _AC_DIAGNOSE, AC_DIAGNOSE): New macros. (AC_DEFUN_ONCE, AC_OBSOLETE, AC_BEFORE, AU_DEFUN, AC_PREREQ, AC_WARNING, AC_FATAL, AC_TRY_RUN): Use AC_DIAGNOSE. * autoconf.sh: Provide support for `--warnings', `-W'. * doc/autoconf.texi (Invoking autoconf): Adjust. (Reporting Messages): New section. 2000-04-13 16:25:11 +08:00			`.SS "Warning categories include:"`
			`.TP`
			`cross'
			`cross compilation issues`
			`.TP`
			`obsolete'
Simplify the handling of `acconfig.h'. * autoheader.sh: No longer try to select the needed paragraphs of `acconfig.h', just dump everything into `config.h.in'. Implement support for `--warnings'. Warn the users that these auxiliary files are obsolete when `-W obsolete'. * doc/autoconf.texi (Invoking autoheader): Adjust. 2000-05-03 19:22:50 +08:00			`obsolete constructs`
Provide a fine grained control over autoconf's warnings. * acgeneral.m4 (AC_WARNING_IFELSE, _AC_DIAGNOSE, AC_DIAGNOSE): New macros. (AC_DEFUN_ONCE, AC_OBSOLETE, AC_BEFORE, AU_DEFUN, AC_PREREQ, AC_WARNING, AC_FATAL, AC_TRY_RUN): Use AC_DIAGNOSE. * autoconf.sh: Provide support for `--warnings', `-W'. * doc/autoconf.texi (Invoking autoconf): Adjust. (Reporting Messages): New section. 2000-04-13 16:25:11 +08:00			`.TP`
			`syntax'
			`dubious syntactic constructs`
			`.TP`
			`all'
			`all the warnings`
			`.TP`
* autoconf.sh (--warnings): Catch `no-category', not `nocategory'. * autoheader.sh: Likewise. * acgeneral.m4 (_AC_WARNING_IFELSE): Adjust. 2000-07-28 15:41:52 +08:00			`no-CATEGORY'
Stop being ridiculous :( acgeneral.m4 (AC_SHELL_DIRNAME): When using m4 the argument is named `$1' not `$dir'. When using m4 you ought to quote properly. When using m4, you should check that there are not too many shell quotes (inside the macro itself, and where it is called). When you do this, Autoconf, hm, works better. 2000-07-10 18:52:04 +08:00			`turn off the warnings on CATEGORY`
			`.TP`
			`none'
			`turn off all the warnings`
			`.TP`
Provide a fine grained control over autoconf's warnings. * acgeneral.m4 (AC_WARNING_IFELSE, _AC_DIAGNOSE, AC_DIAGNOSE): New macros. (AC_DEFUN_ONCE, AC_OBSOLETE, AC_BEFORE, AU_DEFUN, AC_PREREQ, AC_WARNING, AC_FATAL, AC_TRY_RUN): Use AC_DIAGNOSE. * autoconf.sh: Provide support for `--warnings', `-W'. * doc/autoconf.texi (Invoking autoconf): Adjust. (Reporting Messages): New section. 2000-04-13 16:25:11 +08:00			`error'
			`warnings are error`
Stop being ridiculous :( acgeneral.m4 (AC_SHELL_DIRNAME): When using m4 the argument is named `$1' not `$dir'. When using m4 you ought to quote properly. When using m4, you should check that there are not too many shell quotes (inside the macro itself, and where it is called). When you do this, Autoconf, hm, works better. 2000-07-10 18:52:04 +08:00			`.PP`
			The environment variable `WARNINGS' is honored.
Provide a fine grained control over autoconf's warnings. * acgeneral.m4 (AC_WARNING_IFELSE, _AC_DIAGNOSE, AC_DIAGNOSE): New macros. (AC_DEFUN_ONCE, AC_OBSOLETE, AC_BEFORE, AU_DEFUN, AC_PREREQ, AC_WARNING, AC_FATAL, AC_TRY_RUN): Use AC_DIAGNOSE. * autoconf.sh: Provide support for `--warnings', `-W'. * doc/autoconf.texi (Invoking autoconf): Adjust. (Reporting Messages): New section. 2000-04-13 16:25:11 +08:00			`.SS "Tracing:"`
			`.TP`
1999-11-01 Akim Demaille <akim@epita.fr> Be kind to Automake: list the arguments of selected macros (for instance AC_SUBST will list each variable which may be substitued). * autoconf.sh (--trace, --output): New options. Implement tracing of macros. trap also on 0, so that there is no need to rm here and there. * autoconf.texi (Output): Document --trace and --output. 2000-01-29 17:22:53 +08:00			`\fB\-t\fR, \fB\-\-trace\fR=\fIMACRO\fR`
			`report the list of calls to MACRO`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`.TP`
Introduce AC_SUBST(VAR, VAL). * acgeneral.m4 (_AC_INIT_PARSE_ARGS): Stop global double quoting, failed experiment. Merge all the var=val AC_SUBST(var) into AC_SUBST(var, val). (AC_SUBST): Implement support for 2nd arg. * doc/autoconf.texi (Setting Output Variables): Adjust. 2000-03-14 16:09:32 +08:00			`\fB\-i\fR, \fB\-\-initialization\fR`
			`also trace Autoconf's initialization process`
Provide a fine grained control over autoconf's warnings. * acgeneral.m4 (AC_WARNING_IFELSE, _AC_DIAGNOSE, AC_DIAGNOSE): New macros. (AC_DEFUN_ONCE, AC_OBSOLETE, AC_BEFORE, AU_DEFUN, AC_PREREQ, AC_WARNING, AC_FATAL, AC_TRY_RUN): Use AC_DIAGNOSE. * autoconf.sh: Provide support for `--warnings', `-W'. * doc/autoconf.texi (Invoking autoconf): Adjust. (Reporting Messages): New section. 2000-04-13 16:25:11 +08:00			`.PP`
			`In tracing mode, no configuration script is created.`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`.SH AUTHOR`
* bin/autoheader.in, bin/autoconf.in, bin/autoscan.in, * doc/autoconf.texi: Finally add Akim as an author. 2002-01-25 02:41:16 +08:00			`Written by David J. MacKenzie and Akim Demaille.`
* acgeneral.m4: Adjust copyright notice. * acspecific.m4: Likewise. * acoldnames.m4: Likewise. * acversion.m4.in: Likewise. * autoconf.sh: Likewise. * autoheader.sh: Likewise. * autoreconf.sh: Likewise. * autoscan.pl: Likewise. * autoupdate.sh: Likewise. * ifnames.sh: Likewise. 2000-10-17 02:25:55 +08:00			`.PP`
* configure.in: Bump to 2.49e. 2001-03-20 02:14:44 +08:00			`Copyright 1992, 1993, 1994, 1996, 1999, 2000, 2001`
* acgeneral.m4: Adjust copyright notice. * acspecific.m4: Likewise. * acoldnames.m4: Likewise. * acversion.m4.in: Likewise. * autoconf.sh: Likewise. * autoheader.sh: Likewise. * autoreconf.sh: Likewise. * autoscan.pl: Likewise. * autoupdate.sh: Likewise. * ifnames.sh: Likewise. 2000-10-17 02:25:55 +08:00			`Free Software Foundation, Inc.`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`This is free software; see the source for copying conditions. There is NO`
			`warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.`
* acgeneral.m4: Adjust copyright notice. * acspecific.m4: Likewise. * acoldnames.m4: Likewise. * acversion.m4.in: Likewise. * autoconf.sh: Likewise. * autoheader.sh: Likewise. * autoreconf.sh: Likewise. * autoscan.pl: Likewise. * autoupdate.sh: Likewise. * ifnames.sh: Likewise. 2000-10-17 02:25:55 +08:00			`.SH "REPORTING BUGS"`
			`Report bugs to <bug-autoconf@gnu.org>.`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`.SH "SEE ALSO"`
			`.BR autoconf (1),`
* man/config.guess.x: New file. * man/config.sub.x: New file. 2000-12-07 00:02:58 +08:00			`.BR automake (1),`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`.BR autoreconf (1),`
			`.BR autoupdate (1),`
			`.BR autoheader (1),`
			`.BR autoscan (1),`
* man/config.guess.x: New file. * man/config.sub.x: New file. 2000-12-07 00:02:58 +08:00			`.BR config.guess (1),`
			`.BR config.sub (1),`
			`.BR ifnames (1),`
			`.BR libtool (1).`
Added the man pages to the archive. 2000-01-27 17:41:25 +08:00			`.PP`
			`The full documentation for`
			`.B autoconf`
			`is maintained as a Texinfo manual. If the`
			`.B info`
			`and`
			`.B autoconf`
			`programs are properly installed at your site, the command`
			`.IP`
			`.B info autoconf`
			`.PP`
			`should give you access to the complete manual.`