home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / windows / winlisp.zip / READ.ME < prev    next >
Text File  |  1989-09-22  |  10KB  |  240 lines
  1.         =============================================================
  2.         WINLISP (wl.exe) - A shareware Lisp interpreter under Windows
  3.         DOSLISP (dl.exe) - A shareware Lisp interpreter under MS-DOS 
  4.         =============================================================
  5.    
  6.    
  7.    
  8. WinLisp and DosLisp installation.
  9. ---------------------------------
  10.  
  11.    To install WinLisp and DosLisp, follow the steps :
  12.    
  13.    1) copy  your original  floppy disk  into a directory of your hard disk.
  14.       Use xcopy  in order  to copy the lisplib subdirectory, or copy it via
  15.       another command.
  16.    
  17.    2) add in your "autoexec.bat" file the following lines :
  18.    
  19.       SET LISPLIB  = path_of_the_winlisp_directory\LISPLIB
  20.       SET LISPHOME = path_of_the_winlisp_directory
  21.    
  22.       example :
  23.    
  24.       SET LISPLIB  = c:\wl\lisplib
  25.       SET LISPHOME = c:\wl
  26.    
  27.        If  you get the message "out of environnement space" and are running
  28.       MS-DOS 3.3 or more, try adding in your config.sys the line :
  29.    
  30.       device=c:\dos\command.com /P/E:800
  31.    
  32.       if your "command.com" is located in the "\dos" directory.
  33.    
  34.    3) optionally, for WinLisp only, you may add the following option in the
  35.       [extension] section  of the Windows win.ini file, so you will be able
  36.       to start  WinLisp by  double  clicking  on  a  file  having  the  .wl
  37.       extension.
  38.    
  39.       wl=wl.exe ^.wl
  40.    
  41.       to use  this feature,  the WinLisp  directory should be mentionned in
  42.       your path.
  43.    
  44.    
  45.    
  46.                               ===============
  47.                               =   WINLISP   =
  48.                               ===============
  49.    
  50. What is WINLISP.
  51. ----------------
  52.    
  53.    I tried  to produce  a simple,  robust, reasonably  fast  and  ergonomic
  54.    interpreter,  which   would  be  ideally  suited  to  learning  lisp  or
  55.    experimentating with  it. I  truly believe  that lisp is one of the most
  56.    elegant and  easiest language  to learn, and that it has a reputation of
  57.    complexity because  of the  sheer number  of  functions  from  which  it
  58.    derives its  power. In  order for  beginners to  tame this  power,  they
  59.    should be able to learn gradually, starting from a reduced function set,
  60.    and  assimilating   more  as  they  need  them.  This  process  is  much
  61.    facilitated if  they have  the function  definitions  available  just  a
  62.    mouseclick away.  For that  purpose,  WinLisp  has  full  on-line  help,
  63.    indexed both  by  keywords  (function  names)  and  by  topics.  WinLisp
  64.    functions mostly  match those  of the  Le_Lisp system [1], and are quite
  65.    consistant with upstream interpretated lisps.
  66.    
  67.    
  68. How to use it.
  69. --------------
  70.  
  71.    WinLisp runs  in the  Microsoft Windows  environnement, version  2.0  or
  72.    higher. After  starting WinLisp,  as you  start any Windows application,
  73.    appears an editor window where you may enter lisp code, evaluate it, and
  74.    save it  into a file for later usage. Right from that editor window, you
  75.    may get  immediate help  about any WinLisp function. There are three way
  76.    to ask for help :
  77.    
  78.    1- click on the by keyword entry of the help menu. A dialog box appears,
  79.       listing all  the functions  and variables predefined in WinLisp. Just
  80.       double-click on one entry to display the relevant help text.
  81.    
  82.    2- select a  function in  the editor windows, and then click on an entry
  83.       of the  help menu  (or hit F1). The relevant help text is immediately
  84.       displayed.
  85.    
  86.    3- click  on the  by topic entry of the help menu. A dialog box appears,
  87.       showing the  table of  contents of  WinLisp  reference  manual.  Just
  88.       double-click on  one entry to get a box listing all the functions and
  89.       variables defined  in this  chapter. This can be very useful to find,
  90.       for example,  all functions  acting on  symbols. You may then display
  91.       the relevant help text by double-clicking on one entry.
  92.  
  93.  
  94.    When a help text is displayed, you may :
  95.    
  96.    1- request additional  help by  selecting a  keyword and clicking on the
  97.       "help" menu (or hitting F1).
  98.    
  99.    2- evaluate an example (or any expression you enter) by selecting it and
  100.       clicking  on  the  mouse  right  button.  The  evaluation  result  is
  101.       displayed as selected (reverse video) text.
  102.    
  103.    3- close the help window by clicking on the "close" menu (or hitting the
  104.       "Esc" key).
  105.    
  106.    
  107.    Apart from  getting instant  help, you  may also  enter lisp code in the
  108.    editor window,  and evaluate it. The editor is straightforward, enabling
  109.    to use  classic Windows  techniques such  as cut  and paste. It features
  110.    some  lisp   specific  aids,   such  as  hilighting  the  matching  open
  111.    parenthesis  when  you  close  one,  and  also  selecting  the  complete
  112.    expression when  you select  a parenthesis  and click on the right mouse
  113.    button. Clicking  again on  the right mouse button causes the expression
  114.    to be evaluated.
  115.    Selected expression  can be  also evaluated  by using the eval menu. The
  116.    show it entry displays the evaluation result as selected text, while the
  117.    do it  entry only evaluates the selection without displaying the result.
  118.    You can  open as many editor windows as you like by using the new window
  119.    entry of the system menu.
  120.    
  121.    
  122. The future :
  123. ------------
  124.    
  125.    I intend  to make  many developpements  to WinLisp  in the  near future.
  126.    Among them are :
  127.    
  128.    * a debugger.
  129.    * support of large integers (BIGNUMS).
  130.    * developpement of a version for OS2/Windows Presentation Manager.
  131.    * an   object-oriented    interface   for    building    window-oriented
  132.      applications. Ideally,  the  interface  would  be  identical  for  the
  133.      Windows and the WPM version.
  134.   
  135.   
  136.  
  137.  
  138.                               ===============
  139.                               =   DOSLISP   =
  140.                               ===============
  141.  
  142.  
  143.  
  144. What is DOSLISP.
  145. ----------------
  146.    
  147.    DosLisp (dl.exe)  is a version of WinLisp running under the bare MS-DOS.
  148.    It supports  exactly the  same functions with the same interface, except
  149.    for the Windows specific ones, which are for now :
  150.    
  151.    "wait", "time", "prompt", "promptstring".
  152.    
  153.    However, it  is easy  to interact  directly with  the user by asking him
  154.    questions using  "print" and getting answers via "read". As DosLisp uses
  155.    only about  255K, much  more memory  is available  (typically 300 to 350
  156.    Kbytes) than  under WinLisp,  allowing much  larger programs  to be run.
  157.    Also, you may use your favorite editor for editing DosLisp programs with
  158.    the "!" macro-character allowing access to DOS (for example, the command
  159.    "!ed foo.wl"  would start  the editor  called "ed"  on program "foo.wl".
  160.    After beeing edited, this program will have to be reloaded in DosLisp by
  161.    the "loadfile"  function, or  by using the macro-character Control-L (as
  162.    in "^Lfoo" which would load the file "foo.wl").
  163.    
  164.    Here are some specificities of DosLisp, not available in WinLisp :
  165.    
  166.    *   You may  get  the  functions  documentation  on-line  by  using  the
  167.        "apropos" function. Try for example (apropos 'let).
  168.    
  169.    *   If you enter an argument to the "dl" command, the corresponding file
  170.        will be  read before  entering the  toplevel. You  may  for  example
  171.        tailor the  system in  a file  "myenv.wl" and start DosLisp with the
  172.        command "dl myenv".
  173.    
  174.    *   DosLisp reads  from the  standard input  and prints  to the standard
  175.        output, which  may both  be redirected  to disk files. As DosLisp is
  176.        terminated upon  the end  of file in a toplevel read, it may be used
  177.        to create filters. example :
  178.    
  179.        dir | dl <myfilter.wl | more
  180.    
  181.    
  182.                            ====================
  183.                            =   MISCELLANOUS   =
  184.                            ====================
  185.  
  186.  
  187.  
  188. OOPL
  189. ----
  190.    
  191.    OOPL is  an object  oriented layer,  different from  the standard one of
  192.    WinLisp/DosLisp. It has also been written by Hussein Shafie, and follows
  193.    the ObjVLisp  model (P.  COINTE OOPSLA '87 proceedings) minus the multi-
  194.    inheritance feature.
  195.    
  196.    Its usage is not documented, but I believe that its simplicity and power
  197.    will interest  some of you out there. A complete parser has been written
  198.    using this  model, and  is also included. All files relevant to OOPL are
  199.    in the "oopl" subdirectory.
  200.    
  201.    
  202. doctor
  203. ------
  204.    
  205.    I did  port to  DosLisp the  "doctor" program,  derived from the "elisa"
  206.    program of  Joseph Weizenbaum,  which tries  to  enbody  a  psychiatrist
  207.    talking to you. To activate it, just call the function :
  208.    
  209.    (doctor)
  210.    
  211.    inside of DosLisp.
  212.    
  213.    
  214. How you can get these programs.
  215. -------------------------------
  216.    
  217.    As these programs are distributed as shareware, you can freely copy them
  218.    and give  copies to  your  friends,  provided  you  don't  do  it    for
  219.    commercial  reasons. It is strictly forbidden to sell these programs for
  220.    any price,  even if  packaged with  other software,  or to  modify them.
  221.    However, they  may be  distributed via  free bulletin  board services or
  222.    other downloading facilities, and I will post them on the most important
  223.    ones. If  you find  these programs  useful, you may reward my effort and
  224.    contribute to  their further  developpement by sending me $20. Feel free
  225.    anyway to post me any remarks, suggestions, lisp programs and (possibly)
  226.    bug reports. I will be glad to hear from you. My address is :
  227.    
  228.  Stephan Popovitch
  229.  26, rue du champ d'avoine
  230.  78180, Montigny-le-Bretonneux
  231.  FRANCE
  232.    
  233.    
  234.    I wish  you a  lot of  fun using  WinLisp, hopefully  as much  as I  had
  235.    writing it.
  236.  
  237. ===========================================================================
  238.                           end of file "read.me".
  239. ===========================================================================
  240.