JKS 10.2.1997

Grotefend
=========

The Grotefend program is intended to facilitate the making of
hypotheses concerning the decipherment of an unknown syllabic script.
In essence, the program consists of two modules, one that can be used
for assigning readings to the signs and the other for analysis of the
text. The two modules can be used independently of each other, that
is, a text can be analysed without making any assumptions about how
any given sign should be read.

The program is written in Visual Basic and requires Windows 3.1 (or
later).

The program has been developed as a student assignment work in the
Department of Computer Science at the University of Joensuu, Finland
during academic year 1994-1995. It is released without any warranty.
The idea for the program came from Heikki Särkkä, and programming was
done by Tuomo Pusa and Kari Tanskanen under the guidance of Jorma
Sajaniemi.

If you have problems with installing the program, please contact
Jorma Sajaniemi, e-mail Jorma.Sajaniemi@Joensuu.Fi.


Installation
============

There is no installation program (actually, there was, but I couldn't
find it any more, gosh), so you have to go through the following
steps:

1. Make a directory called GF in your C-drive (at least the file
   GF.INI must reside in that directory, so let's put everything there)
   with the following DOS commands:

   C:
   CD \
   MD GF

2. Go to the new directory, copy the zip-file there, and unzip it:

   CD GF
   COPY X:\somewhere\GF115.ZIP .
   PKUNZIP GF115.ZIP

3. If you want (and know what to do) you can now make an icon for the
   program in the Program manager.

4. If the program won't start (see the next section for executing the
   program) then you may need to copy the file VBRUN300.DLL to your
   Windows system directory (usually C:\WINDOWS\SYSTEM) (and maybe,
   even the *.VBX files).


Running Grotefend
=================

If you have made an icon for the program, just double-click it.
Otherwise, start File manager, find C:\GF\GF.EXE and double-click the
name.

On-line help is in Finnish only. To get an impression of the program
do the following steps:

1. Open the example file:

   File - Open - select C:\GF\TEST.GAL

   (GTX-files contain basic text only, GCO-files contain convert
   tables, and GAL-files contain both.)

2. Take the convert table in use:

   Edit - Convert

   (Note that tokens having an conversion are now shown as converted
   in the text.)

3. Open conversion history:

   Click "History>>"

4. Change some conversion:

   Add 's' to the conversion ('ah') of the token 3 and press Enter.
   (Conversion changes are automatically canceled unless approved by
   pressing Enter.)

5. Trace tokens in the text:

   Click "Show tokens"
   Click token 3 in the conversion table

   Note how the token is highlighted with question marks in the text.

6. Create some statistics of the text:

   Statistics - Do...

   (You can edit the result, e.g., add remarks etc.)

7. Close the statistics window:

   Double-click the upper left corner of the window

8. Print the results:

   Print... - select what to print - OK

9. Exit the program:

   File - Exit