[web page david@lichteblau.com**20070624135757] { adddir ./doc addfile ./doc/GNUmakefile hunk ./doc/GNUmakefile 1 +all: index.html + +index.html: index.xml index.xsl + xsltproc index.xsl $< >index.html addfile ./doc/index.css hunk ./doc/index.css 1 +a { + text-decoration: none; + color: black; + border-bottom: 1px solid #777777; +} + +a:hover { + color: #777777; + border-bottom: 1px solid #aaaaaa; +} + +body { + color: #000000; + background-color: #ffffff; + margin-top: 2em; + margin-right: 0pt; + margin-bottom: 10%; + font-family: verdana, arial; +} + +.main { + margin-top: 20px; + margin-left: 40px; + padding-left: 30px; +} + +h1,h2,h3 { + color: #55a6e0; + margin-top: 2em; + margin-left: -30px; +} + +.def { + border-bottom: 1px solid black; + padding: 1px 1px 1px 1px; + margin-bottom: 1px; + font-weight: bold; + margin-right: 40px; +} + +.def:hover { + background-color: #55e0a6; +} + +.def a { + text-decoration: none; + color: #000000; + border-bottom: 0px solid white; + border-top: 0px solid white; + border-left: 0px solid white; + border-right: 0px solid white; +} + +.def a:hover { + background-color: #55e0a6; + color: #000000; + text-decoration: none; + border-bottom: 0px solid white; + border-top: 0px solid white; + border-left: 0px solid white; + border-right: 0px solid white; +} + +.nomargin { + margin-bottom: 0; + margin-top: 0; +} + +.noindent { + margin-left: -30px; +} + +#header { + padding-bottom: 1px; + border-bottom: 1px solid black; + font-family: verdana, arial; + font-size: 15pt; +} + +pre { + background-color: #eeeeee; + border: solid 1px #d0d0d0; + padding: 1em; +} addfile ./doc/index.xml hunk ./doc/index.xml 1 + +

+ A script to update/install the latest versions of all the most + important Common Lisp packages. +

+ +

About

+ +

+ clbuild is a shell script helping with the download, compilation, an + invocation of Common Lisp applications. It defaults to SBCL but + otherwise tries to be somewhat independent of your local + environment. +

+ +

+ clbuild was originally written by Luke Gorrie. + (Idea from jhbuild by James Henstridge, a Gnome hacker). +

+ +

+ Currently, the following libraries and applications are supported + (2007-06-24): +

+
+ beirc, clx, salza, bordeaux-threads, cxml, skippy, cffi, + flexi-streams, slime, cl-fad, flexichain, spatial-trees, cl-irc, + graphic-forms, split-sequence, cl-ppcre, gsharp, tab-layout, + climacs, lw-compat, trivial-gray-streams, climplayer, mcclim, + trivial-sockets, closer-mop, midi, usocket, closure, puri, zip +
+ +

+ Please send patches bug reports + to + clbuild-devel@common-lisp.net + (list information). +

+ +

FAQ

+ +

+ Q  How does clbuild differ from asdf-install? +

+

+ A  clbuild includes a list of selected libraries + and applications and their well-known locations, and + downloads the newest version or CVS/SVN/darcs repositories if + possible. It can also build SBCL for you and includes convenient + commands to start various applications. +

+

+ In contrast, asdf-install can install any software + listed on Cliki. It always downloads release tarballs. (It + is up to the user to hunt down the trustworthy PGP keys as a + protection agains malicous wiki entries.) +

+ +

+

+ Q  My favourite application is not supported. How can I + add it? +
+
+ A  Just add it to clbuild/update.sh. Please + send a note to the mailing list so that we can include it, too. +
+

+ +

+

+ Q  Does it work on cygwin? +
+
+ A  Yes, but you need to recompile SBCL with + an ASDF + patch for shortcut support first. +
+

+

+ To starts clbuild's slime, make sure to use the Windows version of + Emacs, not cygwin's Emacs. +

+ + +

Download and Usage

+ +

+ At this point, clbuild is maintained in darcs. There are several + branches of clbuild, the most recent of which is probably David's: +

+
$ darcs get http://www.lichteblau.com/blubba/clbuild
+

+ Other repositories are Christophe's + tree at http://common-lisp.net/~crhodes/clbuild and Luke's + original + repository at http://fresh.homeunix.net/~luke/misc/repo/clbuild +

+ +

You might want to make the shell script executable:

+
$ cd clbuild
+clbuild$ chmod +x chbuild
+ +

+ clbuild depends on various helper applications. + Try check to make sure they are installed: +

+
clbuild$ ./clbuild check
+Checking for helper applications...
+found /usr/bin/X11/cvs
+found /usr/bin/X11/svn
+found /usr/bin/X11/darcs
+found /usr/bin/X11/wget
+found /bin/tar
+found /bin/mktemp
+Success: All helper applications found.
+
+Checking Lisp startup...
+Success: Lisp starts up using "sbcl"
+
+Looking for installable systems...
+0 systems definition files registered
+ +

+ If that worked, run update or build to download + (and optionally also build) the userland: +

+
clbuild$ ./clbuild update
+cvs co flexichain...
+cvs co mcclim...
+... lots of output not shown ...
+update complete                                                   
+46 systems definition files registered
+ +

+ You can also download and recompile SBCL using buildsbcl + or buildworld: +

+
clbuild$ ./clbuild buildsbcl
+

+ For other options, see help: +

+
clbuild$ ./clbuild help
+Usage:
+  check         check availability of all necessary helper applications
+
+  update        download/update all applications
+  recompile     recompile all applications
+  build         update && recompile
+
+  buildsbcl     download/update and compile SBCL
+  world         buildsbcl && build
+
+  clean         delete all compiled object files
+  mrproper      delete all downloaded source and fasl files
+
+  slime         run the Superior Lisp Interaction Mode in a fresh Emacs
+  lisp          run Lisp in the terminal
+  sbcl          alias for "lisp" (with all packages available to REQUIRE)
+  openmcl       alias for "lisp"
+
+  listener      run the McCLIM listener
+  gsharp        run the Gsharp score editor 
+  climacs       run the Climacs text editor
+  closure       run the CLOSURE web browser
+                (required Debian packages: gif2png,libjpeg-progs)
+  beirc         run the Beirc IRC client
+  climplayer    run the CLIMPlayer music player
+                (required Debian packages: mplayer, fileschanged, fam)
+
+If you do 'world' or 'buildsbcl' then SBCL will be installed in
+target/ and used for future commands. If you don't run these commands
+(or you remove target/) then clbuild uses the 'sbcl' in your PATH.
+
+Set CCL to your OpenMCL binary to use OpenMCL instead of SBCL. 
+Example: CCL=~/ccl/lx86cl64 ./clbuild build
+(Not supported with targets 'buildsbcl' and 'sbcl'.)
+
+Set CLIM_BACKEND=gtkairo to enable clim-gtkairo instead of clim-clx.
+(Requires GTK+ >= 2.8.)
+
addfile ./doc/index.xsl hunk ./doc/index.xsl 1 + + + + + + + + + + + + + + clbuild + + + + + + + + + + + + +
+ +
+
+ + + + + + + + + + + + + + + + +
}