Fix merging of ~/ pathnames.
[sbcl.git] / contrib / README
1 This directory is for extensions to SBCL. They aren't necessary for
2 core SBCL functionality, or else they'd be built into the main SBCL
3 binary automatically. And they're not portable Common Lisp, or they'd
4 be put elsewhere (see http://sbcl.sf.net/libs.php for pointers)
5
6 There are two kinds of contrib module in this directory:
7
8   * Newer contrib modules conform to the contrib standard (see 
9     STANDARDS) and are automatically built and installed along with
10     SBCL itself.  Each of these is in its own subdirectory with a
11     Makefile, and can be loaded with REQUIRE.
12
13   * Older standalone files in the contrib directory itself are
14     effectively unpackaged and may or may not work with the current
15     SBCL version.
16
17 Some good candidates for future extensions here are:
18   * bindings to existing foreign libraries (e.g. to a regexp library
19     like PCRE, or to a compression library like zlib, or to a graphics
20     library like Tk)
21   * new libraries (e.g. a CORBA interface)
22   * low-level hooks into SBCL needed to interface it to some wrapper
23     system (e.g. to interface to a graphical debugger of some sort)
24   * a too-alpha-to-be-supported-yet tree shaker
25
26 SBCL extensions of less general interest, e.g. a binding to the C
27 interface of the Oracle RDBMS, or particularly large extensions, e.g.
28 big graphics frameworks, can also be associated with the SBCL project,
29 but instead of being included in this directory as part of the
30 distribution, they will be made available or linked to on the SBCL
31 project web site.