home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / msdos / menu / toadmenu.arc / TOADMENU.DOC < prev    next >
Encoding:
Text File  |  1987-10-30  |  6.6 KB  |  143 lines
  1.                                  TOAD HALL
  2.                              7573 Jennings Lane
  3.                            Fayetteville NC  28303
  4.                                (919) 868-3471
  5.  
  6.                                                             31 October 1987
  7.  
  8.                              TOADMENU DOS SHELL
  9.  
  10.                    Copyright (C) 1987  David P Kirschbaum
  11.                             All Rights Reserved
  12.  
  13.  
  14.  
  15.  
  16.      TOADMENU  is  a version of a DOS shell.   It displays two  menus,  with
  17. various  menu  selection  options.   Menu  selections are  programs  or  DOS
  18. commands that will be executed from TOADMENU.  When that selected program or
  19. command is completed, you will return to TOADMENU.
  20.  
  21.      Move  the  cursor to any desired menu entry with the Up Arrow  or  Down
  22. Arrow  keys.   Move  to the top or bottom of the menu with the Home  or  End
  23. keys.
  24.  
  25.      Toggle  between  the two menu screens by pressing the space bar or  the
  26. Page Up or Page Down keys.
  27.  
  28.      Choose a selection by:
  29.  
  30.           Function key (F1 through F10)
  31.           Cursor movement to the desired entry (and hit RETURN)
  32.           Key character (enter the illuminated character)
  33.  
  34.      Certain  selections  permit you to enter a  "Command  Parameter".   The
  35. Command  Parameter is any text or commands you wish to pass to  the  program
  36. that will execute.  Example:
  37.  
  38.           One  selection is the DOS DIR command.
  39.  
  40.           If you enter no Command Parameter (just hit RETURN),  you will get
  41.           the normal DIR response (all the file names,  sizes,  dates, etc.,
  42.           scrolling  down  the screen).
  43.  
  44.           If  you  enter the Command Parameter "/w" (without  the  quotation
  45.           marks),  TOADMENU will pass the "/w" to DOS.   The entire  command
  46.           will then be "DIR /w", and you'll see the DOS "wide" display (file
  47.           names only, across the screen).
  48.  
  49.           If  you  enter the Command Parameter "*.DOC",  DOS will only do  a
  50.           DIRectory of .DOC type files.
  51.  
  52.                LIST (Buerg's famous file display program) will accept a file
  53.           name at the command line.   (If you enter no file name,  LIST will
  54.           prompt  you for one.)  You can pass the name of the file you  wish
  55.           to display by entering the name (wild cards permitted for LIST) at
  56.           the Command Parameter prompt.
  57.  
  58.                TOADRPT  permits  redirection of its report  or  form  letter
  59.           output.   Certain  menu selections have already forced redirection
  60.           (with  a  ">PRN:",  for  example).   This  redirection  cannot  be
  61.           changed,  so you will NOT get the Command Parameter  option.   Any
  62.           OTHER selection (without the ">PRN:") can be redirected if you use
  63.           the  Command  Parameter.    Example:    ">MYREPORT.NOV"  redirects
  64.           TOADRPT output to the file MYREPORT.NOV.
  65.  
  66.      One menu selection is "Change drive\subdir."  You can move to any drive
  67. or subdirectory in your system by entering the desired path.  (Read your DOS
  68. manual  to  learn more about paths.)  This selection (and others)  uses  the
  69. public domain utility CDD.COM.
  70.  
  71.      Another  menu  selection  is  "Push  to  DOS."   This  permits  you  to
  72. temporarily  return  to DOS and execute any program  or  command.   TOADMENU
  73. remains  in memory,  awaiting your return.   You can return to  TOADMENU  by
  74. entering "EXIT" at the DOS command line.
  75.  
  76.      TOADMENU  remembers  the original drive and subdirectory where  it  was
  77. first called up, and will return you to that drive and subdirectory when you
  78. exit TOADMENU.
  79.  
  80.      TOADMENU requires its command file,  TOADMENU.DAT (a simple text file),
  81. in the current drive and directory, or in DOS's PATH.  (Read your DOS manual
  82. about  the  use  of  the PATH command,  or use  the  public  domain  utility
  83. SEARCH.COM to establish system paths.)
  84.  
  85.      TOADMENU.DAT  provides  TOADMENU  with the menu  selections  and  their
  86. associated  key  characters,   DOS  commands,   and  text.    You  can  edit
  87. TOADMENU.DAT with any text editor (e.g.,  WordStar in the nondocument mode).
  88. However, do NOT make any changes without thoroughly understanding the rules.
  89. They are briefly explained in comments at the beginning of TOADMENU.DAT
  90.  
  91.      TOADMENU  has  been compiled to use the minimum necessary  memory.   It
  92. will,  however,  use  memory space when executing other programs.   If  your
  93. system  is  limited  in memory or you've eaten up huge  amounts  with  other
  94. resident programs or RAM drives,  you may see a DOS error reported  relating
  95. to insufficient memory when you attempt to execute large programs.
  96.  
  97.  
  98. As an example,  my system has 640Kb RAM,  PC-DOS 3.1,  and a 360Kb RAM  disk
  99. installed.   I first ran MEMSIZ.COM (a public domain utility) before running
  100. TOADMENU  to obtain the available free memory.   I then started TOADMENU and
  101. selected  "Push to DOS" to return to DOS.   At this point both TOADMENU  and
  102. DOS's  COMMAND.COM  are  now in residence.   You can see  the  reduction  in
  103. available memory for any program I'd wish to run.
  104.  
  105.      Available memory = 232144 bytes    before TOADMENU
  106.      Available memory = 199088 bytes    TOADMENU's Push to DOS
  107.  
  108.  
  109.  
  110.      TOADMENU  was written in Turbo Pascal v3.0,  and should run on any  PC-
  111. compatible  system (DOS 2.1 or higher).   I acknowledge  contributions  from
  112. several other programmers in the source code.   I maintain the copyright and
  113. all  commercial rights to TOADMENU.   The program and source code,  however,
  114. may be freely distributed,  copied,  and used for any purpose so long as the
  115. following conditions are met:
  116.  
  117.           Author's  name and copyright are not removed from the  program  or
  118.           source code.
  119.  
  120.           The  program  name  is not significantly  changed  from  TOADMENU.
  121.           (Version  numbers,  if patched,  may be indicated by replacing the
  122.           last character with the version number (TOADMEN1, TOADMEN2, etc.).
  123.  
  124.           All credits remain in the source code.
  125.  
  126.           Distribution or copying fees do not exceed $6.00.
  127.  
  128.           The  source code,  sample TOADMENU.DAT,  and documentation must be
  129.           distributed with the executable program.
  130.  
  131.  
  132.      Disclaimer:   The  author accepts no responsibility for the functioning
  133. of TOADMENU,  or for any losses or other damage that may ensue from its  use
  134. in  any  fashion.   The  author  offers  no support  or  assistance  in  the
  135. understanding or use of TOADMENU.  If you wish to modify the TOADMENU source
  136. code,  be my guest.  However be sure to add your own comments indicating the
  137. changes made so that others may undo your foolishness.
  138.  
  139.  
  140. Author:  David P Kirschbaum
  141.          Toad Hall
  142.          kirsch@braggvax.ARPA
  143.