README 2.27 KB
Newer Older
1
2
3
This directory contains CLX, an X11 client library for Common
Lisp. The code was originally taken from a CMUCL distribution, was
modified somewhat in order to make it compile and run under SBCL, then
4
a selection of patches were added from other CLXes around the net.
5

6
= Features
7

8
9
10
 - SHAPE extension support (Gilbert Baumann)
 - X authority support that works with ssh forwarding (Eric Marsden via CMUCL)
 - OPEN-DEFAULT-DISPLAY function, as the name suggests, does that (dan)
11
 - various bug fixes (Iban Hatchondo and a cast of several)
dan's avatar
dan committed
12

13
= Building
dan's avatar
dan committed
14

15
0. You need SBCL 0.7.13 or any later release
dan's avatar
dan committed
16

17
1. Untar this tree somewhere
dan's avatar
dan committed
18

19
2. Add a symlink to clx.asd from one of the directories listed in your
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
   asdf:*central-registry*

   If that makes no sense to you yet, choose one of -

   2a. personal installation:

     $ cd $HOME/.sbcl/systems # you may have to create this directory
     $ ln -s /path/to/clx/source/clx.asd .

   2b. systemwide installations: you need to ask SBCL where it lives

     $ sbcl --noinform --eval '(format t "~A~%" (posix-getenv "SBCL_HOME"))' </dev/null
     /usr/local/lib/sbcl/
     * 
     $ cd /usr/local/lib/sbcl/site-systems
     $ ln -s /path/to/clx/source/clx.asd .
dan's avatar
dan committed
36

37
38
39
3. 
   * (require 'asdf)
   * (require 'clx)
dan's avatar
dan committed
40

41
This will load all the files, after compiling anything that needs compiling
dan's avatar
dan committed
42

43
44
45
4. To test CLX (and get a small amount of Lisp advocacy), try loading
the file "demo/menu", and then executing the function
xlib::just-say-lisp.
dan's avatar
dan committed
46

47
48
   * (load "clx/demo/menu")
   * (xlib::just-say-lisp)
dan's avatar
dan committed
49

50
51
52
53
54
5. If you're new to Lisp, be advised that despite the examples in
demo/, it's generally /not/ considered good style to switch to the
:xlib package and write your code in it.  Spend some time with a
language reference to familiarize yourself with USE-PACKAGE, or 
better yet, the USE option to DEFPACKAGE
dan's avatar
dan committed
55
56


57
= Known problems:
dan's avatar
dan committed
58

dan's avatar
dan committed
59
(none reported)
dan's avatar
dan committed
60

61
62
 
= Bug reports, new features, patches
dan's avatar
dan committed
63

64
65
66
The best place to send bug reports, especially if you can verify that
some other CLX port (e.g. CMUCL's) also has the problem, is to the
portable-clx-devel list
dan's avatar
dan committed
67

68
http://clozure.com/cgi-bin/mailman/listinfo/portable-clx-devel
dan's avatar
dan committed
69

70
For packaging or SBCL-specific problems, mail dan at metacircles.com
dan's avatar
dan committed
71
72


73
-dan
dan's avatar
dan committed
74

75
76
-- 
Heavy lifting by Raymond.Wiker@fast.no
77
ASDFized version and ongoing by Daniel Barlow <dan@metacircles.com>