home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / pc / source / mg2a_dos.sha / README < prev    next >
Text File  |  1989-03-17  |  3KB  |  63 lines
  1. This is the source for the MS-DOS version of mg2a.  These files are
  2. intended to reside in a directory sys/msdos underneath the main mg2a
  3. source directory. 
  4.  
  5. This code will run under both "Turbo C 1.5" and "Microsoft C 5.1"
  6.  
  7. To compile using Turbo C 1.5, copy makefile.tc from the sys/msdos
  8. directory into the main mg2a source directory, then cd into the main
  9. directory and use the Turbo C "make" program (just type "make"). 
  10.  
  11. To compile using Microsoft C 5.1, cd into the main directory and type
  12. "make sys\msdos\makefile.msc"
  13.  
  14. A few random notes:
  15.  
  16. o   The display routines rely on the ROM BIOS interface.  This has the
  17.     advantage of being more portable, but at the expense of display
  18.     speed.  Direct memory-mapped display code or using ANSI sequences with
  19.     NANSI or FANSI-Console could be much faster.  To keep the program
  20.     small and maintain portability, enhancements such as these should
  21.     be supported as compile-time options (e.g. with #ifdef's)
  22.  
  23.     The only display mode supported is 24 x 80.  To fix this, you will
  24.     need to change NROW and NCOL ttydef.h to be the largest # of rows
  25.     and columns supported, then you will have to change either
  26.     ttresize() in "tty.c" or setttysize() in "ttyio.c" to check the
  27.     BIOS parameter memory for the current screen size.
  28.  
  29. o   Note that the keyboard support also goes through the BIOS.
  30.     The "backspace" key generates DELETE (so that it does a
  31.     delete-backwards, while control-h still returns control-h (i.e.
  32.     HELP).  Arrow keys, HOME, END, PgUp, PgDn, etc.  are supported
  33.     (look in ttykbd.c) The ALT key works like a META key for alpha
  34.     keys, but the BIOS doesn't return keycodes for certain ALT
  35.     key combinations (I wish ALT-SHIFT-< worked!)  8 bit characters
  36.     (the line drawing set!) are supported, but to enter them, you
  37.     must use ALT-ddd (where ddd are digits on the numeric keypad).
  38.  
  39. o   The dired mode SEEMS to work, but I am not real happy with "dired" in the
  40.     first place, and the MS-DOS implementation isn't very well tested.
  41.     Presumably this is one area which will be enhanced in mg 2b.
  42.  
  43. o   REGEX compiles OK, but doesn't seem to work right.  I haven't done any
  44.     extensive testing, and I'm not sure what is breaking down.  If you 
  45.     want to play with this, you must add the
  46.     string "-DREGEX" to the CDEFS macro in the makefile (don't try to
  47.     add it to sysdef.h:  regex.c won't compile right (sigh)).
  48.  
  49.     Anyway, I've got no use for REGEX at the moment, and compiling it
  50.     in adds 15K to the base executable size of 90K.  I pass.
  51.  
  52. Good luck with this.  We hope you find it useful.  Please send any
  53. improvements you make.
  54.  
  55. Credits:
  56.  
  57. John P. Nelson (decvax!genrad!jpn, jpn@genrad.com) did the Turbo C
  58. port and most of the work (based on his earlier work on
  59. MicroGnuEmacs).  Jeff Siegal (jbs@eddie.mit.edu) brought it up under
  60. Microsoft C and fixed a few bugs. 
  61.  
  62. This document was written by John P. Nelson and modified by Jeff Siegal.
  63.