1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
|
.\"
.\" cook - file construction tool
.\" Copyright (C) 1997-1999, 2001 Peter Miller;
.\" All rights reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
.\"
.\" MANIFEST: input for archive/cook.html
.\"
.ad l
.hy 0
.so version.so
<html>
<head><title>Cook \*(v)</title></head>
<body><h1>
<img src="cook.gif" align=left>
<img src="cook.gif" align=right>
<center>Cook \*(v)</center></h1>
Cook is a tool for constructing files. It is given a set of files to
create, and recipes of how to create them. In any non-trivial program
there will be prerequisites to performing the actions necessary to
creating any file, such as include files. Cook provides a
mechanism to define these.
.br
<p>
When a program is being developed or maintained, the programmer will
typically change one file of several which comprise the program. Cook
examines the last-modified times of the files to see when the
prerequisites of a file have changed, implying that the file needs to be
recreated as it is logically out of date.
.br
<p>
Cook also provides a facility for implicit recipes, allowing users to
specify how to form a file with a given suffix from a file with a
different suffix. For example, to create <tt><i>filename</i>.o</tt>
from <tt><i>filename</i>.c</tt>
.br
<p><table>
<tr><td valign=top><ul><li>
Cook is a replacement for the traditional <i>make</i>(1) tool.
</ul></td><td valign=top rowspan=2><ul><li>
There is a <i>make2cook</i> utility included in the distribution
to help convert makefiles into cookbooks.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
Cook is more powerful than the traditional <i>make</i> tool.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
Cook has true variables, not simple macros.
</ul></td><td valign=top rowspan=2><ul><li>
Cook has a simple but powerful string-based description language with
many built-in functions. This allows sophisticated filename
specification and manipulation without loss of readability or
performance.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
Cook has user defined functions.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
Cook can build in parallel.
</ul></td><td valign=top rowspan=2><ul><li>
Cook is able to build your project with multiple parallel threads, with
support for rules which must be single threaded. It is possible to
distribute parallel builds over your LAN, allowing you to turn your
network into a virtual parallel build engine.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
Cook can distribute builds across your LAN.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
Cook is able to use fingerprints to supplement file modification
times. This allows build optimization without contorted rules.
</ul></td><td valign=top rowspan=2><ul><li>
Cook can be configured with an explicit list of primary source files.
This allow the dependency graph to be constructed faster by not going
down dead ends, and also allows better error messages when the graph
can't be constructed. This requires an accurate source file manifest.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
In addition to walking the dependency graph,
Cook can turn the input rules into a shell script, or a web page.
</ul></td></tr>
.br
<tr><td valign=top><ul><li>
Cook runs on almost any flavor of UNIX. The source distribution is self
configuring using a GNU Autoconf generated configure script.
</ul></td><td valign=top><ul><li>
Cook has special <i>cascade</i> dependencies, allowing powerful include
dependency specification, amongst other things.
</ul></td></tr>
</table>
.br
<hr>
See the <a href="cook-\*(v).README">README</a> file for a description
of the new features and bug-fixes in this release. This is also in the
<a href="cook-\*(v).rm.ps.gz">Cook Reference Manual</a>, along with the
build and installation instructions, and all of the manual pages.
.br
<hr>
If you are putting together a source-code distribution and planning to
write a makefile, consider writing a cookbook instead. Although
Cook takes a day or two to learn, it is much more powerful and a bit
more intuitive than the traditional <i>make</i>(1) tool.
And Cook doesn't interpret tab differently to 8 space characters!
.br
<hr><h2><center>
Year 2000 Status
</center></h2>
Cook does not suffer from Year 2000 problems.
<ul>
<li>
Cook stores dates internally in Unix style (<i>i.e.</i> seconds
offset), so internal storage of times and dates does not suffer from
any Y2K problems.
<li>
Cook always uses the ANSI C standard <tt>strftime</tt> function to display
times and dates. (This assumes that your vendor has supplied a compliant
<tt>strftime</tt>.) This means that displaying dates does not assume
fixed field widths, nor will it display the year 2000 as ``100''.
<li>
When a user enters dates, they may specify years with an explicit century.
If a user enters a year with an implicit century, the closest is assumed.
</ul>
.br
<hr><h2><center>
Files for Download
</center></h2>
<center><table>
<tr>
<th>File Name</th>
<th width="60%">Description</th>
</tr>
<tr>
<td><a href="cook-\*(v).README"><tt>cook-\*(v).README</tt></a></td>
<td>The <tt>README</tt> file from the tar distribution.</td>
</tr>
<tr>
<td><a href="cook-\*(v).lsm"><tt>cook-\*(v).lsm</tt></a></td>
<td>Brief description in
.nf
<a href="ftp://sunsite.unc.edu/pub/Linux/LSM-TEMPLATE">LSM</a>
.fi
format.</td>
</tr>
<tr>
<td><a href="cook-\*(v).spec"><tt>cook-\*(v).spec</tt></a></td>
<td>RedHat package manager specification file (<a href="http://www.rpm.org/">RPM</a>)</td>
</tr>
<tr>
<td><a href="cook-\*(v).tar.gz"><tt>cook-\*(v).tar.gz</tt></a></td>
<td>The complete source.</td>
</tr>
<tr>
<td><a href="cook-\*(v).rm.ps.gz"><tt>cook-\*(v).rm.ps.gz</tt></a></td>
<td>Cook Reference Manual in PostScript format.</td>
</tr>
<tr>
<td><a href="cook-\*(v).ug.ps.gz"><tt>cook-\*(v).ug.ps.gz</tt></a></td>
<td>Cook User Guide in PostScript format.</td>
</tr>
<tr>
<td><a href="cook-\*(v)-1.i386.rpm"><tt>cook-\*(v)-1.i386.rpm</tt></a></td>
<td>Pre-built binaries in RPM format.</td>
</tr>
</table></center>
.br
<p align=center><b>
Second Sources
</b></p>
<ul><li>
Cook is also available from
<a href="ftp://sunsite.unc.edu/pub/Linux/">the Linux archives</a>
in the
<a href="ftp://sunsite.unc.edu/pub/Linux/devel/make/">
<tt>devel/make</tt></a>
directory.
.br
<li>
Cook is also available as
.br
<a href="http://www.debian.org/Packages/stable/devel/cook.html">
Debian packages</a> from the
<a href="http://www.debian.org">Debian</a> distribution.
.br
<li> Cook is also available as part of the <a
href="http://www.freebsd.org">FreeBSD</a> ports collection in the <a
.nf
href="ftp://ftp.freebsd.org/pub/FreeBSD/branches/-current/ports/devel/cook/">
.fi
devel/cook</a> directory.
.br
<li> Cook is also available as part of the <a
href="http://www.openbsd.org">OpenBSD</a> ports collection in the <a
.nf
href="http://www.openbsd.org/cgi-bin/cvsweb/ports/devel/cook/">
.fi
devel/cook</a> directory.
</ul>
.br
<hr><h2 align=center>
Mailing List
</h2>
A mailing list has been created so that users of Aegis may exchange ideas
about how to use Aegis. Discussion may include, but is not limited to:
bugs, enhancements, and applications. The list is not moderated.
<table border=1>
<tr><td valign=top>
<p align=center><b>Posting</b></p><p>
The address of the mailing list is
<a href="mailto:cook-users@canb.auug.org.au">
cook-users@canb.auug.org.au</a>
<p>
Please
<b>do not</b>
attempt to subscribe by sending email to this address.
It is for content only.
</td><td valign=top>
<p align=center><b>Subscribe</b></p><p>
To subscribe to this mailing list,
send an email message to
<a href="mailto:majordomo@canb.auug.org.au">
majordomo@canb.auug.org.au</a>
with a message body containing the single line
<blockquote>
subscribe cook-users
</blockquote>
The subscribe is moderated, and there are more options, too.
See the <a href="cook-\*(v).README">README</a> file for details.
</td></tr><tr><td valign=top>
<p align=center><b>Archive</b></p><p>
The mailing list is archived at
<a href="http://www.egroups.com/">eGroups</a>.
The URL is
.br
<a href="http://www.egroups.com/list/cook-users/">
http://www.egroups.com/ list/ cook-users/</a>
and then follow the links.
<p>
The archive starts from November 1999.
Sorry, previous postings are not available.
</td><td valign=top>
<p align=center><b>Unsubscribe</b></p><p>
To unsubscribe from this mailing list,
send an email message to
<a href="mailto:majordomo@canb.auug.org.au">
majordomo@canb.auug.org.au</a>
with a message body containing the single line
<blockquote>
unsubscribe cook-users
</blockquote>
The unsubscribe is moderated, and there are more options, too.
See the
.br
<a href="cook-\*(v).README">README</a> file for details.
</td></tr>
</table>
You can't fetch files throuht the mailing list, so please don't try.
Use the links on this page, instead.
.br
<hr>
<a href="../README.html">
<img src="../pmiller.gif" align=right>
</a>
Cook is written and owned by
<a href="mailto:millerp@canb.auug.org.au">
Peter Miller <millerp@canb.auug.org.au>
</a>
and is freely distributable under the terms and conditions of the
<a href="ftp://prep.ai.mit.edu/pub/gnu/GPL">GNU GPL</a>.
<p>
Cook is developed using <a href="../aegis/">Aegis</a>, a transaction
based software configuration management package.
<p>
There is more <a href="../README.html">Software by Peter Miller</a>
at his home page.
.br
<hr>
This page has been accessed approximately
.nf
<img
src="http://www.canb.auug.org.au/cgi-bin/Count.cgi?df=millerp_cook_\*(v)&ft=0&tr=Y&trgb=black&pad=0">
.fi
times since
.ds MO1 Jan
.ds MO2 Feb
.ds MO3 Mar
.ds MO4 Apr
.ds MO5 May
.ds MO6 Jun
.ds MO7 Jul
.ds MO8 Aug
.ds MO9 Sep
.ds MO10 Oct
.ds MO11 Nov
.ds MO12 Dec
.nr y4 \n[yr]+1900
\n[dy]-\*[MO\n[mo]]-\n[y4].
</body></html>
|