/[cmucl]/src/clx/README
ViewVC logotype

Contents of /src/clx/README

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.5 - (hide annotations)
Thu Jun 11 16:03:56 2009 UTC (4 years, 10 months ago) by rtoy
Branch: MAIN
CVS Tags: merged-unicode-utf16-extfmt-2009-06-11, portable-clx-base
Branch point for: portable-clx-branch
Changes since 1.4: +2 -2 lines
Merge Unicode work to trunk.  From label
unicode-utf16-extfmt-2009-06-11.
1 rtoy 1.5 $Id: README,v 1.4 2007-08-21 15:49:27 fgilham Exp $
2 fgilham 1.4 This directory contains CLX, an X11 client library for Common
3     Lisp. The code was originally taken from a CMUCL distribution, was
4     modified somewhat in order to make it compile and run under SBCL, then
5     a selection of patches were added from other CLXes around the net.
6 ram 1.1
7 fgilham 1.4 = Features
8 ram 1.1
9 fgilham 1.4 - SHAPE extension support (Gilbert Baumann)
10     - XFREE86-VIDMODE extension support (Iban Hatchondo)
11     - experimental RENDER extension support
12     (Gilbert Baumann and Christian Sunesson)
13     - X authority support that works with ssh forwarding (Eric Marsden via CMUCL)
14     - OPEN-DEFAULT-DISPLAY function which, as the name suggests, does that (dan)
15     - various bug fixes (Iban Hatchondo and a cast of several)
16     - a manual in texinfo format (Shawn Betts, Gilbert Baumann)
17 ram 1.1
18 fgilham 1.4 = Compatibility
19 ram 1.1
20 fgilham 1.4 This CLX distribution is intended to work under the latest released
21     version of SBCL - please report the bug if it doesn't. It should
22     usually also work with earlier versions back to 0.9.0, and possibly
23     earlier still, but may need manual adjustment to the clx.asd file (to
24     remove use of newly-introduced features).
25 ram 1.1
26 fgilham 1.4 It has also been used as a basis for CLX ports on other Lisp
27     implementations, but these instructions are only good for SBCL. If
28     you're running something else, you need to know (a) that it builds
29     with asdf (and asdf-install, if the planets are in alignment) and
30     (b) what asdf is anyway. http://www.weitz.de/asdf-install/ might help
31     you there. If you've installed this using some non-SBCL Lisp, please
32     send mail describing the process so that future versions can incorporate
33     your instructions.
34 ram 1.1
35 fgilham 1.4 If you are following SBCL CVS and this CLX does not run in it, please
36     check the darcs repositor{y,ies} for this CLX distribution to see if
37     your bug has been fixed already.
38 ram 1.1
39 fgilham 1.4 darcs get http://verisons.telent.net/clx # version from which releases are made
40     http://common-lisp.net/~crhodes/clx # patches merged by Christophe
41 rtoy 1.5 http://monday-monkey.com/repos/clx/ # OpenMCL tree by Bryan O'Connor?
42 ram 1.1
43 fgilham 1.4 = Building using asdf-install
44 ram 1.1
45 fgilham 1.4 * (require 'asdf)
46     * (require 'asdf-install)
47     * (asdf-install:install 'clx) ; download and install automatically, or
48     * (asdf-install:install "clx-x.y.z.tar.gz") ; if you've downloaded already
49 ram 1.1
50 fgilham 1.4 = Building by hand
51 ram 1.1
52 fgilham 1.4 If you don't trust asdf-install, here's how to do it manually -
53 ram 1.1
54 fgilham 1.4 1. Untar this tree somewhere
55 ram 1.1
56 fgilham 1.4 2. Add a symlink to clx.asd from one of the directories listed in your
57     asdf:*central-registry*
58 ram 1.1
59 fgilham 1.4 If that makes no sense to you yet, choose one of -
60 ram 1.1
61 fgilham 1.4 2a. personal installation:
62 ram 1.1
63 fgilham 1.4 $ cd $HOME/.sbcl/systems # you may have to create this directory
64     $ ln -s /path/to/clx/source/clx.asd .
65 ram 1.1
66 fgilham 1.4 2b. systemwide installations: you need to ask SBCL where it lives
67 ram 1.1
68 fgilham 1.4 $ sbcl --noinform --eval '(format t "~A~%" (posix-getenv "SBCL_HOME"))' </dev/null
69     /usr/local/lib/sbcl/
70     *
71     $ cd /usr/local/lib/sbcl/site-systems
72     $ ln -s /path/to/clx/source/clx.asd .
73 ram 1.1
74 fgilham 1.4 3.
75     * (require 'asdf)
76     * (require 'clx)
77 ram 1.1
78 fgilham 1.4 This will load all the files, after compiling anything that needs compiling
79    
80     4. To test CLX (and get a small amount of Lisp advocacy), try loading
81     the file "demo/menu", and then executing the function
82     xlib::just-say-lisp.
83    
84     * (load "clx/demo/menu")
85     * (xlib::just-say-lisp)
86    
87     5. If you're new to Lisp, be advised that despite the examples in
88     demo/, it's generally /not/ considered good style to switch to the
89     :xlib package and write your code in it. Spend some time with a
90     language reference to familiarize yourself with USE-PACKAGE, or
91     better yet, the USE option to DEFPACKAGE.
92    
93    
94     = Known problems:
95    
96     (none reported)
97    
98    
99     = Bug reports, new features, patches
100    
101     Please send bug reports to the portable-clx list:
102    
103     http://lists.metacircles.com/cgi-bin/mailman/listinfo/portable-clx
104    
105     Note that your post will be held for approval if you are not subscribed.
106    
107    
108     -dan
109    
110     --
111     Heavy lifting by <Raymond.Wiker at fast.no>
112     ASDFized version and ongoing by Daniel Barlow <dan at metacircles.com>
113     and (mostly, these days) Christophe Rhodes <csr21 at cam.ac.uk>

  ViewVC Help
Powered by ViewVC 1.1.5