By Vince Lee, Tex Tennison, and Amanda Epume
Program Version 2.75
Last Updated: Jan 3, 1998
Description
Thank you for trying TealDoc. This program is a
powerful but intuitive reader for standard PalmPilot doc files.
It offers a full set of features but at a reasonable cost.
Installing
This archive contains the files:
TEALDOC.DOC
This document in text format
TEALDOC.HTM
This document in HTML format
MANUAL.PRC
This document in PalmPilot document format
MANUAL.TXT
Sample source to this PalmPilot document
MANUALIM.PDB
Image data for manual document
TEALDOC.PRC
The TealDoc program file
TLENCODE.EXE
TealDoc encoding/password utility
REGISTER.HTM
TealPoint Registration form in HTML format
REGISTER.DOC
TealPoint Registration form in text format
STATESDC.PRC
Sample PalmPilot document demonstrating images
STATESIM.PDB
Image data for sample document
Use the Pilot installer to install the program file TEALDOC.PRC.
To be useful, you'll also need to install some document files, available
online at most software archive sites like PilotGear HQ (www.pilotgear.com).
This manual is provided in this archive as the PalmPilot document MANUAL.PRC.
A sample document US State Data is also provided. It demonstrates the new
image capabilities in TealDoc 2.0. To view it, install both the files
STATESDC.PRC and STATESIM.PDB.
Instructions on how to use the PalmPilot installer are in the
PalmPilot Handbook that came with your Pilot, PalmPilot, or WorkPad.
Using the Program
TealDoc is easy to use, and consists of two basic interface screens.
Document Selection Screen
The first screen, the Document management screen, appears when you first
run TealDoc. On it, a list is shown of all the document files installed
PalmPilot in the current category. You can select or edit categories
on your by clicking on the category selection button in the upper right hand
corner of the screen. When you click on a listed document file, you can either
open that document for reading, change it's category, or delete it permanently
from the PalmPilot memory. To change the action performed, click on the
action-selection buttons at the bottom of the screen.
If you choose to display the documents in a sorted list (under preferences),
you can scroll through a long list of documents to items starting in a
particular letter by entering the graffiti stroke for that letter.
You can also perform similar operations with image files by selecting
the "Pic" options at the bottom right. If you choose to Open a picture
database, TealPaint will activate if present on your PDA, but you'll need
to go manually to the correct image database.
Document Browsing Screen
When you open a document file for reading, you are brought to the file
browsing screen, which is divided into two regions; a large display/selection
region at the top of the screen, and a control panel at the bottom.
The display/selection area shows a window into the document file.
It can be clicked on to either scroll the screen or select text
for copying to another application. To choose which is done,
change the setting in the Preferences Menu. When scrolling, you click in
the top half of the screen to scroll up, the bottom to scroll down. You
can scroll either one line at a time, one page at a time, or a partial
page, which is a full page minus one overlapping line. This setting too
can be found in the preferences menu screen. If you hold down the pen,
the screen will continue to scroll. The closer to the top or bottom of
the screen you go, the faster scrolling will occur.
The control panel at the bottom of the screen has two modes: font/find
mode and scroll mode. The panel starts up the first time in font/find
mode. To change modes, click on the percent display value, which shows
your current position relative to the entire file in percent.
Font/Find Panel
The font/find panel has six buttons. The last three select the current
font to use for display. The first three are for find
functions: Find-Again-Previous, Find-New, and Find-Again-Next. Click on
Find-New the first time you do a search, one of the other two to continue
the same search in a particular direction.
When you perform a find operation, you have four options in addition
to your choice of text to search for.
Case Sensitive - Found string must match upper/lower case letters
Anchor Left - Found string must be the start of a word
Anchor Right - Found string must be the end of a word
Reverse Search - Search going backwards from the current position
If you select both "Anchor Left" and "Anchor Right", then the entered
text must be an isolated word, not a part of some other word.
Scroll Panel
The scroll panel allows you to quickly go to any part of the file, or
to control TealDoc's autoscroll mode. To go to another part of a
file, click on the top drag bar on the panel, dragging it all the way to the
left for the start of the file, all the way to the right for the end,
or anywhere in between to go somewhere in the middle of the file.
TealDoc provides an "AutoScroll" feature to allow you to
conveniently step forward thru a file in a hands-off operation.
When autoscroll is on, the file automatically steps forward or
backwards through the file line-by-line.
Four buttons at the bottom of the scroll panel control autoscroll
operation: STOP, GO, SLOWER (backward), and FASTER (forward). The four
application buttons on the Pilot correspond to the autoscroll control
buttons, and can be mapped to substitute for them in the Preferences Menu
Screen. The application button can be made to control autoscroll when
either the scroll panel is up, the font panel is up, all the time, or
never.
To the right of the control buttons is a small display bar showing
the state and speed of the autoscroll. When autoscroll is active, the
bar is solid. When inactive, the bar is hollow. The length of the bar
indicates the scrolling speed and direction.
Bookmarks
You can mark your current location in the file as a bookmark by creating
a named bookmark using the button in the far lower right corner of the
display. This button brings up a list of current bookmarks which work
using the familiar category-selection interface. Select a bookmark to
immediately move to that location.
Automatic bookmarks are imbedded into many document files using markers
defined at the end of the file, enclosed in "< >" symbols. For instance,
placing "<(BM)>" at the bottom of a document file will cause all other instances of
"(BM)" in the document to be found when the document is scanned for bookmarks.
The rest of the line of text following the mark is used as the bookmark's
name.
By default, when a document file is first opened, it is scanned for such
marks. A bookmark is automatically created for each instance found.
You can turn off this feature in the Preferences Menu, and perform it
later using the "Scan for Bookmarks" menu item.
To manually scan for bookmarks, choose the "Manual Scan" option. Enter
a search string and options, and when you click "ok", TealDoc will
automatically scan the file for the string entered and place a bookmark
at each occurence. The bookmark's name will consist of three optional
elements:
Some specified text
The string being searched-for
A specified count of characters found after the search string.
An auto-incremented number starting at 1
A maximum of 50 bookmarks will be added in this manner each time.
Global Find
TealDoc supports the PalmPilot's "find" button as an option. To
activate it, check the appropriate checkmark in the preferences screen. When
you do so and do a search through the "find" button,
TealDoc will search all document files on your organizer whenever
you do a global find. Note that this process can be quite slow, so you
may not wish to have this option activated at all times.
Flash Rom Support
TealDoc supports read-only document files, such as those present in
Flash Rom. Read-only files cannot have their bookmarks or details
modified, and they will seek more slowly unless they were first opened
in writeable memory.
Upgrading from other browsers
TealDoc uses the standard document file format on the PalmPilot.
If you are using another document browser, TealDoc will use the same files,
but categories will not be consistent between the two programs.
SPECIAL NOTE: If you are using another document browser, it will likely
have a Palm Creator ID that will cause it to be listed together with
the document files in the Memory application, and you will not be able to
delete it separately from the document files without changing the ID
using the instructions below.
To move files to be listed under TealDoc, chose "All to TealDoc format" to
convert all document files currently loaded from
the standard format to TealDoc's local format. When you do this, all
the currently listed files will be marked as TealDoc files, and other
browsers may not be able to read the files anymore. You can always
convert them back using the "All to public format" menu choice.
Creating document Files
A number of excellent utilities by various authors exist for creating
and transferring document files. MakeDoc was the original DOS program
created for this purpose. MakeDocW is an excellent Windows95 program
which does the same thing but using an intuitive graphical interface with
many options. These programs are available at many software archives,
or from our site.
Encrypting document Files
TealDoc 2.7 adds a document encryption feature that allows you to
password protect documents when you create them, allowing protection
from editing or uninvited viewing. To encrypt a document, use the
included DOS program TLENCODE.EXE on the original text file before
converting it into a Pilot document file using the following syntax: