home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / magcat.zip / MAGCAT.DOC < prev    next >
Text File  |  1991-01-11  |  10KB  |  226 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                     MAGCAT
  10.  
  11.                               Magazine Cataloger
  12.  
  13.                                 by Scott Davis
  14.                                  Box 173
  15.                                  Salt Point, NY 12578-0173
  16.  
  17.                                   January,  1991
  18.                                   Version 2.31
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                      (C) Copywrite 1988-1991 by Scott C. Davis 
  28.                               All Rights Reserved 
  29.  
  30.  
  31.  
  32. 1) Introduction 
  33.  
  34.         MagCat is a program to organize a collection of comic books. 
  35.     MAGCAT can store titles with information on condition, value and with       
  36.     associated comments.  It allows for a clear display of all magazines  
  37.     with hardcopy output if desired and it can also tally up the number 
  38.     of magazines and titles in the collection along with the total value. 
  39.  
  40.         MagCat was developed on the IBM Personal Computer using Turbo 
  41.     Pascal. It should therefore run on any IBM compatible computer.
  42.  
  43.         The MagCat disk should contain the MAGCAT.COM program, an example 
  44.     data file (EXAMPLE.DAT), a program to convert data files from 1.X 
  45.     versions to the current format of 2.X (CONVERT.COM), and this text 
  46.     file (MAGCAT.DOC). 
  47.  
  48. 2) Use of CONVERT program 
  49.         This program is used to convert data files from old format to the    
  50.     new format. To run the program type CONVERT at the DOS prompt.  This    
  51.     will then ask for the names off the old data file names and the new    
  52.     data file name.  The new file will then contain the collection data 
  53.     in an ASCII format usable by MAGCAT 2.X series. 
  54.  
  55. 3) Use of MagCat 
  56.  
  57.         To run the program type MAGCAT at the DOS prompt.  After this         
  58.     MAGCAT is a fully menu driven program. When you first start MAGCAT, 
  59.     it will try to open the file COMICS.DAT, if it does not find this 
  60.     file, it will ask to create it.  You can say no and use any other 
  61.     file as a data file.  As a first try, you may want to use the 
  62.     EXAMPLE.DAT file. 
  63.  
  64.     The first menu gives the following options:
  65.  
  66.                 A)dd new titles 
  67.                 D)elete a title 
  68.                 E)dit the entries in a title 
  69.                 L)ist titles 
  70.                 U)tilities (this takes you to the second menu)
  71.                 V)iew titles 
  72.                 X) exiting from the program 
  73.  
  74.  
  75.         Each of these options gives instructions when it is selected. To 
  76.     select an option press the desired letter. In addition, pressing the 
  77.     escape key will exit from the current screen at any point. 
  78.  
  79.         A short description of each option follows: 
  80.  
  81.                 A) Choose this option when adding a new title. When 
  82.     selected you are prompted to enter a new title name. The title may be 
  83.     entered with any combination of upper and lower case characters, and 
  84.     this is how it will appear in a listing. However, titles can be 
  85.     recalled with this or any other combination of upper and lower case.  
  86.     If the title already exists a message is given and you are returned 
  87.     to the main menu. If it does not exist, you will be prompted to enter 
  88.     data for the title.  Title data consists of issue numbers, value,     
  89.     condition, and an optional comment on the issue.  Any of this     
  90.     information may be omitted. 
  91.  
  92.                 D) Used to delete a title from the database. You are 
  93.     prompted to enter a title which, if found is then removed from the
  94.     listings after a request for verification. 
  95.  
  96.                 E) Option to edit which issues are contained in a given 
  97.     title. Editing a title is a two step process. After entering a title 
  98.     to edit, if the title exists, you are shown the issues that are 
  99.     already contained in the title. 
  100.         1) You are then asked to enter any issues that you want to add.  
  101.     When entering issues, you are prompted for number, value, condition 
  102.     and an optional comment.  The current issues can be reviewed at any 
  103.     time by pressing the '-' key.  Press <RET> when complete. 
  104.         2) Then you are prompted to enter any issues that you want to 
  105.     remove from the database. Again, a '-' will show the current issues 
  106.     present. When finished a <RET> terminates. 
  107.  
  108.                 L) This option is used to get a listing of all titles 
  109.     currently in the database. At any point you can press <ESC> to stop 
  110.     viewing the list and you will be returned to the main menu. 
  111.  
  112.                 Q) Quit from program without saving changes. 
  113.  
  114.                 U) Utility menu. 
  115.  
  116.                 V) The View option takes you to a menu where you can
  117.     choose the type of information about out title that you would like to 
  118.     see.  Available choices are: 
  119.                         C) To see issues and comments 
  120.                         L) To view issue numbers, condition and value 
  121.                         S) Shows just the issue numbers 
  122.  
  123.                 X) Exits out of the program and saves data if changes 
  124.     have been made. To prevent data from being saved you can use the 
  125.     UNsave option from the utility menu. 
  126.  
  127.         The utility menu is the second available menu with the following 
  128.     options: 
  129.                 A)utosave 
  130.                 C)ount titles and values 
  131.                 D)isable autosave
  132.                 E)dit a particular title's entered name 
  133.                 N)ew data files 
  134.                 P)rint out title(s) 
  135.                 S)ave everything that has been entered since starting 
  136.                 U)nsave 
  137.                 X) exit back to main menu 
  138.  
  139.     Each of these options also prompts for input when selected.
  140.  
  141.                 A) During a session, there is an automatic save option 
  142.     which is active on start up.  This will save the data file after 20 
  143.     choices have been made from the main menu.  This can prevent the loss 
  144.     of data if the is a system crash for some reason. 
  145.  
  146.                 C) This tallies up all the titles and issues and prints         
  147.     the count to the screen. Also, it supplies the total current value of       
  148.     all issues contained in the database. 
  149.  
  150.                 D) Disables the autosave so any save must be     done 
  151.     manually, or at the end of a session the data will be saved if     
  152.     there have been changes made.  Be careful of system crashes if you     
  153.     select this option. 
  154.  
  155.                 E) This edit allows you to change how a title name was 
  156.     entered without making it necessary to reenter all the information. 
  157.     You are prompted for the title to change, then you are asked to enter 
  158.     what you would like it to be changed to (i.e., How you want it to 
  159.     appear in listings). 
  160.  
  161.                 N) By default MAGCAT uses COMICS.DAT for storing 
  162.     information.  By using this option, you can switch between several 
  163.     different sets of data files. 
  164.  
  165.                 P) This option will take you to a secondary print menu 
  166.     where you are given a choice of either long or short format.  In both 
  167.     cases when you are prompted for a title, if none is given, all titles 
  168.     will be printed. 
  169.  
  170.                 U) This will cause the program to think that no changes 
  171.     have been made. Therefore, data will not be saved when exiting unless 
  172.     further changes are made. When this option is selected, a manual save     
  173.     must be selected or all changes in the current session will be lost. 
  174.  
  175.                 S) Saves all the data that is presently contained in the 
  176.     computer. This is to protect from power outages, etc.. 
  177.  
  178.                 X) Returns to the main menu. 
  179.  
  180. 3) Notes 
  181.  
  182.  
  183.         This program gives an easy way to keep track of any collection of 
  184.     magazines. It has been tested up to 300 titles with a total of 2700 
  185.     issues. With these entries it still runs very quickly. (Though 
  186.     reading and writing the files may take some time on a slow PC.) 
  187.  
  188.         If you would like to be a registered user and be notified of
  189.     future versions, or if you have any comments or suggestions about
  190.     this program, please send your name and address, version of MAGCAT,
  191.     and where it was obtained, along with a $10 registration fee to:
  192.  
  193.                                 Scott C. Davis
  194.                                 Box 173
  195.                                 Salt Point, NY 12578-0173
  196.  
  197.     MagCat is distributed exclusively on:
  198.  
  199.                                 Krynn BBS
  200.                                 Milton, NY [914] 795-5199
  201.                                 300-2400 Baud, 24 hours
  202.  
  203.  
  204.         I hope that you enjoy using this program and that you find it
  205.     useful in your collecting.
  206.  
  207.     ADDITIONAL UPDATE NOTES
  208.  
  209.         I have made several changes to the program in moving from 1.X to
  210.     2.X.  These include condensing the data files into one file and
  211.     storing them as text.  (This will aid in the simple perusal of the
  212.     data file, as well as making it possible to use other means to create
  213.     the data file.)  Additional information has been added to the
  214.     database of title information, making it easier to keep track of the
  215.     condition and value of your collection.  Also, I have made some
  216.     cosmetic changes to the data input process.  I think that these
  217.     changes will be to the liking of most users.  (I like them.)
  218.         I realize that the are many more things that can be added, and
  219.     some probably will be.  If you have any specific suggestions or
  220.     comments, send them to me (hopefully  along with the registration
  221.     fee) either at the above address or I can be contacted on the KRYNN BBS,
  222.     and I'll see what I can do.  (Several changes in this version came from
  223.     user input.)
  224.  
  225.  
  226.