/[cmucl]/src/contrib/CATALOG.TXT
ViewVC logotype

Contents of /src/contrib/CATALOG.TXT

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (show annotations)
Tue Aug 18 15:20:21 2009 UTC (4 years, 8 months ago) by rtoy
Branch: MAIN
CVS Tags: sparc-tramp-assem-base, post-merge-intl-branch, intl-branch-working-2010-02-19-1000, unicode-string-buffer-impl-base, release-20b-pre1, release-20b-pre2, unicode-string-buffer-base, sparc-tramp-assem-2010-07-19, amd64-dd-start, intl-2-branch-base, GIT-CONVERSION, cross-sol-x86-merged, intl-branch-working-2010-02-11-1000, RELEASE_20b, release-20a-base, cross-sol-x86-base, snapshot-2010-12, snapshot-2010-11, snapshot-2011-09, snapshot-2011-06, snapshot-2011-07, snapshot-2011-04, snapshot-2011-02, snapshot-2011-03, snapshot-2011-01, pre-merge-intl-branch, snapshot-2010-05, snapshot-2010-04, snapshot-2010-07, snapshot-2010-06, snapshot-2010-01, snapshot-2010-03, snapshot-2010-02, snapshot-2010-08, cross-sol-x86-2010-12-20, intl-branch-2010-03-18-1300, RELEASE_20a, release-20a-pre1, snapshot-2009-11, snapshot-2009-12, cross-sparc-branch-base, intl-branch-base, HEAD
Branch point for: cross-sparc-branch, RELEASE-20B-BRANCH, unicode-string-buffer-branch, sparc-tramp-assem-branch, RELEASE-20A-BRANCH, amd64-dd-branch, unicode-string-buffer-impl-branch, intl-branch, cross-sol-x86-branch, intl-2-branch
Changes since 1.2: +40 -0 lines
File MIME type: text/plain
Add Gerd's sprof statistical profiler.

contrib/CATALOG.TXT:
o Update with sprof info

contrib/contrib.lisp:
o Add defmodule for sprof.

contrib/sprof/compile-sprof.lisp:
o New file to compile and load sprof.

contrib/sprof/sprof.catalog:
o New file for sprof catalog

contrib/sprof/sprof.lisp:
o New file for implementation of sprof itself.
1 Package Name:
2 DEMOS
3
4 Description:
5 Graphics demonstration programs for CMU Common Lisp using version 11 of the
6 X Window System.
7
8 Author:
9 CMU Common Lisp Group.
10
11 Maintainer:
12 CMU Common Lisp Group.
13
14 Address:
15 Carnegie-Mellon University
16 Computer Science Department
17 Pittsburgh, PA 15213
18
19 Net Address:
20 slisp-group@b
21
22 Copyright Status:
23 Public Domain.
24
25 Files:
26 demos.lisp, demos.fasl, demos.catalog.
27
28 How to Get:
29 The following unix command will copy the pertinent files into directory
30 <spec>:
31 cp /afs/cs.cmu.edu/project/slisp/library/demos/* <spec>
32
33 Portability:
34 Should run in any Common Lisp supporting CLX V11R3.
35
36 Instructions:
37 The function DEMOS:DO-ALL-DEMOS will run through each of the demos once, and
38 the function DEMOS:DEMO will present a menu of all the demos.
39
40
41 Name:
42 Follow Mouse.
43
44 Package Name:
45 HEMLOCK
46
47 Description:
48 This Hemlock customization causes Hemlock's current window to be set to
49 whatever Hemlock window the mouse enters, except the echo area.
50
51 Author:
52 Todd Kaufmann, modified by Dave Touretzky.
53
54 Maintainer:
55 Todd Kaufmann.
56
57 Address:
58 Carnegie-Mellon University
59 Computer Science Department
60 Pittsburgh, PA 15213
61
62 Net Address:
63 Todd.Kaufmann@CS.CMU.EDU
64
65 Copyright Status:
66 Public Domain.
67
68 Files:
69 follow-mouse.lisp, follow-mouse.fasl, follow-mouse.catalog.
70
71 How to Get:
72 The following unix command will copy the pertinent files into directory
73 <spec>:
74 cp /afs/cs.cmu.edu/project/slisp/library/follow-mouse/* <spec>
75
76 Portability:
77 This should work in any Common Lisp supporting Hemlock and CLX V11R3.
78
79 Instructions:
80 Load the fasl file into your editor Lisp. A value of T for the hemlock
81 variable "Follow Mouse To Read-Only Buffers", which is the default, means
82 follow mouse is on. Anything else means hemlock will behave normally.
83
84 Bugs:
85 A few more PROMPT-FOR-... functions need to be modified. They are mentioned
86 in the source code.
87
88
89 Package Name:
90 HIST
91
92 Description:
93 Simple histogram facility using Format strings for output.
94
95 Author:
96 Scott E. Fahlman
97
98 Address:
99 Carnegie-Mellon University
100 Computer Science Department
101 Pittsburgh, PA 15213
102
103 Net Address:
104 Scott.Fahlman@CS.CMU.EDU
105
106 Copyright Status:
107 Public Domain.
108
109 Files:
110 hist.lisp, hist.fasl, hist.catalog
111
112 How to Get:
113 The following unix command will copy the pertinent files into directory
114 <spec>.
115 cp /afs/cs.cmu.edu/project/slisp/library/hist/* <spec>
116
117 Portability:
118 Should run in any legal Common Lisp.
119
120 Instructions:
121 Hist is a macro of form (HIST (min max [bucket-size]) . body)
122
123 Creates a histogram with buckets of the specified size (defaults to 1),
124 spanning the range from Low (inclusive) to High (exclusive), with two
125 additional buckets to catch values below and above this range. The body is
126 executed as a progn, and every call to Hist-Record within the body provides a
127 value for the histogram to count. When Body exits, the histogram is printed
128 out and Hist returns Nil.
129
130 A simple example:
131 (hist (0 10) (dotimes (i 1000) (random 10)))
132 This example may make the RANDOM distribution look more normal:
133 (hist (0 10 2) (dotimes (i 1000) (random 10)))
134 This example will show you overflow buckets:
135 (hist (2 12) (dotimes (i 1000) (random 15)))
136
137 Wish List:
138 Some sort of automatic scaling for the number and size of buckets would be
139 nice, if the user chooses not to supply these. This would probably require
140 running the body twice, once to determine the spread of values, and again to
141 actually produce the histogram.
142
143
144 Name:
145 OPS
146
147 Package Name:
148 OPS
149
150 Description:
151 Interpreter for Ops5, a programming language for production systems.
152
153 Author:
154 Charles L. Forgy. Ported to Common lisp by George Wood and Jim Kowalski.
155 CMU Common Lisp mods by Dario Guise, Skef Wholey, and Dan Kuokka.
156
157 Maintainer:
158 CMU Common Lisp Group.
159
160 Net Address:
161 slisp-group@b
162
163 Copyright Status:
164 Public domain.
165
166 Files:
167 ops.lisp, ops-backup.lisp, ops-compile.lisp, ops-io.lisp, ops-main.lisp,
168 ops-match.lisp, ops-rhs.lisp, ops-util.lisp, ops.catalog, ops-demo-mab.lisp,
169 ops-demo-ttt.lisp, and binaries.
170
171 How to Get:
172 The following unix command will copy the pertinent files into directory
173 <spec>.
174 cp /afs/cs.cmu.edu/project/slisp/library/ops/* <spec>
175
176 Portability:
177 Should run in any legal Common Lisp implementation.
178
179 Instructions:
180 From Lisp, load "ops" and then go into the OPS package with (in-package
181 'ops). Now you can load your OPS5 code or start typing in productions.
182
183 There are two demos -- interactive tic-tac-toe and the monkey and banana
184 problem. To run the former just load it and call RUN. For the latter, first
185 enter "(make start 1)" and then call RUN.
186
187 See the OPS5 User's Manual, July 1981, by Forgy, CMU CSD.
188
189 Bugs:
190 This has been put in its own package, but only a few interfaces have been
191 exported. You must run in the ops package.
192
193
194 Name:
195 PSgrapher
196
197 Description:
198 The PSgrapher is a set of Lisp routines that can be called to produce
199 Postscript commands that display a directed acyclic graph.
200
201 Author:
202 Joseph Bates. Skef put the whole thing in the PSGRPAPH package and added
203 functionality which allows the user to specify EQ, EQUAL, or EQUALP as the
204 node equivalence function. Bill made all exported symbols have stars on them.
205
206 Address:
207 Carnegie-Mellon University
208 Computer Science Department
209 Pittsburgh, PA 15213
210
211 Net Address:
212 Joseph.Bates@CS.CMU.EDU
213
214 Copyright Status:
215 Public Domain.
216
217 Files:
218 psgraph.lisp, psgraph.fasl, psgraph.doc, psgraph.log, psgraph.catalog
219
220 How to Get:
221 The following unix command will copy the pertinent files into directory
222 <spec>.
223 cp /afs/cs.cmu.edu/project/clisp/library/psgraph/* <spec>
224
225 Portability:
226 Should run in any legal Common Lisp. Requires Postscript for printing.
227
228 Instructions:
229 See psgraph.doc.
230
231 Bugs:
232 This code blindly outputs what the user gives it as node labels. It should
233 run through the output escaping any PS control characters. For example, if
234 node labels contain parentheses, your output PS file will not print.
235
236 Examples:
237 Skef Wholey submitted this as a reasonable example:
238
239 ;;; I use this in my compiler so I can look at code trees without
240 ;;; crawling around them in the inspector. The postsript previewer
241 ;;; groks the generated ps file, which is bitchin' marvy.
242
243 (defun code-graph-to-file (s file &optional shrink insert)
244 (let ((psgraph:*fontname* "Times-Roman")
245 (psgraph:*fontsize* 8)
246 (psgraph:*second-fontname* "Times-BoldItalic")
247 (psgraph:*second-fontsize* 6)
248 (psgraph:*boxgray* "0")
249 (psgraph:*edgegray* "0")
250 (psgraph:*extra-x-spacing* 30))
251 (with-open-file (*standard-output* file
252 :direction :output
253 :if-exists :supersede)
254 (psgraph:psgraph s #'psg-children #'psg-info shrink insert #'eq))))
255
256 Package Name:
257 EMBEDDED-C
258
259 Description:
260 This package provides a macro to embed compiled C code in a Lisp
261 fasl file. It's inspired by the GForth FFI.
262
263 Author:
264 Helmut Eller
265
266 Address:
267
268 Net Address:
269
270
271 Copyright Status:
272 Public Domain.
273
274 Files:
275 embedded-c.lisp, embedded-c.catalog
276
277 How to Get:
278 This version is a possibly updated version of the code that was
279 sent to cmucl-imp mailing list on 2008/12/13.
280
281 Portability:
282 Somewhat portable, but depends on CMUCL-specific features.
283
284 Instructions:
285 Here is an example:
286
287 (define-c-code (*example*)
288 "#include <stdio.h>"
289
290 (defstub hello ((msg :string))
291 "printf(\"Hello, World!\\n%s\", msg);"
292 "fflush(0);")
293
294 "#include <sys/types.h>"
295 "#include <sys/wait.h>"
296 (defstub exitedp ((status :int) => :int)
297 "return WIFEXITED(status);"))
298
299 HELLO and EXITEDP are the names for lisp functions which call the
300 corresponding C code. It's quite convenient to access C macros in
301 this manner.
302
303 DEFINE-C-CODE invokes the C compiler on the body and embeds the
304 object code as a byte vector in the Lisp code. At load time, the
305 byte vector is passed to dlopen and callout functions to the C
306 functions are initialized.
307
308 The above example creates two functions callable from Lisp: HELLO
309 and EXITEDP.
310
311 Package Name:
312 SPROF
313
314 Description:
315 Statistical profiler.
316
317 Author:
318 Gerd Moellmann
319
320 Address:
321
322 Net Address:
323 gerd.moellmann@t-online.de
324
325 Copyright Status:
326 BSD-like
327
328 Files:
329 sprof.lisp, sprof.catalog
330
331 How to Get:
332 This version is a possibly updated version of the code that was
333 sent to cmucl-imp mailing list on 2003/10/28.
334
335 Portability:
336 Depends CMUCL-specific features.
337
338 Instructions:
339 See sprof.lisp for details.
340
341 (sprof:start-profiling) starts profiling until stopped
342 (sprof:stop-profiling) stops profiling
343
344 (sprof:reset) resets any gathered statistics
345 (sprof:report) reporst the results.
346
347 (sprof:with-profiling) is a macro that enables statistical
348 profiling for the body of the macro, and optionally produces a
349 report.

  ViewVC Help
Powered by ViewVC 1.1.5