This ARexx script acts as an interface to dictionary files in specified format.
By providing it a suitable dictionary file, you can use it for practically any
dictionary like expression descriptions.

To test the script with the supplied dictionary file, run it by typing
'Dictionary.rexx domains.dic' in the shell (without quotes), but you can use any
dictionary file by replacing domains.dic with its filename. The dictionary file
format is described at the end of this document.

Upon running the script a short text describing all the commands is displayed
but nevertheless I'll describe them all here:
?   - displays the help text with all the commands listed,
!   - quits the script,
# a - displays the header entry for the keyword 'a' (check dictionary file
      format specification for details),
* a - displays all dictionary entries starting with 'a',
a   - displays dictionary entry for 'a' if present.

The dictionary file format is quite simple and consists of two parts. The header
part contains entries for meta keywords:
#meta value
Each line is a separate entry. The meta keywords start with # and must not
contain spaces. Everything after the first space is the value of the keyword.
You can specify any keywords you want, but you really should specify #title as
it gets displayed after running the script.

After the header part there should be one empty line and then the actual
dictionary entries follow in the format:
keyword - description
Again each line is a separate entry and this time the entries should be
alphabeticaly sorted for the script to work correctly. This makes faster
seaching possible in case of bigger dictionary files.

For easier understanding a sample domains.dic dictionary file is supplied.

If you like the script, I'd appreciate it if you would send me an e-mail telling
me about it. I won't refuse any gifts or money you send me either. ;-)


S-mail: Damir Arh
        Titova 89
        SI-4270 Jesenice
        Slovenia

E-mail: damir.arh@telesat.si

WWW:    http://damir.gajba.net

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1003    2196  45.7% -lh5- 071b Oct  8  2000 Dictionary.readme
[generic]                 1452    3542  41.0% -lh5- 8a17 Sep 30  2000 Dictionary.rexx
[generic]                 2501    5267  47.5% -lh5- 9574 Sep  1  2000 domains.dic
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         3 files    4956   11005  45.0%            Oct  9  2000