/[cmucl]/src/general-info/README
ViewVC logotype

Contents of /src/general-info/README

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (show annotations)
Tue Nov 15 15:01:11 2005 UTC (8 years, 5 months ago) by rtoy
Branch: MAIN
CVS Tags: sparc-tramp-assem-base, double-double-array-base, post-merge-intl-branch, merged-unicode-utf16-extfmt-2009-06-11, double-double-init-sparc-2, unicode-utf16-extfmt-2009-03-27, double-double-base, snapshot-2007-09, snapshot-2007-08, snapshot-2008-08, snapshot-2008-09, sse2-packed-2008-11-12, snapshot-2008-05, snapshot-2008-06, snapshot-2008-07, snapshot-2007-05, snapshot-2008-01, snapshot-2008-02, snapshot-2008-03, intl-branch-working-2010-02-19-1000, snapshot-2006-11, snapshot-2006-10, double-double-init-sparc, snapshot-2006-12, unicode-string-buffer-impl-base, sse2-base, release-20b-pre1, release-20b-pre2, unicode-string-buffer-base, sse2-packed-base, sparc-tramp-assem-2010-07-19, amd64-dd-start, release-19f-pre1, snapshot-2008-12, snapshot-2008-11, intl-2-branch-base, snapshot-2007-01, snapshot-2007-02, release-19e, release-19d, GIT-CONVERSION, double-double-init-ppc, unicode-utf16-sync-2008-12, cross-sol-x86-merged, label-2009-03-16, release-19f-base, merge-sse2-packed, merge-with-19f, intl-branch-working-2010-02-11-1000, unicode-snapshot-2009-05, unicode-snapshot-2009-06, double-double-init-%make-sparc, unicode-utf16-sync-2008-07, unicode-utf16-sync-2008-09, unicode-utf16-extfmts-sync-2008-12, RELEASE_20b, snapshot-2008-04, unicode-utf16-sync-label-2009-03-16, RELEASE_19f, snapshot-2007-03, release-20a-base, cross-sol-x86-base, unicode-utf16-char-support-2009-03-26, unicode-utf16-char-support-2009-03-25, unicode-utf16-extfmts-pre-sync-2008-11, snapshot-2008-10, snapshot-2007-04, snapshot-2010-12, snapshot-2010-11, unicode-utf16-sync-2008-11, snapshot-2007-07, snapshot-2011-09, snapshot-2011-06, snapshot-2011-07, snapshot-2011-04, snapshot-2007-06, snapshot-2011-02, snapshot-2011-03, snapshot-2011-01, pre-merge-intl-branch, double-double-array-checkpoint, double-double-reader-checkpoint-1, release-19d-base, release-19e-pre1, double-double-irrat-end, release-19e-pre2, snapshot-2010-05, snapshot-2010-04, snapshot-2010-07, snapshot-2010-06, snapshot-2010-01, snapshot-2010-03, snapshot-2010-02, release-19d-pre2, release-19d-pre1, snapshot-2010-08, double-double-init-checkpoint-1, double-double-reader-base, label-2009-03-25, cross-sol-x86-2010-12-20, double-double-init-x86, sse2-checkpoint-2008-10-01, intl-branch-2010-03-18-1300, double-double-sparc-checkpoint-1, sse2-merge-with-2008-11, sse2-merge-with-2008-10, RELEASE_20a, snapshot-2005-12, release-20a-pre1, snapshot-2009-11, snapshot-2009-12, unicode-utf16-extfmt-2009-06-11, portable-clx-import-2009-06-16, unicode-utf16-string-support, cross-sparc-branch-base, release-19e-base, intl-branch-base, double-double-irrat-start, unicode-utf16-base, portable-clx-base, snapshot-2009-08, snapshot-2007-12, snapshot-2007-10, snapshot-2007-11, snapshot-2009-02, snapshot-2009-01, snapshot-2009-07, snapshot-2009-05, snapshot-2009-04, snapshot-2006-02, snapshot-2006-03, snapshot-2006-01, snapshot-2006-06, snapshot-2006-07, snapshot-2006-04, snapshot-2006-05, pre-telent-clx, snapshot-2006-08, snapshot-2006-09, HEAD
Branch point for: double-double-reader-branch, double-double-array-branch, RELEASE-19F-BRANCH, portable-clx-branch, cross-sparc-branch, RELEASE-20B-BRANCH, unicode-string-buffer-branch, sparc-tramp-assem-branch, release-19d-branch, sse2-packed-branch, RELEASE-20A-BRANCH, amd64-dd-branch, double-double-branch, unicode-string-buffer-impl-branch, intl-branch, unicode-utf16-branch, cross-sol-x86-branch, release-19e-branch, sse2-branch, intl-2-branch, unicode-utf16-extfmt-branch
Changes since 1.2: +20 -33 lines
Merge changes from the 19c branch.
1 ================ C M U C L =============================================
2
3 CMUCL is a free, high performance implementation of the Common Lisp
4 programming language which runs on most major Unix platforms. It
5 mainly conforms to the ANSI Common Lisp standard. CMUCL provides a
6 sophisticated native code compiler; a powerful foreign function
7 interface; an implementation of CLOS; the Common Lisp Object System;
8 which includes multimethods; a metaobject protocol; a source-level
9 debugger and code profiler; and an Emacs-like editor implemented in
10 Common Lisp. CMUCL is maintained by a team of volunteers collaborating
11 over the Internet, and is mostly in the public domain.
12
13
14 === Installation instructions ==========================================
15
16 For each supported platform (see below for platform-specific
17 information) there are two gzipped tar archives, one containing the
18 base system, and the other (with extra in the name) containing
19 optional additional files supporting CLX, Hemlock, the Motif
20 interface, and so on. Alternatively, you can download the slightly
21 smaller bzipped archives (with the .bz2 filename extension), which
22 contain the same data but were compressed using the bzip2 program.
23
24 Download the archives corresponding to your platform. You can check
25 the integrity of the files you have downloaded by comparing the
26 output of md5sum <filename> with that given in the file md5sums.txt.
27
28 The release tarballs extract to the following directory structure:
29
30 bin/lisp
31 lib/cmucl/lib/lisp.core
32 doc/cmucl/README (this file)
33 man/man1/cmucl.1
34 ...
35
36 This allows you to install CMUCL directly under /usr/local, for
37 example using
38
39 cd /usr/local
40 tar xzf /path/to/cmucl-<ver>-<platform>.tar.gz
41
42 or alternatively, install under a directory in /opt, for example
43
44 mkdir /opt/cmucl-<ver>
45 cd /opt/cmucl-<ver>
46 tar xzf /path/to/cmucl-<ver>-<platform>.tar.gz
47
48 You can now invoke CMUCL: this should display a banner then show a
49 prompt (the default prompt is an asterisk).
50
51 % lisp
52 CMU Common Lisp 19c, running on orion
53 With core: /prj/cmucl/release-19c/linux/lisp/lisp.core
54 Dumped on: Thu, 2003-04-03 15:47:12+02:00 on orion
55 See <http://www.cons.org/cmucl/> for support information.
56 Loaded subsystems:
57 Python 1.1, target Intel x86
58 CLOS based on Gerd's PCL 2004/04/14 03:32:47
59 * (format t "~&Hello, world!~%")
60 Hello, world!
61 NIL
62 *
63
64 To load precompiled subsystems (assuming that you installed the
65 -extra- tarball), just use REQUIRE:
66
67 * (require :gray-streams)
68 * (require :simple-streams)
69 * (require :clx)
70 * (require :clm)
71 * (require :hemlock)
72
73 You may wish to edit your site initialization file (in
74 /usr/local/lib/cmucl/site-init.lisp).
75
76 === Platform-specific notes ============================================
77
78 +++ Solaris/SPARC
79 The release binaries are known to work with SunOS 5.7 and 5.8
80 (also known respectively as Solaris 7 and Solaris 8), and should
81 work on any later versions.
82
83 Currently, only UltraSPARC binaries are provided, so you need an
84 UltraSPARC machine. For older machines, you will need a special
85 build. Please ask on the mailing lists if such builds are available.
86
87 If you have an UltraSPARC the command uname -m will say sun4u, if you
88 have an older machine such as a SparcStation it will probably say sun4m.
89 If it says sun4c, sun4d or only sun4, you have a machine with only a
90 SPARC-v7 implementation, and thus will need custom-built binaries.
91
92
93 +++ Linux/x86
94 The release binaries should work with any Pentium or better processor.
95 The binaries were built against version 2.1 of the GNU C library
96 (glibc2.1), but should run on systems using version 2.2. They should
97 run with any Linux kernel after 2.0 (but beware early kernels in the
98 2.4 series, which had poor virtual memory characteristics). There
99 are known problems running CMUCL on kernels using some of the
100 "highmem" patches: in particular the CONFIG_2GB patch seems to
101 conflict with the memory map used by the release binaries. The
102 CONFIG_1GB and CONFIG_64GB options work fine.
103
104 CMUCL is known not to run under libsafe, whose system call
105 interposition mechanism interferes with the foreign function
106 interface.
107
108
109 +++ FreeBSD/x86
110 The release binaries should work with any Pentium or better processor.
111 The binaries were built on FreeBSD 4.7, but should run on any of the
112 4.x releases.
113
114
115 +++ Mac OS X/ppc
116 The release binaries are built on a Mac OS X 10.4.x system. They
117 are also known to work on 10.3.x. They may not work on 10.2.x.
118 The binaries should work on any Power PC system, including G3, G4,
119 and G5's.
120
121
122 +++ Other platforms
123 Binaries for other platforms supported by 19c sources might be made
124 available by contributors at later dates, the details of which were
125 not available at release time. Please see the README file
126 distributed with those binaries for details on platform-specific
127 notes for those platforms.
128
129
130
131 === Further information ================================================
132
133 The best source for information on CMUCL is the web site,
134 <URL:http://www.cons.org/cmucl/>. You will find pointers to
135 documentation and tips on using CMUCL, and information regarding
136 mailing lists and bug reporting.
137
138 Enjoy using CMUCL!
139
140
141 2005-11-15

  ViewVC Help
Powered by ViewVC 1.1.5