<HRULE height=4 STYLE=OUTLINE y=8>
 TEALDOC MANUAL
   
   By Vince Lee, Tex Tennison, and Amanda Epume
   Program Version 2.75
   Last Updated:  Jan 3, 1998
<HRULE height=4 STYLE=OUTLINE y=8>
 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.
<TEALPAINT SRC="ManualIm" IMAGE=0 SX=0 SY=0 WIDTH=32 HEIGHT=14 X=0>
   Version 2.0 adds exciting new features such as imbedded TealPaint images and horizontal line tags.
<LINK TEXT="Installing" TAG="$$inst" x=10 width=80>
<LINK TEXT="Using Program" TAG="$$usin" x=10 width=80>
<LINK TEXT="Global Find" TAG="$$glob" x=10 width=80>
<LINK TEXT="Flash Rom" TAG="$$flas" x=10 width=80>
<LINK TEXT="Upgrading" TAG="$$upgr" x=10 width=80>
<LINK TEXT="Creating Docs" TAG="$$crea" x=10 width=80>
<LINK TEXT="Encrypting Docs" TAG="$$encr" x=10 width=80>
<LINK TEXT="Graphics/Links" TAG="$$grap" x=10 width=80>
<LINK TEXT="Revision History" TAG="$$revi" x=10 width=80 start=100 dir=REVERSE>
<LINK TEXT="Contact Info" TAG="$$cont" x=10 width=80 start=100 dir=REVERSE>
<LINK TEXT="Registering" TAG="$$regi" x=10 width=80 start=100 dir=REVERSE>
<HRULE><LABEL NAME=$$inst>
 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 doc 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, and if installed, should be accompanied by MANUALIM.PDB.
   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.
<HRULE><LABEL NAME=$$usin>
 Using Program

      "TealDoc" is easy to use, and consists of two basic interface screens.

 Select Screen

   The first screen, the Doc management screen, appears when you first run "TealDoc".  On it, a list is shown of all the Doc 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 Doc file, you can either open that Doc 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.

   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. 

 Browse 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.  You can scroll either one line at a time, one page at a time, or a partial page, which is a full page with one overlapping line.  This setting too can be found in the preferences menu screen.  When scrolling, you click in the top half of the screen to scroll up, the bottom to scroll down.  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. 
<TEALPAINT SRC="ManualIm" IMAGE=0 SX=0 SY=46 WIDTH=160 HEIGHT=49 X=0>
 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.
<TEALPAINT SRC="ManualIm" IMAGE=0 SX=0 SY=113 WIDTH=160 HEIGHT=47 X=0>
 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:

1) Some specified text

2) The string being searched-for

3) A specified count of characters found after the search string. 

4) An auto-incremented number starting at 1

A maximum of 50 bookmarks will be added in this manner each time.
<HRULE><LABEL NAME=$$glob>
 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. 
<HRULE><LABEL NAME=$$flas>
 Flash Rom

   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 and then backed up and installed into flash.
<HRULE><LABEL NAME=$$upgr>
 Upgrading

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.
<TEALPAINT SRC="ManualIm" IMAGE=0 SX=0 SY=14 WIDTH=152 HEIGHT=23 X=0>
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 files in the current listed category 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. 
<HRULE><LABEL NAME=$$crea>
 Creating docs

   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.
<HRULE><LABEL NAME=$$encr>
 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: 

TLENCODE 

or 

TLENCODE /R 

Adding the /R option allows you to use the password for registration purposes. In other words, the password only need be entered once to unlock a document. Without this option, the key will need to be entered every time to gain access. 
<HRULE><LABEL NAME=$$grap>
 Graphics/Links

   TealDoc now supports imbedding of graphics into TealDoc documents and links to other places in the document and other documents.  This is done by inserting special HTML-like tags into a text file before converting them into PalmPilot documents.  When the "Show Graphics/links" option is set in TealDoc preferences, these tags insert graphics and link buttons into a document.  The graphics scroll up and down with the document, allowing the insertion of charts, illustrations, and figures into the text, perfect for creating catalogs, price guides, and technical documents.

TealDoc tags appear like HTML as text within less-than and greater-than symbols.  The text begins with the name of the tag, followed by optional parameters.  For predictable results, tags should appear alone on a single line.  This takes the format:

      <TAGNAME PARAM1=VALUE PARAM2=VALUE>

   Defined Tags:
<HRULE x=50 width=60>
      TEALPAINT - Inserts a TealPaint picture, or even a subrectangle of pixels from a picture.  Using subrectangles, you can use memory efficiently by packing multiple graphic elements into single TealPaint images and extract them individually to display in different parts of a document.

      To create TealPaint pictures, use TealPaint or the Windows 95 program "TealPaint Image Manager" that comes with TealPaint.  For the images to appear properly both the document file and image database must be loaded properly.

      The SRC parameter defines the name of the Image Database to use.  This is the name of the file as it appears on the PalmPilot (as in TealPaint), not necessarily the name of the file on the PC.

      You define the subrectangle to grab using the parameters SX,SY,WIDTH,and HEIGHT.  If you omit these, the whole source image will be grabbed.  This will be placed into the document on the current line at the left edge, unless the X and Y parameters are used to offset the image to the right and downwards.

      Required Parameters:

         SRC   - Name of the source image database containing the picture.

      Optional Parameters:

         IMAGE - Image number in the database of the image to use
         WIDTH - Width, in pixels, of the rectangle to grab (multiple of 8)
         HEIGHT- Height, in pixels, of the rectangle to grab
         SX    - Horizontal offset of subrectangle to grab (multiple of 8)
         SY    - Vertical offset of subrectangle to grab
         X     - Horizontal screen offset from left edge to place image (multiple of 8)
         Y     - Vertical screen offset from current line to place image

      Example:

         < TEALPAINT SRC="Pictures" IMAGE=0>
<HRULE x=50 width=60>
      HRULE    - Inserts a horizontal ruled line into the document.  This is useful for dividing parts of a document in a way that works independent of the current font setting.

      Optional Parameters:

         WIDTH - Width (length), in pixels, of the line (default 160)
         HEIGHT- Height (thickness), in pixels, of the line (default 2)
         X     - Horizontal screen offset from left edge (default 0)
         Y     - Vertical screen offset from top of current line (default 4)
         STYLE - "OUTLINE" or "SOLID" (default)

      Example:

         < HRULE STYLE=OUTLINE>

<HRULE x=50 width=60>
      LINK     - Inserts a link button into the document which can be pressed to jump elsewhere into the document or into another document.
          
You typically define a button by naming it using the TEXT parameter and defining a unique TAG to search for which matches the name of a LABEL (described below).  If you wish to link to another document, the FILE parameter should also be defined.
          
The TAG used to mark a document must be unique from any text within the document, as a standard 'find' command is used to located the tag after a link is selected.  By default, this search begins at the top of a file and proceeds downwards.  You can optimize the search by using the START parameter to start the search elsewhere in the document, and the DIR
parameter to search backwards, if appropriate.

      Optional Parameters:

         TEXT  - Text to draw within the button (default 'link')
         FONT  - Font 0 (normal), 1 (bold), or 2 (large) to use for the text 
         WIDTH - Width (length), in pixels, of the line (default 160)
         HEIGHT- Height (thickness), in pixels, of the line (default 2)
         X     - Horizontal screen offset from left edge (default 0)
         Y     - Vertical screen offset from top of current line (default 4)
         FILE  - Name of document to jump to (default = current doc)
         TAG   - Name of label to find
         START - Position in document (0-100) percent to initially seek or "CURRENT".
         DIR   - Find direction: "FORWARD" (default) or "REVERSE"
         STYLE - "BOX" (default), "UNDERLINE", or "BARE" (new for 2.5) 

      Example:

         < LINK TEXT="Press Me" TAG="Contents" FILE="My Novels">

<HRULE x=50 width=60>
      HEADER   - Adds a text header in the specified text and options. (New for 2.5) 

This option is designed to be used to create topic headers with specified justification much like the HTML <H1>...etc tags. Note that when justifying, alignment is relative to the X coordinate, if specified. For instance, if right justification is used, the text is rendered so the right edge of the text lines up onto the X coordinate. 

      Optional Parameters: 

         TEXT  - Text to draw for the header 
         FONT  - Font 0 (normal), 1 (bold), or 2 (large) to use for the text 
         X     - Horizontal screen position 
         Y     - Vertical screen offset from top of current line (default 0) 
         STYLE - "NORMAL" (default), "UNDERLINE", or "INVERT" 
         ALIGN - "LEFT" (default), "RIGHT", or "CENTER" 

      Example: 

         < HEADER TEXT="Contents" ALIGN=CENTER STYLE=UNDERLINE> 

<HRULE x=50 width=60>
      BOOKMARK   - Adds a bookmark here when a bookmark autoscan is done 

This option provides a way to insert invisible bookmarks in a file. It's similar to the standard method of inserting a marker at the end of the file, but both the marker and bookmark name are not normally visible in the file. 

      Optional Parameters: 

         NAME  - Name of the bookmark to add. 

      Example: 

         < BOOKMARK NAME="Contents" >

<HRULE x=50 width=60>

      LABEL    - Inserts nonprinting text into a document to be used as a target for a link.

      Required Parameters:

         NAME  - Name of this label

      Example:

         < LABEL NAME="Contents">
<HRULE><LABEL NAME=$$revi>
 Revisions

Release Beta 2.75 1/3/98 
 Added indicator in doc selection screen for last doc read 
 Added seek feature in document selection screen with graffiti stroke 
 Added support for encoded, password-protected documents 
 Added TLENCODE.EXE encoder utility for creating protected documents 
 Added support for imbedding quotation marks in link and header text 
 Added text selection after global find 
 Increased number of links/buttons on screen at any one time
 Fixed crash opening an empty document 
 Fixed global find to observe Private Document settings 
 Fixed restoriing of a Private Documents after secret records are hidden 
 Fixed preferencs page from resetting checkmarks 
 Fixed NULL form reference for emulator compatibility 
 Fixed field length warning for emulator compatibility 
 Fixed updating of scroll percentages when scrolling with menu shortcuts 
 Fixed category-selection crash 

Release 2.60 6/7/98 

 Added BOOKMARK option to create hidden bookmarks

Release 2.50 6/1/98 

 Added START=CURRENT option to LINK tag 

 Added STYLE=UNDERLINE and STYLE=BARE options to LINK tag 

 Added HEADER tag for stylized text headers 

 Added document-renaming option to selection list 

 Added document name to doc-delete confirmation 

 Added right-justify preferences option for future Hebrew support 

 Document list position is now maintained after viewing document 

 Disabled autoscroll buttons on Font/Find panel 

 Fixed category selection bug to preselect correct category 

 Fixed text clipping when image database is missing 

Release 2.20   4/27/98

 Sorts document list more quickly

 Made Sorting an optional preference item

Release 2.10   4/13/98

 Alphabetizes documents list

 Show warning if not enough memory to set category

 Fixed bug where links all use the same font

 Fixed crash when listing Pics if Pilot has at least 1 empty and 1 non-empty database

Release 2.02   4/5/98

 Fixed crash listing empty TealPaint databases

 Fixed crash on global find when not in TealDoc

 Updates list correctly after setting preferences

Release 2.00   3/20/98

 Added "TEALPAINT" Tag for imbedding images into TealDoc documents

 Added "HRULE" Tag for adding horizontal ruled lines into TealDoc documents

 Added "LINK" Tag for adding hypertext functionality

 Added "LABEL" Tag for adding hypertext functionality

 Increased speed of document list creation

 Added optional support for Global "find" command

 Auto-Activates cursor in text fields, including search

 Fixed Find-Last menu

 Fixed bug preventing setting documents to last category

Release 1.20	2/11/98

 Added powerful new manual bookmark scan control

 Added option to convert document files to/from TealDoc format

 Added "force single-space" option to preferences

 Safely backs up documents, ignoring those in Flash Ram

 Added Graffiti shift indicator to forms with text entry

Release 1.12   1/30/98

 Allows selecting categories in "all" mode

 Faster listing of files in choose list

 Added "backup" option to Doc Details

 Added "backup all" and "backup none" menu items

 Added support for uncompressed document files

 Fixed up/down scroll in choose list

 Fixed bug in listing flash ROM files

Release 1.10   1/29/98

 Added hold-pen to scroll

 Added Private document support

 Added Support for Flash Rom (Read-Only) Documents

 Added Support for definable embedded category markers (defined at end of file)

 Fixed crash when performing an empty search

 Fixed crash when enter registration key on some systems

 Fixed crash when adding bookmarks on some systems

 Fixed error trying to set document to 'all' category 

Initial Release 1.00   1/27/98
<HRULE><LABEL NAME=$$cont>
 Contact Info

   "TealDoc" by TealPoint Software   
   (c)1998 All Rights Reserved.                     

      TealPoint Software         
      454 Las Gallinas Ave, Suite #318  
      San Rafael, CA  94903-3618   

We look forward to hearing from you.            
                                                
Please visit us at www.tealpoint.com, or email us at contact@tealpoint.com.         
                                                
Thank you.                                       
<HRULE><LABEL NAME=$$regi>
 Registering

   Currently, you may register by snail mail, electronically through our website using a First Virtual Bank account, with a credit card through PilotGear HQ. (www.pilotgear.com) 1-800-741-9070.  For the first option, the enclosed   registration form is provided for your convenience.  You may use this form or simply send the following to the address above. 
   
 Product Name
 E-Mail Address
 HotSync   User ID (Required for Passkey generation)
 Check or Money Order for ($16.95 US) to TealPoint Software
<HRULE>
 Disclaimer

   We at TealPoint Software are committed to providing quality, easy-to-use software. However, this product is provided without warranty and the user accepts full resposibility for any damages, consequential or otherwise, resulting from its use. 

   This archive is freely redistributable, provided it is made available only in its complete, unmodified form with no additional files and for noncommercial purposes only.  Any other use must have prior written authorization from TealPoint Software.  

Unauthorized commercial use includes, but is not limited to:

 A product for sale.
 Accompanying a product for sale.
 Accompanying a magazine, book or other publication for sale.
 Distribution with "Media", "Copying" or other incidental costs.
 Available for download with access or download fees.
   
This program may be used on a trial basis for 30 days.  The program will continue to function afterwards.  However, if after this time you wish to continue using it, please register with us for the nominal fee listed in the program.

Thank you.
<HRULE>

<>
