Translate Version 1.12
Copyright (c) 1997 David Haupert
email: dhaupert@ddhsoftware.com

Note:  Translate is released as shareware and must be registered for
continued use.  The author assumes no responsibility for damages caused by
this program.   Make sure to back up (hotsync) your data before installing
the program.


This is the UNREGISTERED shareware version of Translate for the Pilot.

You are free to use this program for up to 30 days in order to
evaluate it.  If you continue to use it beyond 30 days, you must
register it.  For registration information, please see the registration
section below or visit the web page:
  http://www.ddhsoftware.com

----------------------------- Files --------------------------------------

TRANS.PRC    -  The Program that does the actual translating between languages.
SPANISH.PDB  - The English to Spanish Database file.
SPANISH2.PDB - A larger version of the English to Spanish Database file.
README.TXT   - This file.
ORDER.TXT    -  An order form to purchase other DDH Products.

-------------------------- Installation ----------------------------------

First, make sure you have enought free space on your pilot.  To do so, run
the Memory application on the pilot.  If you do not have at least 112K
free you cannot install either database.  To install the large database and
the translate application, you must have at least 204K free.  If you don't
have enough for this, you will either have to choose to delete apps from the
same Memory application, or choose to not install this program until you have
that amount of free memory.

To install Translate onto your Pilot, run the INSTAPP.EXE program which resides
in the same directory as the Pilot Desktop software.  This program will allow
you to specify that a .PRC file should be downloaded to the Pilot during the
next hotsync.  Choose to download both the TRANS.PRC and the SPANISH.PDB or
SPANISH2.PDB to your pilot.  Please be aware that this PDB file is huge
relative to many of the programs you may have installed and it therefore
takes longer to install.  In addition, if the backup checkbox is set in the
preferences portion of the Translate application, this PDB file will be
backed up each time HotSync is run, and this too will take some time.  See
later on in this file for more details on this setting.


----------------------- Instructions For Use ------------------------------
--Selecting a Language
If you have more than one language installed, then running the Translate
application will bring up a language selection screen.  From here you can
choose which language you would like to translate to/from.  To do this, touch
the language in the list box that you would like to use, and press the OK
button.  If there are no languages loaded into the pilot, you will not be
able to get past this screen.

--The Main Screen
The screen contains two fields, the English Word and the Spanish Word.  There
are also buttons: <<, <, To [Language], >, and >>, under the English word, and
buttons: <<, <, To English, >, and >>, under the Spanish word.  In addition,
there are Edit Entry and Add Entry buttons along the bottom of the screen,
and New Word and New Phrase buttons along the top of the screen.

--English To Spanish word
To translate from English to the Spanish word, touch the English field
with the stylus and then write your word in the graffiti area.  When you are
finished writing the word to translate, press the 'To [Language]'
button.  The result should show in the Spanish word's field below.

--Spanish word To English
To translate from a Spanish word to English, touch the Spanish word field
with the stylus and then write your word in the graffiti area.  When you are
finished writing the word to translate, press the 'To English' button.  The
result should show in the English field above.

The program will always attempt to find the exact word you entered.  If it
finds the word you will see the word 'Found!' in the middle area of the
screen.  If it cannot find the word you entered, it will search for the word
as the start of another word.  If finds it this way the screen will show
'Found within word!', and the closest word in the language you enter will be
shown over the field you entered text on.  If it still cannot find the word,
it will search for the closest match of the word, and show 'Closest match!',
and show the word's closest match and it's translation.

    --Additional Buttons
    The << and >> buttons will "rewind" and "fast forward" to the first or
    last word in that list, respectively.  If you press << under the English
    word you will get the first word in the English list, and it's equivalent
    Spanish word also.  If you were to press >> under the Spanish word,
    you would get the last Spanish word in the list, and it's associated
    English word also.

    The < and > buttons will go back or forward one entry in the list,
    respectively.   If after translating a word, you were to press > under the
    English word, you would get the next English word and it's equivalent
    Spanish word.

    --Edit Entry Button
    This button brings up the edit screen which allows you to edit the current
    entry.  There is also a choice to delete the current entry.  To edit the
    entry, just change the fields you desire changed, and press the save button.
    If you change your mind about editing the words, press the Cancel button, to
    return to the main screen.

    --Add Entry Button
    This button brings up the Add Entry screen which allows you to add a new
    entry.  To add an entry, just complete the fields you desire to add, and
    press the save button.   If you change your mind about adding the words,
    press the Cancel button, to return to the main screen.

    --New Word Button
    This button blanks out both fields to allow you to enter a new word to
    translate.

    --New Phrase Button
    This button takes you to the phrase translation screen, where you can
    write sentences and have them translated for you.


--The Translate Phrase Screen
The screen contains two multi-line fields, the English Phrase and the
Spanish Phrase.  There are also buttons: To [Language], and To English.
In addition, there are New Word and New Phrase buttons along the top of the
screen.


--English Phrase To Spanish phrase
To translate from English to the Spanish language, touch the English field
with the stylus and then write your sentence in the graffiti area.  When
you are finished writing the sentence to translate, press the 'To
[Language]' button.  The result should show in the Spanish phrase's field
below.

--Spanish word To English
To translate a Spanish phrase to English, touch the Spanish phrase field
with the stylus and then write your sentence in the graffiti area.  When
you are finished writing the sentence to translate, press the 'To
English' button.  The result should show in the English field above.

NOTE: The Phrase translation used in the program does not make any attempts
at being grammatically correct.  Rather, it works by searching for an exact
match for each word.  If it does not find an exact match, it leaves the word
in the original language and puts square-brackets [] around the word.  While
very few sentences will yield a perfect translation, this feature can still
be quite useful for getting the 'jist' of a sentence quickly.

     --New Word Button
       This button brings you back to the word translation screen where you
       can enter a new word to translate, or add and edit entries.

     --New Phrase Button
       This button blanks out both fields for you to start writing a new
       phrase to translate.


--Choose Language
From the File pull down menu, you can bring up the Choose Language choice,
which will allow you to switch to a different language, as well as delete an
individual language database. This screen contains a list of languages
available and OK button.  To switch languages, touch the language of your
choice with the stylus and press the OK button.  To delete a language, touch
the language of your choice with the stylus, and press the Menu silkscreen
button to bring down the menu.  Select Delete Language from the File
drop-down menu and answer yes to the confirmation screen.  The language will
be deleted from the list.

NOTE: The shareware demo version only functions with the 2 Spanish databases
distributed with it.

--Preferences
From the File pull down menu, you can bring up the Preferences choice,
which will allow you to toggle the HotSync backup setting for whichever
language database is currently in use. When The Backup Database checkbox is
checked, the entire database is backed up on the next HotSync.  If the
checkbox is not checked, the database will not be backed up.  Since the
databases are rather large, the HotSync can take a long time if it has to
back up these languages every time.  So until a conduit is written, this
measure serves to allow the user to select when the databases will be backed
up.  You should only set this checkbox after making serious changes to the
database.   After selecting your choice, press the OK button at the bottom of
the screen.


--Cut, Copy, and Paste
From the pull down menus, you can cut, copy, or paste to and from either word
on the screen, and bring/take either word into/from another application (such
as the memopad application).


-------------------------------- Menus -------------------------------------

File -- contains Choose Language and preferences choices.

Edit -- contains cut, copy, and paste choices as well as a choice to bring up
the onscreen keyboard, as an alternative to entering graffiti.

About -- Gives information about the program.
---------------------------- Registration ----------------------------------

The registered version of the program adds these features:
  - Runs without the splash screens
  - Does not timeout
  - Support for many additional languages including:


    Language              #words       #bytes in Pilot   Price in US $
    ------------------------------------------------------------------
    Danish                3787         73K               $12
    Dutch                 8633         254K              $12
    Esperanto             8665         172K              $12
    Finnish               3228         63K               $12
    French                7135         158K              $12
    German                9335         255K              $12
    Hungarian             1200         24K               $12
    Icelandic             1106         22K               $12
    Indonesian            1155         23K               $12
    Italian/Italian2      2275/3526    27K/81K           $12
    Japanese/Japanese2*   1806/9752    35K/186K          $12
    Latin                 745          15K               $12
    Mandarin              1491         34K               $12
    Norwegian             1936         37K               $12
    Portuguese            2353         48K               $12
    Spanish/Spanish2      3666/8083    82K/175K          $12

    * - The Japanese database contains 1806 words, and is also shipped with
        a public domain database EDICT_S, an EDICT_S.PDB file containing
        9752 Words, and a tool to convert the EDICT_S file into the
        EDICT_S.PDB file with various user defined size options.

    Note: The size does not include the ~27k Translate program that is
          necessary to access any of the files.

    There may be some special deals on multiple languages going-
    see the web page for details:
       http://www.ddhsoftware.com
    or email:
       sales@ddhsoftware.com

    To register go to: http://www.ddhsoftware.com
    and register via the online forms using either your VISA or MASTERCARD
    or your First Virtual account.

    For information on getting a First Virtual account go to:
        http://www.fv.com

    Or read the file ORDER.TXT included with this file.

    Or send Check or Money order (US Only) to:
        David Haupert
        PO Box 970971
        Boca Raton, Fl 33497-0971 USA

    Please include an email address to send the files to (preferably), or a
    return address to send a 3.5" HD disk to.  Note that free updates will
    only be sent via email.


--------------------------- Release History ------------------------------
10/30/97 - V1.12 - Minor Revision.  Word lookups are now MUCH faster when
there is no exact match for the word.

7/22/97 - V1.11 - Bug Fixes:  Fixed an occasional problem with adding and
editing entries corrupting the indexing.  Also fixed it so that switching
back and forth between Translate and other applications would remember what
word was currently on-screen.  Minor Revision.

7/04/97 - V1.10 - New Features: Compression, Phrase translation, New Word and
new phrase.  Fixes 1.0 and Mac problems.  Major revision.

5/20/97 - V1.00 - Created release for the Pilot Plus Pack.  Not released to
the public.

5/12/97 - V0.99 - Experimental version to fix HotSync 1.0 and Macintosh
problems.  Never released to the public.

4/14/97 - V0.98 - Discovered that the language names were not showing
up on the new PalmPilots.  Fixed problem with that.

4/30/97 - V0.97 - Added stuff to show new languages available

4/04/97 - V0.96 - Fixed problem with HotSync version 1.1 and 1.0 not
recognizing SPANISH.PDB file.  HotSync 1.1 now works fine, and V 1.0 loads
but then crashes due to a problem with > 32K sizes in Hotsync 1.0.  Also
fixed problem of program going into endless loop if there is no database
loaded.

3/28/97 - V0.95 - First release to the public
