mirror/autoconf
2
0
Fork 0
mirror of git://git.sv.gnu.org/autoconf synced 2024-11-21 01:01:48 +08:00
Code Issues Packages Projects Releases Wiki Activity
e2e36c55ce
autoconf/man/autoconf.1

104 lines
2.4 KiB
Groff
Raw Normal View History

* autoconf.sh (M4): Handle PC drive letters. * autoupdate.sh: Likewise.
2001-01-11 22:18:48 +08:00
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24.
* Makefile.am (editpl, editsh): Merge into... (edit). * m4sh.m4 (AS_UNAME): Eved out from... * acgeneral.m4 (_AC_INIT_DEFAULTS): here. (_AC_INIT_PACKAGE): Define AC_PACKAGE_NAME. (_AC_INIT_PARSE_ARGS): AC_SUBST the PACKAGE_ variables. Propagate their use in the executables and the test suite. * tests/atgeneral.m4 (PATH): Include only absolute paths. (AT_INIT): Use AS_UNAME.
2001-01-16 18:25:57 +08:00
.TH AUTOCONF "1" "January 2001" "autoconf (@PACKAGE_NAME@) 2.49c" FSF
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
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.
* autoconf.sh: Don't show obsolete options on "--help". Report obsolete options to stderr. Adjust list of options. Correct processing of options. Process options with values separated by "=" first, so that abbreviations work. Don't accept "=" with short options. * autoheader.sh: Likewise. * autoreconf.sh: Likewise. * autoupdate.sh: Likewise. * ifnames.sh: There is no "--verbose" option. * doc/autoconf.texi: Option "-A" requires an argument. (autoreconf Invocation): Document "--install", "--symlink", "--m4dir" and the options passed to Automake.
2000-10-27 06:27:48 +08:00
.SS "Library directories:"
.TP
\fB\-A\fR, \fB\-\-autoconf\-dir\fR=\fIACDIR\fR
Autoconf's macro files location (rarely needed)
.TP
\fB\-l\fR, \fB\-\-localdir\fR=\fIDIR\fR
location of the `aclocal.m4' file
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
Written by David J. MacKenzie.
* 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
Copyright 1992, 1993, 1994, 1996, 1999, 2000
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.
Reference in New Issue Copy Permalink