Translation Dictionary
======================

Author:   Scott Powell (of Evolutionary Systems)
Email:    support@evolutionary.net
Version:  1.8e
Date:     03/07/1999

Copyright Notice
----------------

   Copyright(c) 1997-1999, Evolutionary Systems Pty Ltd.


Install Notes
-------------

  Simply use PalmPilot Install Tool to install the dict.prc file
  onto your pilot.

  Install at least one of the language modules:

     e2d.pdb    - English <-> German       [Has Phrases]
     e2s.pdb    - English <-> Spanish
     e2f.pdb    - English <-> French
     e2j.pdb    - English <-> Japanese (romanized)

  See the following Web site for new language modules:

     http://www.evolutionary.net/


Instructions
------------

  There are three functions that the program provides:
         * Word lookup
         * Phrase lookup
         * Language notes (usually pronunciation guides)

  These functions are activated by tapping on the corresponding tab
  at the bottom of the screen.

  The following notes refer to both the 'Words' & 'Phrases' functions:

  Just type in the word you are looking for in the edit text field, and see
  the matches appear in the listbox below. The listbox is updated as you write
  for quick access.

  The word you type in can be from either language, the search looks for matches
  of both. This is far simpler than having a togglable mode (ie. English ->
  Deutsch, or Deutsch -> English. The output in the list can be viewed in one
  of three formats (mode selectable from buttons at top of screen):

  Mode 'x/x'   (display both languages) :

    <lang-word-or-phrase>/<other-language-equivalent>

  Mode 'x/..'  (only display hits in language on left side)

    <lang-word-or-phrase>...

  Mode '../x'  (only display hits in language on right side)

    ...<other-lang-word-or-phrase>


  Sometimes either side may have semicolons in them (;) indicating alternative
  words, all meaning the same or similar thing.

  The listbox only fills when at least two characters have been entered, and then
  only the first 32 matches are placed in the listbox. Just keeping entering more
  letters until the search narrows down enough.

  Tap on a list-box entry if it is too long for the display, then a dialog box
  should pop-up, displaying the entire entry.

Multiple Language Module Support - NEW!!

  Select the 'Modules...' menu item to either switch to ('Load' button) another
  language module, or to delete a language module.


German Database Notes:

  The database hold German words in 'expanded' form, that is umlaut characters should
  be entered with a trailing 'e', eg. oe = . The 'eszet' character is entered as two
  'S's.

Spanish & French Notes:

  European accented characters are included in the databases. When searching for a word
  you can enter the correct accented characters, or, for speed, you can just type the
  particular letter without the accent, and the search will still find the desired word.


The 'MakeDict' utility
----------------------

  This program (for Win95) is provided so that you can create your own
  databases. First, open a DOS window, then execute MakeDict with no
  parameters (from the command line). You should see some basic help on
  how to provide necessary parameters. The input files (.vok extension)
  are normal text files, with the following format:

    [words]
    word/translated-word
    word2/translated-word2
        .
        .

    [phrases]
    >category-name
    phrase/translated-phrase
        .
        .
    >category-name
    phrase/translated-phrase
        .
        .

    [notes]
    <any-text>


  NOTE: do NOT put spaces around the '/' character.

  Also, in the [words] section, you may have ';' characters on either
  side of the '/' to indicate multiple translations of a word. eg.

       ability/Faehigkeit;Begabung

  'Raw' mode:

       If you have '/Raw' as the first parameter, the sort order for the
       entered words does NOT go through any European translation ('' -> 'a').

   Running...
   ----------

   Open a DOS window (console), then change directory to where the MakeDict.EXE
   file is. You should also have your .VOK files in the same directory (easier).
   You start the program as follows (from the command line):

        MakeDict {/Raw} {/New} <base-name> <db-title>

    <base-name> is the base name of the .VOK file (input file). The output
    file will be <base-name>.PDB. (WINDOWS CE USERS: rename the PDB file to
    .TLD extension).

    <db-title> is the title of the output database (eg. "English-Deutsch").

    '/Raw' and '/New' are optional switches:
       'Raw' mode:
       If you use the '/Raw' parameter, the sort order for the
       entered words does NOT go through any European translation ('' -> 'a').

       'New' mode:
       If you use the '/New' parameter, the database gets formatted
       in the new 'high capacity' format (max 1Mb). Otherwise the
       maximum database size is about 128K (and more space efficient).


Revision History
----------------

03/07/1999  1.8e - Fixed large module search bug (eg. English-Portugese module).

30/03/1999  1.8c - Workaround for Palm IIIx and Palm V bug.

02/02/1999  1.8  - Added support for the new 'high capacity' database format.

13/01/1999  1.7  - Added support for Norwegian characters.

20/11/1998  1.6  - Added 'Phrases' & 'Notes' tab folders.

19/03/1998  1.5a - Fixed 32K overflow problem during search.
                   (English-Dutch module was affected)

06/01/1998  1.5  - Added 'Read-only' mode for ROM'ed modules.
                   Can now install multiple language modules.

26/12/1997  1.4c - A few tweaks for new English-Dutch module.

05/12/1997  1.4a - Fixed 'Raw mode' bug, and European character ordering.

10/10/1997  1.4  - Added better European character support (umlaut chars)
                   Added 'raw mode' support (MakeDict & Dictionary).
                   Now runs faster; has better code optimization.

07/07/1997  1.3  - Added expiry reminder at program startup.

26/05/1997  1.2  - Added three different 'view' modes.

24/05/1997  1.1  - Fixed indexing error.
                   Added 'New Entry' & 'Delete Entry' functions (reg. ver only)
                   Added option to Backup dictionary (reg. ver only)

12/05/1997  1.0  - Initial version


Credits

  thanks to:
     - John J. Lehett        for the GNU 'C' port.
     - Wes Cherry            for 'PILRC'
     - Pat Beirne            for .PDB file structure info


Standard Disclaimer Stuff

  This program is presented 'as is'. I take no responsibility in any loss of data
  or productivity in case of operating failures.

