Skip to content
Newer
Older
100644 126 lines (83 sloc) 4.46 KB
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
1 Prerequisites:
2 ==============
5e31dea Initial INSTALL instructions
CVS pserver daemon authored Jun 13, 2000
3
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
4 ASDF - The ASDF system definition facility. Many implementations come
5 with it and (require :asdf) is all that is needed. If yours doesn't,
6 see http://www.cliki.net/asdf.
ae3f6e4 Removed address book demo and added calculator and colorslider.
CVS pserver daemon authored Sep 5, 2000
7
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
8
9
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
10 Installing McCLIM using mcclim.asd
11 ==================================
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
12
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
13 To tell ASDF about the wherabouts of McCLIM and to compile it for the
14 first time, perform these steps:
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
15
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
16 1. Symlink mcclim.asd to a directory in your
17 asdf:*central-registry* list. E.g., for SBCL, that would be:
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
18
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
19 $ ln -sf /path/to/mcclim.asd ~/.sbcl/systems/
20
21 2. If you are using a Lisp implementation that requires a separate
22 CLX to be installed, do this now and symlink the clx's .asd file
23 to your asdf:*central-registry*, as above. If your
24 implementation's CLX doesn't come with a clx.asd file, you will
25 have to load CLX via (require :clx) or a similar mechanism
26 yourself.
27
28 3. You need to install the spatial-trees library (available at
29 http://cliki.net/spatial-trees). The preferred method for that is
30 via asdf-install. see http://cliki.net/asdf-install for an
31 introduction to that method.
32
33 4. On your Lisp's REPL (with ASDF loaded), type
34
35 (asdf:oos 'asdf:load-op :mcclim)
36 ; compilation messages should zip past
37
38 After step 4, McCLIM and the CLX backend should be loaded and
39 you are good to go.
40
41 When you restart your lisp image, you will need to perform step 4 to
42 load McCLIM again.
43
44 Installing mcclim.asd if you were using ASDF & system.lisp before
45 =================================================================
46
47 Make sure to remove all symlinks in your asdf:*central-registry* to
48 system.lisp and replace them with symlinks to mcclim.asd. Keeping the
49 old links around will break loading the McCLIM system in subtle ways.
50
51 After replacing the symlinks, follow the "Installing McCLIM..."
52 section above, beginning at step 1 - the symlink mcclim.asd itself is
53 required, too.
54
55 Writing a system that depends on McCLIM
56 =======================================
57
58 In an ASDF system that depends on a loaded CLIM, use the following
59 code to declare a dependency on McCLIM:
60
61 (defsystem :your-clim-using-system
62 :depends-on (:mcclim #| other dependencies |#)
63 :components (#| components |#)
64 )
65
66 The dependency on the McCLIM system will also load a suitable display
67 backend on implementations where it can determine one.
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
68
69 Running the demos
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
70 =================
71
72 McCLIM comes with some interesting demo programs and applications:
02cb80c documentation fix (thanks to Willem Broekema)
Rudi Schlatte authored Jul 24, 2006
73 address-book - The classic CLIM demo: (asdf:oos 'asdf:load-op :clim-examples) (in-package :clim-demo) (run-frame-top-level (make-application-frame 'address-book)) The Examples directory includes other demo programs that might be of interest. Many of these are quite old and were written before large parts of the CLIM specification were implemented; for good
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
74 examples of CLIM style it is best to look elsewhere.
75
76
77 clim-listener - a Lisp 'listener' or top-level loop with many
78 goodies for examining directories, CLOS classes, etc. Printed
02cb80c documentation fix (thanks to Willem Broekema)
Rudi Schlatte authored Jul 24, 2006
79 results are mouse-sensitive and in supported implementations (currently OpenMCL) can be used directly as arguments in Lisp expressions: (asdf:oos 'asdf:load-op :clim-listener) (clim-listener:run-listener) functional-geometry - Frank Buss' and Rainer Joswig's functional
80 geometry explorer, implemented on top of clim-listener: (load "Apps/Functional-Geometry/functional-geometry.asd") (asdf:oos 'asdf:load-op :functional-geometry) (functional-geometry::run-functional-geometry) Installation Notes for Implementations
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
81 ======================================
82
83 Notes about bugs or gotchas in specific Common Lisp implementations
84 appear in the release notes found in the ReleaseNotes directory.
85
86 Franz Allegro Common Lisp
87 =========================
88
89 McCLIM has been tested with the ANSI Common Lisp image alisp. It
90 doesn't currently work in with "modern Lisp" but support is on the way.
91
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
92
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
93 OpenMCL
94 =======
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
95
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
96 McCLIM has been tested with openmcl-1.0. It is recommended that you
97 download CLX from ftp://clozure.com/pub/CLX.
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
98
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
99 An experimental Cocoa backend for McCLIM, called Beagle, is included
100 in Backends/beagle.
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
101
102
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
103 CLISP
104 =====
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
105
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
106 1. Get clisp-20041218 or newer. Build it with option --with-module=clx/mit-clx.
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
107
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
108 2. Get a copy of the ASDF package. Compile it:
109 $ clisp -c $ASDF/asdf.lisp
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
110
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
111 3. Start
112 $ clisp -K full -i $ASDF/asdf.fas
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
113
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
114 and continue as above.
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
115
116
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
117 CMUCL
118 =====
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
119
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
120 McCLIM has been tested with version 19.c.
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
121
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
122 SBCL
123 ====
1663fad copied INSTALL.CMU and updated for ACL
Mike McDonald authored Oct 25, 2001
124
5ed5a64 Updated instructions to refer only to asdf method
Timothy Moore authored Mar 23, 2006
125 McCLIM has been tested with version 0.9.8 and later.
Something went wrong with that request. Please try again.