From 9085d90926f8be8d6bfc6189f1672e949292c5c5 Mon Sep 17 00:00:00 2001 From: ram <ram> Date: Fri, 11 Mar 1994 14:26:48 +0000 Subject: [PATCH] Update for 17e --- general-info/beta-release-notes.txt | 22 +++- general-info/net-README.txt | 181 ++++++++++++++++++++-------- 2 files changed, 148 insertions(+), 55 deletions(-) diff --git a/general-info/beta-release-notes.txt b/general-info/beta-release-notes.txt index aab86dc63..8186d88b7 100644 --- a/general-info/beta-release-notes.txt +++ b/general-info/beta-release-notes.txt @@ -1,7 +1,8 @@ Release notes for CMU Common Lisp 17e, 19 September 93 -17e is primarily a bug-fix release. This release also supports -Hewlett-Packard 700-series workstations running HP-UX version 9.x. +17e is primarily a bug-fix release. This release is also available on +Hewlett-Packard 700-series workstations running HP/UX version 9.x. +The main missing feature on HP/UX is LOAD-FOREIGN. BASIC COMMON LISP SUPPORT CODE: @@ -30,6 +31,9 @@ Enhancements: supply NIL for the package, meaning all packages. Bug fixes: + -- In SIGNAL, bind *break-on-signals* to NIL even before doing the type test + so that we don't wedge the error system if the type is malformed or + undefined. -- Fix arg ordering for GETF in new condition support. Default the name slot in DEFMACRO-LAMBDA-LIST-BIND-ERRORS to NIL (instead of leaving it unbound.) @@ -56,6 +60,7 @@ CLOS (PCL): -- Fix some problems with the LISP:CLASS class-precedence-list suddenly becoming empty when a class is redefined. -- Fixed SIMPLE-STRING to list STRING in the inherits list. + -- Fix to update-instance-for-different-class. COMPILER: @@ -70,6 +75,13 @@ Enhancements: interpreted code. Bug fixes: + -- Allow stream arg to compile-file. + -- Changed assert-definition-type to quietly ignore non function-types. + -- Allow stream arg to compile-file. + -- Deleted incorrect type declaration in process-1-ftype-proclamation. + Deleted test for function-type-p around call to assert-definition-type, + since this is now folded into the function. Previously several calls + weren't doing this necessary check. -- Fix a problem where spurious argument types could be inferred for optional arguments in byte-compiled code (caused yes-or-no-p to fail.) -- Fixed an internal error related to tail local calls. @@ -96,6 +108,7 @@ Misc extensions: Fixed PROFILE:REPORT-TIME to not choke if any of the function names are not symbols (e.g. setf functions). +[NOTE: Motif server doesn't work on HP yet.] Motif interface: -- Added an optional STYLE arg to the graphical inspector to make the function consistent with its doc string (as well as the old inspector). @@ -103,6 +116,11 @@ Motif interface: intelligible error message. -- Added some extra protection against recursive invocation of the windowing debugger. + -- Don't try to invoke motif debugger if we didn't succeed in opening a + connection. + -- Print warning in status hook when server dies. + -- Made server fflush after all output so that we see output when it is run + on a pipe. Hemlock: -- Add window-buffer-hook for echo area buffer to make absolutely sure we diff --git a/general-info/net-README.txt b/general-info/net-README.txt index f3a8a906a..9922ef238 100644 --- a/general-info/net-README.txt +++ b/general-info/net-README.txt @@ -26,26 +26,43 @@ EMAIL address.) When you log in, cd to /pub (a symbolic link to the CMU CL release area.) If you have any trouble with FTP access, please send mail to slisp@cs.cmu.edu. +The most recent version is: 17e +The old version is: 16f + +The currently supported platforms are: + sunos: + Sun SPARC machines running the the pre-Solaris BSD SunOS system, + version 4.x. + + hp700_ux90: + HP 700 series machines (based on the HPPA architecture) running HP/UX + 9.x. + The release area holds compressed tar files with names of the form: - <version>-<machine>_<os>.tar.Z - <version>-extra-<machine>_<os>.tar.Z + <version>-<platform>.tar.Z + <version>-extra-<platform>.tar.Z + <version>-runtime-<platform>.tar.Z + + -- The first file holds binaries and documentation for the standard Common + Lisp portion of CMU CL. This includes our version of the PCL + implementation of the CLOS object system. + -- The `-extra' file contains the Hemlock editor, the Motif toolkit, + the graphical debugger and the CLX interface to X11. + -- The `-runtime' file contins one file: lib/runtime.core, which is a + smaller substitute for lib/lisp.core. See the "runtime distribution" + section. + +The sizes of the configurations are approximately: + Basic: 15 megabytes + Basic+Extra: 24 megabytes + Runtime: 5.3 megabytes + +For installation directions, see the section "site initialization". FTP compressed tar archives in binary mode. To extract, "cd" to the directory that is to be the root of the tree, then type: uncompress <file.tar.Z | tar xf - . -As of 11/11/93, the latest SunOS Sparc release is: - 17c-sunos.tar.Z (6.6 meg) - 17c-extra-sunos.tar.Z (3.9 meg) -This version works with all the versions of SunOS we've tried it on, but does -*NOT* work under Solaris. - -The first file holds binaries and documentation for the basic Lisp system, -while the second `-extra' file contains the Hemlock editor, the Motif toolkit, -the graphical debugger and the CLX interface to X11. The basic configuration -takes 15 megabytes of disk space; adding the extras takes another 8 megabytes. -For installation directions, see the section "site initialization". - If poor network connections make it difficult to transfer a 7 meg file, the release is also available split into 2 megabyte chunks, suffixed `.0', `.1', etc. To extract from multiple files, use: @@ -55,9 +72,6 @@ The release area also contains source distributions and other binary distributions. A listing of the current contents of the release area is in FILES. Major release announcements will be made to comp.lang.lisp. -SunOS credit: - -The SunOS support was written by Miles Bader and Ted Dunning. Site initialization: @@ -77,18 +91,22 @@ library:lisp.core. To avoid overwriting the running Lisp image, any existing image is renamed to `lisp.core.BAK'; this file may be manually deleted to save disk space. +[NOTE: Motif server doesn't work on HP yet.] + Note: In order to use Motif (and the graphical debugger) with X servers from non-OSF vendors (like Sun) you may need to set the environment variable XKEYSYMDB to point to the file lib/XKeySymDB. Otherwise, you will get many error messages every time a new connection is opened to the CMU CL motifd. This file is read by the X11R5 Xt in order to augment the keysym database with -certain OSF vendor keysyms that Motif wants to use. If you get errors about -being unable to start the Motif server, try setting DISPLAY to the full -hostname, like: - lisp-rt1.slisp.cs.cmu.edu:0 - -and delete any .motif-socket-* files in /tmp. +certain OSF vendor keysyms that Motif wants to use. +If you get errors about being unable to start the Motif server, try: + -- Setting DISPLAY to the full hostname, like: + lisp-rt1.slisp.cs.cmu.edu:0 + -- Killing any motifd processes that didn't die when Lisp did. + -- Deleting any .motif-socket-* files in /tmp. + -- Make sure CMUCLLIB points to the lib/ directory, and that motifd is + in the lib/ directory. Installation example (assuming the distribution files are in the cwd): @@ -139,13 +157,51 @@ Use config to load optional subsystems: % +Runtime distributions: + +The <version>-runtime-<platform>.tar.Z distribution contains a small alternate +version of lib/lisp.core called lib/runtime.core. If you say: + lisp -core lib/runtime.core + +you'll get a Lisp process into which you can load a compiled CMU CL program. + +The runtime image does not contain PCL (CLOS), the compiler, or the full +Common Lisp eval. EVAL only supports function calls and the (non-lambda) +FUNCTION, QUOTE, PROGN, EVAL-WHEN and SETQ special forms. Macros are o.k. as +long as they expand into one of the supported forms. + +Additional compactness is gained by byte-compiling some language features that +are primarily used for development and debugging, like the reader. + +Probably the main use for the runtime image is to load in some large +application, saving the result with SAVE-LISP. This core image can then +replace lisp.core in distributions based on CMU CL. The SAVE-LISP +:INIT-FUNCTION argument can be used to replace the top-level Lisp prompt with +the function of your choice. + +Note that the size of the loaded application can be substantially reduced by +using non-default compilation policies, like: + (declaim (optimize (speed 3) (safety 0) (debug 0))) + +See the "CMU Common Lisp User's Manual" for more discussion of compilation +policy, byte compilation, etc. + +You can reduce the size of your distribution somewhat more by deleting the +doc/ directory containing the CMU CL documentation. Really, the entire tree +and CMUCLLIB environment variable are unnecessary. All you need is the "lisp" +executable and the core file, which can be started by using the -core option, +like in: + lisp -core my.core + + SunOS/SPARC Notes: With this release, CMU CL should require no special effort to run on Sparc10's -under SunOS. Solaris is still not supported. +under SunOS. Solaris >=2 is still not supported. At least 16 meg of memory is recommended, and more is better. Your system -maintainer may need to configure extra paging space for large Lisp application. +maintainer may need to configure extra paging space for large Lisp +applications. It is not possible to mmap a file in a tmpfs filesystem. If /tmp is a "tmpfs" filesystem, then you must setenv CMUCL_EMPTYFILE to the pathname of some file @@ -156,6 +212,29 @@ exists on your system, lisp will get an error like: ensure_space: Failed to validate 67108864 bytes at 0x01000000 +HP/UX (HPPA) Notes: + +CMU CL only runs with HP/UX version 9.x. Currently there are two major quirks: + -- Huge amounts of swap space are required, since every time a lisp process + forks, paging space is reserved for the entire image (~20 meg per fork.) + Even when one Lisp has started successfully, any subsequent RUN-PROGRAM + could possibly fail. Probably you need at least 75 meg for reliable + operation. Run /etc/swapinfo. If swapping hasn't already been enabled on + the unix filesystem partitions, you can increase paging space using + /etc/swapon or by modifying /etc/checklist. (Note that a runtime-only + image will require much less paging space.) + -- Due to a HP/UX bug, the normal "lisp" startup program has been replaced by + a wrapper which creates a copy on /tmp of the actual startup program (now + kept in lib/lisp.orig) If a lisp process terminates violently, spurious + copies of /tmp/lisp.copy.a* may be left around. Also, due to some weird + terminal I/O interaction, if you interrupt Lisp when it is running in a + shell script, Lisp keeps trying to read from the terminal even though the + shell is too. Note that the CMUCLLIB environment variable is used to + locate lisp.orig (the actual startup code.) + +Also, LOAD-FOREIGN is not implemented yet. + + Running CMU CL: Run "lisp". If Hemlock is loaded, you can also "lisp -edit". Hemlock will @@ -172,43 +251,39 @@ packages: PCL and CLX. Although these packages are copyrighted, they may be freely distributed without any licensing agreement or fee. The release area contains a source distribution, which is an image of all the -".lisp" source files used to build version 17c: - 17c-source.tar.Z (4.9 meg) +source code files used to build the current version: + <version>-source.tar.Z (5 meg) + +A brief overview of the source tree: + Totally machine-independent compiler code: + .../compiler/*.lisp + See especially node.lisp and ir1tran.lisp for the front end. vop.lisp, + vmdef.lisp and ir2tran.lisp for the back end. -All of our files (including the release area) are actually in the AFS file -system. On the release machines, the FTP server's home is the release -directory: /afs/cs.cmu.edu/project/clisp/release. The actual working source -areas are in other subdirectories of "clisp", and you can directly "cd" to -those directories if you know the name. Due to the way anonymous FTP -access control is done, it is important to "cd" to the source directory with a -single command, and then do a "get" operation. + Stuff that is dependent on our choice of object format, but not + particularly machine-dependent: + .../compiler/generic/*.lisp -Totally machine-independent compiler code: - /afs/cs/project/clisp/src/beta/compiler/*.lisp -See especially node.lisp and ir1tran.lisp for the front end. vop.lisp, -vmdef.lisp and ir2tran.lisp for the back end. + Compiler back-end for the MIPS, SPARC and HPPA + .../compiler/mips/*.lisp + .../compiler/sparc/*.lisp + .../compiler/hppa/*.lisp -Stuff that is dependent on our choice of object format, but not -particularly machine-dependent: - /afs/cs/project/clisp/src/beta/compiler/generic/*.lisp + Miscellaneous Lisp run-time code: + .../code/*.lisp -Compiler back-end for the PMAX and SPARC: - /afs/cs/project/clisp/src/beta/compiler/mips/*.lisp - /afs/cs/project/clisp/src/beta/compiler/sparc/*.lisp + C run-time code: + .../lisp/* -Miscellaneous Lisp run-time code: - /afs/cs/project/clisp/src/beta/code/*.lisp -C run-time code: - /afs/cs/project/clisp/src/beta/lisp/* +There is also a distribution of documentation sources: + documents.tar.Z +The contents of the ".../internals/" directory may be of interest. This is A very drafty version of an internal design document: (160 pages) Some of the "tex" files may be more humanly readable, since many formatting commands need to be added. There is some inaccurate (dated) material in the compiler description. - /afs/cs/project/clisp/hackers/ram/docs/internals/*.tex - /afs/cs/project/clisp/hackers/ram/docs/internals/design.ps -See hackers/ram/docs/internals/architecture.tex (the System Architecture -chapter in the internals document) for more information on the source tree -organization. +See ".../internals/architecture.tex (the System Architecture chapter in the +internals document) for more information on the source tree organization. -- GitLab