=====================================================================
===                             AMADEUS                           ===
===                     for simple family trees                   ===
===                                                               ===
===                         Amadeus-Famibase                      ===
===                           vers. 090304                        ===
=====================================================================

    A SIMPLE VERSION OF FAMILY TREE LANGUAGE DESIGNED SPECIALLY 
          TO ACCOMPANY THE SUBMISSION TO WoDiSEE
          http://www.cs.ut.ee/~kiho/submissionWoDiSEE.pdf
           


GENERAL
Amadeus-Famibase enables handling family trees of a very simple 
structure. 
It is a version of Amadeus with a new base language "Family00". 
     
---------------------------------------------------------------------
FORMAL DATA SYNTAX (GRAMMAR)

     s ::= person 
     person ::= "{" name (data)* (partnership)* "}" } 
     name ::= (<$IDENTIFIER$>)+}     
     data ::= "("  (\~{}[")"])  ")"}     
     partnership ::= "[" name (data)*  (child)* "]"}   
     child ::$=$  person

---------------------------------------------------------------------
SAMPLE FAMILY TERR FT (PLAIN TEXT)              File: Family00/FT.txt

{Jaan King (1743 - 1817)
   (Was born in Tartu. Moved to Edinburgh in 1780.) 
   [  Mari Kass (1750 - 1777)  {Kai King (1770 - ?)} ]
   [  Mary McQueen (1760 - 1835) 
      (Church wedding in June 1783.) 
   ]
}

---------------------------------------------------------------------
USAGE
is free. Unzip Amadeus-Famibase into a folder, say Am. In the folder, 
run
      java Amadeus
(jre 1.4.1 at least).

    ---  INPUT PLAIN TEXT ---
To read (family tree) from plain text
   perform File + Read text           ...  FT.txt
   
    ---  DISPLAY PARSE TREE ---   
Staring point: a family tree as plain text has been input into a window.	
Select all (mouse left-click at upper left corner of the main sketch)
   perform  Tools + Parse  (select base language Family00 if asked)
The parse tree (sketchy view) appears in a new window.
To see the parse tree in the tree-like view, select all and 
   perform View + Set  (and select the view STree)
Back to sketchy view: select all and
   perform View + Set  (and select the view Sketchy)
To reduce the parse tree (in sketchy view), select all and 
   perform  Tools + Reduce
   
    ---  CONVERT FAMILY TREE ---
Starting point: a convert model has been copied to the folder Am 
and given the name family00Model.html. Three convert models 
(M0, M1, M2) are available in Family00 (files family00ModelM0.html, 
family00ModelM1.html, family00ModelM2.html). Initially, the model 
M0 has been copied also to the file Am/family00ModelM1.html.

To display the current model
   perform File + Import  ... Am/family00Model.html

To convert a family tree plain text (displayed in a window) 
according to the current model (found in Am), select all and  
   perform Tools + Sketchify
   
To change the current model, import it and edit it and 
   perform File + Export plain-HTML  ... Am/family00Model.html
  
To replace the current model by family00ModelM[i].html, import 
family00ModelM[i].html and export to    Am/family00Model.html

    ---  TEXTUALIZE TO XML ---	
If the current sketchy text in a window contains only mono-sketches
it might be assigned the base language XML: select all and
   perform Base + Set    (... select XML)
After that the corresponding XML plain text can be obtained: 
select all and 
   perform Tools + Textualize

    ---  SOME OF THE EDITOR'S FEATURES ---	
Click mouse right button to open/close a sketch (click near the left
upper corner of the sketch).
Double click mouse right button to open/close all sketches at the 
pointed level. 
See also Help + Actions.
NB! The window closing operation will be done without any warning  
    (without prompting for to save the current file). 
To save the current sketchy text 
   perform File + Export plain-HTML
To open a sketchy text (exported),
   perform File + Import
To convert a sketch into plain text select the sketch and 
   perform Tools + Textualize
To save plain text
   perform File + Write text
   
---------------------------------------------------------------------
WARNING
Amadeus-Famibase is an incomplete version of Amadeus. 
So many other functions may fail.

=====================================================================
===  Jüri Kiho                                      kiho@cs.ut.ee ===
===  University of Tartu                                  Estonia ===
=====================================================================