home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / busi / mystuff.zip / MYSTUFF.DOC < prev    next >
Text File  |  1989-09-16  |  19KB  |  460 lines
  1.  
  2.  
  3.  
  4.  
  5.                                  Mystuff.Exe
  6.  
  7.                                 Version  4.0
  8.  
  9.                              (c) September, 1989
  10.  
  11.                                      by
  12.  
  13.                                Rad Delaroderie
  14.                                  PO Box 1991
  15.                                 Columbus, Ga.
  16.                                     31902
  17.  
  18.                                  written in
  19.  
  20.                                  Turbo Basic
  21.  
  22.  
  23. ---------------------------------------------------------------------------
  24. ---------------------------------------------------------------------------
  25. ---------------------------------------------------------------------------
  26.  
  27.  
  28. *********************
  29. Program Requirements:
  30. *********************
  31.  
  32.      128K RAM
  33.      DOS 2.0 or later
  34.      IBM or compatible
  35.  
  36.  
  37. ---------------------------------------------------------------------------
  38. ---------------------------------------------------------------------------
  39. ---------------------------------------------------------------------------
  40.  
  41.  
  42. *************
  43. Idiosyncrasy:
  44. *************
  45.  
  46.      My  programming  philosophy  is  that a program shows its first sign of 
  47.      failure  the  moment you have to pick up a user's manual to see what to 
  48.      do  next.   With  this  in mind, let me make a few points, and then you 
  49.      should  never  have  to  read  this  file again.  If you do, leave me a 
  50.      scathing message.
  51.      
  52.      I can be contacted at the PO Box listed above, or at
  53.      
  54.           Columbus Connection BBS
  55.           1-404-687-7309
  56.           Rad Delaroderie
  57.  
  58.  
  59. ---------------------------------------------------------------------------
  60. ---------------------------------------------------------------------------
  61. ---------------------------------------------------------------------------
  62.  
  63.  
  64. *************
  65. Packing List:
  66. *************
  67.  
  68. This  package,  whether  ZIPped  or  ARCed,  should  contain  at  least  the 
  69. following files:
  70.  
  71.      MyStuff.Exe    (The executable program file)
  72.      MyStuff.Doc    (This documentation file that you're reading now)
  73.      RadCat.Txt     (A catalog of other available RAD Software programs)
  74.  
  75.  
  76. ---------------------------------------------------------------------------
  77. ---------------------------------------------------------------------------
  78. ---------------------------------------------------------------------------
  79.  
  80.  
  81. ********************
  82. Program Description:
  83. ********************
  84.  
  85.  
  86.      Mystuff.Exe  is  a personal inventory program that maintains a detailed 
  87.      isting  of  your  stuff.   This  type  of  data  file is invaluable for 
  88.      nsurance   purposes.    This   program  will  also  let  you  pull  out 
  89.      information  in  a variety of interesting ways that let you learn a lot 
  90.      about  your  stuff  that  you would never otherwise know if not for the 
  91.      processing abilities of computers when properly programmed.
  92.      
  93.      Despite  the  complex abilities of MyStuff, the program is fairly self-
  94.      explanatory.   However,  you  do  need  to  be  aware  of the following 
  95.      limitations:
  96.      
  97.           * MyStuff will not hold more than 999 items
  98.           
  99.           *  If  the  total  value  of  all  your  things exceed one million 
  100.           dollars,  that  amount  will  not  display properly on the screen, 
  101.           although  the math computations will be correct.  (I'm not worried 
  102.           about  this:   if  you  have  that  much, you've got an accountant 
  103.           anyway...)
  104.           
  105.           * 14 Basic categories are pre-defined as follows:
  106.           
  107.                Appliances
  108.                Cash
  109.                Clothing
  110.                Computer Hardware
  111.                Computer Software
  112.                Electronics
  113.                Furniture
  114.                Jewelry
  115.                Other
  116.                Office Equipment
  117.                Tools
  118.                Vehicles
  119.                Weapons
  120.                Yard Equipment
  121.           
  122.           If  you wish to have a custom category list designed just for you, 
  123.           send  a  list  of 14 categories to me, along with an extra $5, and 
  124.           I'll send you a custom program for you.
  125.  
  126.  
  127. ---------------------------------------------------------------------------
  128. ---------------------------------------------------------------------------
  129. ---------------------------------------------------------------------------
  130.  
  131.  
  132. *****************
  133. To Install & Run:
  134. *****************
  135.  
  136.  
  137.      The  following  instructions assume that you know next to nothing about 
  138.      DOS  or installing and running programs.  I always try to remember that 
  139.      new  computer  users  are  many,  and I wish to make things as easy and 
  140.      clear as possible for these new users.
  141.      
  142.      Floppy disk based users-
  143.      
  144.           Insert  a blank floppy disk into Drive A.  At the DOS prompt, type 
  145.           the following:
  146.           
  147.                a:                            (Enter)
  148.                format a: /v/s                (Enter)
  149.           
  150.           When  the  system  finishes formatting the disk, it will ask for a 
  151.           Volume Label.  Type
  152.           
  153.                Mystuff                      (Enter)
  154.           
  155.           Now  remove  this newly formatted disk from Drive A and insert the 
  156.           disk  containing the Mystuff program files into Drive A.  Type the 
  157.           following:
  158.           
  159.                Copy a:\Mystuff.* b:         (Enter)
  160.           
  161.           Follow  the  instructions as they appear on the screen.  New users 
  162.           should  note  that,  on a single floppy disk system, your computer 
  163.           considers  your single drive to be both Drive A and Drive B.  When 
  164.           you  are  finished,  you  now  have a usable Mystuff program disk.  
  165.           Label  the  disk  and  make  a  copy  for safekeeping.  To run the 
  166.           program,  insert  the  Mystuff  program disk into Drive A.  If the 
  167.           computer is off, turn it on.  Type the following:
  168.           
  169.                a:                            (Enter)
  170.                Mystuff                       (Enter)
  171.           
  172.           The program will now run.
  173.                           
  174.      
  175.      Hard Disk System-
  176.      
  177.           At the DOS prompt, type the following:
  178.           
  179.                c:                            (Enter)
  180.                cd\                           (Enter)
  181.                md \mystuff                   (Enter)
  182.                cd \mystuff                   (Enter)
  183.           
  184.           If  the  original  Mystuff files are on a floppy disk, insert that 
  185.           disk into Drive A and type the following:
  186.           
  187.                copy a:\Mystuff.* c:\Mystuff     (Enter)
  188.           
  189.           If  the  original Mystuff files are already somewhere on your hard 
  190.           disk,  I'll  assume  that,  if you knew enough to get them on your 
  191.           hard  disk  already,  you  know enough to copy them to the Mystuff 
  192.           sub-directory.
  193.           
  194.           To start the program, type the following:
  195.           
  196.                c:                            (Enter)
  197.                cd \Mystuff                   (Enter)
  198.                Mystuff
  199.           
  200.           
  201.      
  202.      Mystuff.Exe  creates  a  data  file, called Mystuff.Dat, when you start 
  203.      entering  your  items.  Database-type programs are by their very nature 
  204.      "file  read/write"  intensive.  For that reason, performance is slowest 
  205.      on  a  floppy  disk,  very  fast on a hard disk, and lightning on a RAM 
  206.      disk.
  207.      
  208.      If  a  small  sample  Mystuff.Dat file is included in this package, you 
  209.      may  immediately  get some idea of Mystuff's features without having to 
  210.      enter  your own items right away.  When you are ready to establish your 
  211.      own  personal  Mystuff.Dat  file,  you  simply erase the sample file by 
  212.      typing the following:
  213.      
  214.                          del Mystuff.Dat         (Enter)
  215.      
  216.      at  the  DOS prompt while in the Mystuff sub-directory, then start from 
  217.      scratch with your own data file.
  218.  
  219.  
  220. ---------------------------------------------------------------------------
  221. ---------------------------------------------------------------------------
  222. ---------------------------------------------------------------------------
  223.  
  224.  
  225. ******************
  226. Using the program:
  227. ******************
  228.  
  229.      Mystuff  starts  with  a  title  page  containing  author and copyright 
  230.      information,  and a brief description of the program.  Pressing any key 
  231.      then displays the focal point of the program-- the Main Menu.
  232.      
  233.      The Main Menu has three choices:
  234.      
  235.           * See the inventory of items on file
  236.           
  237.           * Add an item to the inventory
  238.           
  239.           * Quit the program
  240.      
  241.      I  use  the  "point  &  shoot"  method  for user choices.  That is, you 
  242.      simply  use  the  spacebar  or arrow keys to highlight your choices and 
  243.      press  the  ENTER  key.   The  program  will immediately branch to that 
  244.      section  of  the  program.  You can back out of any part of the program 
  245.      with the ESC key, eventually returning to the Main Menu.
  246.      
  247.      Let's  look  at  the  features  available  in  each  of the above three 
  248.      choices in more detail below--
  249.      
  250.      
  251.      **********************************
  252.      Add an item to the inventory list-
  253.      **********************************
  254.      
  255.      
  256.           If  you highlight this option and press the ENTER key, you will be 
  257.           presented  with  an  entry screen.  Mystuff lets you enter an item 
  258.           in  an  easy  simple  manner.   When  entering information in each 
  259.           field,  note that the entry lines are fully editable; that is, you 
  260.           have   basic   word  processing  capabilities,  including  Insert, 
  261.           Overtype, Delete, Home, End, etc.
  262.           
  263.           Also  note  that  only  the date field is a "required" entry; that 
  264.           is,  you  may  press  the ENTER key without typing anything in the 
  265.           other fields if you wish.  The program will insert "n/a" for you.
  266.  
  267.  
  268.      ******************
  269.      See the inventory-
  270.      ******************
  271.      
  272.      
  273.           This  Main  Menu  option lets you find and/or collate your entries 
  274.           in  a  way  that could never be accomplished in a practical manner 
  275.           by  "thumbing  through" or using a card index filing system.  Upon 
  276.           highlighting  this  option  and  pressing  the  ENTER key, you are 
  277.           presented with a sub-menu that asks whether you would like to see
  278.           
  279.                All items on file, or
  280.                
  281.                Certain items.
  282.           
  283.           *********
  284.           All items
  285.           *********
  286.           
  287.                If  you  wish  to  look  at All of your items on file, simply 
  288.                highlight  this  choice and press the ENTER key.  The program 
  289.                will  then  present  you will another sub-menu that gives you 
  290.                choices  of  how  you  want the list sorted.  Highlight which 
  291.                criterion  you  want  the  list sorted by and press the ENTER 
  292.                key.
  293.           
  294.           *************
  295.           Certain items
  296.           *************
  297.           
  298.                Here  is  where  you can utilize the most powerful processing 
  299.                feature  of  this  program.   If  you  wish to put together a 
  300.                limited  user-defined  list  of  entries in your file, simply 
  301.                highlight  "Certain  items"  and  press  the  ENTER key.  The 
  302.                program  will  then  present  you  with another sub-menu that 
  303.                gives  you  choices  of how you want define the list of items 
  304.                you  want  to see.  Highlight which criterion  wish to search 
  305.                the list by and press the ENTER key.
  306.                
  307.                The  program  will then ask you to enter the phrase, word, or 
  308.                partial  word  that  you  want  the  program  to  find in the 
  309.                particular  field  you  chose.   You  don't  have  to enter a 
  310.                complete  word or phrase.  The program will locate every item 
  311.                that  has  that  particular  sequence  of  characters in that 
  312.                field.
  313.           
  314.           **********************
  315.           Displaying the Results
  316.           **********************
  317.           
  318.                Whether  you've  chosen  All  items  or  Certain  items,  the 
  319.                program  will  go  through the entire list extremely quickly, 
  320.                using  a  very  efficient  sorting  (All  items  selected) or 
  321.                finding  (Certain items selected) algorithm, and then display 
  322.                information  about  the  first  item  in  the sorted or found 
  323.                list.   The spacebar, down arrow, and up arrow go through the 
  324.                list  of  items  one  at a time.  The PgUp and PgDn keys will 
  325.                page  through  the  list  10  items  at a time.  The Home key 
  326.                brings  you  immediately  to  the first item in the list, and 
  327.                the  End  key  brings you immediately to the last item in the 
  328.                list.
  329.                
  330.                The  bottom  line of the screen displays the options that are 
  331.                available  to  you at this point.  You may Print, Modify, and 
  332.                Delete as follows:
  333.                
  334.                
  335.                Print Option-
  336.                
  337.                     Pressing  the  Function  key F2 allows you the choice of 
  338.                     printing  either  the  entire  sorted  or found list, or 
  339.                     just  the  item  entry  currently  shown  on the screen.  
  340.                     Simply  highlight  your  choice and press the ENTER key.  
  341.                     Suggestion:   Set  your  printer  in  the compressed (17 
  342.                     cpi)  mode when printing item lists.  The printout looks 
  343.                     better and, at least for me, is easier to read.
  344.                
  345.                Modify Option-
  346.                
  347.                     You  can  modify any field in any item entry.  Press the 
  348.                     Function  key F4 and then highlight which field you wish 
  349.                     to  modify  and press the ENTER key.  You can then enter 
  350.                     whatever  modified  information  you  wish and press the 
  351.                     ENTER key.
  352.                
  353.                Delete Option-
  354.                
  355.                     Pressing  the  Function key F8 will, after asking you to 
  356.                     confirm,  cause  the  program to permanently delete that 
  357.                     particular item from your data file.
  358.  
  359.  
  360.      *****************
  361.      Quit the Program-
  362.      *****************
  363.      
  364.           If  you wish to Quit the program, simply highlight that option and 
  365.           press the ENTER key.
  366.  
  367.  
  368. ---------------------------------------------------------------------------
  369. ---------------------------------------------------------------------------
  370. ---------------------------------------------------------------------------
  371.  
  372.  
  373. ********
  374. Request:
  375. ********
  376.  
  377.      I  love  compliments.   I  welcome critiques.  I'm open to suggestions.  
  378.      I'll   listen  to  advice.   I'll  consider  criticisms.   I'll  ignore 
  379.      sarcasm.   I'll  seethe  over  insults.   No  matter  what, I encourage 
  380.      feedback  one way or the other.  The bottom line is that someone else's 
  381.      point  of  view  always gives me a wider perspective on my work.  So if 
  382.      you have something to say, make the effort and get in touch with me.
  383.  
  384.  
  385. ---------------------------------------------------------------------------
  386. ---------------------------------------------------------------------------
  387. ---------------------------------------------------------------------------
  388.  
  389.  
  390. *************
  391. Expectations:
  392. *************
  393.  
  394.      If  you  find  that  you  use  the  limited  version  of  this  program 
  395.      regularly,  and  you  are  any  kind of gentleman or lady, I know you'd 
  396.      send  a  miserly  $5  for  a full-featured version of a program that is 
  397.      commercially  worth  a  lot more than that.  Make sure that you specify 
  398.      the  program  name,  version number, and the type floppy disk you need.  
  399.      (Use the order form at the bottom of the accompanying RadCat.Txt file)
  400.      
  401.      If  you  wish  to  use  this  program  in a commercial or institutional 
  402.      environment, contact me and we'll make arrangements.
  403.      
  404.      Finally,  if  this is the limited version, you are encouraged to freely 
  405.      distribute  copies  of  this  program  for  others to review.  However, 
  406.      please  make  sure  to  include  this  MyStuff.Doc file, the RadCat.Txt 
  407.      catalog   file,   and  the  sample  MyStuff.Dat  file  along  with  the 
  408.      MyStuff.Exe file.
  409.  
  410.  
  411. ---------------------------------------------------------------------------
  412. ---------------------------------------------------------------------------
  413. ---------------------------------------------------------------------------
  414.  
  415.  
  416. ********
  417. History:
  418. ********
  419.  
  420.  
  421.      MyStuff.Exe
  422.      Version 1.1
  423.      January, 1989
  424.      
  425.      Mystuff.Exe
  426.      Version 2.0
  427.      May, 1989
  428.      
  429.           *  Considerable  reworking  of  the analysis section of the coding 
  430.           Mystuff.Exe
  431.      
  432.      Version 2.1
  433.      June, 1989
  434.      
  435.           *  User  caught  a  very careless bug that caused a crash when you 
  436.           try to delete an item.  My apologies.
  437.      
  438.      Mystuff.Exe
  439.      Version 3.0
  440.      June, 1989
  441.      
  442.           * Editing features added to data entry fields
  443.           * Even faster sorting routine
  444.      
  445.      Mystuff.Exe
  446.      Version 4.0
  447.      September, 1989
  448.      
  449.           * Screens now functional in either color or monochrome
  450.           * More efficient algorithms
  451.           * Even faster sorting routine
  452.           * Limited version released
  453.  
  454.  
  455. ---------------------------------------------------------------------------
  456. ---------------------------------------------------------------------------
  457. ---------------------------------------------------------------------------
  458.  
  459.                         End of Mystuff.Doc File
  460.