Penguin
Recent Changes
Annotated edit history of automake(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 AUTOMAKE
2 !!!AUTOMAKE
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 SEE ALSO
7 AUTHORS
8 ----
9 !!NAME
10
11
12 automake - automatically create Makefile.in's from Makefile.am's
13 !!SYNOPSIS
14
15
16 __automake__ [[ __-a__ | __--add-missing__ ] [[
17 __--amdir=__DIR ] [[ __--build-dir=__DIR ] [[
18 __--cygnus__ ] [[ __--foreign__ ] [[ __--gnits__ ] [[
19 __--gnu__ ] [[ __--help__ ] [[ __-i__ |
20 __--include-deps__ ] [[ __--no-force__ ] [[ __-o__
21 DIR ] [[ __--output-dir=__DIR ] [[ __--srcdir-name=__DIR
22 ] [[ __-v__ | __--verbose__ ] [[ __--version__
23 ]
24 !!DESCRIPTION
25
26
27 To create all the __Makefile.in__s for a package, run the
28 __automake__ program in the top level directory, with no
29 arguments. __automake__ will automatically find each
30 appropriate __Makefile.am__ (by scanning
31 __configure.in__) and generate the corresponding
32 __Makefile.in__. Note that __automake__ has a rather
33 simplistic view of what constitutes a package; it assumes
34 that a package has only one __configure.in__, at the top.
35 If your package has multiple __configure.in__s, then you
36 must run __automake__ in each directory holding a
37 __configure.in__.
38
39
40 You can optionally give __automake__ an argument;
41 __.am__ is appended to the argument and the result is
42 used as the name of the input file. This feature is
43 generally only used to automatically rebuild an out-of-date
44 __Makefile.in__. Note that __automake__ must always be
45 run from the topmost directory of a project, even if being
46 used to regenerate the __Makefile.in__ in some
47 subdirectory. This is necessary because __automake__ must
48 scan __configure.in__, and because __automake__ uses
49 the knowledge that a __Makefile.in__ is in a subdirectory
50 to change its behavior in some cases.
51
52
53 __automake__ accepts the following options:
54
55
56 __-a__
57
58
59 __--add-missing__
60
61
62 Automake requires certain common files to exist in certain
63 situations; for instance __config.guess__ is required if
64 __configure.in__ runs __AC_CANONICAL_HOST__. Automake
65 is distributed with several of these files; this option will
66 cause the missing ones to be automatically added to the
67 package, whenever possible. In general if Automake tells you
68 a file is missing, try using this option.
69
70
71 __--amdir=__DIR
72
73
74 Look for Automake data files in directory DIR instead of in
75 the installation directory. This is typically used for
76 debugging.
77
78
79 __--build-dir=__DIR
80
81
82 Tell Automake where the build directory is. This option is
83 used when including dependencies into a __Makefile.in__
84 generated by __make dist__; it should not be used
85 otherwise.
86
87
88 __--cygnus__
89
90
91 Causes the generated __Makefile.in__s to follow Cygnus
92 rules, instead of GNU or Gnits rules.
93
94
95 __--foreign__
96
97
98 Set the global strictness to __foreign__.
99
100
101 __--gnits__
102
103
104 Set the global strictness to __gnits__.
105
106
107 __--gnu__
108
109
110 Set the global strictness to __gnu__. This is the default
111 strictness.
112
113
114 __--help__
115
116
117 Print a summary of the command line options and
118 exit.
119
120
121 __-i__
122
123
124 __--include-deps__
125
126
127 Include all automatically generated dependency information
128 in the generated __Makefile.in__. This is generally done
129 when making a distribution.
130
131
132 __--no-force__
133
134
135 Ordinarily __automake__ creates all __Makefile.in__s
136 mentioned in __configure.in__. This option causes it to
137 only update those __Makefile.in__s which are out of date
138 with respect to one of their dependents.
139
140
141 __-o__ DIR
142
143
144 __--output-dir=__DIR
145
146
147 Put the generated __Makefile.in__ in the directory DIR.
148 Ordinarily each __Makefile.in__ is created in the
149 directory of the corresponding __Makefile.am__. This
150 option is used when making distributions.
151
152
153 __--srcdir-name=__DIR
154
155
156 Tell Automake the name of the source directory associated
157 with the current build. This option is used when including
158 dependencies into a __Makefile.in__ generated by
159 __make__dist__;__ it should not be used
160 otherwise.
161
162
163 __-v__
164
165
166 __--verbose__
167
168
169 Cause Automake to print information about which files are
170 being read or created.
171
172
173 __--version__
174
175
176 Print the version number of Automake and exit.
177 !!SEE ALSO
178
179
180 aclocal(1), and the Texinfo documentation for
181 automake
182 !!AUTHORS
183
184
185 Automake was written primarily by David Mackenzie and Tom
186 Tromey. This manpage written by Ben Pfaff
187 automake__ package.
188 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.