* lib/autoconf/general.m4 (AC_CONFIG_MACRO_DIR): Stub out a macro
[autoconf.git] / man / autoreconf.1
blobad884d08d74154ae314ea98083af2afb343e2a87
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.33.
2 .TH AUTORECONF "1" "October 2003" "autoreconf 2.57f" "User Commands"
3 .SH NAME
4 autoreconf \- Update generated configuration files
5 .SH SYNOPSIS
6 .B autoreconf
7 [\fIOPTION\fR] ... [\fICONFIGURE-AC or DIRECTORY\fR] ...
8 .SH DESCRIPTION
9 Run `autoconf' (and `autoheader', `aclocal', `automake', `autopoint'
10 (formerly `gettextize'), and `libtoolize' where appropriate)
11 repeatedly to remake the GNU Build System files in the DIRECTORIES or
12 the directory trees driven by CONFIGURE-AC (defaulting to `.').
13 .PP
14 By default, it only remakes those files that are older than their
15 predecessors.  If you install new versions of the GNU Build System,
16 running `autoreconf' remakes all of the files by giving it the
17 `--force' option.
18 .SS "Operation modes:"
19 .TP
20 \fB\-h\fR, \fB\-\-help\fR
21 print this help, then exit
22 .TP
23 \fB\-V\fR, \fB\-\-version\fR
24 print version number, then exit
25 .TP
26 \fB\-v\fR, \fB\-\-verbose\fR
27 verbosely report processing
28 .TP
29 \fB\-d\fR, \fB\-\-debug\fR
30 don't remove temporary files
31 .TP
32 \fB\-f\fR, \fB\-\-force\fR
33 consider all files obsolete
34 .TP
35 \fB\-i\fR, \fB\-\-install\fR
36 copy missing auxiliary files
37 .TP
38 \fB\-s\fR, \fB\-\-symlink\fR
39 with \fB\-i\fR, install symbolic links instead of copies
40 .TP
41 \fB\-m\fR, \fB\-\-make\fR
42 when applicable, re-run ./configure && make
43 .TP
44 \fB\-W\fR, \fB\-\-warnings\fR=\fICATEGORY\fR
45 report the warnings falling in CATEGORY [syntax]
46 .SS "Warning categories include:"
47 .TP
48 `cross'
49 cross compilation issues
50 .TP
51 `gnu'
52 GNU coding standards (default in gnu and gnits modes)
53 .TP
54 `obsolete'
55 obsolete features or constructions
56 .TP
57 `override'
58 user redefinitions of Automake rules or variables
59 .TP
60 `portability'
61 portability issues
62 .TP
63 `syntax'
64 dubious syntactic constructs (default)
65 .TP
66 `unsupported'
67 unsupported or incomplete features (default)
68 .TP
69 `all'
70 all the warnings
71 .TP
72 `no-CATEGORY'
73 turn off warnings in CATEGORY
74 .TP
75 `none'
76 turn off all the warnings
77 .TP
78 `error'
79 treat warnings as errors
80 .PP
81 The environment variable `WARNINGS' is honored.  Some subtools might
82 support other warning types, using `all' is encouraged.
83 .SS "Library directories:"
84 .TP
85 \fB\-B\fR, \fB\-\-prepend\-include\fR=\fIDIR\fR
86 prepend directory DIR to search path
87 .TP
88 \fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR
89 append directory DIR to search path
90 .PP
91 The environment variables AUTOCONF, AUTOHEADER, AUTOMAKE, ACLOCAL,
92 AUTOPOINT, LIBTOOLIZE are honored.
93 .SH AUTHOR
94 Written by David J. MacKenzie and Akim Demaille.
95 .SH "REPORTING BUGS"
96 Report bugs to <bug-autoconf@gnu.org>.
97 .SH COPYRIGHT
98 Copyright \(co 2003 Free Software Foundation, Inc.
99 .br
100 This is free software; see the source for copying conditions.  There is NO
101 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
102 .SH "SEE ALSO"
103 .BR autoconf (1),
104 .BR automake (1),
105 .BR autoreconf (1),
106 .BR autoupdate (1),
107 .BR autoheader (1),
108 .BR autoscan (1),
109 .BR config.guess (1),
110 .BR config.sub (1),
111 .BR ifnames (1),
112 .BR libtool (1).
114 The full documentation for
115 .B autoreconf
116 is maintained as a Texinfo manual.  If the
117 .B info
119 .B autoreconf
120 programs are properly installed at your site, the command
122 .B info autoreconf
124 should give you access to the complete manual.