/[cmucl]/src/general-info/cmu-README.txt
ViewVC logotype

Contents of /src/general-info/cmu-README.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (show annotations)
Fri Nov 19 00:58:51 1993 UTC (20 years, 5 months ago) by ram
Branch: MAIN
CVS Tags: sparc-tramp-assem-base, double-double-array-base, post-merge-intl-branch, release-19b-pre1, release-19b-pre2, 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, ppc_gencgc_snap_2006-01-06, 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, snapshot-2003-10, snapshot-2004-10, release-18e-base, release-19f-pre1, snapshot-2008-12, snapshot-2008-11, intl-2-branch-base, snapshot-2004-08, snapshot-2004-09, remove_negative_zero_not_zero, snapshot-2007-01, snapshot-2007-02, snapshot-2004-05, snapshot-2004-06, snapshot-2004-07, release-19e, release-19d, GIT-CONVERSION, double-double-init-ppc, release-19c, dynamic-extent-base, unicode-utf16-sync-2008-12, LINKAGE_TABLE, release-19c-base, cross-sol-x86-merged, label-2009-03-16, release-19f-base, PRE_LINKAGE_TABLE, merge-sse2-packed, mod-arith-base, sparc_gencgc_merge, merge-with-19f, snapshot-2004-12, snapshot-2004-11, intl-branch-working-2010-02-11-1000, unicode-snapshot-2009-05, unicode-snapshot-2009-06, amd64-merge-start, ppc_gencgc_snap_2005-12-17, double-double-init-%make-sparc, unicode-utf16-sync-2008-07, release-18e-pre2, unicode-utf16-sync-2008-09, unicode-utf16-extfmts-sync-2008-12, prm-before-macosx-merge-tag, cold-pcl-base, RELEASE_20b, snapshot-2008-04, snapshot-2003-11, snapshot-2005-07, 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, release-19a-base, unicode-utf16-extfmts-pre-sync-2008-11, snapshot-2008-10, sparc_gencgc, 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, snapshot-2003-12, release-19a-pre1, release-19a-pre3, release-19a-pre2, pre-merge-intl-branch, release-19a, UNICODE-BASE, 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, release-18e, double-double-init-checkpoint-1, double-double-reader-base, label-2009-03-25, snapshot-2005-03, release-19b-base, cross-sol-x86-2010-12-20, double-double-init-x86, sse2-checkpoint-2008-10-01, intl-branch-2010-03-18-1300, snapshot-2005-11, double-double-sparc-checkpoint-1, snapshot-2004-04, sse2-merge-with-2008-11, sse2-merge-with-2008-10, snapshot-2005-10, RELEASE_20a, snapshot-2005-12, release-20a-pre1, snapshot-2005-01, snapshot-2009-11, snapshot-2009-12, unicode-utf16-extfmt-2009-06-11, portable-clx-import-2009-06-16, unicode-utf16-string-support, release-19c-pre1, cross-sparc-branch-base, release-19e-base, intl-branch-base, double-double-irrat-start, snapshot-2005-06, snapshot-2005-05, snapshot-2005-04, ppc_gencgc_snap_2005-05-14, snapshot-2005-02, unicode-utf16-base, portable-clx-base, snapshot-2005-09, snapshot-2005-08, lisp-executable-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, release-18e-pre1, 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: release-19b-branch, double-double-reader-branch, double-double-array-branch, mod-arith-branch, RELEASE-19F-BRANCH, portable-clx-branch, sparc_gencgc_branch, cross-sparc-branch, RELEASE-20B-BRANCH, unicode-string-buffer-branch, sparc-tramp-assem-branch, dynamic-extent, UNICODE-BRANCH, release-19d-branch, ppc_gencgc_branch, sse2-packed-branch, lisp-executable, RELEASE-20A-BRANCH, amd64-dd-branch, double-double-branch, unicode-string-buffer-impl-branch, intl-branch, release-18e-branch, cold-pcl, unicode-utf16-branch, cross-sol-x86-branch, release-19e-branch, sse2-branch, release-19a-branch, release-19c-branch, intl-2-branch, unicode-utf16-extfmt-branch
Changes since 1.2: +115 -13 lines
File MIME type: text/plain
Updated somewhat for non-Mach environments.
1 CMU Common Lisp is a public domain implementation of Common Lisp. Both
2 sources and executables are freely available via anonymous FTP; this software
3 is "as is", and has no warranty of any kind. CMU and the authors assume no
4 responsibility for the consequences of any use of this software. See
5 doc/release-notes.txt for a description of the state of the release you have.
6
7 CMU Common Lisp is available for:
8 HPPA "snake" workstations running HPUx 9.X
9 Sun SPARC workstations running SunOS (but not Solaris)
10 DECstations (pmaxes) running Mach.
11
12 There are also frozen versions for Mach on the SPARC and IBM RT.
13
14 To get CMU Common Lisp on facilities Mach machines, run:
15 /usr/cs/etc/modmisc -release beta - cs.misc.cmucl
16
17 This establishes /usr/misc/.cmucl as a symbolic link to the release area.
18 In your .login, add CMU CL to your path:
19 setpath -i /usr/misc/.cmucl
20
21 Then run "lisp". Note that the first time you run Lisp, it will take AFS
22 several minutes to copy the image into its local cache. Subsequent starts
23 will be much faster.
24
25 Instead of using modmisc, you can create the symbolic links by hand, or run out
26 of the AFS release area. This method of installation is necessary on HPUx and
27 SunOS machines. Put this in your .login shell script:
28 setenv CMUCLLIB "/afs/cs/misc/cmucl/@sys/beta/lib"
29 setpath -i /afs/cs/misc/cmucl/@sys/beta
30
31 After setting your path, "man cmucl" will give an introduction to CMU CL and
32 "man lisp" will describe command line options.
33
34 See /usr/misc/.cmucl/doc for release notes and documentation. Rather old
35 hardcopy documentation is available as tech reports in the document room.
36
37 Send bug reports and questions to cmucl-bugs@cs.cmu.edu. If you send a bug
38 report to gripe, they will just forward it to this mailing list.
39
40 See "man cmucl" (man/man1/cmucl.1) for other general information.
41
42 SunOS credit:
43
44 The SunOS support was written by Miles Bader and Ted Dunning.
45
46 Site initialization:
47
48 To run CMU CL, place bin/ in PATH and setenv CMUCLLIB to point to lib/. The
49 file lib/site-init.lisp contains site-specific initialization, such as setting
50 of the site name. Any site-specific initialization should be placed in this
51 file; this file can be compiled. See bin/sample-wrapper for a shell script
52 template that sets up environment variables and then runs CMU CL. You may
53 want to have your EMACS maintainer place doc/cmu-user.info in the info root, or
54 you can setenv INFOPATH to include the doc/ directory.
55
56 Note: In order to use Motif (and the graphical debugger) with X servers from
57 non-OSF vendors (like Sun) you may need to set the environment variable
58 XKEYSYMDB to point to the file lib/XKeySymDB. Otherwise, you will get many
59 error messages every time a new connection is opened to the CMU CL motifd.
60 This file is read by the X11R5 Xt in order to augment the keysym database with
61 certain OSF vendor keysyms that Motif wants to use. If you get errors about
62 being unable to start the Motif server, try setting DISPLAY to the full
63 hostname, like:
64 lisp-rt1.slisp.cs.cmu.edu:0
65
66 and delete any .motif-socket-* files in /tmp.
67
68 SunOS/SPARC Notes:
69
70 With this release, CMU CL should require no special effort to run on Sparc10's
71 under SunOS. Solaris is still not supported.
72
73 At least 16 meg of memory is recommended, and more is better. Your system
74 maintainer may need to configure extra paging space for large Lisp application.
75
76 It is not possible to mmap a file in a tmpfs filesystem. If /tmp is a "tmpfs"
77 filesystem, then you must setenv CMUCL_EMPTYFILE to the pathname of some file
78 (in a normal filesystem) that can be used instead of /tmp/empty. The "df"
79 command will show tmpfs filesystems as mounted on "swap". If this problem
80 exists on your system, lisp will get an error like:
81 mapin: mmap: Invalid argument
82 ensure_space: Failed to validate 67108864 bytes at 0x01000000
83
84
85 Running CMU CL:
86
87 Run "lisp". If Hemlock is loaded, you can also "lisp -edit". Hemlock will
88 use X if the DISPLAY environment variable is defined, otherwise it will use
89 terminal i/o based on TERM and /etc/termcap. If the Motif debugger is loaded,
90 it will be invoked on errors and by INSPECT.
91
92 Source availability:
93
94 Lisp and documentation sources are available via anonymous FTP ftp to any CMU
95 CS machine. [See the "Distribution" section for FTP instructions.] All CMU
96 written code is public domain, but CMU CL also makes use of two imported
97 packages: PCL and CLX. Although these packages are copyrighted, they may be
98 freely distributed without any licensing agreement or fee.
99
100 The release area contains a source distribution, which is an image of all the
101 ".lisp" source files used to build version 17c:
102 17c-source.tar.Z (4.9 meg)
103
104 All of our files (including the release area) are actually in the AFS file
105 system. On the release machines, the FTP server's home is the release
106 directory: /afs/cs.cmu.edu/project/clisp/release. The actual working source
107 areas are in other subdirectories of "clisp", and you can directly "cd" to
108 those directories if you know the name. Due to the way anonymous FTP
109 access control is done, it is important to "cd" to the source directory with a
110 single command, and then do a "get" operation.
111
112 Totally machine-independent compiler code:
113 /afs/cs/project/clisp/src/beta/compiler/*.lisp
114 See especially node.lisp and ir1tran.lisp for the front end. vop.lisp,
115 vmdef.lisp and ir2tran.lisp for the back end.
116
117 Stuff that is dependent on our choice of object format, but not
118 particularly machine-dependent:
119 /afs/cs/project/clisp/src/beta/compiler/generic/*.lisp
120
121 Compiler back-end for the PMAX and SPARC:
122 /afs/cs/project/clisp/src/beta/compiler/mips/*.lisp
123 /afs/cs/project/clisp/src/beta/compiler/sparc/*.lisp
124
125 Miscellaneous Lisp run-time code:
126 /afs/cs/project/clisp/src/beta/code/*.lisp
127
128 C run-time code:
129 /afs/cs/project/clisp/src/beta/lisp/*
130
131 A very drafty version of an internal design document: (160 pages) Some of
132 the "tex" files may be more humanly readable, since many formatting
133 commands need to be added. There is some inaccurate (dated) material in
134 the compiler description.
135 /afs/cs/project/clisp/hackers/ram/docs/internals/*.tex
136 /afs/cs/project/clisp/hackers/ram/docs/internals/design.ps
137
138 See hackers/ram/docs/internals/architecture.tex (the System Architecture
139 chapter in the internals document) for more information on the source tree
140 organization.

  ViewVC Help
Powered by ViewVC 1.1.5