home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 8 / boot-disc-1997-04.iso / PDA_Soft / Psion / utils / Vr3a100 / vr3a.doc < prev    next >
Text File  |  1994-01-09  |  11KB  |  303 lines
  1. Prologue
  2. --------------------------------------------------------------------------
  3.  
  4. This text is based on Gilles Kohl's HP95XL/HP100XL Vertical Reader v1.05
  5. package.  Many thanks to him to allow me to use his text.
  6.  
  7.  
  8. Introduction
  9. --------------------------------------------------------------------------
  10.  
  11. VR stands for 'vertical reader' and will add another use to your
  12. palmtop:  reading 'electronic texts'. (In short, etexts - these are
  13. simply ASCII files and can range from short-stories to entire books
  14. and novels.) Read a book or short-story wherever you have your
  15. palmtop with you: on the train, on the plane, in that boring
  16. conference - no need to carry piles of paper along.
  17.  
  18. VR allows you to hold your palmtop like you would hold a book:
  19. upright, in one hand. Text is much easier to read this way - the
  20. distances the eye has to travel are reduced. VR further increases
  21. readability through the use of proportional fonts and on-the-fly word
  22. wrapping. All navigation and control keys are conveniently located
  23. near your thumb.
  24.  
  25.  
  26. A word about word wrap, page positions and rescan
  27. --------------------------------------------------------------------------
  28.  
  29. Unlike other reader programs, VR doesn't have an 80 column screen at
  30. its disposal and can't output lines from the original text verbatim.
  31. It must break them down into smaller units by using word wrap and
  32. proportional fonts. To save memory, VR doesn't read the whole text
  33. into memory, but works directly on the file level. VR also tries to
  34. gain more space on the screen by reducing horizontal and vertical
  35. whitespace (blanks and empty lines) a bit. While you are reading, VR
  36. remembers the positions (in the file) of the pages you have visited,
  37. so that you can get back to previous pages. Because of this, VR can't
  38. directly jump to the end of your text, for example, if it has not
  39. seen the last page yet.  This is also the reason why you can confuse
  40. VR by changing fonts while reading. When you change the text font,
  41. the amount of text that fits on a page is very likely to change. This
  42. in turn invalidates the page positions VR has remembered - they were
  43. valid for the font previously used. The effect is overlap or gaps
  44. (depending on the new font chosen) between pages. (Only when paging
  45. back, though)
  46.  
  47. The solution is called 're-scan'. VR can be instructed to re-read
  48. your text without actually displaying it, storing updated page
  49. positions as it scans along. This will result in consistent pages,
  50. and will allow you to jump to the last page of the text. Because
  51. scanning may take a long time for larger texts, this operation is 
  52. not automatically done but is available from the menu.
  53.  
  54.  
  55. VR command overview
  56. --------------------------------------------------------------------------
  57.  
  58. All VR commands are directly accessibly via the menu and the
  59. keyboard.
  60.  
  61.  
  62. NEXT PAGE (<up-arrow>, <Enter>, or Psion-n)
  63. PREVIOUS PAGE (<down-arrow>, <Delete>, or Psion-p)
  64. JUMP TO PAGE (</>, or Psion-j)
  65.  
  66. These commands allow the reader to move around in the text. 
  67.  
  68.  
  69. OPEN TEXT FILE (Psion-o)
  70.  
  71. Will pop up a file query dialog to select a new text.  By default, the
  72. directory is "\TXT".  Select a text and press <Enter> to
  73. accept your selection, or cancel using <ESC>. If you select a new text,
  74. the page positions, current page, text font and bookmarks (see below)
  75. of the current text are saved first. Then, VR tries to recover the above
  76. information for the newly opened text. (These are stored in *.VPG
  77. files that have the same name as the text file they refer to.)
  78.  
  79.  
  80. SELECT FONT (<*>, Psion-f)
  81.  
  82. This command will pop up a menu of text fonts.  Select a font to be 
  83. used, and accept it using <Enter> or cancel the menu with <ESC>. 
  84. Be sure to read the section entitled 'A word about word wrap, page 
  85. positions and rescan' above. 
  86.  
  87.  
  88. ZOOM IN  (<.>(>), Psion-z)
  89.  
  90. This command simply cycles forward through the text fonts without any 
  91. further interaction - it is probably most useful when directly accessed 
  92. on the keyboard (by pressing '.').
  93.  
  94.  
  95. ZOOM OUT (<,>(<), Psion-Z)
  96.  
  97. This command simply cycles backwords through the text fonts without 
  98. any further interaction.
  99.  
  100.  
  101. FIRST PAGE (<->, or Psion-<->)
  102.  
  103. Jumps to the very first page of the current text, as you would expect.
  104.  
  105.  
  106. LAST PAGE (<+>, or Psion-<+>)
  107.  
  108. This is less obvious, as this command does _not_ necessarily jump to
  109. the last page of your text. Instead, it can only jump to the last
  110. page VR has ever seen of this text. For an explanation of this
  111. behaviour, refer to the section entitled 'A word about word wrap,
  112. page positions and rescan' above. The last page that VR currently
  113. knows is displayed in the status window, see below.
  114.  
  115.  
  116. DROP BOOKMARK (Psion-r)
  117. GOTO BOOKMARK (Psion-g)
  118.  
  119. These two commands are used to drop bookmarks and jump to them. A
  120. bookmark is simply a saved position in the text file that you can
  121. later return to. Ten bookmarks are available - they are all
  122. initialized to the start of the file. When you select 'Drop Bmk', 
  123. select the bookmark you want to drop and press <Enter> to drop it,
  124. <ESC> to cancel or <SPACE> to view the current bookmark assignment.
  125. You can later go back to that spot
  126. using 'Goto Bmk'. 
  127.  
  128. Note also that bookmarks really remember file positions, not pages.
  129. Suppose you're reading a text in a rather tiny font, drop bookmark 1
  130. on page 7 and then later decide to switch to a larger font and do a 
  131. rescan (see section entitled 'A word about word wrap, page positions
  132. and rescan' above). The page number of bookmark 1 will now be higher
  133. because pages contain less text. Also, bookmark 1 will probably not be
  134. on the top of a page any more. When you jump to bookmark 1, VR will find
  135. the correct location regardless of current page size.
  136.  
  137.  
  138. FULL RESCAN (Psion-</>)
  139. SCAN TO END (Psion-k)
  140.  
  141. These two commands scan your text as if you were reading it very fast
  142. - without displaying the pages (the status window is updated though,
  143. watch it to see the scan progress). A full rescan starts at page 1,
  144. while a rescan to end starts at your current page. You would do a
  145. full rescan to ensure correct page positions after a font change, for
  146. example. A reason for a 'scan to end' might be that you want to go to
  147. the last page of the text.
  148.  
  149.  
  150. ABOUT VR (<help>, or Psion-v)
  151.  
  152. This command will issue some information on your VR version and its
  153. author.
  154.  
  155.  
  156. QUIT (<ESC>)
  157. EXIT (Psion-x)
  158.  
  159. Well, the quit command leaves VR. There are actually two quit
  160. commands:  hitting the <ESC> key will ask for confirmation before 
  161. quitting. Hitting Psion-x will leave VR no questions asked.
  162.  
  163.  
  164. The status window
  165. --------------------------------------------------------------------------
  166.  
  167. VR uses two lines on the bottom of the screen to display some status 
  168. information. The lines looks like this:
  169.  
  170.    Pag: 26/27 Fnt:6 
  171.    Text: filename.txt
  172.  
  173. The PAG information gives the current page number, and the number of
  174. the highest page that VR can currently go to. (It will do so when you
  175. hit the <+> key or select the corresponding command from the menu).
  176.  
  177. The FNT field shows the currently selected text font number.  And TEXT
  178. show the filename of the current viewed file.
  179.  
  180.  
  181. Font nomenclature
  182. --------------------------------------------------------------------------
  183.  
  184. VR fonts are named using the following system:
  185.  
  186.    letter 1: identifies the 'family'.
  187.                s: sans serif font  ('helvetica' style)
  188.                f: font with serifs ('times roman' style)
  189.    letter 2: monospaced or proportional
  190.                m: monospaced
  191.                p: proportional
  192.    letter 3: character set
  193.                a: ascii only (characters from 32 to 126 available)
  194.                x: extended set
  195.    letter 4: type
  196.                n: normal
  197.                b: bold
  198.    letters 5-6: width in pixel for a monospaced font,
  199.                 00 for a proportional font.
  200.    letters 7-8: depth in pixel for a monospaced font,
  201.                 approximate point size for a proportional font.
  202.  
  203. Note:  Currently VR3a only provides fixed width fonts (sm*.*)
  204.  
  205.  
  206. [The following section is copied verbatim from Gilles Kohl's
  207.  documentation, with the references to SHRUNK.TXT removed since
  208.  it is not included with VR3A. -Rob]
  209.  
  210. Where to find more etexts
  211. --------------------------------------------------------------------------
  212.  
  213. There are several sources for etexts that can be read with VR:
  214.  
  215.  
  216. + The Literary forum on CompuServe (GO LITFORUM)
  217.  
  218. The libraries of this forum have a wealth of etexts available for
  219. download. I'd suggest getting an overview by downloading the summary
  220. files first. If you're into SF, get KIRINY.AGA by Mike Resnick 
  221. - a genuine Hugo Award. (All section 17)
  222.  
  223.  
  224. + The Science Fiction and Fantasy Forum on CompuServe (GO SCI-FI)
  225.  
  226. Lots of etexts here too. I read (and liked) SOUL.TXT by Mike Resnick
  227. in Section 3, and BARB.TXT by John Thompson in section 14.
  228.  
  229.  
  230. + The Travel Forum on CompuServe. (GO TRAVSIG)
  231.  
  232. More non-fiction here of course. You'll find travel diaries, saved forum
  233. threads discussing issues important to the frequent traveller, member
  234. written reports and tips, etc.
  235.  
  236. If you're on a hurry, download the files relevant to your
  237. destination, and read while on the plane. Beside the fact-filled,
  238. there's sometimes funny stuff too. (Try XXSHOW.AMS in TRAVSIG lib
  239. section 8. Caution: Adults only.)
  240.  
  241.  
  242. + CDROMs.
  243.  
  244. If your PC or Mac is equipped with a CDROM drive, you can get entire
  245. collections of etexts on CDROM.
  246.  
  247. Here's a short list - those that I have. 
  248.  
  249. * "World Library's 171 Stories of Murder, Mystery, Magic, Terror &more..."
  250.  
  251. Definitely a must if you like Conan Doyle, Edgar Allen Poe, H.P. Lovecraft ...
  252. Has a complete collection of Sherlock Holmes stories.
  253.  
  254. Contact (from the back of the CD):
  255.  
  256. WORLD LIBRARY INC., 12914 Haster Street,
  257. Garden Grove, CA 92640. (714)748-7197 or (800)443-0238
  258.  
  259.  
  260.  
  261. * Bureau Development's "Great Literature" CDROM.
  262. (Runs on both Mac and PC.)
  263.  
  264. Has the texts of 1896 literary classics. Impressive list of
  265. authors and texts. More 'serious' than the above.
  266.  
  267. Contact (from the back of the CD):
  268.  
  269. Bureau Development, Inc., 141 New Road,
  270. Parsipany, NJ 07054. (201)-808-2700
  271.  
  272.  
  273. * Walnut Creek's "SIMTEL-20 MSDOS ARCHIVE"
  274.  
  275. This CD has some 11MB of zipped etexts (probably some 33 MB unpacked)
  276. in its \MSDOS\BOOKS archive. The texts are all from Project Gutenberg
  277. (read more about P.G. below) and include classics like Dr. Jekyll and
  278. Mr. Hide, Moby Dick, The Time Machine ...  If you have an MSDOS
  279. machine and a CDROM drive, the 'SIMTEL archive' is worth getting
  280. anyway, one of the best shareware and PD collections I know of.
  281.  
  282.  
  283. + Project Gutenberg
  284.  
  285. Project Gutenberg was initiated by Prof. Michael S. Hart. Their goal is
  286. to make a maximum of free electronic texts available to everybody.
  287.  
  288. Send e-mail to dircompg@ux1.cso.uiuc.edu for details on the project.
  289.  
  290. To retrieve etexts via FTP: FTP mrcnext.cso.uiuc.edu
  291. (128.174.201.12), (login 'anonymous', password 'your@login') cd etext
  292. and snoop around.
  293.  
  294. To get etexts via e-mail, send the following line by itself to
  295. almanac@oes.orst.edu
  296.  
  297.    send gutenberg catalog
  298.  
  299. then follow the instructions from the Almanac server in Oregon.
  300. (Attention CompuServers: receiving huge e-mail from the Internet may
  301. be dangerous to your CIS bill)
  302.  
  303.