home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / HOME / COMIC15.ZIP / COMICS.DOC < prev    next >
Encoding:
Text File  |  1992-04-16  |  12.6 KB  |  286 lines
  1.  
  2.                                 COMICS
  3.  
  4.                               Version 1.5
  5.  
  6.  
  7. This program is being distributed as "Shareware".  That means you are free to
  8. make as many copies as you like and give them to friends, Bulletin Board
  9. Services, etc.  If you enjoyed using the program, and would like to see the 
  10. Turbo Basic source code, then complete the order form shown below and send 
  11. it, along with a check or money order for $10.00, to:
  12.  
  13.                       Jeff Bangle
  14.                       56 Indiantown Road
  15.                       King George, VA  22485
  16.  
  17. This program makes extensive use of routines found in the Turbo Basic
  18. Database Toolbox.  Since the source code for the Toolbox is copyrighted, I 
  19. can't give you a copy of it.  To modify my program, you will need my source 
  20. code and your own copy of the Database Toolbox.  I will also send along a game
  21. program that plays cribbage, and several utility programs that I have written.
  22. The game and utility programs are written in Turbo Pascal and include full
  23. source code.
  24.  
  25. +------------------------------------------------------------------------+
  26. |  COMICS Version 1.5 Source Code Order Form  ----  (without Toolboxes)  |
  27. |                                                                        |
  28. |  Name _____________________________________                            |
  29. |  Address ___________________________________________________________   |
  30. |  City _____________________________  State ______  Zip _____________   |
  31. |  Phone Number  (____) ________________                                 |
  32. |                                                                        |
  33. |  Source of your copy (friend, BBS, Company, etc.) __________________   |
  34. |  If from BBS or Company, which one _________________________________   |
  35. |                                                                        |
  36. |  Disk Type (check one):   ___ 5 1/4"      ___ 3 1/2"                   |
  37. |                                                                        |
  38.   Allow 4 to 6 weeks for delivery.                                      |
  39. +------------------------------------------------------------------------+
  40.  
  41.  
  42. You may also contact me at the above address if you have any comments or
  43. suggestions about the program.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                            START-UP INSTRUCTIONS
  50.  
  51. To install the program, simply copy it to any formatted disk.  To run it, 
  52. type COMICS at the DOS prompt.  If the necessary database files are not in 
  53. the current directory, the program will create a blank database for you.
  54.  
  55. A sample database is provided with the program to give you an idea of how it 
  56. works before you enter your own data.  It is suggested that you add a few of 
  57. your own records to the sample database, then delete the sample records.  
  58. Several program functions will not work properly on an empty database.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                               RUNNING COMICS
  68.  
  69. After the program finishes loading, you will be presented with the Main Menu,
  70. which has the following options:
  71.  
  72.     Add Records
  73.     Edit Records
  74.     List Records
  75.     Rebuild Files
  76.     Copy Files
  77.     Set Defaults
  78.     DOS Shell
  79.     Quit
  80.  
  81. Each of these options is described later.  On this, or any of the other 
  82. menus, use the arrow keys to move the selection bar to your choice, and then 
  83. press <Enter>.  On any menu where the first letter of each option high-
  84. lighted, such as the Main Menu, pressing the letter corresponding to your 
  85. choice will also select it.
  86.  
  87.  
  88.  
  89. ADD RECORDS 
  90.  
  91. This option allows you to Add new records to the database.  Use the arrow 
  92. keys to move from one entry field to another, or left and right within each 
  93. field.  Pressing <Enter> will take you to the next field; pressing <Enter> on
  94. the last field will write the record to the disk and clear the entry fields 
  95. for the next record.  After the first three fields have been entered, 
  96. pressing <Home> will take you to the Company field; pressing <End> will take 
  97. you to the last field.  The <Insert> key will toggle the program between 
  98. Insert and Overwrite modes.  The shape of the cursor shows which mode it is 
  99. currently in.
  100.  
  101. If you try to enter a record that already exists, the program will tell you 
  102. and give you the opportunity to edit the existing record.  Simply type "yes" 
  103. when asked and you will be able to edit any field in the existing record 
  104. just as in the normal Edit mode detailed below.
  105.  
  106. When you are done Adding records, simply press the <Esc> key after the last 
  107. record has been written to the disk to return to the Main Menu.  Any record 
  108. still on the screen when the <Esc> key is pressed will NOT be saved.  If you 
  109. try to Add a record with a blank Title, the program will return you to the 
  110. Main Menu.
  111.  
  112.  
  113.  
  114. EDIT RECORDS
  115.  
  116. This option allows you to browse through the database, viewing entire 
  117. records, searching for records that meet specified criteria, or Edit any part
  118. of each record.  The Edit Menu on the right side of the screen operates just
  119. like the Main Menu, described above.
  120.  
  121. The Previous and Next options take you to either the previous or to the next 
  122. record.  When not editing a record, the <PgUp> and <PgDn> keys also take you 
  123. to the previous or next records, respectively.  Further, while not editing, 
  124. the <Home> and <End> keys will take you to either the first or last record.
  125.  
  126. The Title option will search for the first record whose Title matches the 
  127. one you enter when asked.  You do not have enter the entire Title:  entering 
  128. "THE" would find both "THE NEW MUTANTS" and "THE UNCANNY X-MEN", but would 
  129. take you to the first issue of "THE NEW MUTANTS" if both were in the 
  130. database. If the program can't find a match, it will take you to the record 
  131. which would normally follow the Title you're looking for.
  132.  
  133. The Issue option will take you to the specified Issue number of the currently
  134. displayed Title.  If that Issue is not in the database, the program will take
  135. you to the record which would normally follow the Issue you're looking for.
  136.  
  137. The Following option will take you to the next Title + Volume after the 
  138. current one.
  139.  
  140. The Search option will take you to the first record in the database that 
  141. meets the criteria you specify.  If you make a mistake, pressing <Esc> will 
  142. abort the process, reset the Search criteria, and return you to the record 
  143. that you were originally at.  The Search Field Menu contains more options 
  144. than can be displayed on screen at once.  Use the up and down arrow keys to 
  145. scroll to hidden parts of the menu, or press <Home> or <End> to go to the top
  146. or bottom of the menu.  The Alpha-Fields option will search each non-numeric 
  147. field for the string of characters you enter.  All Searches are case-
  148. insensitive: any lower-case letters are converted to upper-case for 
  149. comparison purposes.
  150.  
  151. The Continue option will take you to the next record after the current one in
  152. the database that meets the criteria you specified in the last Search.  If 
  153. you make a mistake, pressing <Esc> will abort the process, reset the search 
  154. criteria, and return you to the record you were originally at.  If you 
  155. haven't used the Search option yet this session, Continue will work just like
  156. the Next option.
  157.  
  158. Only the Edit and Delete options actually change the database in any way.  
  159. The Edit option allows you to modify the information in any field.  It works
  160. just like the Add Records function described earlier.  Press <PgDn> from any
  161. field or press <Enter> on the last field to save your changes.  Pressing <Esc>
  162. before saving your changes will restore the original information and return
  163. you to the Edit Menu.  If your changes to the first three fields would result
  164. in duplicate records, the program warns you and restores any changes you just
  165. made to the record.
  166.  
  167. The Delete option will remove the current record from the database.  The 
  168. program will ask you if you wish to remove the current record.  If you type 
  169. "yes" and press <Enter>, the record will be deleted.  However, it will still 
  170. take up space on the disk.  When you next Add records, each will be written 
  171. over the space used by any deleted record.  If you Rebuild the files, as 
  172. explained later, the wasted disk space will also be recovered.  There is no 
  173. way to recover records after they have been deleted; they must be re-Added to
  174. the database from scratch.
  175.  
  176.  
  177.  
  178. LIST RECORDS
  179.  
  180. The List Records option will bring up the List Menu:
  181.  
  182.     Inventory List
  183.     Location List
  184.     Search List
  185.     Quick Report
  186.  
  187. Each of the List Menu options will send output to either the screen or the 
  188. printer as you specify.  Pressing <Esc> on this menu will return you to the 
  189. Main Menu.  The first three options produce lists of records that include the
  190. Title, Volume, and Issue number, as well as the number of each condition 
  191. (Mint, Fine, or Good) you have, the total number, and the record's current 
  192. worth.
  193.  
  194. The Inventory List option produces an alphabetical list of all the comics in 
  195. your collection.  This option, and the next two options as well, will pause 
  196. after each full screen or page.  Pressing <Esc> while paused will return you 
  197. to the List Menu; pressing any other key will continue the report.
  198.  
  199. The Location List option produces an alphabetical list of all the comics in 
  200. the specified Box, and the number of comics in that Box and their current 
  201. total worth.
  202.  
  203. The Search List option produces an alphabetical list of all the comics that 
  204. meet the specified Search Criteria, as detailed in the Edit section earlier. 
  205. It also produces a total of the comics that meet the criteria and their 
  206. current total worth.
  207.  
  208. The Quick Report option produces a one screen or page report that summarizes 
  209. your collection.  It gives the number of active records, the number of 
  210. deleted records, the number of comics of each quality level, the total number
  211. of comics, their total initial price, and the current total worth of your 
  212. collection.
  213.  
  214.  
  215.  
  216. REBUILD FILES
  217.  
  218. The Rebuild Files option will recover any space being wasted by deleted 
  219. records.  It will also try to rebuild your database if it was somehow damaged
  220. (such as having the power shut off while the database was open).  This option
  221. is very time-consuming and requires enough disk space for two copies of the 
  222. database files.
  223.  
  224.  
  225.  
  226. COPY FILES
  227.  
  228. This option allows you to copy your data to and from a back-up database.  The
  229. back-up database will have the same file names, so it must be located in a 
  230. different directory or on a different disk.  Enter the full path (but not the
  231. file names) for both the source and destination files.  The program must be 
  232. able to access a copy of COMMAND.COM for this option to operate.  It will 
  233. look for it on the path specified in the DOS environment.
  234.  
  235.  
  236.  
  237. SET DEFAULTS
  238.  
  239. This option allows you to change the Defaults for the current session of the 
  240. program; you can also save your changes to the disk so they will be active 
  241. the next time you run the program.  You can turn the sound on and off, and 
  242. edit the default source and destination paths for the Copy Files function 
  243. described above.  Pressing <Esc> before the program asks you about saving the
  244. changes will restore the previous defaults.
  245.  
  246.  
  247.  
  248. DOS SHELL
  249.  
  250. This option allows you to leave the program and go to the operating system 
  251. temporarily.  You can execute DOS commands, and if you have enough memory, 
  252. you can run other programs.  When you wish to return to COMICS, type "exit" 
  253. at the DOS prompt and press <Enter>.  If you plan on using this option often,
  254. you might consider executing this program with the COMBAT batch file, which 
  255. was provided to you.  This batch file will display a special message at each 
  256. DOS prompt while in the DOS Shell mode.  This option, like the Copy Files 
  257. option described earlier, needs access to COMMAND.COM in order to operate.
  258.  
  259.  
  260.  
  261. QUIT
  262.  
  263. This, the final option, will close the database files and terminate the 
  264. program.
  265.  
  266.  
  267.  
  268.  
  269.  
  270. BUG REPORT
  271.  
  272. There is still one known bug in this program.  For extra safety, the program 
  273. closes the database files before executing the Rebuild, Copy, or DOS Shell 
  274. options.  Each time it reopens them, it eats up a little more memory.  
  275. Eventually, it will run out of memory and crash while attempting to reopen 
  276. the files.  Since it ALWAYS crashes with the database files closed, there is 
  277. NO DANGER of losing any data.  In four years of using the program with my own
  278. collection of several hundred comics, I have never lost a record.  I have 
  279. not been able to track down the bug, and believe it is inherent in the way 
  280. Turbo Basic handles random file buffers.  
  281.  
  282. If anyone can tell me how to get rid of this bug, I would greatly appreciate 
  283. it.  As I said, it's not dangerous, just damned annoying at times.
  284.  
  285.  
  286.