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
b7d564360d
autoconf/man/autoconf.1

99 lines
2.3 KiB
Groff
Raw Normal View History

* aclang.m4 (AC_LANG_PROGRAM(Fortran 77): Complain about $1 having a value. Reported by Paul Martinolich. (_AC_LANG_COMPILER_GNU): Pass the test as the body of AC_LANG_PROGRAM, not the prologue.
2000-11-09 01:46:24 +08:00
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.23.
* m4sugar.m4 (m4_dquote, m4_pattern_forbid, m4_pattern_allow) (m4_cr_letters, m4_cr_LETTERS, m4_cr_Letters, m4_cr_digits) (m4_cr_symbols1, m4_cr_symbols2, m4_re_string, m4_re_word) (m4_init): New macros. (m4_token_allow): Remove. * acgeneral.m4: Don't push BODY into the diversion stack. (AC_PLAIN_SCRIPT): Do it. Call m4_init, define the Autoconf patterns. (AC_INIT): Use AC_PLAIN_SCRIPT. Remove the useless `dnl' (those where the current diversion is KILL). * autoconf.sh (m4_common): Fix quotation. (finalize.awk): Load forbidden.rx and allowed.rx. Split the line into tokens, and check their validity. * tests/tools.at (Forbidden tokens): Adjust.
2000-12-06 16:58:13 +08:00
.TH AUTOCONF "1" "December 2000" "GNU autoconf 2.49b" 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
`configure.in' by default. 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),
.BR autoreconf (1),
.BR autoupdate (1),
.BR autoheader (1),
.BR autoscan (1),
.BR ifnames (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.
Reference in New Issue Copy Permalink