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

98 lines
2.3 KiB
Groff
Raw Normal View History

* acgeneral.m4 (AC_DIRNAME): Use an `expr' solution instead of echo|sed. From Paul Eggert. * doc/autoconf.texi (Limitations of Usual Tools): Include the words from Paul about `|' with expr(1).
2000-07-10 16:53:58 +08:00
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.022.
.TH AUTOCONF "1" "July 2000" "GNU autoconf 2.14a" 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
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
\fB\-m\fR, \fB\-\-macrodir\fR=\fIDIR\fR
1999-11-10 Akim Demaille <akim@epita.fr> Make autoconf support --install. * autoconf.sh (task install): New task. Extract the set of auxiliary m4 files a configure.in depends upon. Install links from library files to the local dir so that the packages depends only on local extensions. Check that the user includes exactly the files she needs.
2000-01-29 17:54:27 +08:00
directory storing Autoconf's macro files
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.TP
\fB\-l\fR, \fB\-\-localdir\fR=\fIDIR\fR
directory storing the `aclocal.m4' file
.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
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
`noCATEGORY'
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
Written by David J. MacKenzie.
.SH "REPORTING BUGS"
Report bugs to <bug-autoconf@gnu.org>.
.SH COPYRIGHT
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
Copyright \(co 1992, 93, 94, 96, 99, 2000 Free Software Foundation, Inc.
Added the man pages to the archive.
2000-01-27 17:41:25 +08:00
.br
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 "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