Debian Codegraph @

upstream/debian-unstable/man1/autoconf.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2 .TH AUTOCONF "1" "March 2026" "GNU Autoconf 2.73" "User Commands"
3 .SH NAME
4 autoconf \- Generate configuration scripts
5 .SH SYNOPSIS
6 .B autoconf
7 [\fI\,OPTION\/\fR]... [\fI\,TEMPLATE-FILE\/\fR]
8 .SH DESCRIPTION
9 Generate a configuration script from a TEMPLATE\-FILE if given, or
10 \&'configure.ac' if present, or else 'configure.in'. Output is sent
11 to the standard output if TEMPLATE\-FILE is given, else into
12 \&'configure'.
13 .SS "Operation modes:"
14 .TP
15 \fB\-h\fR, \fB\-\-help\fR
16 print this help, then exit
17 .TP
18 \fB\-V\fR, \fB\-\-version\fR
19 print version number, then exit
20 .TP
21 \fB\-v\fR, \fB\-\-verbose\fR
22 verbosely report processing
23 .TP
24 \fB\-d\fR, \fB\-\-debug\fR
25 don't remove temporary files
26 .TP
27 \fB\-f\fR, \fB\-\-force\fR
28 consider all files obsolete
29 .TP
30 \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
31 save output in FILE (stdout is the default)
32 .TP
33 \fB\-W\fR, \fB\-\-warnings\fR=\fI\,CATEGORY\/\fR
34 report the warnings falling in CATEGORY
35 (comma\-separated list accepted)
36 .SS "Warning categories are:"
37 .TP
38 cross
39 cross compilation issues
40 .TP
41 gnu
42 GNU coding standards (default in gnu and gnits modes)
43 .TP
44 obsolete
45 obsolete features or constructions (default)
46 .TP
47 override
48 user redefinitions of Automake rules or variables
49 .TP
50 portability
51 portability issues (default in gnu and gnits modes)
52 .TP
53 portability\-recursive
54 nested Make variables (default with \fB\-Wportability\fR)
55 .TP
56 extra\-portability
57 extra portability issues related to obscure tools
58 .TP
59 syntax
60 dubious syntactic constructs (default)
61 .TP
62 unsupported
63 unsupported or incomplete features (default)
64 .SS "-W also understands:"
65 .TP
66 all
67 turn on all the warnings
68 .TP
69 none
70 turn off all the warnings
71 .TP
72 no\-CATEGORY
73 turn off warnings in CATEGORY
74 .TP
75 error
76 treat all enabled warnings as errors
77 .SS "Library directories:"
78 .TP
79 \fB\-B\fR, \fB\-\-prepend\-include\fR=\fI\,DIR\/\fR
80 prepend directory DIR to search path
81 .TP
82 \fB\-I\fR, \fB\-\-include\fR=\fI\,DIR\/\fR
83 append directory DIR to search path
84 .SS "Tracing:"
85 .TP
86 \fB\-t\fR, \fB\-\-trace\fR=\fI\,MACRO[\/\fR:FORMAT]
87 report the list of calls to MACRO
88 .TP
89 \fB\-i\fR, \fB\-\-initialization\fR
90 also trace Autoconf's initialization process
91 .PP
92 In tracing mode, no configuration script is created. FORMAT defaults
93 to '$f:$l:$n:$%'; see 'autom4te \fB\-\-help\fR' for information about FORMAT.
94 .SH AUTHOR
95 Written by David J. MacKenzie and Akim Demaille.
96 .SH "REPORTING BUGS"
97 Report bugs to
98 .MT [email protected]
99 .ME ,
100 or via Savannah:
101 .UR https://savannah.gnu.org/support/?group=autoconf
102 .UE .
103 .SH COPYRIGHT
104 Copyright \(co 2026 Free Software Foundation, Inc.
105 License GPLv3+/Autoconf: GNU GPL version 3 or later
106 <https://gnu.org/licenses/gpl.html>, <https://gnu.org/licenses/exceptions.html>
107 .br
108 This is free software: you are free to change and redistribute it.
109 There is NO WARRANTY, to the extent permitted by law.
110 .SH "SEE ALSO"
111 .BR autoconf (1),
112 .BR automake (1),
113 .BR autoreconf (1),
114 .BR autoupdate (1),
115 .BR autoheader (1),
116 .BR autoscan (1),
117 .BR config.guess (1),
118 .BR config.sub (1),
119 .BR ifnames (1),
120 .BR libtool (1).
121
122 The full documentation for Autoconf is maintained as a Texinfo manual.
123 To read the manual locally, use the command
124 .IP
125 .B info autoconf
126 .PP
127 You can also consult the Web version of the manual at
128 .UR https://gnu.org/software/autoconf/manual/
129 .UE .