home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Windows CE - The Ultimate Companion
/
ROMMAN_CE.iso
/
Files
/
Utils
/
Bookworm
/
readme.txt
< prev
next >
Wrap
Text File
|
1997-10-28
|
7KB
|
211 lines
Commercial Information
----------------------
BookWorm is not "free software"; it is a commercial product, distributed
as shareware so you can evaluate it to decide whether or not it
meets your requirements before buying it. The evaluation version may
be used for a maximum of 30 days, and is fully functional except that
it will only run for a maximum of 10 minutes at a time.
To purchase BookWorm, either use the ICL Software Technologies web
site at:
http://www.iclsofttech.com/centrivex
or refer to the enclosed order form "order.txt".
Introduction
------------
BookWorm is a "reader" for plain ASCII text files for Windows CE
palmtop computers. It allows you to:
- display the text using any available font.
- display the text either horizontally or vertically.
- automatically scroll the text at any desired speed.
- set "bookmarks" in the text to mark points of interest.
- easily move to any point in the text.
- search for words or phrases.
BookWorm is ideal for:
- reading electronic books, such as those produced by the
"Project Gutenberg" project.
- accessing reference information easily and efficiently.
- displaying notes for public speaking.
- any other application where you need to display information
in a "hands-off" situation.
Installing BookWorm
-------------------
To install BookWorm on your Windows CE machine, ensure that the
"H/PC Explorer" application is running, and then run the "setup.exe"
program contained in the same directory as this file. Follow the
on-screen instructions to install the program.
Basic Operation
---------------
BookWorm is a standard Windows CE application, and its use should
be relatively self-explanatory. To open a file to read, select
the "Open" item from the "File" menu, and choose the file from
the standard file selector. Note that BookWorm can only read
text files - do not try to open a word processor document,
spreadsheet, or any other file which is not "plain text"!
Once the file is displayed, you can choose the font in which
the text is displayed from the drop-down combo-boxes on the
command bar at the top of the screen. The selected font is
automatically saved between runs of the program - you don't have
to reselect it every time you run BookWorm.
BookWorm is primarily controlled using single key presses. These
are all described in the on-line help system, but the main ones
are:
- To start and stop text scrolling, press <Space>. The speed
and style in which the text scrolls can be set using the
"Scrolling" item on the "Tools" menu.
- To switch the command bar off or on, giving a larger area in
which to display text, press the <Escape> key.
- To scroll up or down a page, press <PgUp> or <PgDn>. Since
these keys are "shifted" on many CE machines, single key
equivalents are also provided - press <Tab> to scroll up a
page, and <Enter> to scroll down a page.
- To scroll up or down a single line, press the up or down
arrow keys.
- Press <Ctrl+Home> to move to the start of the file.
- Press <Ctrl+End> to move to the end of the file.
The "View/Goto..." dialog provides a way of rapidly scrolling
to any point in the file, as well as providing a visual
indication of your current location within the file. Selecting
"Goto" from the "View" menu (or pressing <Ctrl+G>) displays
a dialog with a "slider" showing the current position. Dragging
the slider scrolls the text to the corresponding position in
the file.
Using Bookmarks
---------------
You can set bookmarks to mark important places in the text.
To set a bookmark at the current location in the text, select
"Bookmarks" from the "Tools" menu, or press <Ctrl+B>. Enter
a descriptive name for the bookmark if desired (or simply leave
the default name), and either press <Enter> or tap the <Add>
button to insert the bookmark.
To move to an existing bookmark, press <Ctrl+B> to display the
bookmarks dialog, tap the name of the bookmark in the list, and
tap the "Goto" button. Alternatively, simply double-tap the
bookmark name in the list.
To delete a bookmark, tap its name in the list, and then tap
the "Delete" button.
Note that your current location in the file, and all your
bookmarks, are automatically saved when you either exit the
program or close the file. The information is stored in a
file with a ".wrm" extension in the same directory as the text
file itself. For example, if you are reading a text file whose
name is "\My Documents\Book.txt", Bookworm will create a file
called "\My Documents\Book.txt.wrm" in which to store its
information; this file will be automatically read the next time
you open the file "Book.txt" with BookWorm. Important - do NOT
attempt to open a ".wrm" file with BookWorm itself - it is NOT
a readable text file!
Searching the File
------------------
BookWorm allows you to search the text for words or phrases.
To display the search dialog, select "Find" from the "View"
menu, or press <Ctrl+F>. Enter the string you wish to locate,
and press <Enter> to locate it. There are two check boxes on
the dialog:
- "Ignore case" allows you to select whether the search is
"case sensitive" or not. If the box is checked, the search
will locate the search string regardless of upper-case or
lower-case letters (eg a search for "house" will locate
"house", "House", "HOUSE", etc.); if the box is clear, only
an exact match will be found.
- "Match whole word only" allows you to choose whether to
locate only whole words, or strings within words. For example,
if the search string is "ball", then if this box is checked,
a search will only locate the whole word "ball". If the box
is clear, the a search for "ball" will also match "ballet",
"baseball", etc.
Note that if you wish to search for a phrase (ie the search
string contains spaces), you must clear the "Match whole word
only" box.
When searching, BookWorm starts at the current position in
the file, and searches forward from that point. If the text is
not located, it will ask you if you wish to continue the search
from the beginning of the file.
Searching a large file can take a few seconds - be patient!
Technical Information
---------------------
The way that BookWorm operates is to read words from the text
file one at a time, fitting as many words as possible onto a line.
Single carriage returns are ignored, two (or more) carriage
returns in succession will cause a blank line to be displayed.
Eg, if the text file contains:
a b c
d e f
g
h
i
BookWorm will display:
a b c d e f
g h i
Resolving Problems
------------------
If the text file is displayed oddly - eg if no paragraph breaks
are shown, or if scrolling occasionaly displays duplicated lines -
some minor editing of the file may be required.
BookWorm makes the following assumptions about a file:
- Blank lines really are blank, rather than containing spaces.
- A carriage return immediately follows the last word on each
line, with no intervening spaces. ie, BookWorm expects:
"This is a line<cr>"
and not:
"This is a line <cr>"
Both of these editing tasks are easily accomplished with any
good PC-based text editor.