--- THE GRAMMAR ----------------------------------------------------------------

The grammar/ directory contains the TAG grammar for polish:
    * polish.mg - the grammar file in XMG metagrammar format
    * polish.xml - the same grammar in XML format, used by TuLiPA-pl
    * polish-lex - the lexicon file in LEX2ALL format
    * polish-lex.xml - the same lexicon in XML format, used by TuLiPA-pl
There is no morphology file since this one is either provided by the user or
created automatically by TuLiPA-pl (Morfeusz Java bridge required, see below).

--- TuliPA-pl ------------------------------------------------------------------

This is a modified version of TuLiPA (https://sourcesup.cru.fr/tulipa/). The
modifications concern mainly integration of Morfeusz into TuLiPA. Usage options:

    * -s "sentence" - the sentence to be parsed
    * -m file - the morphology file in LEX2ALL format provided by the user
    * -t timeout - timeout (in minutes)
    * -o file - XML output (no GUI)
    * -w - show derivation steps in the GUI

--- MORFEUSZ (not included) ----------------------------------------------------

Morfeusz is a morphosyntactic analyser for Polish. If the user wishes TuLiPA-pl
to take care of morphosyntactic analysis, Morfeusz and Morfeusz Java bridge
are required. They can be downloaded from

  http://sgjp.pl/morfeusz/dopobrania.html
  
(Morfeusz) and

  http://www.cs.put.poznan.pl/dweiss/xml/projects/morfeusz-java/index.xml?lang=en

(bridge) respectively. The directory containing libmorfeusz-java.so must be on
java.library.path (run "java -jar" with "-Djava.library.path=path_to_directory"
argument).

--- LEX2ALL (not included) -----------------------------------------------------

LEX2ALL is a lexicon converter which TuLiPA-pl uses for creating the morphology
file. It can be downloaded from
    
    https://sourcesup.renater.fr/frs/?group_id=417

and installed according to instructions on

  https://sourcesup.cru.fr/tulipa/overview.html.
  
REMARK:
In order to compile LEX2ALL, I had to change line 7 in MorphParser.hs from
    import Text.ParserCombinators.Parsec.Language (emptyDef)
to
    import Text.ParserCombinators.Parsec.Language (emptyDef, commentLine, commentStart, commentEnd, identStart, identLetter, nestedComments, caseSensitive, reservedNames)

Documentation is here:

  http://wiki.loria.fr/wiki/LEX2ALL.

In case the user wishes to provide their own morphology file, LEX2ALL will be
neede to convert it into XML format as well.

--- XMG (not included, optional)-----------------------------------------------

XMG can be used (among other uses) to browse the grammar trees. It can be
downloaded from

  https://sourcesup.renater.fr/frs/?group_id=417

and installed according to instructions on

  https://sourcesup.cru.fr/tulipa/overview.html.
    
XMG's documentation can be found on this webpage:

  http://wiki.loria.fr/wiki/XMG/Documentation.
