home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / sml.zip / readme < prev    next >
Text File  |  1993-08-10  |  6KB  |  146 lines
  1. Endinburgh SML for OS/2 2.x and OS/2 2.x PM and DOS/386 (v0.3)
  2. --------------------------------------------------------
  3.  
  4. This package contains the following software:
  5.         sml.exe     -   Standard ML for OS/2 2.x
  6.         smlpm.exe   -   Standard ML for OS/2 2.x PM
  7.         smldos.exe  -   Standard ML for DOS (& Windows)
  8.         smlref.inf  -   A language reference of ML (german)
  9.         src\*       -   A few sample files
  10.  
  11. ===============================================================================
  12.  
  13. Featurs of SML for OS/2 2.x:
  14.         - 32 Bit and flat memory for high performance
  15.         - cut&paste features of OS/2 can be used
  16.         - Editor and SML can be used at the same time
  17.         - ML-function system can be used to call OS/2 programs
  18.         - uses two color when in ANSI mode
  19.  
  20. Features of SML for OS/2 2.x PM;
  21.         - 32 Bit and flat memory
  22.         - built-in editor
  23.         - undo/redo, cut&paste, support of clipboard
  24.         - makes use of OS/2's multitasking and multithreading capabilities
  25.           (at least 4 thread at a time)
  26.         - online reference for language
  27.         - context-sensitive help
  28.         - keyboard macros for frequently used words (e.g. Alt-d=datatype)
  29.         - syntax expansion
  30.         - use OS/2 2.x std. dialogs for load/save and fonts
  31.  
  32. [ For both version OS/2 2.0 & Service Pak and 8 MB of memory are recommended ]
  33.  
  34.  
  35. Features of SML for DOS/386
  36.         - uses 32 Bit and flat memory
  37.         - DMPI compliant (runs under OS/2-DOS-box (for 2.0 serv.pak necessary),
  38.           windows 3.x and works together with some memory-resident-editors).
  39.         - history function
  40.         - ANSI 2 colors
  41.  
  42.  
  43. ===============================================================================
  44.  
  45. Usage:
  46.  
  47. OS/2 2.x:     sml [-a] [-h heapsize] [-q] [sml.exp]
  48.                 -a: use ANSI colors
  49.                 -h: size of heap in bytes (4000 recommended)
  50.                 -q: quiet mode
  51.            sml.exp: import file
  52.  
  53.               for more information type view sml.inf
  54.  
  55.  
  56. OS/2 2.x/PM:  smlpm
  57.               (smlpm does not take any paramters. If it does not work
  58.               select Options/change options.)
  59.  
  60.               for more information click on help
  61.  
  62.  
  63. DOS:          smldos [-a] [-h heapsize] [-q] [-f ramdisk] [-d] [-n] sml.exp
  64.                 -a: use ANSI colors
  65.                 -h: size of heap in bytes
  66.                 -q: quiet mode
  67.                 -f: specify the ramdrive. sml is polling on the ramdrive
  68.                     for sml.ml. Whenever this file is saved, SML loads it
  69.                     into memory.
  70.                     for example:
  71.                     sml -f h: -h 2000     -> 1. Window
  72.                     notiz.exe h:\sml.ml   -> 2. Window
  73.                     Whenever h:\sml.ml is saved, sml evaluates sml.ml
  74.                     When running under OS/2 or Windows a minimum cpu time
  75.                     is used since sml gives away its timeslice when no key is
  76.                     pressed
  77.                 -d: Output by using DOS functions (e.g. for piping stdin/stdout)
  78.                     (without history)
  79.                 -n: slows down NNANSI.SYS. This switch is necessary for nnansi!
  80.  
  81.               By default smldos.exe uses bios for video output/keyb. input
  82.               SML can only be left by using "exit".
  83.  
  84. ===============================================================================
  85.  
  86. Using the DOS version under Windows 3.1 and OS/2 2.x
  87.  
  88. Windows:
  89.         1. The DOS windows are very slow. You a fast machine.
  90.                 (or try the OS/2 dos boxes, s. below)
  91.         2. Try some tuning with .PIF files.
  92.                 (With bad settings the program may not work in the correct way.)
  93.         3. Start smldos.exe with e.g. -h 3000 -f h:
  94.            The -h switch specifies the amount of memory used. 3 or 4 MB
  95.            is a good value. The -f swith specifies the ramdrive.
  96.            Start your favourite Windows editor. Save your ML file als
  97.            x:\sml.ml where x is your ramdrive.
  98.            smldos.exe is polling (because of -f switch) on your
  99.            ramdrive. As soon as you save the file smldos.exe loads it
  100.            into memory. Do not forget to give smldos.exe some
  101.            background priority.
  102.         4. smldos.exe causes an error when it finishes work.
  103.            This as a Windows bug.
  104.  
  105. OS/2:
  106.         1. Service Pak necessary
  107.         2. work analog as for windows. Use e or epm instead.
  108.            e.g. smldos -h 3000 -f h: and epm h:\sml.ml
  109.         3. Under OS/2 this solution runs faster
  110.  
  111. ===============================================================================
  112.  
  113. Known problems:
  114.         - The font dialog might not work under OS/2 2.0
  115.             (I don't know wether this is a problem of OS/2 or my test PC)
  116.         - The small editors do not work with more than 64 K.
  117.             (They are intended to be used for testing and experimenting.
  118.              Try to use a real editor instead. use File/Import. This
  119.              works with very large files.)
  120.         - For large files "Eval" might not work
  121.             (Try to use "Use" instead)
  122.         - Sometimes the temorary files are not deleted.
  123.             (They are created only when using "Use". Try deltmp.cmd)
  124.         - smldos.exe sometimes get an error on program start.
  125.             (I have not yet isolated this problem. Just try tor rerun.)
  126.         - smldos.exe does not support the system function.
  127.  
  128. ===============================================================================
  129.  
  130. The source code of SML is (c) by Edinburgh University.
  131.  
  132. Porting to DOS, porting to OS/2 and writing the PM-Shell done by myself.
  133. All software written by myself is supplied free.
  134.  
  135. There are no warranties for any damages caused directly or indirectly by
  136. this software. All software is supplied AS IS.
  137.  
  138. All comments are very welcome.
  139.  
  140. I can be reached at:
  141.  
  142. Felix von Normann
  143. Innstrasse 82
  144. D-94036 Passau
  145. e-mail: normann@peschl.fmi.uni-passau.de
  146.