home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / t / txtbk20.zip / TXTBOOK.DOC < prev    next >
Text File  |  1993-02-01  |  15KB  |  287 lines
  1.  
  2.                                     ┌────┐
  3.                                  ┌──┴─┐┌─┴──┐
  4.                               ┌──┴─┐┌─┴┴─┐┌─┴──┐
  5.                            ┌──┴─┐┌─┴┴─┐┌─┴┴─┐┌─┴──┐
  6.                         ┌──┴─┐┌─┴┴─┐┌─┴┴─┐┌─┴┴─┐┌─┴──┐
  7.                         │    ├┤    ├┤    ├┤    ├┤    │
  8.                         └────┘└────┘└────┘└────┘└────┘
  9.                                TXTBook, ver. 2.0
  10.                         Electronic Publishing Software
  11.                        Copyright 1992, 1993 EFD Systems
  12.                                All Rights Reserved
  13.                         ┌────┐┌────┐┌────┐┌────┐┌────┐
  14.                         │    ├┤    ├┤    ├┤    ├┤    │
  15.                         └──┬─┘└─┬┬─┘└─┬┬─┘└─┬┬─┘└─┬──┘
  16.                            └──┬─┘└─┬┬─┘└─┬┬─┘└─┬──┘
  17.                               └──┬─┘└─┬┬─┘└─┬──┘
  18.                                  └──┬─┘└─┬──┘
  19.                                     └────┘
  20.  
  21.                            "Hypertext without Hype"
  22.  
  23. TXTBook, "Hypertext without Hype" and the overlapping pages logo are trademarks
  24. of EFD Systems
  25. ─────────────────────────────────────────────────────────────────────────────
  26.  
  27.   TABLE OF CONTENTS                                                  page
  28.   ┌──────────────────────────────────────────────────────────────────────┐
  29.   │ Title Page ...................................................... 1  │
  30.   │                                                                      │
  31.   │ Table of Contents ............................................... 2  │
  32.   │                                                                      │
  33.   │ Description ..................................................... 3  │
  34.   │                                                                      │
  35.   │ Authoring Books ................................................. 5  │
  36.   │                                                                      │
  37.   │ Reading Books ................................................... 6  │
  38.   │                                                                      │
  39.   │ Error Conditions ................................................ 7  │
  40.   │                                                                      │
  41.   │ Warranty and Disclaimer ......................................... 8  │
  42.   │                                                                      │
  43.   │ License Agreement ............................................... 9  │
  44.   │                                                                      │
  45.   │ Appendix ........................................................ 11 │
  46.   │                                                                      │
  47.   │ Revision History ................................................ 12 │
  48.   └──────────────────────────────────────────────────────────────────────┘
  49. ───────────────────────────────────────────────────────────────────────────────
  50.                                   DESCRIPTION
  51.  
  52. TXTBook is a hypertext-style ASCII file browser which emulates the natural
  53. intuitative feel of a paper media book from the perspective of both reader and
  54. author.  Books are prepared with a word processor or text editor in the same way
  55. that a paper document is prepared.  The reader of a "book" can scroll and flip
  56. pages, jump instantly to any page number, or place a bookmark for later use,
  57. just like with a paper book. Typical computerized conveniences such as text
  58. scans are also provided.  Unique "dynamic links", built automatically by the
  59. software, allow a reader to easily backtrack to the prior location after
  60. searching or browsing.  Hypertext-style publishing can't get any easier!
  61.  
  62. The defining characteristic of hypertext is the use of page "links" to inter-
  63. connect related parts of a document.  The objective is to overcome the inherent
  64. sequential nature of computers and to allow the reader to browse the electronic
  65. document as freely as a paper one.  This page link concept is nothing new.  For
  66. centuries, authors have provided "links" in the form of reference page numbers
  67. and footnotes.  With TXTBook, links are provided in a familiar, traditional way
  68. like this:
  69.  
  70.            Shakespeare (see page 11) was a famous English playwright.
  71.  
  72. Type the reference page number, 11, and press [ENTER] for a live demonstration.
  73. ───────────────────────────────────────────────────────────────────────────────
  74.                               DESCRIPTION (cont'd)
  75.  
  76. As demonstrated above, TXTBook provides "dynamic links" which are built
  77. on-the-fly as the reader jumps from reference to reference using page numbers.
  78. Other hypertext systems require the author to use special software in order to
  79. encode any available links into a document in a special, proprietary format.
  80. With these systems, document production is often a complex and time consuming
  81. process and the result is a "static" document; i.e. all available links have
  82. been fixed by the author and cannot be changed.  In contrast, your existing
  83. ASCII word processor or text editor is all you need to produce a dynamic
  84. computer "book".
  85.  
  86. Page jumps and dynamic links are the key elements which allow TXTBook to provide
  87. unparalled freedom to the computer document reader.  The reader can branch out
  88. in any direction, at any time, to search and browse as easily as with a paper
  89. book and without fear of becoming lost or losing track of the current page.  The
  90. software automatically remembers each stop along the way and can easily return
  91. the reader back to the starting point on demand.
  92.  
  93.  
  94.  
  95.  
  96.  
  97. ───────────────────────────────────────────────────────────────────────────────
  98.                                 AUTHORING BOOKS
  99.  
  100. As noted above, your existing ASCII word processor or text editor is used to
  101. prepare a computer "book" in exactly the same way that a paper book is prepared,
  102. the only difference is page size.  TXTBook considers each screen of text to be
  103. one page in your book.  A text screen can display 24 lines of text, 80 columns
  104. per line, so your editor or word processor should be configured to use this as
  105. the page size.  Your editor should also be configured to use "hard" returns at
  106. the end of a line and to expand tabs into spaces.  The included CLEAN utility
  107. will convert ASCII output from most word processors to the necessary format
  108. should any problems occur.  Aside from these simple considerations, everything
  109. else at the author's discretion.
  110.  
  111. Reference page numbers can be included in a document in any manner of the
  112. author's choosing.  The Shakespeare example on page 3 has the reference page
  113. number embedded into the sentence.  Another possibility is to use footnotes at
  114. the bottom of a page as shown below.
  115.  
  116. Feel free to experiment with jumping and linking using any of the reference
  117. pages shown below.  Remember that pressing ENTER will bring you back here.
  118.  
  119.  
  120.           INDEX - 2   DESCRIPTION - 3   READING BOOKS - 6   ERRORS - 7
  121. ───────────────────────────────────────────────────────────────────────────────
  122.                              READING BOOKS
  123.  
  124. - To begin reading a "book", simply type : TXTBook bookname
  125.  
  126. - Use the PgUp and PgDn keys to page through the document.  Ctrl-PgUp/PgDn jumps
  127.   by 10 pages.  Home and End keys move to the book start/end.  Cursor Arrow keys
  128.   can be used to scroll up/down and left/right.  Press "A" to re-align the
  129.   current page to the screen after scrolling.
  130.  
  131. - To jump to a known reference page, type the number and press the ENTER key.  A
  132.   page link is automatically built before each jump or text scan to allow you to
  133.   return easily.  The last 50 jumps or scans are "remembered" and can be undone
  134.   in order (last undone first) by simply pressing ENTER.
  135.  
  136. - To scan for a particular word or phrase (40 characters or less); press "s" or
  137.   "S" and enter the text when prompted.  Press ENTER to complete the entry and
  138.   begin the scan or press ESC to abort.  If the word or phrase is found, press
  139.   "R" to repeat the scan and look for the next occurance.  Lower case "s"
  140.   performs a case insensitive scan; i.e. capitalization is ignored.  Upper case
  141.   "S" performs a case sensitive scan.
  142.  
  143. - Press "M" to set a bookmark at the current page, press "K" to return
  144.   to the mark later.  The page number "winks" to indicate the mark was set.
  145. ───────────────────────────────────────────────────────────────────────────────
  146.                                 ERROR CONDITIONS
  147.  
  148. The following error messages are reported by TXTBook.
  149.  
  150. - File not found.  Self explanatory.
  151.  
  152. - File Empty.  Self explanatory.
  153.  
  154. - Invalid Index file.  TXTBook uses an internal page index to allow instant access
  155.   to any page in a book.  This index can be saved to disk and re-used later for
  156.   faster loading of large files.  If the index does not match the book, for
  157.   example, if the book as been edited and changed, this message is displayed and
  158.   the index is re-built.
  159.  
  160. - Unexpected file error.  For some unknown reason, data cannot be read from a
  161.   book as needed.  Hopefully, you will never see this message.
  162.  
  163. TXTBook will ignore any data found beyond column 128.  TXTBook will stop reading a
  164. file after 175,000 lines have been read.  This is usually 5-10 meg. of text.
  165.  
  166. TXTBook requires approximately 50K to run properly; however, available memory is
  167. not checked by the software.  Attempts to use the software without sufficient
  168. memory available will likely produce a DOS error.
  169. ───────────────────────────────────────────────────────────────────────────────
  170.                             WARRANTY and DISCLAIMER
  171.  
  172. This software is provided solely "as is".  The author hereby disclaims any and
  173. all warranties, either expressed or implied, including without limitation the
  174. warranties of merchantability and fitness of purpose.  In no event will the
  175. author be liable for any damages, incidential, consequential or otherwise,
  176. resulting from the use or mis-use of this software. In any event, the author's
  177. liability shall be limited to the originial software license purchase price.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193. ───────────────────────────────────────────────────────────────────────────────
  194.                          LICENSE AGREEMENT - SHAREWARE
  195.  
  196. This software is distributed as "shareware".  You are allowed to use the
  197. software for a trial period of 30 days.  If you wish to continue using the
  198. software after the trial period, you must purchase a license. You may distribute
  199. this software to others for use under these same terms provided that the
  200. following conditions are adhered to:
  201.  
  202. 1) No fee may be charged in connection with distribution other than a nominal $5
  203.    fee to cover the cost of materials and postage.  It must be clearly stated
  204.    that any such fees do not constitute a license fee for use of the software.
  205.  
  206. 2) The software is distributed in it's entirety as originally released including
  207.    this documentation file.
  208.  
  209. 3) The software may not be distributed in connection with or incorporated into
  210.    any other software, product or information being distributed, sold or offered
  211.    for sale.
  212.  
  213. See below for more details regarding registration and distribution of the
  214. software by registered users.
  215.  
  216.  
  217. ───────────────────────────────────────────────────────────────────────────────
  218.                        LICENSE AGREEMENT AND REGISTRATION
  219.  
  220. To use this software beyond the trial period requires the purchase of a license
  221. agreement.  A license can only be purchased directly from the author by sending
  222. a check or money order for $25 to:
  223.  
  224.                                   EFD Systems
  225.                             304 Smokerise Circle SE
  226.                                Marietta, GA 30067                CIS:72627,3026
  227.  
  228. Licensed users have the unlimited royalty-free right to distribute copies of the
  229. software in conjunction with other legally distributable documents solely for
  230. the purpose of accessing said documents.  Any such distribution must plainly
  231. indicate to those receiving the software that they have NOT been given similiar
  232. distribution rights to the software.  Such indication can be given by clearly
  233. displaying the following copyright notice:
  234.  
  235. "The included software is copyrighted material and is protected under copyright
  236.  law.  No part of this software may be reproduced or transmitted in any form by
  237.  any means without the expressed written permission of EFD Systems."
  238.  
  239. Personalized versions of the software are available for business or corporate
  240. use at an additional charge.
  241. ───────────────────────────────────────────────────────────────────────────────
  242.                                     APPENDIX
  243.  
  244. Shakespeare, William
  245.  
  246. The English dramatist and poet William Shakespeare was the author of the most
  247. widely admired and influential body of literature by any individual in the
  248. history of Western civilization.  His work comprises 36 plays, 154 sonnets, and
  249. 2 narrative poems.  Knowledge of Shakespeare is derived from two sources:  his
  250. works and those remains of legal and church records and contemporary allusions
  251. through which scholars can trace the external facts of his life.
  252.  
  253.  
  254.  
  255.  
  256. ┌──────────────────────────────────────────────────────────────────────────────┐
  257. │ If you jumped here for the live demonstration, the software has automatically│
  258. │ built a "link" with your last page in order to return you back once you are  │
  259. │ finished here.  To return, simply press ENTER.  An internal "dynamic link" is│
  260. │ built by the software prior to each jump or text scan.  The last 50 jumps or │
  261. │ scans are "remembered" in this way and can be undone in order using ENTER.   │
  262. └──────────────────────────────────────────────────────────────────────────────┘
  263.  
  264.  
  265. ───────────────────────────────────────────────────────────────────────────────
  266.                             REVISION HISTORY
  267.  
  268. 1.0 - 10/11/92 Original release of character mode BOOK.
  269.  
  270. 1.1 - 10/13/92 Fixed problem with sporadic string space corruption.
  271.                Added additional backtracking from reference pages.
  272.                Revised documentation.
  273.  
  274. 1.2 - 12/2/92  Added "bookmark", revised and corrected documentation.
  275.  
  276. 2.0 - 1/25/93  Major Revision.  Revised backtracking mechanism --- ENTER key
  277.                alone now backtracks.  Corrected bug in repeat scan.  Added case
  278.                sensitive search.  Added ability to save index to disk for large
  279.                files.  Much faster searching and indexing. Increased allowable
  280.                file size to 175,000 lines (approx. 10 meg.).  Changed name to
  281.                TXTBook due to problems with the name "BOOK",
  282.  
  283. Licensed users of TXTBook may upgrade to any later version for a $5 shipping and
  284. handling fee.
  285.  
  286. *** End of Book ***
  287.