home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / xlisp / xl21freq.zip / README.WIN < prev    next >
Text File  |  1993-12-10  |  8KB  |  188 lines
  1.        INFORMATION ABOUT XLISP 2.1F, MICROSOFT WINDOWS VERSION
  2.  
  3. GENERAL INFORMATION
  4.  
  5.     XLISPWIN, XLISP 2.1F for Windows, is intended to be a Windows
  6.     version of the MSDOS program, and therefore has the same
  7.     general feel. Some aspects of its use do not match typical
  8.     Windows applications, and XLISPWIN applications do not have
  9.     any access to the Windows API. I will leave that to future
  10.     developers.
  11.  
  12.  
  13. SYSTEM REQUIREMENTS
  14.  
  15.     Microsoft Windows version 3.1. The executable provided also
  16.     requires an 80386, however "enhanced" mode of operation is
  17.     not required. XLISPWIN is memory efficient, however memory
  18.     requirements are a function of your application. XLISPWIN will
  19.     use as much memory as it need for the application.
  20.  
  21.     The font utilized will virtually require the use of an
  22.     800x600 pixel display or larger ("Super-VGA"). 640x480 is
  23.     slightly too small. To adjust the font size, see the last
  24.     section in this file.
  25.  
  26.  
  27.  
  28. BUILDING INSTRUCTIONS
  29.  
  30.     XLISPWIN has been tested with Borland C++, Version 3.1. Other
  31.     compilers will probably require changes. Future versions of
  32.     Windows or Windows NT native versions will almost certainly
  33.     require changes. Particularly watch out for the MALLOC and
  34.     FREE macros defined in xlisp.h. The dldmem/dlimage memory
  35.     management option must be used. The winstuff.c file contains
  36.     most of the system changes, but if you want to make
  37.     alterations, you need to study xlisp.h as well. The files
  38.     xlispwin.def, xlispwin.rc, xlispwin.ico, xlispwin.h and
  39.     makewin are used for this version. 
  40.  
  41. IMPLEMENTATION FEATURES
  42.  
  43.     XLISPWIN has been designed to be "Windows friendly." In that
  44.     regard, it: 
  45.  
  46.     * regularly yields control to other Windows processes
  47.     * does not use processor cycles when idle (waiting for input)
  48.     * closes all files when idle
  49.     * allocates memory in ~64k chunks to preserve memory handles
  50.  
  51.     XLISPWIN can be compiled for either the ASCII8 (IBM-PC ASCII)
  52.     or ANSI character sets, with the distribution default being
  53.     ANSI. For full source file compatibility with the DOS
  54.     versions, the ASCII8 version might be preferred. This only
  55.     affects the high-bit set characters.
  56.  
  57. MISSING FEATURES (COMPARED TO MS-DOS VERSION)
  58.  
  59.     While all command line arguments function, standard input and
  60.     output cannot be redirected from the command line. But then
  61.     it is difficult to access the Windows "command line" anyway!
  62.     However a default set of command line arguments can be
  63.     specified in XLISPWIN.INI.
  64.  
  65.     All the keyboard and display functions match those of the DOS
  66.     version. The display size cannot be changed while running, 
  67.     which disallows full-screen operation. The display size can 
  68.         be changed via a XLISPWIN.INI file.
  69.  
  70.     The system function returns immediately, spawning a separate
  71.     application window. Both Windows and DOS applications can be
  72.     launched, and the program filename extension must be specified.
  73.  
  74. ADDED FEATURES TO THE USER INTERFACE
  75.  
  76.     Unlike the DOS version, the color changing applies to text.
  77.     The COLOR function takes 1, 3, or 6 integer arguments, with
  78.     the one argument version being like the MS-DOS version,
  79.     however the bit positions 256, 64, 32, 16 (notice the gap
  80.         for the intensity bit so it doesn't overlap with XOR)
  81.     specify the background text color, which is also the screen
  82.     clearing color. This means that "compatible" programs will
  83.     end up using a black background. Compatible programs should
  84.     also set (color 15) before writing text. The exclusive or bit
  85.     (128) sets exclusive or mode, just like the MS-DOS version.
  86.  
  87.     When three arguments are specified, the represent the red, green,
  88.     and blue intensity levels, respectively, in a range of 0-255.
  89.     Add a red value 256 to get xor mode (like in the one arg case).
  90.  
  91.     When six arguments are provided, the last three set the
  92.     background color. XLISP-PLUS does not realize palettes so
  93.     is limited to 16 colors. Feel free to change the source if this
  94.     is important to you!  The MODE command is ignored, but (like
  95.         the DOS version) returns the display size in characters and
  96.         the maximum pixel coordinates).
  97.  
  98.     The cursor ("caret") shows matching parenthesis and quotes.
  99.  
  100.     The mouse cursor changes shape to hourglass or garbage bag 
  101.     (for garbage collection) while executing. This doesn't work
  102.     as smoothly as I had hoped. Don't tell me about it unless you
  103.     can offer a solution.
  104.  
  105.     The "Drag and Drop" feature of the File Manager is supported.
  106.  
  107.     Popup dialog boxes are used for fatal errors and for the
  108.     control-T activated status report.
  109.  
  110.     Exiting via the Files menu or system menu (or ALT-F4) will
  111.     cause a prompt allowing saving the workspace before leaving.
  112.     The (EXIT) function will bypass this prompt. Control-Z will
  113.     no longer cause the program to exit, and now behaves like a
  114.     silent version of control-G.
  115.  
  116.     Files menu: allows menu activiation of LOAD, RESTORE, SAVE,
  117.     DRIBBLE, and EXIT commands. The standard dialog boxes are
  118.     used for the file accessing commands. The last file LOADed
  119.     via the menu is    remembered, as is the last file DRIBBLEd by
  120.     the menu, or the last workspace saved or restored by any
  121.     means. The EXIT command can be executed at any time, while
  122.     the other commands can only be executed when XLISPWIN is
  123.     waiting for input -- this is to protect against mysterious
  124.     interactions since there is only a single execution thread.
  125.  
  126.     The SAVE and DRIBBLE commands preserve line currently being
  127.     edited, while the LOAD and RESTORE commands delete the
  128.     current line (figuring you won't what anything typed).
  129.  
  130.     Edit menu: The copy command copies a rectangular region to
  131.     the clipboard, and pastes at the cursor position. That means
  132.     it works effectively like the the commands do in a DOS
  133.     window, however they are activated with the typical Windows
  134.     keystrokes. Drag with the left mouse button to select the
  135.     region. Hitting any key (without doing the copy) will delete
  136.     the region.
  137.  
  138.     Run menu: Allow menu operation of the keyboard control-B, -T,
  139.     -G, -C, and -P commands. Inappropriate commands are grayed
  140.     out. 
  141.  
  142.     Help menu: There is no additional help, but there is an
  143.     "About" selection.
  144.  
  145. XLISPWIN.INI
  146.  
  147.     A file of this name can be placed in the Windows directory to
  148.         control the font, number of lines, and other characteristics.
  149.     Only fixed width fonts (such as "Courier New", "Fixedsys", or
  150.     "Lucinda Sans Typewriter" (from the Microsoft Truetype Font
  151.     Pack I)) should be used for best results. Font sizes should
  152.     be in the 10-20 point range. The Fixedsys font cannot be
  153.     scaled. You can also specify the number of lines. When the
  154.     OEM (PC-8) character set is selected, only the number of
  155.     lines can be changed. In addition the leading between the
  156.     lines can be adjusted via a "Leading" entry. This may be
  157.     desirable for fonts other than FixedSys which seem to insert
  158.     too much leading. The default leading is what Windows
  159.     suggests for the font, and  negative values are allowed. 
  160.  
  161.     The entry "Arglist" can be used to specify a default argument
  162.     list to, for instance, load a certain workspace file. When missing,
  163.     the actual argument list is used.
  164.  
  165.     The entry "FilePath" specifies an an alterative search path to
  166.         the environment variable XLPATH. The path should be specified in
  167.         quotes so the semicolon separators are not take as the start of
  168.         the comments. When this entry is missing, the environment variable
  169.         is used. This allow specifying a different path for the Windows
  170.         version.
  171.  
  172. The default file contents are: 
  173.  
  174. [Display]
  175. FilePath="[the contents of the XLPATH environment variable]"
  176. Arglist="[the command line arguments]"
  177. Lines=25
  178. Font="Fixedsys"
  179. FontSize=16
  180.  
  181.     I happen to like:
  182.  
  183. [Display]
  184. FontSize=14
  185. Lines=30
  186. Font="Courier New Bold"
  187. Leading=-4
  188.