home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / HM11A.ZIP / 11111111.111 / HARMFILE.ZIP / HARMFILE.DOC next >
Text File  |  1992-11-16  |  8KB  |  198 lines
  1.  
  2.                      Harmony File Base Manager v1.0
  3.  
  4.                    (C)Copyright 1992 Concord Software
  5.  
  6.          =====================================================
  7.  
  8.                            Copyright Notice
  9.  
  10.     Harmfile and this documentation are protected under United States
  11.     and international copyright laws.  All rights granted by these
  12.     laws are reserved by the author Jasen M. Fici and Concord Software.
  13.     Under no circumstances shall any part of Harmfile be redistributed
  14.     in any way other than permitted in the distribution policy stated
  15.                            in this document.
  16.  
  17.          =====================================================
  18.  
  19.                           Distribution Policy
  20.  
  21.     This is an evaluation package of Harmfile.  Harmfile is
  22.     NOT in the public domain, nor is it free software.  Instead, in
  23.     order to make Harmfile more use to the public, it is being
  24.     distributed and redistributed as "shareware" under the following
  25.     conditions :
  26.  
  27.         * You MUST register Harmfile for a fee of $10 after 30 days upon
  28.         the first day you use Harmfile.  Simply print out the Concord
  29.         Software REGISTER.FRM and check the Harmfile product.
  30.  
  31.         * Harmfile is distributed in its original distribution
  32.         form.  Do not change, alter or delete in any way the
  33.         contents of the distribution files.
  34.  
  35.         * Harmfile is not to be distributed with any other
  36.         software package without prior written consent from the
  37.         authors.
  38.  
  39.         * Harmfile can not be distributed for any cost exceeding
  40.         a $10 maximum disk copying charge.
  41.  
  42.         * Harmfile may only be distributed in the United States
  43.         of America.
  44.  
  45.         * Harmfile may not be used by any government agency, or
  46.         affiliated government agency.
  47.  
  48.         Distribution of the REGISTERED version of Harmfile in
  49.         any way, shape or form is in direct violation of the law.
  50.         We WILL prosecute.
  51.  
  52.          =====================================================
  53.  
  54.                                 Warranty
  55.  
  56.     Harmfile is provided "AS IS"  without
  57.     warranty of any kind.  The authors will only be held
  58.     responsible to the extent permitted under applicable law.  The
  59.     entire risk is assumed by you.  If any part of Harmfile is
  60.     found defective, the authors are not liable for anything.
  61.  
  62.     DISCLAIMER :  Concord Software, (and it's respective owners)
  63.     make no representations or warranties, either expressed or
  64.     implied, with respect to the contents hereof and specifically
  65.     disclaims any warranties, merchantability or fitness for any
  66.     particular purpose.  Any software described in the manual is
  67.     sold or licensed "AS IS."  Should the programs prove defective
  68.     following their installation or registration (which ever comes
  69.     first), the user (YOU!), (and NOT Concord Software, its
  70.     distributors, or its dealers) assumes the entire cost of all
  71.     necessary servicing, repair, and any incidental or
  72.     consequential damages (including but not limited to monetary
  73.     damages) resulting from any defect in the software.  Further,
  74.     Concord Software reserves the right to revise this publication
  75.     and make changes from time to time in the contents hereof
  76.     without obligation of Concord Software to notify any person of
  77.     such revision or changes.
  78.  
  79.     Information in this document is subject to change without
  80.     notice and does not represent a commitment on the part of
  81.     Concord Software.
  82.  
  83.          =====================================================
  84.  
  85.  
  86.       With all the legal stuff behind us, let's get on with it ...
  87.  
  88.     HARMFILE was made at the request of many sysops to add at least
  89.     SOME amount of file management capability to Harmony BBS.
  90.     With the limited release of Harmony BBS v1.0, I decided to wait
  91.     until v1.1 was finished.  So, here it is -- in all it's glory,
  92.     HARMFILE!
  93.  
  94.          =====================================================
  95.  
  96.         When Harmfile is loaded, it defaults to the first file transfer
  97.         base defined in HMC.  You are immediately brought to a menu
  98.         which allows for the following choices :
  99.  
  100.         Change File Base
  101.         Edit File Descriptions
  102.         Add files to base
  103.         Take files offline
  104.         Quit
  105.  
  106.         Each one will now be explained in as much detail as reasonably
  107.         needed :
  108.  
  109.          =====================================================
  110.  
  111.                               Change File
  112.  
  113.         This option simply lets you choose which file base you currently
  114.         wish to work with.  Harmfile only lets you work with 1 file base
  115.         at a time.  Choose a base by moving the highlighted bar (with
  116.         your up and down cursor keys) to the file base you want to work
  117.         with, then press [ENTER].
  118.  
  119.         The current file base will be displayed at the bottom left hand
  120.         corner of the screen at the main menu.
  121.  
  122.          =====================================================
  123.  
  124.                          Edit File Descriptions
  125.  
  126.         This is the main section of Harmfile.  It lets you edit both the
  127.         single line, and extended descriptions of all files found in
  128.         this base.
  129.  
  130.         The current file will be highlighted.  You can move around with
  131.         your up and down cursor keys, and you can move forward and
  132.         backward entire screens by using your page up and page down
  133.         keys.
  134.  
  135.         To edit the description of the current file, simply start typing
  136.         it.  Harmfile will automatically enter edit mode for that file.
  137.         When you are finished, press [ENTER] to accept the change to
  138.         that file, or press [ESC] to abort the change.
  139.  
  140.         If you accept the changes, Harmfile will automatically advances
  141.         the cursor the next file.
  142.  
  143.         To edit the extended description of a file, make sure that file
  144.         is the current highlighted file, and press Alt-E.  An extended
  145.         description window will pop up and allow you to edit the
  146.         extended description of this file.
  147.  
  148.          =====================================================
  149.  
  150.                            Add Files to Base
  151.  
  152.         This option allows you to add a batch of files to the current
  153.         base at one time.  It is the same as the Add Files to HMC of
  154.         Harmony BBS v1.0.  Simply enter the directory where you new
  155.         files are currently located and press [ENTER].
  156.  
  157.         Next, highlight by press [SPACE] on each file you wish to add to
  158.         the file base.  You can also use the mouse to highlight them.
  159.         When you are finished, press [ENTER].
  160.  
  161.         You should NOT try to add files that are already located in the
  162.         file bases directory -- it won't work!
  163.  
  164.         You will then be asked if you want to erase the original copies
  165.         of all the files you just added.  BE VERY CAREFUL!
  166.  
  167.         Now, just go into Edit File Descriptions mode, and change all
  168.         the descriptions to each file.  See how easy it is?
  169.  
  170.          =====================================================
  171.  
  172.                            Take Files Offline
  173.  
  174.         This option allows you to take files offline that you have on
  175.         this base.  Simply choose this option, and highlight (in the
  176.         same way you highlighted the files in Add Files).
  177.  
  178.         You will then be asked if you want to move the selected files to
  179.         an "offline" directory.  If you wish to save these files, this
  180.         is highly suggested.
  181.  
  182.         Finally, you will be asked if you want to update the file
  183.         statistics for this base.  This should be done immediately,
  184.         but if it isn't, you can leave Harmfile and run HMHOUSE -O.
  185.         Same thing.
  186.  
  187.          =====================================================
  188.  
  189.                                In Closing
  190.  
  191.         That's it.  Simple and sweet.  I will probably be adding
  192.         features to Harmfile as time goes by, but I would really like to
  193.         see an ambitous 3rd part programmer create an all out, superior
  194.         file management tool.
  195.  
  196.          =====================================================
  197.  
  198.