home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / qfix101.arj / QFIX.DOC < prev    next >
Encoding:
Text File  |  1991-06-06  |  5.5 KB  |  125 lines
  1.     QFIX.C v 1.01  by Shaun Case  Feb 21 1991
  2.     Released to the public domain Feb 22 1991
  3.  
  4.     Platform: PC clones under MS DOS 2.10 or higher (?)
  5.     Supports  CGA/EGA/VGA/MCGA.
  6.               Untested on Hercules and MDA.
  7.  
  8.     Purpose:  Qfix gets around Qedit's annoying habit of
  9.               not restoring the screen when it terminates
  10.               if it detects that it is unregistered.  To
  11.               combat this annoyance, Qfix will save the current
  12.               screen to a disk file, and later restore it.
  13.  
  14.     Instructions:
  15.  
  16.               To use Qfix, you should rename Qedit from Q.EXE to
  17.               QEDIT.EXE, and create the following batchfile,
  18.               called Q.BAT:
  19.  
  20.  
  21.               @echo off
  22.               qfix save f:\tmp\q.sav
  23.               qedit %1 %2 %3 %4 %5 %6 %7 %8 %9
  24.               qfix restore f:\tmp\q.sav
  25.  
  26.  
  27.               Replace f:\tmp\ above to any path that contains
  28.               at least 15k free space.  The size of the save
  29.               file varies, depending on the mode you are in.
  30.               You can count on something between 2k (for 40X25
  31.               mode) and ~12k for 132X43 (the mode I use.)
  32.  
  33.               Make sure that the above batch file is in your path.
  34.  
  35.               I put QCONFIG.DAT, Q.BAT, QEDIT.EXE, and QFIX.EXE all
  36.               in a RAMDISK (which is what f:\tmp is on my system.)
  37.               This makes everything run really, really fast, and
  38.               you won't notice the screen being restored at all
  39.               after you have used it for a while.  If you use it
  40.               on a floppy system, well, it's going to be pretty
  41.               darn slow.
  42.  
  43.               If you are using a version of DOS older than 3.30,
  44.               you should replace the first line of the batch file
  45.               above with just "echo off", with no '@' in front.
  46.               The '@' just keeps the "echo off" message from being
  47.               displayed, and looks a little nicer.
  48.  
  49.     Using Qfix under MDA:
  50.  
  51.               You will have to patch the program with MDA's starting
  52.               address, and recompile.  This should be relatively
  53.               painless.
  54.  
  55.  
  56.               For god's sake, get a color card! You've been in the dark
  57.               ages long enough.
  58.  
  59.     Note on source:
  60.  
  61.               The source is written under Turbo C 2.0, but was compiled
  62.               under Borland C++ 2.0.  Either should work fine.  This executable
  63.               and the source are in the public domain.  Use them any way
  64.               you want -- use them in your own programs, make them into
  65.               games, art, plant mulch, or sell them at a profit.  I don't
  66.               care.  If for some reason you want to contact me (other than
  67.               for flames, especially if you work for Semware!  <nirg>) then
  68.               you can send me mail at atman%ecst.csuchico.edu@RELAY.CS.NET.
  69.  
  70.  
  71.               By the way, you may wonder why I used the save to disk approach
  72.               to solving this problem.  Here are the main reasons I did it
  73.               the way I did, rather than making a TSR or patching the Qedit
  74.               code directly:
  75.  
  76.               1)  TSRs are hard to write, and waste memory that could be used
  77.                   to edit files.
  78.               2)  This method will work for any version of Qedit that does
  79.                   this nasty trick, or for any other program that destroys the
  80.                   screen and doesn't put it back.  (Really bad programming
  81.                   practice, if you ask me.)
  82.               3)  I want people to appreciate what a fast 386 and a ramdisk
  83.                   can do for you.  I like making good use of available
  84.                   resources, and anyone who still uses a floppy based PC
  85.                   system probably doesn't mind the screen not being restored.
  86.                   God knows they've been putting up with enough from
  87.                   their machine as it is.
  88.               4)  People get mean when you patch their executables.
  89.                   Also, this method, as far as I know, is legal, whereas
  90.                   patching executables probably isn't in all cases.
  91.               5)  Bus stop F'tang F'tang Ole Biscuit Barrel.  Fnord.
  92.  
  93.     Moralizing:
  94.  
  95.               Incidentally, I do sort of believe in registering shareware,
  96.               if you get the urge, but what I really believe in is
  97.               donating both your executables AND YOUR SOURCE to anything
  98.               useful you write into the PUBLIC DOMAIN!  If more people
  99.               would share code, the world would be a better place.  For
  100.               instance, this code should save and restore most video modes
  101.               correctly.  It is my sincere hope that someone uses this
  102.               code (or at least some of it) when writing screen savers.
  103.               I currently use one called EXPLOSIV, which only restores
  104.               HALF my screen when I am in 132X43 mode.  It is quite
  105.               annoying.  Anyhow, here it is, and happy Qediting!  ($55
  106.               is a bit pricey, don't you think?)
  107.  
  108.     Future Versions:
  109.  
  110.               Future versions will have the following feature(s):
  111.  
  112.               - Save screen info to EMS, if available
  113.               - Support for MDA
  114.  
  115.               Future versions may have the following features:
  116.  
  117.               - Hercules support
  118.               - Save screen info to XMS, if available
  119.  
  120.               All future versions will also be in the public domain.
  121.  
  122.  
  123.                                                  Shaun Case, 6/6/91
  124.  
  125.