home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff319.lzh / AHDM / AHDM11a.DOC < prev    next >
Text File  |  1990-02-12  |  7KB  |  197 lines
  1. ******************************************************************************
  2. *                                                                            *
  3. *                    AHDM - The Amiga Hard Disk Menu                         *
  4. *                                                                            *
  5. *                              (C) 1990                                      *
  6. *                                                                            *
  7. *                            by Scott Meek                                   *
  8. *                                                                            *
  9. ******************************************************************************
  10.  
  11. Copyright Notice:
  12.    AHDM V1.0a is copyrighted.  However, you are free to distribute it in an
  13.    un-modified fashion so long as this notice and all files are distributed
  14.    together, and unchanged form.  This release (V1.0a) is a limited working
  15.    version of the original program.  A full working version may be obtained
  16.    be sending one of the following:
  17.  
  18.  
  19.       1) 10$ U.S.
  20.          A Blank Disk
  21.          Self addressed stamped mailer
  22.  
  23.       2) A disk with the 'C' source code for a program that you authored.
  24.          Self addressed stamped mailer
  25.  
  26.       3) 4 blank Disks (I get to keep three disks)
  27.                        (Great International Currency isn't it !?!?!)
  28.          Self addressed stamped mailer
  29.  
  30.  
  31.    TO:
  32.          AHDM
  33.          c/o Scott Meek
  34.          P.O. Box 16
  35.          Trenton, MI 48183
  36.  
  37.  
  38. Disclaimer:
  39.    Due to the nature of AHDM V1.0a, I cannot, in any way be held liable for
  40.    for direct, indirect, or incidental damages resulting from from the use
  41.    or mis-use of this program. Enough said.
  42.  
  43.  
  44. You will need the following files:
  45.  
  46.    1) AHDM        The program.
  47.    2) AHDM.TXT    Used to store program data in.
  48.    3) AHDM.NDX    Index into AHDM.TXT.
  49.    4) AHDM.DOC    This file.
  50.  
  51.    The files AHDM.TXT and AHDM.NDX should be placed into the current AmigaDOS
  52.    directory before starting AHDM.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. What it does:
  68.    Placed in your startup-sequence, in place of the LOADWB command (or whatever
  69.    you use to bring up the system), it offers a ten page menu, each page having
  70.    up to ten possible actions.  By double clicking on an action, that action
  71.    will execute any legal AmigaDOS command, most any program, or an AmigaDOS
  72.    script file.
  73.  
  74.    When AHDM is brought up, it's window will contain a top row of 7 gadgets,
  75.    the current date and time, the title of the menu, and 2 columns of black
  76.    gadgets.  The column on the right will contain the description of various
  77.    actions that can be executed.  The column on the left will contain the 
  78.    description of up to 10 pages. ( AHDM V1.0a is a demo. only 2 pages may be
  79.    accessed.)  The current page is highlighted in white.
  80.  
  81. The Gadgets:
  82.  
  83.    ADD:
  84.       Will add an action to the current page. Note that if the current page is
  85.       full, no additions will be made.  When clicked, it brings up 2 string 
  86.       gadgets below.  Enter a brief description, in the 'New Entry:' gadget, 
  87.       of what action is to take place.  Then enter the command to execute 
  88.       below and click 'OK'.
  89.  
  90.    CHANGE:
  91.       Click on an action or page description to change, then edit the string
  92.       gadgets that appear at the bottom of the window and click 'OK'.
  93.  
  94.    DELETE:
  95.       Click on an action to delete and answer the requester.
  96.       Note: Clicking on a page to delete will delete an action.  I still 
  97.       haven't found the bug causing this, but, I shold have it taken care of
  98.       by the next release.  Until then, use the CHANGE gadget to delete a page
  99.       description.
  100.  
  101.    MOVE:
  102.       Click on action to move, then click on page and action to move to.
  103.       Caution: This will delete anything that is in the position that you are
  104.       moving to.  You cannot move a page description.
  105.  
  106.    TITLE:
  107.       Edits the text that appears just below the date/time.
  108.  
  109.    PAGE:
  110.       Adds a page description to the pages column. Note that if the pages
  111.       column is full, no addition will take place.
  112.  
  113.    EXIT:
  114.       Terminates AHDM and updates the files AHDM.TXT and AHDM.NDX with any
  115.       changes made.  You must exit this way to preserve any data added to
  116.       the menu.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. How It Works:
  134.  
  135.       I have provided 10 sample actions and their script files (if any) to
  136.       aquaint you with AHDM and it use.  I suggest you look these over.
  137.       (you can see the sample actions by flipping to page 2 on the menu and
  138.       using the CHANGE gadget to see what each action contains. Click on 
  139.       'OK' when finished with each selection.)  For ease of recognition, I
  140.       have placed a '.bat' extension on each script file.  'TYPE' these out
  141.       to read them.
  142.  
  143.       While some commands can be executed directly from AHDM, like LoadWB or
  144.       any task that does not require user intervention, others need the benefit
  145.       of an open cli window.  These tasks include formatting a disk or copying
  146.       disks.  Executing a format directly from AHDM will immediatly begin to 
  147.       format the disk in the drive without waiting for you to change disks,
  148.       press [RETURN] or click a continue gadget.  For this reason,  PLEASE:
  149.       EXERCISE CAUTION WHEN ADDING A NEW FUNCTION TO THE MENU!!  If in doubt
  150.       use the script file.  Better safe than sorry!!!!
  151.  
  152. Example:
  153.       Here is an example that loads the workbench from the menu.  It is done
  154.       first by direct command, then by script file.
  155.  
  156. ******************************************************************************
  157.       Select 'ADD' and enter
  158.  
  159.       New Entry: Load Amiga Workbench
  160.       Command: SYS:C/LOADWB or C:LOADWB or just LOADWB
  161.  
  162.       It's as simple as that.
  163. ******************************************************************************
  164.  
  165.       To format a disk from the menu, Select 'ADD' and enter
  166.  
  167.       New Entry: Format Drive DF0:
  168.       Command: NewCLI FROM FormatDF0.bat
  169.  
  170.       Now, create an ASCII file named FormatDF0.bat containing the following 
  171.       lines.
  172.  
  173.       FORMAT DRIVE DF0: NAME <name>
  174.       ENDCLI
  175.  
  176. ******************************************************************************
  177.  
  178.       Complete Volume/Pathnames can be used in the command field.  This will
  179.       allow you to keep all of your script files in one directory.
  180.  
  181.       Some programs I have started from AHDM did not function properly at 
  182.       first.  This was due to the fact that I launched them directly from
  183.       AHDM without going thru a script file.  They were therefore run from the
  184.       incorrect directory and could not locate the files the needed to function
  185.       properly.  This was remedied by using a script file to CD to the correct
  186.       directory before running them.
  187.  
  188.       So far, I have not found a program that would not run from AHDM, other
  189.       than certain heavily protected games.  So, if you can't run a program
  190.       from the menu, try a new approach.  Experiment.
  191.  
  192. The End:
  193.  
  194.       Well that is about all there is to it.  Good Luck.
  195.  
  196.       Scott.
  197.