Penguin
Recent Changes
Annotated edit history of autoconf(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 AUTOCONF
2 !!!AUTOCONF
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 SEE ALSO
7 AUTHORS
8 ----
9 !!NAME
10
11
12 autoconf - creates scripts to configure source code packages using templates
13 !!SYNOPSIS
14
15
16 __autoconf__ [[ __--help__ | __-h__ ] [[
17 __--version__ | __-V__ ] [[ __--verbose__ |
18 __-v__ ] [[ __--debug__ | __-d__ ] [[
19 __--autoconf-dir=__''dir'' | __-A__ ''dir'' ] [[
20 __--localdir=__''dir'' | __-l__ ''dir'' ] [[
21 __--output=__''file'' | __-o__ ''file'' ] [[
22 __--warnings=__''category'' | __-W__
23 ''category'' ] [[
24 __--trace=__''macro''[[__:__''format''] |
25 __-t__ ''macro''[[__:__''format''] ] [[
26 __--initialization__ | __-i__ ]
27 !!DESCRIPTION
28
29
30 To create __configure__ from __configure.in__, run the
31 __autoconf__ program with no arguments. __autoconf__
32 processes __configure.ac__ with the __m4__ macro
33 processor, using the Autoconf macros. If you give
34 __autoconf__ an argument, it reads that file instead of
35 __configure.ac__ and writes the configuration script to
36 the standard output instead of to __configure__. If you
37 give __autoconf__ the argument __-__, it reads the
38 standard input instead of __configure.ac__ and writes the
39 configuration script on the standard output.
40
41
42 The Autoconf macros are defined in several files. Some of
43 the files are distributed with Autoconf; __autoconf__
44 reads them first. Then it looks for the optional file
45 __acsite.m4__ in the directory that contains the
46 distributed Autoconf macro files, and for the optional file
47 __aclocal.m4__ in the current directory. Those files can
48 contain your site's or the package's own Autoconf macro
49 definitions. If a macro is defined in more than one of the
50 files that __autoconf__ reads, the last definition it
51 reads overrides the earlier ones.
52
53
54 __autoconf__ accepts the following options:
55
56
57 __--help__
58
59
60 __-h__
61
62
63 Print a summary of the command line options and
64 exit.
65
66
67 __--version__
68
69
70 __-V__
71
72
73 Print the version number of Autoconf and exit.
74
75
76 __--verbose__
77
78
79 __-v__
80
81
82 Report processing steps.
83
84
85 __--debug__
86
87
88 __-d__
89
90
91 Don't remove the temporary files.
92
93
94 __--autoconf-dir=__''dir''
95
96
97 __-A__ ''dir''
98
99
100 Look for the installed macro files in directory ''dir''.
101 You can also set the __AC_MACRODIR__ environment variable
102 to a directory; this option overrides the environment
103 variable.
104
105
106 __--localdir=__''dir''
107
108
109 __-l__ ''dir''
110
111
112 Look for the package file __aclocal.m4__ in directory
113 ''dir'' instead of in the current directory.
114
115
116 __--output=__''file''
117
118
119 __-o__ file
120
121
122 Save output (script or trace) to ''file''. The file
123 __-__ stands for the standard output.
124
125
126 __--warnings=__''category''
127
128
129 __-W__ ''category''
130
131
132 Report the warnings related to ''category'' (which can
133 actually be a comma separated list). Special values for
134 ''category'' include __all__ to report all warnings,
135 __none__ to report no warnings, and __error__ to treat
136 warnings as errors. See the Texinfo documentation for a list
137 of categories and additional information.
138
139
140 __--trace=__''macro''[[__:__''format'']
141
142
143 __-t__ ''macro''[[__:__''format'']
144
145
146 Do not create the __configure__ script, but list the
147 calls to ''macro'' according to the Iformat. Multiple
148 __--trace__ arguments can be used to list several macros.
149 Multiple __--trace__ arguments for a single macro are not
150 cumulative; instead, you should just make ''format'' as
151 long as needed.
152
153
154 The ''format'' is a regular string, with newlines if
155 desired, and several special escape codes. It defaults to
156 __$f:$l:$n:$%__; see the Texinfo documentation for
157 details.
158
159
160 __--initialization__
161
162
163 __-i__
164
165
166 By default, __--trace__ does not trace the initialization
167 of the Autoconf macros (typically the __AC_DEFUN__
168 definitions). This results in a noticeable speedup, but can
169 be disabled by this option.
170 !!SEE ALSO
171
172
173 autoheader(1), autoreconf(1),
174 autoscan(1), autoupdate(1),
175 ifnames(1)
176 !!AUTHORS
177
178
2 perry 179 David !MacKenzie, with help from Franc,ois Pinard, Karl
180 Berry, Richard Pixley, Ian Lance Taylor, Roland !McGrath,
1 perry 181 Noah Friedman, David D. Zuhn, and many others. This manpage
182 written by Ben Pfaff
183 autoconf__ package.
184 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.