home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / RiscOS / APP / DEVS / LISP / XL2SRC.ZIP / XLisp2Src / ReadMe!
Text File  |  1992-07-22  |  6KB  |  124 lines
  1. The package contains:
  2. =====================
  3.  
  4. either
  5.         - the !Xlisp application
  6.         - the lisp-files from the original distribution
  7.         - a manual for Xlisp (only text version)
  8.  
  9. or
  10.         - the complete source code for xlisp and the desktop frontend.
  11.  
  12. The distributions:
  13. ==================
  14.   There are two distributions. With the binary distribution, you get the
  15. readily built application, a bunch of lsp files, the Xlisp manual (text form
  16. only), and some other documentation.
  17.   The source distribution comes with full source code, an application skele-
  18. ton, the lsp.init file, and my best wishes ;-)
  19.  
  20. The application:
  21. ================
  22. Let me start out with the features so far:
  23.  
  24.         - provides fully-multitasking desktop frontend with a simple
  25.           teminal emulation.
  26.         - works CSD-independent.
  27.         - suffixes 'lsp' and 'wsp' are translated to prefixes for the file-
  28.           name.
  29.         - get-internal-real-time, get-internal-run-time and time are sup-
  30.           ported.
  31.  
  32. In fact, a full-feature XLisp 2.1d is supported except for the following:
  33.   Not supported are filetable operations (that is truename and delete-file),
  34. and grafix.
  35.  
  36.   To start XLisp, just double-click the Application. You will get a terminal
  37. window in which you do normal XLisp operations. Note the following on ope-
  38. ration:
  39.         - pressing Escape will bring you to the top-level read/eval loop
  40.           at any time.
  41.         - selecting 'quit' from the menu or clicking the close icon will
  42.           immediately quit XLisp, without any security check! I might add
  43.           one in later versions.
  44.  
  45.   The terminal-emulation provides the following facilities:
  46.         CHR 12  clears the terminal screen.
  47.         CHR 8   does a backspace
  48.         CHR 127 also does a backspace.
  49.         CHR 9   moves the cursor up 1 line
  50.         CHR 11  moves the cursor to the next char
  51.         CHR 10  performs a CR/NL
  52.         CHR 13  does a carriage return.
  53.         CHR 30  homes the cursor
  54.         CHR 31  moves the cursor. This one takes 2 parameters, x and y, both
  55.                 starting from 0, so the syntax is actually CHR(30)CHR(x)CHR(y)
  56.  
  57.   The CSD independence was implemented using two environment variables,
  58. namely XLisp$WorkDir and XLisp$lspPath. Both are set in the !run file.
  59.         - XLisp$lspPath is the path along which files are looked up for
  60.           loading, whereas
  61.         - XLisp$WorkDir is the working directory, to which all write oper-
  62.           ations will go. !Xlisp will also try to load a file from this
  63.           directory if it can not be found via XLisp$lspPath.
  64.   XLisp$Workdir is evaluated every time a file operation is done, so you can
  65. alter your working directory by setting the environmental variable to point
  66. to the place you like. XLisp$lspPath is evaluated only once at startup.
  67.  
  68. The sources:
  69. ============
  70.   The complete source code including the frontend is contained in the direc-
  71. tory sources. The file ARCchanges contains the descriptions of some minor
  72. changes I have made to source other than h.xlisp and c.arcstuf to get the
  73. source compiled. The file c.arcstuf contains the entire desktop frontend and
  74. system specific stuff for the ARC, and the system-specific section in
  75. h.xlisp is enclosed in #ifdef ARM / #endif. Forget about the 'asm', 's' and
  76. 'makefiles' directory, you won't need them.
  77.  
  78. The manual:
  79. ===========
  80.   ... is the file cldoc_txt in the directory named 'doc' of the binary
  81. distribution. This is a text-only version. There is a postscript-version
  82. of this available, it comes with the original XLISP-PLUS distribution.
  83.  
  84. The original distribution:
  85. ==========================
  86.   You can obtain the original distribution from glia.biostr.washington.edu,
  87. it should reside somewhere in /pub/xlisp, when I recall this correctly...
  88.  
  89. Rebuilding the application:
  90. ===========================
  91.   To rebuild the application, you need the sources. If you have already got
  92. the binary distribution, then place the sources directory in the same
  93. directory where the !Xlisp application is.
  94.   If you have only got the sources distribution, you will find a directory
  95. called XLisp in the same place where the directory sources is. This is the
  96. application skeleton. the makefile will take care of it. You need to create
  97. the directories lsp and wks in the applications parent directory (od where-
  98. ever you have set up XLisp$WorkDir to point to).
  99.   Enter the sources directory, and edit the makefile to suit your configura-
  100. tion. Then start amu with the target install. Now go and drink some coffee.
  101. If everything goes OK, you should now have a new !Runimage within the !Xlisp
  102. directory.
  103.  
  104. Comments & suggestions:
  105. =======================
  106.   I will not touch any other file than arcstuf.c and xlisp.h, as this port
  107. is going to be a contribution for the next version of the official XLisp-PLUS
  108. distribution. This does especially mean: I won't alter (add or remove) any
  109. language facilities, nor can I add support for multiple sessions with one
  110. interpreter.áBut I will alter some points with the frontend. I will:
  111.         - add support for drop-and-drag of xlisp files to the window.
  112.         - add support for setting Xlisp$WorkDir by dragging
  113. Eventually I might add graphics support... a very big maybe for this one.
  114. Well, if you have any comments/suggestions, you can reach me under my normal
  115. Email Adresses, namely:
  116.  
  117.       gunnar@fasel.hotb.sub.org (Gunnar Zoetl)  (home)
  118.       gunnar@fasel.robin.de (Gunnar Zoetl)      (also home, from august on...)
  119. and   zoetl@isa.informatik.th-darmstadt.de      (university)
  120.  
  121. And now: have fun!
  122.  
  123. Gunnar
  124.