home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / f / ilisp-1.lbr / README.2ZD / README.2ND
Encoding:
Text File  |  1993-10-26  |  4.4 KB  |  112 lines
  1. Unpacking iLISP
  2. ===============
  3. Most of the files in iLISP.LBR have been compressed. The two copies of 
  4. the interpreter, LISP.COM and LISP0.COM, were compressed with the 
  5. normal SQ compression program which can be found on most electronic 
  6. bulletin boards. The rest of the programs were compressed with Steven 
  7. Greenberg's CRUNCH program. CRUNCH uses the Lempel/Zev compression 
  8. technique which reduces the size of text files significantly more than 
  9. the usual SQ (while it is not as effective as SQ for COM files). 
  10. Steven Greenberg's UNCR program is included in the iLISP.LBR to aid in 
  11. unpacking the files. After extracting them from the library type 
  12.     UNCR *.?Z? 
  13. (or use more specific file names to avoid unpacking more than 
  14. your disk can handle all at once).
  15.  
  16. I know that using two different squeezing algorithms inside one 
  17. library isn't very nice, but it did reduce the size of the LBR by at 
  18. least another 11K; for people without 2400 baud modems, it makes a 
  19. difference.
  20.  
  21. LIKE iLISP ITSELF, UNCR WILL ONLY RUN ON A Z-80 CP/M 2.2 MACHINE.
  22.  
  23. I apologize to those of you with 8080s and 8085s, but iLISP has always 
  24. been a Z-80 project and the LISP.DOC file really isn't very useful 
  25. without iLISP itself running.
  26.  
  27. UNCR.COM is usually distributed with its other half (CRUNCH.COM) along 
  28. with documentation in a library called CRUNCHLZ.LBR. 
  29.  
  30. For people worried about disk space, you don't really need all the files
  31. right away. To start with, get LISP.COM, INIT.LSP and LISP.DOC (and
  32. of course README.1st and README.2nd). To run the ELIZA program, you 
  33. will also need ELIZA.LSP, DOCTOR.TXT and DOCTOR.LSP. The remaining 
  34. files contain source code which (except for UTILITY.LSP) has already
  35. been loaded into LISP.COM and the stripped down kernel (LISP0.COM).
  36.  
  37.  
  38. About the Documentation
  39. =======================
  40. As noted earlier, the file LISP.DOC does not contain the complete 
  41. documentation. However, LISP.DOC contains more than enough detail 
  42. to allow any LISP programmer to use iLISP effectively.
  43.  
  44. LISP.DOC contains:
  45.   1) The table of contents of both the complete reference
  46.      manual and the guide
  47.   2) Chapter 0 of the reference manual (INTRODUCTION)
  48.   3) Chapter 6 of the reference manual (The List Editor)
  49.   4) Appendix A - Alphabetical summary of ALL iLISP functions
  50.   5) Appendix I - Difference between iLISP and other LISPs
  51.  
  52. I have not made a serious effort at making these files very neat in 
  53. this form. I have had to hack them from their well formatted Wordstar 
  54. files into their present state. They are standard ASCII files with all 
  55. lines less than 70 characters. Each line ends with a carriage return 
  56. and a line feed. There are occasional page ejects (^L) where I thought 
  57. they would be helpful.)
  58.  
  59. More documentation can be found in the source code of the 
  60. LISP files. Once you are in iLISP, typing
  61.  
  62.      (LISTFILE 'FILE 'CON: T)
  63.  
  64. will pretty print the contents of FILE.LSP to the console. Typing
  65.  
  66.      (LISTFILE 'FILE 'LST: T)
  67.  
  68. will print it to the LST device. Typing 
  69.  
  70.      (LISTFILE 'FILE 'FILE.LST T) will send it to a disk file.
  71.  
  72. You can explore the contents of the other .LSP files in a similar way.
  73.  
  74. About ELIZA
  75. ===========
  76. While the extensive description of how ELISP.LSP works and can be 
  77. extended is not included in LISP.DOC, here are the instructions for 
  78. running it:
  79.  
  80. You need these files on your disk:
  81.  
  82.           LISP.COM
  83.           ELIZA.LSP
  84.           DOCTOR.TXT
  85.           DOCTOR.LSP
  86.  
  87. Then type at CP/M:
  88.  
  89.           LISP DOCTOR
  90.  
  91. This will start LISP running and it will load the ELIZA program which 
  92. will load the DOCTOR script and start running. The entire process, 
  93. from your typing the above line until ELIZA is ready to interact with 
  94. you may take a few minitues. When it is ready, the program types: 
  95. "Hello. Please tell me your problem." We have run the program in a 62K 
  96. CP/M system and believe it will run in a smaller one, but haven't 
  97. testing it in one.
  98.  
  99. Some ELIZA documentation can be found by using LISTFILE on ELIZA.LSP
  100. as described above for FILE.
  101.  
  102. Enjoy.
  103.  
  104.                               Richard Fritzson, Proprietor
  105.                               Computing Insights
  106.                               PO Box 4033
  107.                               Madison, WI  53711
  108.  
  109.                               Richard Fritzson
  110.                               Fido Net/Node 121/90
  111.  
  112.