]> git.pld-linux.org Git - packages/automake.git/blob - automake-man.patch
- don't call aclocal - now automake really doesn't buildrequire automake
[packages/automake.git] / automake-man.patch
1 --- automake-1.4.orig/automake.1
2 +++ automake-1.4/automake.1
3 @@ -0,0 +1,223 @@
4 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
5 +.\" Copyright (C) 1998 Ben Pfaff.
6 +.\"
7 +.\" Permission is granted to make and distribute verbatim copies of
8 +.\" this manual provided the copyright notice and this permission notice
9 +.\" are preserved on all copies.
10 +.\" 
11 +.\" Permission is granted to copy and distribute modified versions of this
12 +.\" manual under the conditions for verbatim copying, provided that the entire
13 +.\" resulting derived work is distributed under the terms of a permission
14 +.\" notice identical to this one.
15 +.\" 
16 +.\" Permission is granted to copy and distribute translations of this manual
17 +.\" into another language, under the above conditions for modified versions,
18 +.\" except that this permission notice may be stated in a translation approved
19 +.\" by the Foundation.
20 +.\"
21 +.TH AUTOMAKE 1 "Automake"
22 +.SH NAME
23 +automake - automatically create Makefile.in's from Makefile.am's
24 +.SH SYNOPSIS
25 +.B automake
26 +[
27 +.B -a
28 +|
29 +.B --add-missing
30 +] [
31 +.BR --amdir= DIR
32 +] [
33 +.BR --build-dir= DIR
34 +] [
35 +.B --cygnus
36 +] [
37 +.B --foreign
38 +] [
39 +.B --gnits
40 +] [
41 +.B --gnu
42 +] [
43 +.B --help
44 +] [
45 +.B -i
46 +|
47 +.B --include-deps
48 +] [
49 +.B --no-force
50 +] [
51 +.B -o 
52 +DIR
53 +] [
54 +.BR --output-dir= DIR
55 +] [
56 +.BR --srcdir-name= DIR
57 +] [
58 +.B -v
59 +|
60 +.B --verbose
61 +] [
62 +.B --version
63 +]
64 +.SH DESCRIPTION
65 +.PP
66 +To create all the 
67 +.BR Makefile.in s 
68 +for a package, run the 
69 +.B automake
70 +program in the top level directory, with no arguments.  
71 +.B automake
72 +will automatically find each appropriate 
73 +.B Makefile.am
74 +(by scanning
75 +.BR configure.in )
76 +and generate the corresponding 
77 +.BR Makefile.in .
78 +Note that 
79 +.B automake
80 +has a rather simplistic view of what constitutes a package; it assumes
81 +that a package has only one
82 +.BR configure.in , 
83 +at the
84 +top.  If your package has multiple 
85 +.BR configure.in s, 
86 +then you must run
87 +.B automake
88 +in each directory holding a 
89 +.BR configure.in .
90 +.PP
91 +You can optionally give 
92 +.B automake
93 +an argument; 
94 +.B .am
95 +is appended to the argument and the result is used as the name of the
96 +input file.  This feature is generally only used to automatically
97 +rebuild an out-of-date
98 +.BR Makefile.in .  
99 +Note that 
100 +.B automake
101 +must always be run from the topmost directory of a project, even if
102 +being used to regenerate the
103 +.B Makefile.in
104 +in some subdirectory.  This is necessary
105 +because 
106 +.B automake
107 +must scan 
108 +.BR configure.in ,
109 +and because 
110 +.B automake
111 +uses the knowledge that a 
112 +.B Makefile.in
113 +is in a subdirectory to change its behavior in some cases.
114 +.PP
115 +.B automake
116 +accepts the following options:
117 +.TP
118 +.BI -a
119 +.TP
120 +.BI --add-missing
121 +Automake requires certain common files to exist in certain
122 +situations; for instance 
123 +.B config.guess
124 +is required if
125 +.B configure.in
126 +runs 
127 +.BR AC_CANONICAL_HOST .  
128 +Automake is distributed with several of these files; this option will
129 +cause the missing ones to be automatically added to the package,
130 +whenever possible.  In general if Automake tells you a file is
131 +missing, try using this option.
132 +.TP
133 +.BI --amdir=\fRDIR
134 +Look for Automake data files in directory DIR instead of in the
135 +installation directory.  This is typically used for debugging.
136 +.TP
137 +.BI --build-dir=\fRDIR
138 +Tell Automake where the build directory is.  This option is used
139 +when including dependencies into a 
140 +.B Makefile.in
141 +generated by 
142 +.B make
143 +.BR dist ; 
144 +it should not be used otherwise.
145 +.TP
146 +.BI --cygnus
147 +Causes the generated 
148 +.BR Makefile.in s 
149 +to follow Cygnus rules, instead of GNU or Gnits rules.
150 +.TP
151 +.BI --foreign
152 +Set the global strictness to 
153 +.BR foreign .
154 +.TP
155 +.BI --gnits
156 +Set the global strictness to 
157 +.BR gnits .
158 +.TP
159 +.BI --gnu
160 +Set the global strictness to 
161 +.BR gnu .
162 +This is the default strictness.
163 +.TP
164 +.BI --help
165 +Print a summary of the command line options and exit.
166 +.TP
167 +.BI -i
168 +.TP
169 +.BI --include-deps
170 +Include all automatically generated dependency information in the
171 +generated
172 +.BR Makefile.in . 
173 +This is generally done
174 +when making a distribution.
175 +.TP
176 +.BI --no-force
177 +Ordinarily 
178 +.B automake
179 +creates all 
180 +.BR Makefile.in s
181 +mentioned in
182 +.BR configure.in .
183 +This option causes it to only update those
184 +.BR Makefile.in s 
185 +which are out of date with respect to one of their dependents.
186 +.TP
187 +.BI -o\ \fRDIR
188 +.TP
189 +.BI --output-dir=\fRDIR
190 +Put the generated 
191 +.B Makefile.in
192 +in the directory DIR.  Ordinarily
193 +each 
194 +.B Makefile.in
195 +is created in the directory of the
196 +corresponding 
197 +.BR Makefile.am .  
198 +This option is used when making
199 +distributions.
200 +.TP
201 +.BI --srcdir-name=\fRDIR
202 +Tell Automake the name of the source directory associated with the
203 +current build.  This option is used when including dependencies into a
204 +.B Makefile.in
205 +generated by 
206 +.BR make dist ; 
207 +it should not be used otherwise.
208 +.TP
209 +.BI -v
210 +.TP
211 +.BI --verbose
212 +Cause Automake to print information about which files are being read
213 +or created.
214 +.TP
215 +.BI --version
216 +Print the version number of Automake and exit.
217 +.PP
218 +.SH "SEE ALSO"
219 +.BR aclocal (1),
220 +and the Texinfo documentation for automake
221 +.SH AUTHORS
222 +Automake was written primarily by David Mackenzie and Tom Tromey.
223 +This manpage written by Ben Pfaff <pfaffben@pilot.msu.edu> for the
224 +Debian GNU/Linux
225 +.B automake
226 +package.
227 --- automake-1.4.orig/aclocal.1
228 +++ automake-1.4/aclocal.1
229 @@ -0,0 +1,108 @@
230 +.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
231 +.\" Copyright (C) 1998 Ben Pfaff.
232 +.\"
233 +.\" Permission is granted to make and distribute verbatim copies of
234 +.\" this manual provided the copyright notice and this permission notice
235 +.\" are preserved on all copies.
236 +.\" 
237 +.\" Permission is granted to copy and distribute modified versions of this
238 +.\" manual under the conditions for verbatim copying, provided that the entire
239 +.\" resulting derived work is distributed under the terms of a permission
240 +.\" notice identical to this one.
241 +.\" 
242 +.\" Permission is granted to copy and distribute translations of this manual
243 +.\" into another language, under the above conditions for modified versions,
244 +.\" except that this permission notice may be stated in a translation approved
245 +.\" by the Foundation.
246 +.\"
247 +.TH ACLOCAL 1 "Automake"
248 +.SH NAME
249 +aclocal - automatically generate aclocal.m4 from configure.in
250 +.SH SYNOPSIS
251 +.B aclocal
252 +[
253 +.BR --acdir= DIR
254 +] [
255 +.B --help
256 +] [
257 +.B -I
258 +DIR ] [
259 +.BR --output= FILE
260 +] [
261 +.B --verbose
262 +] [
263 +.B --version
264 +]
265 +.SH DESCRIPTION
266 +.PP
267 +Automake includes a number of Autoconf macros which can be used in
268 +your package; some of them are actually required by Automake in certain
269 +situations.  These macros must be defined in your 
270 +.BR aclocal.m4 ;
271 +otherwise they will not be seen by 
272 +.BR autoconf .
273 +.PP
274 +The 
275 +.B aclocal
276 +program will automatically generate 
277 +.B aclocal.m4
278 +files based on the contents of 
279 +.BR configure.in .  
280 +This provides a convenient way to get Automake-provided macros,
281 +without having to search around.  Also, the 
282 +.B aclocal
283 +mechanism is extensible for use by other packages.
284 +.PP
285 +At startup, 
286 +.B aclocal
287 +scans all the 
288 +.B .m4
289 +files it can find, looking for macro definitions.  Then it scans
290 +.BR configure.in .  
291 +Any mention of one of the macros found in the first step causes that
292 +macro, and any macros it in turn requires, to be put into
293 +.BR aclocal.m4 .
294 +.PP
295 +The contents of 
296 +.BR acinclude.m4 , 
297 +if it exists, are also automatically included in 
298 +.BR aclocal.m4 .  
299 +This is useful for incorporating local macros into 
300 +.BR configure .
301 +.PP
302 +.B aclocal
303 +accepts the following options:
304 +.TP
305 +.BI --acdir=\fRDIR
306 +Look for the macro files in DIR instead of the installation
307 +directory.  This is typically used for debugging.
308 +.TP
309 +.BI --help
310 +Print a summary of the command line options and exit.
311 +.TP
312 +.BI -I\fR\ DIR
313 +Add the directory DIR to the list of directories searched for
314 +.B .m4
315 +files.
316 +.TP
317 +.BI --output=\fRFILE
318 +Cause the output to be put into FILE instead of 
319 +.BR aclocal.m4 .
320 +.TP
321 +.BI -v
322 +.TP
323 +.BI --verbose
324 +Print the names of the files it examines.
325 +.TP
326 +.BI --version
327 +Print the version number of Automake and exit.
328 +.PP
329 +.SH "SEE ALSO"
330 +.BR automake (1),
331 +and the Texinfo documentation for automake
332 +.SH AUTHORS
333 +Automake was written primarily by David Mackenzie and Tom Tromey.
334 +This manpage written by Ben Pfaff <pfaffben@pilot.msu.edu> for the
335 +Debian GNU/Linux
336 +.B automake
337 +package.
338 --- automake-1.4.orig/config.h.in
339 +++ automake-1.4/config.h.in
340 @@ -0,0 +1,8 @@
341 +/* config.h.in.  Generated automatically from configure.in by autoheader.  */
342 +
343 +/* Name of package */
344 +#undef PACKAGE
345 +
346 +/* Version number of package */
347 +#undef VERSION
348 +
This page took 0.080829 seconds and 3 git commands to generate.