home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / sysutl / hotdos.arc / HOTDOS.DOC < prev   
Text File  |  1986-08-31  |  8KB  |  156 lines
  1.                        THIS IS NOT A DEMONSTRATION VERSION!
  2.                          IT IS THE ACTUAL RELEASE VERSION! 
  3.          
  4.                       Released into the public domain under 
  5.                         SHAREWARE concept -- July 26, 1986
  6.  
  7.                            *** HOT-DOS *** Version 1.18
  8.  
  9.                           Copyright (C) 1985 Robert Best
  10.  
  11.               The  following  documentation  describes  the  operation   of
  12.          HOT-DOS,  a small but powerful program that, with the press of the
  13.          CTRL-SHIFT  --  LEFT-SHIFT  combination,  allows  any    currently
  14.          executing  program  to  be  temporarily suspended so that a second
  15.          copy  of  COMMAND.COM can be loaded and run in the background (the
  16.          aptly named HOT-DOS partition.)
  17.  
  18.               NOTE:--USE  CTRL-LEFT  SHIFT COMBINATION -- NOT LEFT-RIGHT AS
  19.          IN DEMO!
  20.  
  21.               To  exit from HOT-DOS and return to the suspended application
  22.          program, type EXIT at the DOS prompt.
  23.  
  24.  
  25.               The  HOT-DOS Version 1.18 package includes 1 program file and
  26.          this documentation file.  The following list describes each of the
  27.          options  available  as  command  line  parameters  when  executing
  28.          HOT-DOS.
  29.  
  30.               'G'  or  'g'  --  For  use  on  a system using Color/Graphics
  31.          display.   This program will fully restore any CGA graphics screen
  32.          at  the  expense  of an additional 12K memory for use as a buffer.
  33.          It  will  not  restore an EGA graphics display,  but is compatible
  34.          with EGA text modes.
  35.  
  36.               'X'  or 'x' -- For use on a system supporting BOTH monochrome
  37.          and  color/graphics displays.   This program will activate HOT-DOS
  38.          on  whichever  display  is NOT active when the HOT-KEY is pressed.
  39.          From that point on, the user can freely switch displays -- HOT-DOS
  40.          will  properly  restore  the  display  that  was  active  prior to
  41.          escaping  to  the  HOT-DOS  partition.   This  is an indispensable
  42.          utility for users who require simultaneous viewing of two separate
  43.          screens  of data.   As an example,  I usually run my editor in the
  44.          primary  DOS  partition,  then  switch to HOT-DOS for compilation.
  45.          This  arrangement spares the nuisance of exiting and reloading the
  46.          editor,  as  well  as  allowing  viewing  of  compilation   errors
  47.          simultaneous with editing the source code.
  48.  
  49.               Both  the  'x'  and  'g' options can be combined when running
  50.          HOT-DOS.
  51.  
  52.               NOTE:  -- Using the 'x' option of HOT-DOS on a system without
  53.          a  monochrome  adapter  will  cause  a  system  crash  requiring a
  54.          re-boot.
  55.  
  56.               HOT-DOS uses the value of the environment variable COMSPEC to
  57.          determine  the  path  to the COMMAND.COM command interpreter.   It
  58.          will  use  the  value  of COMSPEC that existed just prior to being
  59.          loaded  for the duration of execution.   It is therefore suggested
  60.          that  HOT-DOS  be  run from an AUTOEXEC.BAT file AFTER setting the
  61.          COMSPEC  environment variable.   For optimum use,  it is suggested
  62.          the  COMSPEC be set to a RAM disk drive.   This will cause HOT-DOS
  63.          to  be run instantaneously with each press of the HOT-KEY.   There
  64.          will be no delays waiting for COMMAND.COM to be loaded from floppy
  65.          or  hard  disk media.   A fragment of code to achieve this from an
  66.          AUTOEXEC.BAT file follows: (assume drive E: is a ramdisk)
  67.  
  68.               copy a:command.com e:\ set COMSPEC=E:\COMMAND.COM hotdos
  69.  
  70.  
  71.               To load this version of HOT-DOS, use the following syntax:
  72.  
  73.               HOTDOS [n] [/x] [/g]
  74.  
  75.               where n = requested size of HOT-DOS partition (in K) such
  76.          that 20 < n < 576
  77.  
  78.               NOTE: -- The default value of 'n' for HOT-DOS is n=64K
  79.  
  80.               The parameters may be given in any order on the command line.
  81.  
  82.               Examples:  HOTDOS Loads HOTDOS.COM using n=64K,  no graphics,
  83.          one  screen  HOTDOS  100  /g  Loads  HOTDOS.COM using n=100K,  CGA
  84.          graphics restored HOTDOS 250 /x Loads HOTDOS.COM using n=250K, two
  85.          screens HOTDOS /x /g 100 Loads HOTDOS.COM using n=100K,  graphics,
  86.          two screens
  87.  
  88.  
  89.                         TIPS AND PRECAUTIONS USING HOT-DOS
  90.  
  91.               1)  Do  not  load  any  RESIDENT  application  in the HOT-DOS
  92.          partition.   Doing so will surely destroy the integrity of the DOS
  93.          memory  allocation  chain.   All  other  resident software must be
  94.          loaded in the primary DOS partition.
  95.  
  96.               2)  Do  not  load  any  application that will overlay without
  97.          checking  for  the  top  of  memory location stored in the Program
  98.          Segment  Prefix.   A  program  that  overlays  above  the  top  of
  99.          available  memory  (in  the  HOT-DOS partition) will overwrite the
  100.          memory chain block of the primary application,  not to mention the
  101.          PSP and part of the primary application itself!
  102.  
  103.               3)  Do  not  load  BASIC in the HOT-DOS partition if BASIC is
  104.          currently suspended in the primary partition.
  105.  
  106.               4)  If  you  mistakenly  type  EXIT  at the DOS prompt in the
  107.          primary  partition,  immediately  run  a  CHKDSK  on  any    drive
  108.          configured  in  your  system.   For some reason,  running a CHKDSK
  109.          avoids  problems  that  occur  if  you  type  EXIT  in the primary
  110.          partition  and  then immediately escape to HOT-DOS.   This problem
  111.          has  not  been  traced,  but  seems  to  be  a bug in the DOS EXIT
  112.          command.
  113.  
  114.               5)  Previous  versions  of HOT-DOS required certain care when
  115.          pressing  the HOT-KEY to avoid crashing the system during critical
  116.          sections of code execution.  This version has provided substantial
  117.          security  to  prevent  these  cases.   The  HOT-KEY  can safely be
  118.          pressed at anytime.
  119.  
  120.               NOTE:  --  It  is  strongly  suggested,  if  not   absolutely
  121.          required,  to load HOT-DOS first among resident applications.   In
  122.          particular,  to run HOT-DOS and SIDEKICK (tm) simultaneously,  you
  123.          must load SIDEKICK (tm) after loading HOT-DOS.
  124.  
  125.  
  126.                          ** HOT-DOS LICENSING AGREEMENT **
  127.  
  128.               The authorized version of HOT-DOS included in this package is
  129.          copyrighted  material  intended  for  use  in  unaltered     form.
  130.          Distribution of the authorized version of HOT-DOS in any form is a
  131.          violation  of copyright.   The program is provided "AS IS" without
  132.          any warranty of any kind.  Should the program prove defective, the
  133.          user  shall  assume  the  entire  cost of all necessary servicing,
  134.          repair or correction.  Site licensing of the authorized version of
  135.          HOT-DOS  is  available  by  arrangement  with  Robert    Best. The
  136.          authorized  version  of  HOT-DOS  is  intended for use on a single
  137.          machine.   Making  copies  for  use on other machines represents a
  138.          violation of this licensing agreement.
  139.  
  140.  
  141.               July  26,  1986  HOT-DOS is hereby made available for general
  142.          public  use  without any limitations.   This version is the actual
  143.          release,  it  is  NOT  a demo.   It is being distributed under the
  144.          SHAREWARE  concept.   A  contribution  of  $20.00  is requested of
  145.          satisfied users.
  146.  
  147.               Contributions may be sent to:
  148.  
  149.               Robert Best 
  150.               13681 Dall Lane 
  151.               Santa Ana, CA 92705
  152.  
  153.               If  anyone  is  interested in purchasing the source code,  as
  154.          well  as the exclusive marketing rights to any derivative thereof,
  155.          please contact me at the above address to discuss terms.
  156.