home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / ANSWER40.ZIP / ANSWERS.DOC < prev    next >
Encoding:
Text File  |  1988-04-19  |  6.9 KB  |  162 lines
  1. ANSWERS ! Version 4.0
  2. Copyright 1988 Brian Corll and TEN B.C. Micro Systems,Inc.
  3.  
  4.  
  5. INTRODUCTION 
  6.  
  7.      ANSWERS ! Version 4.0 is a system of three programs which allow you 
  8. to index large text files in such a way as to enable you to retrieve 
  9. information on any topic in the file very quickly, in many cases, 
  10. literally in the blink of an eye ! 
  11.  
  12.      These programs are being distributed as ShareWare in archived format as 
  13. ANSWER40.arc, which should include the following files:
  14.  
  15.      ANSWERS.exe - the runtime module      
  16.  
  17.      ANSWERS.cfg - configuration file, for storing color choices 
  18.     
  19.      PROCESS.exe - the parse and sort module
  20.  
  21.      POINTERS.exe - the indexer and pointers creator
  22.  
  23.      COMMON.wds - a text file, explained below
  24.  
  25.      INDEX.bat - a batch file, to make things a little easier
  26.  
  27.      ANSWERS.doc - this manual
  28.  
  29.  
  30. HOW IT WORKS
  31.  
  32.      Briefly, the system parses a text file, such as a manual, and breaks it 
  33. down into its individual words.  These words are then sorted alphabetically
  34. (natch !) and from this sorted list two files are created: 1) an index file of 
  35. all the unique words which occur in the manual, and 2) a pointers file 
  36. containing the line numbers in which each unique word appears. Meantime, a 
  37. third file has been created which is merely a structured copy of the text file 
  38. itself.  These three files are used by the runtime program to quickly 
  39. locate any subject matter anywhere in the text file. 
  40.  
  41.  
  42. HOW TO USE IT
  43.  
  44.      There is one major rule: the file to be processed must be in ASCII text 
  45. format.  The file name and extension must follow the usual MS-DOS conventions
  46. (eight letters maximum for the file name, three letters for its extension).
  47.  
  48.      Now then, the simple part :
  49.  
  50.      All of the files from the archive must be on the same disk and in the same 
  51. directory as the text file to be processed.  A word of warning: the resulting 
  52. files will take up large amounts of space, so this system is best used on a 
  53. hard disk with lots of room.
  54.  
  55.      To begin processing, simply type the following:
  56.  
  57.      INDEX filename.ext
  58.  
  59.      The program will begin immediately and will keep you informed of what it 
  60. is doing as the indexing progresses.  Processing time averages 
  61. approximately one minute for every 10K of text file size.  When 
  62. processing is complete, three new files should be on your disk, all with 
  63. the same root name, and these extensions : '.dat','.ndx', and '.ptr'.  
  64. These three files are necessary to run the system.  The original text
  65. file can then be deleted (for God's sake, back it up first, though !).
  66.  
  67.      Once the indexing is complete, you are ready to go ! Here's how:
  68.  
  69.      First of all, you should configure the runtime program to use colors for 
  70. the screen display which suit your taste and eyeballs.  To do that, simply type
  71.  
  72.      ANSWERS COLORS
  73.  
  74. and follow the instructions on the screen.  This process creates a file called 
  75. ANSWERS.cfg in which the four allowed color choices are stored.  If this file 
  76. is not present on the disk at run time, ANSWERS ! will use its default colors.
  77.  
  78.     OK. Now for the test drive.  Type ANSWERS filename, that is, just the root 
  79. name (the first eight letters) of the file which you just indexed.  After an
  80. opening screen display (which is just a novelty to amuse you while the index is
  81. being loaded into memory), the topic entry screen will appear.  You have 55
  82. spaces in which to specify the topic you wish to search for.  Type anything you
  83. want any way you want to type it.  If it isn't in the text, ANSWERS ! will let
  84. you know instantly.  There are a few things to keep in mind:
  85.  
  86.      1)  ANSWERS ! can find at most a hundred references to a particular topic.
  87. If 100 references to the topic you want appear on the screen, you may want to
  88. try again and be more specific.  If 102 references to a topic exist in the
  89. text, you won't see the last two.
  90.  
  91.      2) When the references appear on the screen, simply type the number of the
  92. one you want and press the 'Enter' key.  The text will appear on the screen
  93. with the line you chose highlighted.  This line will remain highlighted 
  94. whenever it appears on the screen during highlighting.  To scroll through the 
  95. text, simply press the up and down arrow keys.  When you're finished reading, 
  96. press 'Enter' or the 'Esc' key.  ANSWERS ! will ask if you want to look at 
  97. another reference.  If you answer 'Y', the references will be re-displayed and 
  98. you may choose another.  If you answer 'N', the entry screen will reappear.
  99. To exit ANSWERS ! and return to DOS, simply type DOS as your topic 
  100. entry.
  101.  
  102. That's it !
  103.  
  104. ORAL ROBERTS PART
  105.  
  106.      As I said in the beginning, this program is ShareWare.  For those of you
  107. unfamiliar with this concept, it works like this:
  108.  
  109.      You may use this program on a trial basis for a period of ninety days with
  110. no obligation whatsoever.  You may redistribute it in its present form to other
  111. individuals or bulletin boards.  However, I hold the copyright to this system,
  112. so neither you nor anyone else has the right to modify the program or market it
  113. without my written consent (and my being compensated accordingly !).
  114.  
  115.      Ahem ! Now for some sales talk:
  116.  
  117.      Please keep in mind that you are not licensed to use this program past
  118. ninety days unless you have registered with me as a user and paid the one time
  119. license fee of $ 35 ($ 200 for a corporate site license).  Once this fee has
  120. been paid, you may use the program as often as you want, on as many machines as
  121. you wish.  Future upgrades will then be sent to you for an additional fee of $
  122. 5, payable when the upgrade is received by you.  Checks may be mailed to:
  123.  
  124.  
  125.                              Brian Corll
  126.                              1700 N. 2nd St. #9
  127.                              Harrisburg,PA 17102
  128.                              Tel.: 717-233-3217
  129.  
  130.      Questions or comments should be left as messages on the BBS where you got
  131. these files.
  132.  
  133.      If you like this program and use it, please register.  I'm getting married
  134. on August 6, 1988 , and I can certainly use the money !
  135.  
  136.  
  137. POSSIBLE PITFALLS
  138.  
  139.      The only possible difficulty you may encounter in the use of this program
  140. is the fact that the file sizes are large.  However, this system was designed
  141. to be used with files which are large to begin with, and in these times of huge
  142. hard disks, a couple of million bytes are no big deal, especially when you 
  143. weigh the storage space against the speed and usefulness of the program.  Try
  144. it out and decide for yourself.
  145.  
  146. WHO DONE IT AND WHAT IT IS
  147.  
  148.      I am new to the world of ShareWare, but no longer so new to PC's.  I
  149. received a B.A. in art history from Vassar about five years before the IBM PC
  150. was born.  I create software as a fulltime job and as a hobby.  If you like and
  151. use what I do, let me know.  If you love what I do, pay me !
  152.  
  153.                                     Brian Corll
  154.                                     April 19, 1988
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.