summaryrefslogtreecommitdiffstats
path: root/man/autoconf.1
blob: 11bfc1eab932050113f4ea748b04668d4ca3607a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH AUTOCONF "1" "June 2024" "GNU Autoconf 2.52.20240618" "User Commands"
.SH NAME
autoconf \- Generate configuration scripts
.SH SYNOPSIS
.B autoconf
[\fI\,OPTION\/\fR] ... [\fI\,TEMPLATE-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\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
save output in FILE (stdout is the default)
.TP
\fB\-W\fR, \fB\-\-warnings\fR=\fI\,CATEGORY\/\fR
report the warnings falling in CATEGORY [syntax]
.SH OPTIONS
.TP
\fB\-\-opt\-functions\fR
use shell\-functions to reduce repetition
.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 "Library directories:"
.TP
\fB\-A\fR, \fB\-\-autoconf\-dir\fR=\fI\,ACDIR\/\fR
Autoconf's macro files location (rarely needed)
.TP
\fB\-l\fR, \fB\-\-localdir\fR=\fI\,DIR\/\fR
location of the `aclocal.m4' file
.SS "Tracing:"
.TP
\fB\-t\fR, \fB\-\-trace\fR=\fI\,MACRO\/\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.
.SH "REPORTING BUGS"
Report bugs to <dickey@invisible\-island.net>.
.SH COPYRIGHT
Copyright 2003\-2022,2023        Thomas E. Dickey
.br
Copyright 1992, 1993, 1994, 1996, 1999, 2000, 2001
Free Software Foundation, Inc.
.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 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.