home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / coders / jËzyki_programowania / clisp / doc / readme < prev    next >
Text File  |  1977-12-31  |  6KB  |  207 lines
  1. This is CLISP, a Common Lisp implementation.
  2.  
  3.  
  4. What is LISP?
  5. -------------
  6.  
  7. LISP is a programming language. It was invented by J. McCarthy in 1959.
  8. There have been many dialects of it, but nowadays LISP has been standardized
  9. and wide-spread due to the industrial standard COMMON LISP. There are
  10. applications in the domains of symbolic knowledge processing (AI), numerical
  11. mathematics (MACLISP yielded numerical code as good as FORTRAN), and
  12. widely used programs like editors (EMACS) and CAD (AUTOCAD).
  13. There is an introduction to the language:
  14.  
  15.   Sheila Hughes: Lisp. Pitman Publishing Limited, London 1986.
  16.   107 pages.
  17.  
  18. After a while wou will need the standard text containing the language
  19. definition:
  20.  
  21.   Guy L. Steele Jr.: Common Lisp - The Language. Digital Press.
  22.   1. edition 1984, 465 pages.
  23.   2. edition 1990, 1032 pages.
  24.  
  25. This book is available in HTML form via FTP from
  26.   ftp.cs.cmu.edu:/user/ai/lang/lisp/doc/cltl/cltl_ht.tgz  and
  27.   ma2s2.mathematik.uni-karlsruhe.de:/pub/lisp/CLtL2/cltl_ht.tgz
  28. and can be viewed through WWW under
  29.   http://www.cs.cmu.edu:8001/Web/Groups/AI/html/cltl/cltl2.html or
  30.   http://www.cs.cmu.edu:8001/afs/cs/project/ai-repository/ai/html/cltl/cltl2.html .
  31.  
  32. LISP is run in an interactive environment. You input forms, and they will be
  33. evaluated at once. Thus you can inspect variables, call functions with given
  34. arguments or define your own functions.
  35.  
  36.  
  37. Contents:
  38. ---------
  39.  
  40. It consists of the following files:
  41.  
  42.       lisp.run           main program
  43.       lispinit.mem       memory image needed for startup
  44.       clisp.1            manual page in Unix man format
  45.       clisp.man          manual page
  46.       clisp.html         manual page in HTML format
  47.       impnotes.txt       implementation notes
  48.       cltl2.txt          notes about the relation of CLISP to CLtL2
  49.       LISP-tutorial.txt  LISP tutorial for beginners
  50.       CLOS-guide.txt     brief guide to CLOS
  51.       README             this text
  52.       SUMMARY            short description of CLISP
  53.       ANNOUNCE           announcement
  54.       NEWS               list of modifications since the last version
  55.       COPYRIGHT          copyright notice
  56.       GNU-GPL            free software license
  57.       config.lsp         site-dependent configuration
  58.       timezone.lsp       site-dependent time zone
  59.  
  60. and - to your convenience, if you like reading source -
  61.  
  62.       *.lsp              the source of lispinit.mem
  63.       *.fas              the same files, already compiled
  64.  
  65.  
  66. Hardware requirements:
  67. ----------------------
  68.  
  69. This Amiga version of CLISP requires at least 1.5MB RAM. The version called
  70. CLISP-LOW runs on machines with no memory outside the 24 bit addressable
  71. range: on 68000, A2620, A2630. The version called CLISP-HIGH runs in memory
  72. that is 27 bit addressable (address range #x00000000 to #x07FFFFFF), but
  73. only on 68020/030/040(/60?) CPU: on A3000 and A4000 without Zorro-III memory
  74. boards. The version called CLISP-00 runs on 68000/010 CPU only but is faster
  75. than CLISP-LOW. The version called CLISP-WIDE uses 64 bit integers and runs
  76. in any memory on 68020 or better CPU: on A4000 using VMM. The overhead for
  77. 64 bit integers cause CLISP-WIDE to be slower than CLISP-HIGH.
  78.  
  79.  
  80. Software requirements:
  81. ----------------------
  82.  
  83. This version of CLISP requires OS 2.04 (V37) or newer.
  84.  
  85.  
  86. Installation:
  87. -------------
  88.  
  89. Edit the contents of config.lsp appropriately for your site,
  90. especially the definitions of short-site-name and long-site-name.
  91. You may also want to edit the time zone definition at the end of
  92. timezone.lsp.
  93. Then start
  94.  
  95.          lisp.run -M lispinit.mem
  96.  
  97. When the LISP prompt
  98.  
  99.       > _
  100.  
  101. appears, type
  102.  
  103.         (compile-file "config")
  104.         (load "config")
  105.  
  106. and - in case you modified timezone.lsp -
  107.  
  108.         (compile-file "timezone")
  109.         (load "timezone")
  110.  
  111. and then
  112.  
  113.         (saveinitmem)
  114.  
  115. to overwrite the file lispinit.mem with your configuration. Then
  116.  
  117.         (exit)
  118.  
  119. Then create a directory, and put the executable and the memory image there.
  120.  
  121.  
  122.  
  123. Note:
  124. -----
  125.  
  126. You can start CLISP from Workbench(tm). The following Tooltypes are
  127. recognized in the Tool Icon:
  128.  
  129.    WINDOW=<window or pipe specification>
  130.    ARGS=<CLI-like arguments>
  131.  
  132. For example,
  133.  
  134.    WINDOW=CON:0/11/640/200/CLISP-Listener/CLOSE
  135.    ARGS=-M lispinit.mem
  136.  
  137.  
  138. When you encounter problems:
  139. ----------------------------
  140.  
  141. After errors, you are in the debugger:
  142.  
  143.      1. Break> _
  144.  
  145. You can evaluate forms, as usual. Furthermore:
  146.  
  147.      Help
  148.                calles help
  149.      Abort     or
  150.      Unwind
  151.                climbs up to next higher input loop
  152.      Backtrace
  153.                shows the contents of the stack, helpful for debugging
  154.  
  155. And you can look at the values of the variables of the functions where the
  156. error occurred.
  157.  
  158. On bigger problems, e.g. "guru"s, please send a description of the error
  159. and how to produce it reliably to the authors or the maintainer. Please
  160. accompany it with the CLISP version, which you get by calling
  161. (lisp-implementation-version).
  162.  
  163.  
  164. Mailing List:
  165. -------------
  166.  
  167. There is a mailing list for users of CLISP. It is the proper forum for
  168. questions about CLISP, installation problems, bug reports, application
  169. packages etc.
  170.  
  171. For information about the list and how to subscribe it, send mail to
  172. listserv@ma2s2.mathematik.uni-karlsruhe.de, with the two lines
  173.           help
  174.           information clisp-list
  175. in the message body.
  176.  
  177.  
  178. Acknowledgement:
  179. ----------------
  180.  
  181. We are indebted to
  182.   * Guy L. Steele and many others for the Common Lisp specification.
  183.   * Richard Stallman's GNU project for GCC.
  184.  
  185.  
  186. Authors:
  187. --------
  188.  
  189.         Bruno Haible
  190.         Michael Stoll
  191.  
  192. Email: haible@ma2s2.mathematik.uni-karlsruhe.de
  193.  
  194. Amiga Port by:
  195. --------------
  196.  
  197.         Jörg Höhle
  198.  
  199. Email: Joerg.Hoehle@gmd.de
  200.  
  201. Maintainer:
  202. -----------
  203.  
  204.         Marcus Daniels
  205.  
  206. Email: marcus@sysc.pdx.edu
  207.