	mgcomp

What is mgcomp
==============

	mgcomp is a compiler developped with system DyALog for
	Linguistic Meta-Grammars (MG). mgcomp can compile a MG in
	DyALog format into an XML representation [TAGML] of a Tree
	Adjoining Grammar [TAG], file extension .tag.xml.

	mgcomp comes with some additional files for a
	full processing chain. See section "contents".

	For information about DyALog, please check:
	<http://alpage.inria.fr/dyalog.en.html>

	You can find papers related to mgcomp on this page: 
	<http://alpage.inria.fr/catalogue.fr.html#mgcomp>

	mgcomp is part of the Linguistic Processing Chain
        developped by INRIA project team ALPAGE. More information on
        this page:
	<http://alpage.inria.fr/alpc.en.html>


Description
===========

	The compilation of a Meta-Grammar by mgcomp can be decomposed
	in 3 phases:

	1. Propagation of inherited information in hand-crafted classes
  
	2. Class crossing based on ressources
  
	3. (Quasi) Tree enumeration for each neutral derived class
	   Some neutral classes may produce no tree


Contents
========

	INSTALL		instructions for installation
	LICENSE		license and copyright notice
	README		this file

	mgcompl.pl      main compiler file
	check.pl	class integrity checking
	closure.pl	Compute all needed closure relations
	crossing.pl	class crossing algorithm
	display.pl	display of MG information
	fs.pl		Feature Structure light implementation
	tools.pl	Auxiliary tools
	tree.pl		tree generation
	mgconvert.pl	MG conversion to XML
	header.plh	Some generic stuff to be included by other files
	toplevel.pl	Small toplevel for Meta Grammar constraints

	lfg2latex.pl	Convert lfg notation into LaTeX
	mg2dyalog.xsl   XSL file to transform Clement's MG editor
			output to DyALog mgcomp input format
	tagml2latex.xsl	XSL file to transform TAGML format to LaTeX

	Fr*.xml		some sample files in Clement's MG editor format
	noyau.xml	another very simple sample file


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

	See the INSTALL file for the compilation and installation procedure.


Documentation
=============
  
	usage:
        ./mgcomp <mg.pl> [-options]
  
	options:
        -xml      XML TAG1 compliant output
        -info     display detailled debug information
        -tree     display generated trees in simplified format
        -simple   display generated trees in alternative simplified format
        -warning  output warning information
	-usage

	For additional information:

	- Check papers listed on mgcomp page:
	  <http://alpage.inria.fr/catalogue.fr.html#mgcomp>
	- Also look at Makefile.am for the processing chain
	- Check Alpage Linguistic Processing Chain documentation:
	  <http://alpage.inria.fr/docs/alpchain-doc.pdf>


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

	Download the latest release from INRIA GForge:
	<http://gforge.inria.fr/frs/?group_id=473>

	You can also download the latest sources from our Subversion
	repository typing the following command:

	svn co svn://scm.gforge.inria.fr/svn/mgkit/mgcomp/trunk mgcomp


Copyright and Licence
=====================

	GNU Lesser General Public License (LGPL)
	copyright INRIA 2002 -- 2008

	
Author
======

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

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