Overview
=========

	A new small preliminary example of a French grammar generated from
	a MetaGrammar and compiled with DyALog

	It is based on a previous MetaGrammar (frenchmg), itself based
	on an previous version developped by Lionel Clment.

	A new simplified notation is been used to simplify the writing
	of the MetaGrammar, with still conversion to an XML exchange
	format.

	The MetaGrammar exploits several new functionnalities allowed
	by mgcomp (MG compiler) and DyALog to be more compact. We can
	cite MG classes with namespace (to use several times a same
	class but with different namespaces in a terminal class), free
	node ordering when possible (interleaving), alternatives,
	kleene star nodes, nodes sequences, conditionnal nodes, ...

Contents
========

	INSTALL		instructions for installation
	LICENSE		license and copyright notice
	README		this file
                        hierarchies (still prototype)

	frgram.smg	the source meta grammar in simplified format
	frgram.tag.xml  (derived file) the resulting TAG grammar (XML format)
	frgram.tag      (derived file) the resulting TAG grammar (DyALog format)
	addons.tag	addons to the grammar, outsie the metagrammar

	easy.pl		a small segmenter tool (need access to a lexed lexicon)
	parserd.conf	to register parsers to a parser of server (see parser_server)
	testparser	a centralized script to run parsers with many options

	error_analyzer.pl a script to compute error rates for words from parse logs

	extract.xsl	to extract part of the grammar (XML format)
	tagml2html.xsl	to convert XML TAG to HTML TAG
	style.css	Style Sheet for HTML TAG


	easyforest.pl	to convert xmldep to XML Easy format
	easy2html.xsl	to convert XML Easy format to HTML Easy format



Copyright
=========

	INRIA 2004	

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

See the file INSTALL for installation instructions.

This package requires
     - DyALog > 1.10.5	: grammar compiler
     - tag_utils > 1.10	: a set of perl modules to convert TAG grammars 
     - mgcomp > 1.4.0	: compiler of meta-grammars
     - mgtools > 0.0.1  : conversion of Simplified MG format to XML MG format
     
Optional:
     - dyalog-xml > 1.0.0 : API to read/write XML with DyALog
     - parser_server : a server of parsers
     - dyalog-sqlite > 1.0.0 : API to use SQLITE2 databases with DyALog

WARNING: this package is really a 'work in progress' and may be
difficult to install. This package and its dependencies also change
relatively often.

WARNING2: this package comes without the corresponding lexicon.

WARNING3: there are hardcoded pathes in script 'easy.pl' to be updated

Documentation
=============

	None !

  - To run a sentence (with a lexicon) :

echo "il mange une pomme." | ./easy.pl | ./tig_parser small_header.tag - [-forest] [-robust]

where:
      -forest : to output the shared derivation forest
      -robust : to do partial parsing


  - To run a sentence (without a lexicon) :

echo "il:cln mange:v une:det pomme:nc ." | ./easy.pl | ./tig_parser small_header.tag - [-forest] [-robust]


  - To run a sentence, using a server of parser

echo "il mange une pomme." | ./testparser -t - [options]

where <options> in:

      -time: exec time
      -stats: stats about ambiguity
      -d dep: graphical dependency view
      -forest: XML shared derivations
      -grammar: HTML view of shared derivations
      -xmldep: XML shared dependencies
      -tagger: tagging projection of parsing
      -robust: test full parsing and, when failure, robust parsing
      -easy: XML Easy format
      -easyhtml: HTML Easy format
      ...

      (see other options in testparser)      


   - To run a sentence file (one per line) using a server of parser

./testparser -t <file> <options>


Availability
============

	GNU Public License (GPL)

Bug Reports and User Feedback
=============================

Send your bug reports and suggestions by E-mail to:

          Eric de la Clergerie <Eric.De_La_Clergerie@inria.fr>
