home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 300 / 279 / readme.doc < prev    next >
Text File  |  1988-02-18  |  17KB  |  284 lines
  1.                     ▄▄   ▄▄  ▄▄▄▄▄▄   ▄     ▄    ▄▄▄ ▄▄▄ ▄▄▄
  2.                     ██   ██  ██▀▀██▌  ██▄ ▄██    ▐█▌ ▐█▌ ▐█▌
  3.                     ██   ██  ██   ██  ███████    ▐█▌ ▐█▌ ▐█▌
  4.                     ███████  ██   ██  ██▐█▌██    ▐█▌ ▐█▌ ▐█▌
  5.                     ██   ██  ██   ██  ██ ▀ ██    ▐█▌ ▐█▌ ▐█▌
  6.                     ██   ██  ██▄▄██▌  ██   ██    ▐█▌ ▐█▌ ▐█▌
  7.                     ▀▀   ▀▀  ▀▀▀▀▀▀   ▀▀   ▀▀    ▀▀▀ ▀▀▀ ▀▀▀
  8.  
  9.                     Hard Disk Menu  Release III  Version 1.2
  10.  
  11.  
  12.  
  13.      HDM III (tm) (ASP)  The HARD DISK MENU (tm) System  February 12, 1988
  14.      Copyright (C) 1986-88 by Jim Hass                 All rights reserved
  15.  
  16.  
  17.      To install HDM III for the first time:
  18.      1. Put the HDM III diskette in drive A:
  19.      2. Key in   A:INSTALL C:\DIR   where C:\DIR is the dir to install to.
  20.  
  21.      To update an existing Hard Disk Menu system:
  22.      1. Put the HDM III diskette in drive A:
  23.      2. Key in  A:UPDATE C:\DIR  where C:\DIR is the dir that contains HDM
  24.  
  25.      To start the Hard Disk Menu III,  change to the directory that it was
  26.      installed in and key in HDM, then press ENTER.
  27.  
  28.      When in HDM III, key in /H and read the Help Screens.
  29.  
  30.      HDM III (tm)  (ASP)                                          Jim Hass
  31.      Hard Disk Menu (tm)                                      P.O. Box 447
  32.      Copyright (C) 1986-88 by Jim Hass           Richfield, OH  44286-0447
  33.  
  34.      ---------------------------------------------------------------------
  35.  
  36.         This program is a  DOS shell  that hides  the underlying operating
  37.      system from the uninitiated user,  yet does not get in the way of the
  38.      expert user.   The basic system consists of  ten menu pages with each
  39.      page having ten selections to choose from.   You start a selection in
  40.      classic Lotus style  by pointing to it  with the cursor  and pressing
  41.      the return key  or  by pressing the  number key  associated with that
  42.      selection.   Each selection can start a program, run a batch file, or
  43.      execute any  DOS command.   A selection can also have  multiple steps
  44.      which  can include any  or  all of the possibilities above.   You can
  45.      change menu  pages by  pressing  F1 thru F10  keys to go  directly to
  46.      page  1 thru 10  or  use the PgUp and PgDn keys.   Each page and each
  47.      selection on each page has a user definable description.
  48.  
  49.         The slash key displays a 1-2-3 type menu at the top of the screen.
  50.      The choices from the menu include:   Help, Add, Change, Delete, Move,
  51.      Page, Run, Exit, and Quit.  If you select HELP you are presented with
  52.      another menu and screens  that explain how to use the  Hard Disk Menu
  53.      system.   ADD,  CHANGE,  DELETE,  and  MOVE  allow  you to  alter the
  54.      description  and  action taken by a  main menu selection.   PAGE lets
  55.      you change the description of a page.   RUN allows you to execute any
  56.      program,  DOS command,  or batch file from within the  Hard Disk Menu
  57.      program.   EXIT returns you to the DOS prompt and QUIT erases the top
  58.      menu and puts you back in the Hard Disk Menu.   Other selections from
  59.      the Top Menu allow you to set up  variables,  passwords,  menu title,
  60.      change colors,  and blank the menu screen after a set amount of time.
  61.  
  62.      ---------------------------------------------------------------------
  63.  
  64.      This is a list of files that should be on your distribution disk:
  65.  
  66.      README.DOC   This file.
  67.      HDM.BAT      The batch file that starts the Hard Disk Menu.
  68.      INSTALL.BAT  The batch file that installs HDM III on your hard disk.
  69.      UPDATE.BAT   The batch file that updates a currently installed HDM III.
  70.      HDMENU.EXE   The main program used by the Hard Disk Menu system.
  71.      HDMENU.TXT   A file used by HDM III to hold configuration and menu info.
  72.      LIST.EXE     A utility program to list a text file to the screen/printer.
  73.      LIST.DOC     A documentation file about using LIST.COM.
  74.      REGISTER.DOC A form useful for registering HDM III.
  75.      HDM.DOC      The HDM III reference and user manual.
  76.      INVOICE.DOC  A form useful if your company requires an invoice.
  77.      EZT.EXE      A genealogy program for tracking family trees. (EZ-TREE)
  78.      EZT.DOC      A documentation file about using EZ-Tree.  (Pre-Release)
  79.      EPSON.EXE    A utility program to set control codes on a Epson printer.
  80.      IBMPRO.EXE   A utility program to set control codes on an IBM Proprinter.
  81.  
  82.      The last two programs can be used in menu entries to send print codes
  83.      to your printer before running programs like 1-2-3, dBase, and others
  84.      that don't provide  easy methods  of printer setup.   An entry in HDM
  85.      might look like this:   C:~CD\DBASE3~EPSON~DBASE~
  86.      They can also be used with the  dBase III run command as part of your
  87.      own program to allow user selection of print styles.
  88.  
  89.      ---------------------------------------------------------------------
  90.  
  91.      SOME COMMON QUESTIONS:
  92.      Q:  What language was the Hard Disk Menu written in?
  93.      A:  Turbo Pascal.
  94.      Q:  After I run a batch file from a menu selection I get a DOS prompt
  95.          instead of returning to the Hard Disk Menu.  What's wrong?
  96.      A:  When DOS runs a batch file (yours) from within a batch file (HDM)
  97.          it does not return  to complete the first batch file  which would
  98.          take you back to the menu.  You can remedy the situation by using
  99.          @@ in front of your batch file name.   If DW3 is a batch file and
  100.          your entry was: CD\DSPWRITE~DW3~ change it to: CD\DSPWRITE~@@DW3~
  101.      Q:  When I press /E to exit HDM,  sometimes I get the  DOS prompt and
  102.          other times I stay in the Hard Disk Menu.   Why does this happen?
  103.      A:  The problem may be this:   if you left HDM by using  /E  and then
  104.          returned to the menu by keying in HDM, you would have called in a
  105.          second copy of the Hard Disk Menu.  While in a secondary HDM, the
  106.          exit command (/E) returns to the primary Hard Disk Menu, not to a
  107.          DOS prompt.   The solution is to make sure you key in EXIT at the
  108.          DOS prompt to return to HDM III. Another reason this could happen
  109.          is that the program can't find the file COMMAND.COM.    This file
  110.          is located by the PATH command in your AUTOEXEC.BAT file.  If you
  111.          don't have a PATH command, add one that points to your DOS files.
  112.          If you don't have an AUTOEXEC.BAT file, see your DOS manual.
  113.      Q:  Some DOS commands work fine from the Hard Disk Menu  while others
  114.          give me a message  that says  "Bad command or file name".    What
  115.          should I do to fix the problem?
  116.      A:  The DOS commands  that work are  probably the  internal commands.
  117.          The system can't find  the external  DOS commands.   See your DOS
  118.          manual  to see  which are  internal and which are external.   The
  119.          solution is a  PATH  command that  shows where the  DOS files are.
  120.          Add this to your AUTOEXEC.BAT file:   PATH C:\DOS
  121.          Replace  C:\DOS  with the directory that  contains your DOS files.
  122.  
  123.      ---------------------------------------------------------------------
  124.  
  125.      ADVANCED FEATURES:
  126.      1.  The HDM command that should be in your AUTOEXEC.BAT file can have
  127.          parameters.   The first parameter is the  page number to display,
  128.          the second one is the  menu selection  on that page  to highlight
  129.          with the cursor.   These two parameters  are positional,  if they
  130.          are not used they will both default to zero. The other parameters
  131.          all begin with a hyphen and can be in any sequence.
  132.  
  133.          -A  would automatically  start the  procedure from  the first two
  134.          parameters.  An example:  if Symphony is on page four  and is the
  135.          tenth selection on that page,  it can automatically be started by
  136.          the following line in your AUTOEXEC.BAT file:  HDM 4 10 -A
  137.          The next parameters  tell HDM  where to find certain files,  they
  138.          all require a drive and directory immediately following the codes
  139.          with no spaces in between.
  140.  
  141.          -C  shows the path to a second copy of the menu text file.   This
  142.          is useful for  backup copies of all  variable data in the menu or
  143.          as the permanent copy of HDMENU.TXT if HDM is used in a ram disk.
  144.          If -C is not used, a second copy of the text file is not created.
  145.  
  146.          -T  shows the path to the text files, HDMENU.TXT, HDMENU.T01-T99.
  147.  
  148.          -W  shows the path to the work file, HDMX.BAT    (created by HDM)
  149.  
  150.          If -T or -W  are not used, the current drive & directory is used.
  151.          An example:   HDM -Cc:\ramdisk -Hc:\help -Tc:\hdmdir -Wc:\ramdisk
  152.  
  153.          -M  tells what menu text file to use,  they are numbered 00 - 99.
  154.          if -M is not used it defaults to  -M00  which uses HDMENU.TXT, if
  155.          another number is used, like -M99,  then file HDMENU.T99 is used.
  156.          This option allows you to use 99 additional  HDM menu text files.
  157.  
  158.          -N  bypasses the initial HDM III title screen.
  159.  
  160.      2.  If the 10,000 entries in HDM III are not enough (using {MENU ##})
  161.          you can use multiple HDM's.   Copy all the HDM III files from the
  162.          original diskette to another drive  or  another directory.   Then
  163.          ADD the following entry to your primary HDM III: C:~CD\DIR~@@HDM~
  164.          where  C: is the drive and  DIR is the subdirectory that contains
  165.          your secondary  HDM III.  When this  entry is  selected  from the
  166.          primary  HDM III, your secondary  HDM III  is displayed and is in
  167.          control.  The /E command will return you to your primary HDM III.
  168.          This is different than using  /E  in the primary HDM  which takes
  169.          you  to the  DOS prompt.    There is  no limit  to the  number of
  170.          secondary  HDM's  and they can all be called from the primary  or
  171.          from other secondaries.
  172.  
  173.          An alternate method of using  secondary HDM's  is to use the same
  174.          Hard Disk Menu program,  but different text (HDMENU.TXT) and work
  175.          files (HDMX.BAT).   This can be done using the -T and -W switches
  176.          explained above.  You will not need to copy any files, a new text
  177.          file will be created when you add your first menu entry, the work
  178.          file is created  as needed.   The action statement  of your  menu
  179.          selection in the primary HDM should look like this:
  180.                            @@HDM -TC:\NEWDIR -WC:\NEWDIR~
  181.          The path C:\NEWDIR  should be replaced by the directory that will
  182.          contain the secondary text file.   This directory must not be the
  183.          same  as the directory  containing  the  primary  Hard Disk Menu.
  184.  
  185.      3.  Variables can be set up  and  used in the action statement of any
  186.          menu selection.   They can also be use with the Run command (/R).
  187.          There are ten variables available,  numbered 0 - 9.  They are set
  188.          up by choosing Variables from the Top Menu (/V), then by choosing
  189.          a number.   You can then enter  any information  to be  stored in
  190.          that variable,  even other variables,  but be careful  not to put
  191.          the program  into a loop  by using a variable  within a  variable
  192.          that directly or indirectly  uses the original variable.   Once a
  193.          variable is set up  it can be referred to by  a menu selection by
  194.          placing an & + number in it.   So if you have variable number one
  195.          set up and one or more action statements containing  &1,  the  &1
  196.          will be  replaced with  the information  that was  stored  in it.
  197.          These variables can also have up to nine parameters,  to use them
  198.          you  must  enclose the  entire  variable  and  its  parameters in
  199.          braces { }.   These parameters  in turn  can then also be used in
  200.          any  action statement,  in any variable,  or in the  Run command.
  201.          They are numbered  1 - 9  and are referred to by placing a  %  in
  202.          front  of it.    The  parameters  can  contain  any  information,
  203.          including variables and other parameters  (&1, &2, %1, %2, etc.).
  204.          Again  you must be careful not to put  the program  in a loop  by
  205.          circular variable  or  parmeter calls.    An  example  of using a
  206.          variable  with a  parmeter  could look  like this  if  &1 = COPY:
  207.                  C:~CD\LOTUS~{&1 FILE.WKS} %1 A:~ERASE %1~
  208.          Everything  within the braces  and the  braces themself  would be
  209.          replaced by  the contents  of variable &1  which is  "COPY".  The
  210.          parameter %1 contains  "FILE.WKS"  because it was the first entry
  211.          (and only in this case)  for the variable &1.   Any %1's that are
  212.          used after this  are replace with  the contents of parameter  %1.
  213.          In this case the action to take becomes:
  214.                  C:~CD\LOTUS~COPY FILE.WKS A:~ERASE FILE.WKS~
  215.          A  more  interesting  version   of  this  variable  and  parmater
  216.          combination would be:  {&1 {?ENTER NAME OF FILE TO COPY & ERASE}}
  217.          This would first prompt the user for a file name,  that file name
  218.          would then be contained in the parameter  %1  which could be used
  219.          anywhere.   As an alternative to this, the variable &1 could have
  220.          contained:   COPY %1~ERASE %1~   instead of just COPY.   Then the
  221.          action to take statement would have been simplified to:
  222.                  C:~CD\LOTUS~{&1 {?ENTER NAME OF FILE TO COPY & ERASE}}~
  223.          Both methods give  the same result  because  the variable &1  now
  224.          contains  the %1's  and  the ERASE  which are  put in  to replace
  225.          the variable call  {&1...}  after the file name  is prompted for.
  226.          The rule is:   Inner braces  get evaluated  before  outer braces.
  227.          Parameters  within a  variable  are  separated  by  spaces,  if a
  228.          parameter contains spaces,  it must be enclosed with braces to be
  229.          evaluated as one parameter.  An example of this is:
  230.                  {&2 THESE ARE SEPARATED PARMETERS}
  231.          The result of  evaluating this variable and parameter combination
  232.          is  &2  will be replaced by the contents of Variable 2 as defined
  233.          by  the  set  up  from  the  Top Menu  (/V),  and  the  following
  234.          parameters  contain this:    %1 = THESE, %2 = ARE, %3 = SEPARATE,
  235.          %4 = PARAMETERS, %5 thur %9 are null.   Another example:
  236.                  {&3 {THIS IS ONE PARAMETER} {THIS IS ANOTHER}}
  237.          This time the  parameters contain:    %1 = THIS IS ONE PARAMETER,
  238.          %2 = THIS IS ANOTHER, %3 thru %9 are null.
  239.          This may be a bit confusing,  but once you understand it  you can
  240.          set up some  very sophisticated  menu selections  that  can  make
  241.          difficult tasks very easy for a user to perform.
  242.          One caution: There is a 255 character limit to the final expanded
  243.          menu action  that could be exceeded  when all  the variables  and
  244.          parameters are expanded.  (HDM III will tell you if this happens)
  245.  
  246.  
  247.      ---------------------------------------------------------------------
  248.      HDM III (tm)  Hard Disk Menu (tm)   Copyright (C) 1986-88 by Jim Hass
  249.      --------------------------------(ASP)--------------------------------
  250.  
  251.      This is a shareware product.  Though HDM III is copyrighted,  you are
  252.      encouraged to copy and distribute this program to others. If you like
  253.      this product and find it useful, then please register it.
  254.  
  255.      Registration Fees:
  256.  
  257.      1 to 4 copies:   $25.00 each  (no discount).
  258.  
  259.      5 to 10 copies:  $20.00 each.
  260.  
  261.      11 to 20 copies: $15.00 each.
  262.  
  263.      Unlimited copies license  for one company:  $500.00  one time charge.
  264.  
  265.      ---------------------------------------------------------------------
  266.  
  267.      With your support, the Hard Disk Menu can continue to be improved and
  268.      expanded.  Send your comments, questions, and registration to:
  269.  
  270.  
  271.  
  272.                                    JIM HASS
  273.                                  P.O. BOX 447
  274.                               RICHFIELD, OH, USA
  275.                                   44286-0447
  276.  
  277.                                 (216) 842-8491
  278.  
  279.                          THANK YOU FOR YOUR SUPPORT!
  280.  
  281.      ---------------------------------------------------------------------
  282.      |    Member of the Association of Shareware Professionals (ASP)     |
  283.      ---------------------------------------------------------------------
  284.