home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / hhg105.zip / HHG.MAN < prev    next >
Text File  |  1990-04-12  |  12KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.             Household Goods Inventory Control Program(HHG)
  18.  
  19.                           HHG Version 1.05
  20.                              4/12/90
  21.  
  22.                 Copyright (c) M.J. Cloutier 1989,1990
  23.  
  24.  
  25.  
  26.  
  27. HHG
  28. Command
  29. ______________________________________________________
  30.  
  31. Purpose:  The Household Goods Inventory Management Program
  32.           (HHG) provides a reliable, easy-to-use method to
  33.           create and maintain a detailed inventory of personal
  34.           property.  HHG is menu-driven, provides full mouse
  35.           support and provides on-screen cuing and help functions
  36.           for convenient use by persons with little or no
  37.           computer operating experience.
  38.  
  39. Format:   [d:][path]HHG [Q] ([I] or [L])
  40.           (Q switch available in registered version only)
  41.  
  42. Type:     External
  43.  
  44. Remarks:  Specify parameters as follows:
  45.  
  46.           [d:][path] before HHG to specify the drive and path
  47.           that contain the HHG command file.
  48.  
  49.           [Q] Eliminates the "ticker-tape" noise (registered only)
  50.  
  51.           [I] -- IBM Proprinter & compatibles
  52.           [L] -- HP LaserJet & compatibles
  53.           (default is [E] for Epson & compatibles)
  54.  
  55.           Once in HHG, select the desired '.HHG' file (MUST end
  56.           in '.HHG') from those displayed in the current directory,
  57.           or select a file from a different drive or directory.
  58.           (registered users:  a properly formatted ASCII text file
  59.            ending in '.HHL' can also be chosen)
  60.  
  61.  
  62.  
  63. *** HHG SYSTEM OVERVIEW ***
  64.  
  65.     HHG was developed using Borland's Turbo Pascal 5.0 and TechnoJock's
  66. Turbo Toolkit (Ver 5.0).  The Turbo Toolkit was invaluable in the rapid
  67. coding of HHG.  I would highly recommend it to anyone doing serious
  68. program development in Turbo Pascal.
  69.  
  70.     HHG provides the following functionality:
  71.  
  72.     *  create and maintain a detailed listing of personal property
  73.        items through an interactive, menu-driven cuing sequence.
  74.  
  75.     *  accomodate any level of organization through the creation of
  76.        a heirarchy of major categories, sub-categories, and specific
  77.        items.
  78.  
  79.     *  each category can have up to 255 items or sub-categories.
  80.  
  81.     *  provide the ability to add, edit or delete any category,
  82.        sub-category or item.
  83.  
  84.     *  items consist of the following information:
  85.         - item name (required, all other fields optional)
  86.         - current value
  87.         - date acquired
  88.         - acquisition value
  89.         - serial number
  90.         - user comments
  91.  
  92.     *  enables the user to print the inventory on any IBM/Epson
  93.        compatible printer with or without full item comments.
  94.  
  95.     *  provides full mouse support
  96.  
  97.     *  allow printout of inventory as ASCII text file (registered only)
  98.  
  99.  
  100. *** HARDWARE REQUIREMENTS ***
  101.  
  102.     *  a minimum of 512K RAM
  103.     *  DOS version 3.0
  104.     *  Hard disk (desired, but not required)
  105.     *  IBM/Epson compatible printer (for hardcopy only)
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. HHG User's Manual (Ver 1.05)                                Page 1
  116.  
  117.  
  118. *** USING HHG ***
  119.  
  120.     HHG should be installed on a hard drive, if possible.  HHG has the
  121. ability to operate on files consisting of over 3000 individual items, but
  122. you may find that operation on very large files is too slow on all but the
  123. fastest machines.  For that reason, I recommend that you create several small
  124. inventory files.  As an example, you could create a file for your household
  125. effects, another for your album or stamp collection, and yet another for your
  126. outdoor recreation equipment.  Operation on all files will be much quicker,
  127. and you will still be able to take advantage of the full functionality of the
  128. program.
  129.  
  130. *** OPERATION ***
  131.  
  132.     Type 'HHG' at the DOS prompt using appropriate switches [I] [Q] (see above).
  133. You will be presented with a directory of all available '.HHG' files.  You can
  134. select one of these, or you can create a new file by entering a file name
  135. (with path if desired) ending in '.HHG'.  As HHG accesses a file, it creates a
  136. backup with the extension '.BAK' to guard against inadvertent deletion.
  137. (Registered Users - When saving to an ASCII text file the backup has a '!HL'
  138.  extension)
  139.  
  140.     Items are added to the currently displayed category using <F2>, and
  141. Sub-Categories are added using <F3>.
  142.  
  143.     HHG keeps a running balance of the value of all items and categories.
  144. This balance is displayed as 'Current Value' in the upper right hand corner
  145. of the screen.
  146.  
  147. *** FUNCTION KEYS ***
  148.  
  149. For CATEGORIES:
  150.  
  151.     <ESC>:  MOVE_UP  - Moves Up one category to the 'Parent' of the currently
  152.                        displayed category
  153.     <F1> :  HELP     - Displays the Help Screen
  154.     <F2> :  ADD_CAT  - Adds a new subcategory, and moves down to this new,
  155.                        empty category
  156.     <F3> :  ADD_ITEM - Adds a new item to the currently displayed category
  157.     <F4> :  MOVE     - Allows rearrangement of the items/categories which
  158.                        make up the currently displayed category
  159.     <F5> :  DEL_CAT  - Allows deletion of the displayed category
  160.                        WARNING! - this will also delete all of the components
  161.                                   which make up the selected category
  162.     <F6> :  NAME     - Allows changing the name of the current category
  163.     <F7> :  PRINT    - Allows printing of the displayed category and all of
  164.                        its component parts (items/categories)
  165.     <F8> :  SAVE     - Save the current '.HHG' file
  166.     <F10>:  END      - Exit the program (prompts for SAVE)
  167.  
  168.  
  169. HHG User's Manual (Ver 1.05)                                Page 2
  170.  
  171. For ITEMS:
  172.  
  173.     <ESC>:  MOVE_UP  - Moves Up to the 'Parent' of the currently displayed item
  174.     <F1> :  HELP     - Displays the Help Screen
  175.     <F5> :  DEL_ITEM - Allows deletion of the displayed item
  176.     <F10>:  SAVE_CHG - Used to save editing changes made to displayed item,
  177.                        returns to the parent category upon completion
  178.  
  179. *** PRINTING ***
  180.  
  181.     HHG allows several different print functions/formats to printer and to
  182. disk (to disk for Register users only):
  183.  
  184.     *  A category can be printed without 'Item Information'.  This means
  185.        that the print out will only show the current values of all component
  186.        items/categories
  187.  
  188.     *  A category can be printed with 'Item Information' included.  This
  189.        means that all items will print with Comments, Acquisition Value,
  190.        Serial Number, and Acquisition Date (in addition to Current Value).
  191.  
  192.     *  A category can be written to an ASCII text file ending in '.HHL'.
  193.        This file will contain all item information and can be read back in
  194.        to HHG.  The primary user of this feature are those with non-standard
  195.        printers and those who want to modify the HHG data outside the program.
  196.        (Registered users)
  197.  
  198. *** HHL FILES ***
  199.  
  200.     '.HHL' files are ASCII text files properly formatted for use by HHG.  They
  201. can be created by HHG as mentioned above, or they can be created with an ASCII
  202. text editor and then read in to HHG. (Registed Users Only)
  203.  
  204.     If the '.HHL' file is created or modified using a text editor, the correct
  205. list order must be maintained.  This means that all items in a category must
  206. appear before subcategories.  The Format for '.HHL' files can most easily be
  207. seen by creating one using 'DUMMY.HHG' from inside the HHG program.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.                         
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223. HHG User's Manual (Ver 1.05)                                Page 3
  224.  
  225. *** DISCLAIMER ***
  226.  
  227. EVEN THOUGH NO I HAVE TESTED THIS SOFTWARE AND REVIEWED THIS
  228. DOCUMENTATION, I MAKE NO WARRANTY OR REPRESENTATION, EITHER
  229. EXPRESSED OR IMPLIED, WITH RESPECT TO THE SOFTWARE, ITS QUALITY,
  230. PERFORMANCE, OR FITNESS FOR A PARTICULAR PURPOSE.
  231. IN NO EVENT WILL I, OR ANYONE ELSE WHO HAS BEEN INVOLVED IN
  232. THE CREATION, PRODUCTION, OR DELIVERY OF THIS PROGRAM, BE LIABLE
  233. FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  234. RESULTING FROM ANY DEFECT IN THE SOFTWARE OR ITS DOCUMENTATION,
  235. EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  IN PARTICULAR,
  236. I SHALL HAVE NO LIABILITY FOR ANY PROGRAMS OR DATA STORED OR USED
  237. WITH THIS SOFTWARE, INCLUDING THE COSTS OF RECOVERING SUCH PROGRAMS
  238. OR DATA.
  239.  
  240. *** REGISTRATION ***
  241.  
  242.     Thanks for evaluating HHG.  HHG is a Shareware product.  As  such,
  243. it is made available to the general computing public for evaluation.
  244. If you find this program useful, a donation of $10 would be sincerely
  245. appreciated.  I would also like to hear from you concerning possible
  246. improvements to HHG.
  247.  
  248.                   M.J. CLOUTIER
  249.                   591-B Michelson Rd.
  250.                   Monterey, CA 93940-6233
  251.  
  252.     I can be reached through the CRICKET BBS (Jim Robeson - SysOp) in
  253. Monterey,CA  at (408) 373-3773.
  254.  
  255. *** HISTORY OF REVISIONS ***
  256.  
  257. v1.05
  258.     - provided command line selection of IBM Proprinters and HP 
  259.       LaserJet printers
  260.     - allowed 'level jump' up to 10 levels for HHL files
  261.     - tightened up code (140k to 90k)
  262.     - compressed EXE using LZE (90k to 41k)
  263.  
  264. v1.04
  265.     - fixed various bugs on save/exit, HELP
  266.     - fixed bug that prevented printing very large inventories
  267.     - added support for international character set
  268.     - added switches for music/info (registered users only)
  269.     - added ablility to print file to disk as ASCII text (registered users only)
  270.     - increased flexibility for movement within Category
  271.     - increased Item descriptor field length
  272.     - modified print format for easier readability
  273.     - added more disk I/O error checking
  274.  
  275.  
  276.  
  277. HHG User's Manual (Ver 1.05)                                Page 4
  278.  
  279.  
  280. v1.03
  281.     - Increased Comments and Serial Number Field length
  282.     - Added more printer error checking
  283.  
  284. v1.02
  285.     - Automatic Backup of data files upon program entry.
  286.     - Simplify entry of values (eliminated cents).
  287.     - Fixed unusual date bug.
  288.     - Corrected bug in MOVE procedure.
  289.  
  290. v1.01
  291.     - Initial program release.
  292.  
  293.                     HERE'S HOW SHAREWARE WORKS:
  294.  
  295. You are encouraged to copy the Household Goods Inventory Program diskettes
  296. and share them freely with others.  You have the luxury of trying out the
  297. complete programs at your own pace and in the comfort of your own home 
  298. or workplace.  This is not a crippled or "demo" copy, but the complete 
  299. working version of the program.
  300.  
  301. After you have used HHG for a reasonable evaluation period, you should
  302. either discontinue use of the program or purchase a licensed copy.  Your
  303. support is important and greatly appreciated.  With it, Shareware authors
  304. are encouraged to design and distribute new products. Without it, a great
  305. deal of high quality, low cost software will cease to be available.
  306.  
  307. Why pay at all?
  308. --------------------------------------------------------------
  309.    *  You receive a CURRENT copy of the program
  310.    *  Notification of updates and new versions
  311.    *  Inexpensive upgrade offers
  312.    *  Notification of new products
  313.    *  Your input and ideas help shape future products
  314.    *  A sense of pride and ownership in having honestly
  315.       participated in the Shareware revolution
  316.    *  You help to keep software prices down by supporting a
  317.       distribution method which doesn't depend on expensive
  318.       advertising campaigns.
  319.  
  320. So please dive in and enjoy the fun of legally sharing good software with
  321. your friends and associates. But also be aware of the restrictions, designed
  322. to protect the community of Shareware users and to prevent greedy people from
  323. taking unfair advantage of the trust, hardwork and good will of Shareware
  324. authors.  Exceptions to any of the above listed conditions must be received
  325. in writing from M.J. Cloutier.
  326.  
  327.  
  328.  
  329.  
  330.  
  331. HHG User's Manual (Ver 1.05)                                Page 5