-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- NOTE: Fixes for Garnet to work with MCL 3.x from Russell Almond on 26 Aug 1996 result in new files. Russell's message is here first, followed by the original instructions for Garnet V3.0 from December 10, 1994: -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- From: Russell Almond To: garnet-users@cs.cmu.edu, info-mcl@digitool.com Subject: Garnet 3.0r1 --- Bug fixes for MCL 3.x I've put together all of the bug fixes and patches that were necessary to get Garnet to work under MCL 3.0/3.9, hopefully in time for them to be bundled with the MCL 4.0 CD which is due out soon. For those of you (info-mcl list) who are unfamiliar with Garnet, Garnet is a set of extensible tools for building user interfaces. Some of its novel features include: (1) a complete prototype-instance constraint-based object system, (2) separate display and interactor object for capturing interactions, (3) a platform independent graphics system (only implemented for Mac and X-windows), (4) a well stocked library of widgets with both Motif (emulated) and a custom look and feel, (5) drag and drop and interactive interface construction tool, (6) interactive debuggers. Garnet is public domain, more information is available at the garnet WWW site: http://www.cs.cmu.edu/afs/cs.cmu.edu/project/garnet/www/garnet-home.html For those of you familiar with Garnet, this patch release contains: 1) Changes necessary to get Garnet working under MCL 3.0 and 3.9 (previously only worked with MCL 2.x) 2) Fixes to the Animator interactor to get it working under MCL 3.x 3) Fixes to the Mouseline interactor to get it sort of working under MCL 3.x (there are still some problems because of the Mac concept of focus window which I don't know how to fully address. This interactor is really only showing how garnet can introduce a customizable version of balloon help anyway). 4) The true-color display patch (allows more than 256 colors). 5) Some speed-ups for creating postscript dumps of the windows. 6) Separate source and binary trees (as with the Unix version). This is a user community contributed bug fix release, which I've labeled 3.0r1, it is not an "official" release, but as Garnet is not officially supported anymore, I'm calling this a successor to the official releases. The files (which are currently at: ftp://a.gp.cs.cmu.edu/usr/garnet/garnet/ are Garnet3.0r1.src.sit.Hqx --- Source code Garnet3.0r1.bin.sit.Hqx --- Binary Directory shell Garnet3.0r1.lib.sit.Hqx --- Library Directory shell (just like the 3.0 library with some extra garnet icon goodies) Garnet3.0.doc.sit.hqx --- Original documenation (unchanged from version 3.0) I hope you find this of some use. --Russell Almond almond@acm.org -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- Instructions for Retrieving the Garnet Software on the Macintosh December 10, 1994 V3.0 RELEASE These instructions are for the official release of version 3.0 of Garnet for loading the software directly onto a MACINTOSH. If you are downloading the Unix version you should read the separate file FTPINSTR.UNIX. If you want both versions, you can follow both sets of instructions. Note that the source files for both versions are identical, but the instructions will get you two copies. There is an internet bulletin board for discussing Garnet, called comp.windows.garnet. If you cannot access that, then please send mail to garnet@cs.cmu.edu or garnet-request@cs.cmu.edu to be added to the mailing list (which contains the same messages as the bboard). To send mail to the Garnet maintainers, send to garnet-bugs@cs.cmu.edu. Posting to the bboard or sending mail to garnet-users@cs.cmu.edu will send the message to all garnet users all over the world. All administrative questions about the mailing list should be sent to garnet-request@cs.cmu.edu. Garnet 3.0 is available in a Stuffit file that includes the sources, the library files, and the binary files compiled for Macintosh Common Lisp 2.0.1. To download the Garnet collection that includes MCL binaries, use FTP or Fetch (a Mac file transfer utility) to connect to a.gp.cs.cmu.edu (128.2.242.7) and login as ``anonymous'' with your e-mail address as the password. Change to "binary" mode for FTP, or stay in "automatic" mode for Fetch, and download the Stuffit archive /usr/garnet/garnet/mac.sit Alternatively, you can get the BinHex version in text mode by retrieving /usr/garnet/garnet/mac.sit.hqx If you are using Fetch, it will automatically convert the BinHex file into a binary .sit file after it is installed on your Mac. If you used FTP to get the .hqx file, you will need to BinHex4 Decode the file. You should also retrieve one version of the documentation file: /usr/garnet/garnet/doc.sit /usr/garnet/garnet/doc.sit.hqx If you do not have a version of Stuffit, you can also download the copy of Stuffit_Expander from the same directory to uncompress the Garnet archive. The Stuffit utility is a self-extracting archive that you only need to double-click on to install on your Mac. Be sure to use binary transfer mode in FTP if you are retrieving StuffIt_Expander_.sea. Once you have downloaded the mac.sit or mac.sit.hqx archive (and installed the Stuffit Expander, if necessary), launch the Stuffit utility. Next, "Expand..." or "Open" the mac.sit archive, and choose a folder into which the uncompressed Garnet folder will be expanded. The instructions below assume you have installed the uncompressed folder at the top-level of your hard drive, and that your hard drive is named "Macintosh HD" (i.e., the uncompressed folder will become "Macintosh HD:Garnet:". It would be a good idea to expand the doc.sit archive in the Garnet folder that was created by the first archive. The documentation is briefly discussed below. For detailed instructions about printing the documentation, consult the doc/README file. When using Garnet, you may need to increase the amount of memory that is claimed by the Lisp application. You can change the memory claimed by MCL by selecting the MCL application in the Macintosh Finder and choosing "Get Info" from the Finder's "File" menu. Most Garnet applications will require that MCL use at least 6Mb of RAM, and using at least 12Mb is recommended. The default "Preferred size" for MCL is 3072K, so you will need to edit that value to be upwards of 6000K. You are only allowed to change this information when the application is NOT running, and it should be done before proceeding with the rest of these instructions. Note: All Lisp images saved from the MCL application will retain the new "Preferred size" value. Now you can launch MCL, and edit the file garnet-loader.lisp from the new Garnet folder (choose "File,Open..." to edit a file in MCL). Find the definition of the variable Your-Garnet-Pathname and set its value to the path of the new Garnet folder you created with Stuffit. All other subfolders of Garnet will be computed relative to this pathname. Save the new version of the garnet-loader file. Before loading Garnet, you will need to compile several MCL library files that are used by Garnet. A compiler script for this procedure is provided in the Garnet collection. In the fresh MCL listener, load the file "Macintosh HD:Garnet:compile-mcl-libraries.lisp" (replacing the hard drive prefix with whatever is appropriate for your machine). After the script is finished, quit MCL and then launch MCL again. In a fresh Lisp listener, load "Macintosh HD:Garnet:garnet-loader.lisp" (using whatever prefix is appropriate instead of "Macintosh HD:Garnet:"). Garnet will inform you as it loads each module, and will finally return with a prompt. At this point, Garnet is fully loaded and you are ready to try some demos or whatever as discussed in the Garnet 2.2 manual. However, at this point you may wish to create an image of Garnet so that you will not have to load the library files and the Garnet modules again next time. The function opal:make-image is documented in the Garnet 2.2 reference manual, and can be executed as (opal:make-image "Macintosh HD:Garnet:GARNET-image") replacing the filename with whatever you prefer. Launching the resulting "GARNET-image" application will be just like launching MCL, except that Garnet will already be fully loaded. COMMON INSTALLATION PROBLEMS REPORTED BY MAC USERS: * The binary files in the mac.sit file have been compiled for MCL 2.0.1, and will not load into an MCL 2.0 image. If you simply installed MCL 2.0 from a set of Apple disks, you will need to additionally download the official 2.0.1 upgrade from Apple. To get the upgrade package, ftp to cambridge.apple.com and retrieve file /pub/mcl/patches/2.0->2.0.1.sea.hqx. Further instructions for applying the upgrade are included in that file. * Garnet should be loaded into a fresh lisp image. If you have loaded other code into lisp before loading Garnet (including some MCL library files), or you have saved a lisp image from a previous session, or you perform some instructions automatically through an initialization file when MCL is started, then something in your lisp session may be incompatible with the plain lisp environment that Garnet expects. * Some users have reported "recursive printing errors" when attempting to load or compile library files in MCL, or when attempting to execute functions in the MCL 'traps' package. This problem can be avoided by starting the MCL image from the official MCL folder, rather than starting a saved image of MCL that has been moved into another folder. * It is important to compile the required library files by loading the compile-mcl-libraries.lisp script. There is a new manual for version 3.0, which includes all the information supplied in changes3.0.txt and mac-addendum.txt, though you may still find these files useful in highlighting differences from the 2.2 version. There are PostScript files for the Garnet 3.0 manual in both TAR format for Unix and Stuffit/BinHex format. If you have access to a Unix machine and can print PostScript files directly, you may find it easier to download the TAR version (either doc.tar or doc.tar.Z) and follow the instructions in FTPINSTR.UNIX and the README file in the doc directory for printing all the files using a handy shell script. To print the manuals from a Mac, you should download the Stuffit or BinHex versions of the documentation (doc.sit or doc.sit.hqx, respectively). The unstuffed documentation requires about 8 megabytes of disk space. We have provided a Freeware utility called ShowPages in the Garnet release directory (where you got mac.sit, above) which you can use to print the PostScript files. Download either showpages.sit or showpages.sit.hqx and then use ShowPages to print each file in the doc directory. The README file lists the order of the files in the finished Garnet manual. If you have trouble printing the manuals, some people have reported that it works better to change the top line of each postscript file from %!PS-Adobe-2.0 to be just %! If you cannot print out the documentation, we will mail you a hardcopy if you send a check for $40 (US) made out to "Carnegie Mellon University" to: Brad A. Myers School of Computer Science Carnegie Mellon University 5000 Forbes Avenue Pittsburgh, PA 15213-3890 From this point, Mac-specific instructions and considerations are included in the file mac-addendum.txt, which highlights Mac-specific issues from the Garnet 3.0 manual and the changes3.0.txt document. You might now want to read the introductory material in the manual, and then run the "tour" and read the "tutorial". Thanks again for your interest in Garnet, and we hope that it works well for you.