home *** CD-ROM | disk | FTP | other *** search
/ Windows CE - The Ultimate Companion / ROMMAN_CE.iso / Files / Utils / Bookworm / readme.txt < prev    next >
Text File  |  1997-10-28  |  7KB  |  211 lines
  1. Commercial Information
  2. ----------------------
  3.  
  4. BookWorm is not "free software"; it is a commercial product, distributed
  5. as shareware so you can evaluate it to decide whether or not it
  6. meets your requirements before buying it. The evaluation version may
  7. be used for a maximum of 30 days, and is fully functional except that
  8. it will only run for a maximum of 10 minutes at a time.
  9.  
  10. To purchase BookWorm, either use the ICL Software Technologies web
  11. site at:
  12.  
  13.     http://www.iclsofttech.com/centrivex
  14.  
  15. or refer to the enclosed order form "order.txt".
  16.  
  17.  
  18. Introduction
  19. ------------
  20.  
  21. BookWorm is a "reader" for plain ASCII text files for Windows CE
  22. palmtop computers. It allows you to:
  23.  
  24.  - display the text using any available font.
  25.  - display the text either horizontally or vertically.
  26.  - automatically scroll the text at any desired speed.
  27.  - set "bookmarks" in the text to mark points of interest.
  28.  - easily move to any point in the text.
  29.  - search for words or phrases.
  30.  
  31. BookWorm is ideal for:
  32.  
  33.  - reading electronic books, such as those produced by the
  34.    "Project Gutenberg" project.
  35.  - accessing reference information easily and efficiently.
  36.  - displaying notes for public speaking.
  37.  - any other application where you need to display information
  38.    in a "hands-off" situation.
  39.  
  40.  
  41. Installing BookWorm
  42. -------------------
  43.  
  44. To install BookWorm on your Windows CE machine, ensure that the
  45. "H/PC Explorer" application is running, and then run the "setup.exe"
  46. program contained in the same directory as this file. Follow the
  47. on-screen instructions to install the program.
  48.  
  49.  
  50. Basic Operation
  51. ---------------
  52.  
  53. BookWorm is a standard Windows CE application, and its use should
  54. be relatively self-explanatory. To open a file to read, select
  55. the "Open" item from the "File" menu, and choose the file from
  56. the standard file selector. Note that BookWorm can only read
  57. text files - do not try to open a word processor document,
  58. spreadsheet, or any other file which is not "plain text"!
  59.  
  60. Once the file is displayed, you can choose the font in which
  61. the text is displayed from the drop-down combo-boxes on the
  62. command bar at the top of the screen. The selected font is
  63. automatically saved between runs of the program - you don't have
  64. to reselect it every time you run BookWorm.
  65.  
  66. BookWorm is primarily controlled using single key presses. These
  67. are all described in the on-line help system, but the main ones
  68. are:
  69.  
  70.  - To start and stop text scrolling, press <Space>. The speed
  71.    and style in which the text scrolls can be set using the
  72.    "Scrolling" item on the "Tools" menu.
  73.  
  74.  - To switch the command bar off or on, giving a larger area in
  75.    which to display text, press the <Escape> key.
  76.  
  77.  - To scroll up or down a page, press <PgUp> or <PgDn>. Since
  78.    these keys are "shifted" on many CE machines, single key
  79.    equivalents are also provided - press <Tab> to scroll up a
  80.    page, and <Enter> to scroll down a page.
  81.  
  82.  - To scroll up or down a single line, press the up or down
  83.    arrow keys.
  84.  
  85.  - Press <Ctrl+Home> to move to the start of the file.
  86.  
  87.  - Press <Ctrl+End> to move to the end of the file.
  88.  
  89. The "View/Goto..." dialog provides a way of rapidly scrolling
  90. to any point in the file, as well as providing a visual
  91. indication of your current location within the file. Selecting
  92. "Goto" from the "View" menu (or pressing <Ctrl+G>) displays
  93. a dialog with a "slider" showing the current position. Dragging
  94. the slider scrolls the text to the corresponding position in
  95. the file.
  96.  
  97.  
  98. Using Bookmarks
  99. ---------------
  100.  
  101. You can set bookmarks to mark important places in the text.
  102. To set a bookmark at the current location in the text, select
  103. "Bookmarks" from the "Tools" menu, or press <Ctrl+B>. Enter
  104. a descriptive name for the bookmark if desired (or simply leave
  105. the default name), and either press <Enter> or tap the <Add>
  106. button to insert the bookmark.
  107.  
  108. To move to an existing bookmark, press <Ctrl+B> to display the
  109. bookmarks dialog, tap the name of the bookmark in the list, and
  110. tap the "Goto" button. Alternatively, simply double-tap the
  111. bookmark name in the list.
  112.  
  113. To delete a bookmark, tap its name in the list, and then tap
  114. the "Delete" button.
  115.  
  116. Note that your current location in the file, and all your
  117. bookmarks, are automatically saved when you either exit the
  118. program or close the file. The information is stored in a
  119. file with a ".wrm" extension in the same directory as the text
  120. file itself. For example, if you are reading a text file whose
  121. name is "\My Documents\Book.txt", Bookworm will create a file
  122. called "\My Documents\Book.txt.wrm" in which to store its
  123. information; this file will be automatically read the next time
  124. you open the file "Book.txt" with BookWorm. Important - do NOT
  125. attempt to open a ".wrm" file with BookWorm itself - it is NOT
  126. a readable text file!
  127.  
  128.  
  129. Searching the File
  130. ------------------
  131.  
  132. BookWorm allows you to search the text for words or phrases.
  133. To display the search dialog, select "Find" from the "View"
  134. menu, or press <Ctrl+F>. Enter the string you wish to locate,
  135. and press <Enter> to locate it. There are two check boxes on
  136. the dialog:
  137.  
  138.  - "Ignore case" allows you to select whether the search is
  139.    "case sensitive" or not. If the box is checked, the search
  140.    will locate the search string regardless of upper-case or
  141.    lower-case letters (eg a search for "house" will locate
  142.    "house", "House", "HOUSE", etc.); if the box is clear, only
  143.    an exact match will be found.
  144.  
  145.  - "Match whole word only" allows you to choose whether to
  146.    locate only whole words, or strings within words. For example,
  147.    if the search string is "ball", then if this box is checked,
  148.    a search will only locate the whole word "ball". If the box
  149.    is clear, the a search for "ball" will also match "ballet",
  150.    "baseball", etc.
  151.  
  152. Note that if you wish to search for a phrase (ie the search
  153. string contains spaces), you must clear the "Match whole word
  154. only" box.
  155.  
  156. When searching, BookWorm starts at the current position in
  157. the file, and searches forward from that point. If the text is
  158. not located, it will ask you if you wish to continue the search
  159. from the beginning of the file.
  160.  
  161. Searching a large file can take a few seconds - be patient!
  162.  
  163.  
  164. Technical Information
  165. ---------------------
  166.  
  167. The way that BookWorm operates is to read words from the text
  168. file one at a time, fitting as many words as possible onto a line.
  169. Single carriage returns are ignored, two (or more) carriage
  170. returns in succession will cause a blank line to be displayed.
  171.  
  172. Eg, if the text file contains:
  173.  
  174. a b c
  175. d e f
  176.  
  177. g
  178. h
  179. i
  180.  
  181. BookWorm will display:
  182.  
  183. a b c d e f
  184.  
  185. g h i
  186.  
  187.  
  188. Resolving Problems
  189. ------------------
  190.  
  191. If the text file is displayed oddly - eg if no paragraph breaks
  192. are shown, or if scrolling occasionaly displays duplicated lines -
  193. some minor editing of the file may be required.
  194.  
  195. BookWorm makes the following assumptions about a file:
  196.  
  197.  - Blank lines really are blank, rather than containing spaces.
  198.  
  199.  - A carriage return immediately follows the last word on each
  200.    line, with no intervening spaces. ie, BookWorm expects:
  201.  
  202.    "This is a line<cr>"
  203.  
  204.    and not:
  205.  
  206.    "This is a line <cr>"
  207.  
  208. Both of these editing tasks are easily accomplished with any
  209. good PC-based text editor.
  210.  
  211.