home *** CD-ROM | disk | FTP | other *** search
/ Media Share 13 / mediashare_13.zip / mediashare_13 / ZIPPED / OTHER / SMWINV23.ZIP / OLB_READ.ME < prev    next >
Text File  |  1993-08-30  |  15KB  |  276 lines
  1.       ╔═════════════════════════════════════════════════╗
  2.       ║            SeedMaster OLB_READ.ME               ║
  3.       ║ Copyright (c) 1993 White Harvest Software, Inc. ║
  4.       ╚═════════════════════════════════════════════════╝
  5.  
  6. This is intended to provide users of the Online Bible program an intro-
  7. duction to the Online Bible file format compatible version of SeedMaster.
  8.  
  9. HISTORY
  10. ~~~~~~~
  11. Around April 1993, Larry Pierce, author of Online Bible, provided White 
  12. Harvest (among others) with C source code to access his Online Bible 
  13. files. We used it to implemented Online Bible databases into our Seed-
  14. Master/DOS V2.3 program. Since we already had a mature Bible study pro-
  15. gram, it only took about 2 weeks to implement and we went into beta test 
  16. in late June, 1993. Though our file structures are almost the complete 
  17. opposite of Online Bible's (see below), the modularity of the code Larry 
  18. provided and the modular design of our program made the task possible.
  19.  
  20. By late August, 1993, we had Online Bible files running in our SM/Win
  21. beta test version. This is scheduled for release in Sept, 1993.
  22.  
  23. OUR TECHNICAL VIEW OF THE ONLINE BIBLE PROGRAM
  24. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25. From a programming standpoint, the Online Bible program is quite a feat.
  26. Larry uses the PL/1 language, and he must use an old, "small memory 
  27. model" compiler to create his program. "Small memory model" means he is
  28. limited to only 64K of code (programming) and lacks overlay support. That 
  29. he has been able to cram as much function into 64K as he has is amazing.
  30. We use the C language and do not have that limitation. Frankly, we 
  31. probably wouldn't have tried this kind of a program if we did.
  32.  
  33. OUR APPROACH TO ONLINE BIBLE DATABASES
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35. We have not sought to purely "clone" the Online Bible program. We already
  36. have a mature Bible study product, so we have implemented Online Bible
  37. databases within our existing structure. We have tried to add, where 
  38. possible, features to help ease the evaluation or transition for an Online
  39. Bible user to our program. 
  40.  
  41. BIBLE DATABASES SUPPORTED
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~
  43. Generally, we support Online Bible databases that use the "standard"
  44. KJV 31,102 verse layout. As this is released, we are not aware of any
  45. particular databases that are not supported. It is likely that only a
  46. few foreign languages will cause difficulty.
  47.  
  48.  * We know that V6.X files are supported. Older versions may work as
  49.    well. We would guess that V5.X and up would work if they use the 
  50.    31,102 format (most English translations will).
  51.  * We know V6.0 SCHOLAR, AV-LSG, AV-RSV, AV-ELB, ELB and AV-NRSV work.
  52.  
  53. Please let us know your experiences. (We realize that we'll hear from
  54. more that don't work than those that do.) We'll list them on our BBS
  55. as we get the feedback.
  56.  
  57. TEXT-BASED RESOURCE SUPPORT
  58. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  59. We support the Online Bible text resources in two ways:
  60.  * We support the native Online Bible format with certain limitations.
  61.    First, files are only access read-only any changes you make are
  62.    NOT SAVED. Second, you cannot Search the resources as you can with
  63.    our format. Third, this format is slower than ours. If you use this
  64.    format and use the DIET compression, you are responsible to load 
  65.    and unload DIET appropriately.
  66.  * We have included a conversion program, OLB2SM.EXE, to convert Online 
  67.    Bible text resources to our format. Instead of spreading text files 
  68.    across many directories, OLB2SM concatenates the text, (stripping 
  69.    extraneous hard returns and spacing to display more info on the 
  70.    screen at one time) and builds two files:  
  71.     * A Text file (ends in .DAT or .SMC)  
  72.     * An Index file (.NDX)
  73.    Again, there are benefits to this approach. First, more efficient 
  74.    disk space usage. Second, faster text access. Third, you can edit
  75.    and update the text. Finally, you can search textual resources. You 
  76.    can search the TSK, Lex, etc., for words or numbers and "page" thru 
  77.    the hits. 
  78.    OLB2SM has a special "Demo" option to convert only a portion of the 
  79.    text resources to conserve disk space while you test and evaluate SM.
  80.    If used, the following limitations are in effect:
  81.     TOPICS:  Only the first 1000 topics are converted.
  82.     WORD P.: Only Matt through Luke.
  83.     SCOFIELD, TREASURY, PEOPLE'S, & NOTES: only Gospel of John.
  84.    See the OLB2SM.DOC file for more details.
  85.  
  86. SUMMARY OF BENEFITS
  87. ~~~~~~~~~~~~~~~~~~~
  88. SM/DOS and SM/Win have program features not found in Online Bible:
  89.    * The ability to run more than one Online Bible database (combin-
  90.      ation or single) at the same time. For instance, you can run side 
  91.      by side windows of the Darby Bible (found in SCHOLAR) beside the 
  92.      LSG (found in AV-LSG) and scroll them together.
  93.    * The ability to run SeedMaster databases beside Online Bible data-
  94.      bases. For instance, you can scroll/search our NKJV, Living Bible, 
  95.      or TEV Bible databases beside your Online Bible texts.
  96.    * An exhaustive list of all Words in a database. You can look up and
  97.      scroll words alphabetically and search directly from our Word List.
  98.    * An integrated text editor. You can edit verse by verse notes or
  99.      the text Resources within SeedMaster with the Bible verses still
  100.      on the screen.
  101.    * Different search result display. SeedMaster displays each search
  102.      verse on a single line with the reference, then a fragment of the
  103.      text to the right. This lets you see and screen about 20 verses at
  104.      a time on a standard 25 line screen (SM/DOS). To see the full text 
  105.      of the verse in context, you simply press <Enter> on it.
  106.    * Search Statistics - a book by book and chapter by chapter summary
  107.      of search "hits".
  108.    * Searches can be saved and merged using AND, OR, XOR, NOT logic.
  109.    * You can search the Text Resources (TSK, etc.).
  110.  
  111. SPECIAL "TWEAKS" FOR ONLINE BIBLE USERS - SM/DOS ONLY!
  112. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  113. We have implemented an alternative function key mapping to let you try
  114. out SeedMaster using most of the familiar Online Bible function keys. 
  115. You can do this three ways:
  116.    * Start SM with the special "=O" option. This will force Online Bible
  117.      key usage and status line prompts in View, Search and Commentarys.
  118.      Example:  SM =O  <Enter>
  119.    * Press <Shift><F1> to toggle Online Bible function key translation
  120.      on and off. Note the status line will change to reflect the new keys.
  121.    * Press <Home> once, then type the Online Bible function key. Note
  122.      that the status line will NOT change when you press <Home>.  
  123.    * Online Bible has some undocumented, basic "WordStar" cursor keys.
  124.      These are now supported by SeedMaster.
  125.    * If you have extended memory and have HIMEM.SYS loaded in your
  126.      CONFIG.SYS file, SM will cache Online Bible files into this high
  127.      memory. Speeds, even for multiple databases, are pretty quick.
  128.  
  129. SM/Win NOTE: Since Windows reserves many of the function keys, and
  130. since the Windows environment is rather different than the DOS Online
  131. Bible environment, we did not attempt implementing Online Bible keys.
  132.  
  133. ABOUT OUR SHAREWARE REGISTRATION
  134. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  135. The distribution of Online Bible is unique, as Larry seeks no compen-
  136. sation for his work. His financial needs are met via other means. 
  137. Frankly, we do not enjoy that freedom. We are sympathetic to his approach, 
  138. as we distribute SeedMaster as Shareware. We ask those who find the
  139. program useful to register their use with us for $30 (SM/DOS, or $40 
  140. for SM/Win). This includes:
  141.    * Putting you on our mailing list for updates/enhancments
  142.    * Sending a full, printed and indexed manual (over 90 pages)
  143.    * Sending the latest version of our progam, and
  144.    * Providing us compensation for our efforts.
  145.  
  146. Please note that the requested registration fee is ONLY for the use of 
  147. our program. We DO NOT ask any additional registration fees for each 
  148. "Shareware" Bible database. (If you obtain them from us, our fees cover 
  149. duplication expenses, etc.). We allow people to freely copy our non-copy-
  150. righted (non-royalty) Bible databases (we obtained many from Online 
  151. Bible). We simply ask to be compensated for our efforts in creating and 
  152. enhancing the program. This is where we spend the bulk of our time. 
  153.    (For more information, see Registration Info on the Help Menu.)
  154.  
  155. INTRODUCTORY SPECIAL
  156. ~~~~~~~~~~~~~~~~~~~~
  157. Through 10/1/93, order the NKJV, TLB, or TEV for $25 ($5 off). Just
  158. mention this Online Bible Introductory Special on the order form
  159. and adjust the price. 
  160.  
  161. SUGGESTIONS / QUESTIONS
  162. ~~~~~~~~~~~~~~~~~~~~~~~
  163. We are always open to suggestions and questions. Be gentle, but
  164. direct. You can contact us at:
  165.     White Harvest Software, Inc.
  166.     PO Box 97153
  167.     Raleigh, NC 27624-7153  U.S.A.
  168.     Voice/Fax: (919) 870-0775 
  169.       (To reach the Fax, press your "Go" or "Start" button BEFORE
  170.        you hear our phone ring.)
  171.     BBS: (919) 846-2141
  172.  
  173. WHICH BIBLE DATABASES (SM or OLB) SHOULD YOU USE?
  174. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  175. As stated earlier, Online Bible databases are designed very differently
  176. from our native SeedMaster databases. Naturally, Larry prefers his format, 
  177. and we prefer ours. Nevertheless, the following is our best attempt at 
  178. an objective assessment the differences between the two designs:
  179.  
  180. Because of the Online Bible program's "small memory model", Larry has 
  181. had limited code space and gobs of memory left over to "cache" files 
  182. in memory. So, Larry designs very tightly coded and compressed Bible 
  183. texts and indexes. He loads key index and decompression files (100K to 
  184. 200K) into memory for fast access. Otherwise, access speed would be 
  185. rather slow. On your hard disk, therefore, his databases are smaller 
  186. than ours. Because Online Bible must have so much information in memory, 
  187. it can only run one database at a time (which is one reason for the 
  188. "combination" databases).
  189.  
  190. We have never had significant code space limitations. We emphasized:
  191.    * Minimizing hard disk accesses 
  192.    * Conserving memory space, and
  193.    * Providing any combination of Bible databases simultaneously. 
  194. The memory required to decompress one of our databases is only about 5K. 
  195. We also need very few hard disk accesses, so we do not need to cache 
  196. our indexes for speed. The penalty we pay for this is larger database 
  197. files (about 4MB each version). It has been our position that hard disk 
  198. space is "cheap", at least compared with a user's study options and time. 
  199. Therefore, we prefer to err on the side of large files to gain greater 
  200. flexibility and speed. When we run Online Bible databases, we performed 
  201. some "tweaks" and we do try to cache key files (to extended memory in 
  202. SM/DOS if you have HIMEM.SYS loaded in your CONFIG.SYS). However, if 
  203. your memory  is limited, access to Online Bible databases will be slow. 
  204. Under the same constraints, our databases WOULD NOT suffer speed 
  205. degradation.
  206.  
  207. There are other related differences:
  208.  * Online Bible databases do not index all words. They leave out very
  209.    common words such as "the", "and", etc. SeedMaster databases ex-
  210.    haustively index all words.
  211.  * Online Bible databases do not support paragraph markers (or hard
  212.    returns) within the text of a verse--such as in poetry sections.
  213.    SeedMaster databases do support them, when we have that information
  214.    (as in the NIV, TEV, TLB and other databases).
  215.  * In Online combination databases, words are indexed across all Bible
  216.    texts. If a program wants to find out if a word is used only in a 
  217.    given translation, it must read in all possible verses and check for
  218.    that word (slow). All SeedMaster databases are indexed separately.
  219.  
  220. So, we would counsel as follows (this presumes you use our program and
  221. therefore have a choice of databases):
  222.  * If your hard disk space/budget is constrained, use Online Bible
  223.    databases. Note, however, if you use multiple Online Bible data-
  224.    bases, the disk savings can decrease due to the duplication of 
  225.    the AV and Strong's numbers in each database.
  226.  * If your DOS memory is too constrained for SM/DOS to run Online Bible 
  227.    databases quickly--or if you want maximum flexibility in database 
  228.    combinations, use SeedMaster databases. You will find them rather 
  229.    affordable (none over $30).
  230.  
  231. In summary, there is nothing really "wrong" or "evil" about either design 
  232. approach. They reflect both personal philosophies and technical con-
  233. straints. Between them, they do offer a rather complete range of choice 
  234. for the Bible student. We hope you use them to their best advantage.
  235.  
  236. SPECIAL ONLINE BIBLE DATABASE IMPLEMENTATION COMPROMISES
  237. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  238.  * SEARCH WORD VERIFICATION: Because SeedMaster displays so many more
  239.    search verses at a time, and because background verification of
  240.    words in a particular text is impractical, as a default, we do not 
  241.    verify the existance of a word in a given text as Online Bible
  242.    does. We have provided the OLBWORDS.EXE program that will create a
  243.    supplemental database that we can use to verify a word's existance
  244.    quickly. On a 33MHz 386, this program takes about 2 hours to run on
  245.    the SCHOLAR pak, and takes about 450K RAM. 
  246.  * NO STRONG'S IN WORD LIST: We could not justify implementing Online 
  247.    Bible Strong's numbers in our Word List as we do with the SeedMaster 
  248.    version. If you have the SeedMaster STR database, the Word List 
  249.    lists each Strong's number, the Greek/Hebrew word, and the most 
  250.    common AV rendition. The STR has a special file to provide this 
  251.    information quickly. This data is not quickly available within
  252.    Online Bible databases. Since most of the benefit is the supple-
  253.    mental information that we lack, we did not implement it.
  254.  * CROSS REFERENCE NUMBERS (SM/DOS only): If you run the cross-
  255.    references (F10) on Gen 1:1 within Online Bible, it will say 78 
  256.    verses. In SeedMaster, you will get 75. The difference is that 3 
  257.    verses are listed twice, but both give you the same verses to look at.
  258.  * CONVERTING WORD PICTURES: Broadman Press permits Online Bible to
  259.    distribute all 6 volumes royalty-free. They did not choose to do so 
  260.    with our program. We must pay royalties on volumes 5 & 6, and are 
  261.    constrained to only sell them direct. Since OLB2SM converts RWP files 
  262.    to our format, we could be held liable for royalties on the converted 
  263.    files (which would be inumerable). Thus, we only allow OLB2SM to 
  264.    convert volumes 1-4 (copyright has expired). This is not our desire 
  265.    or decision. We do sell the complete set for an affordable $15. 
  266.  
  267. SPECIAL NOTE TO ONLINE BIBLE DEALERS
  268. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  269. We know that there is an army of dealers who sell copies of the Online 
  270. Bible program and databases. It is not our intent to damage your ministry/
  271. business. In fact, we can help. If you also offer our program, you can 
  272. continue to distribute the Online Bible files and add our Bible databases. 
  273. We can provide (at wholesale pricing) our copyrighted databases (some of 
  274. which are not available in Online Bible format). Contact us for details.
  275.  
  276.