			       MALAGA VERSION 7
		       Copyright (C) 1996 Bjoern Beutel

This is Malaga, a software package for the development and application of
grammars that are used for the analysis of words and sentences of natural
languages. It is a language-independent system that offers a programming
language for the modelling of the language-dependent grammatical
information. This language is also called Malaga.

Malaga is based on the grammatical theory of the "Left Associative Grammar"
(LAG), developed by Roland Hausser, professor for Computational Linguistics at
University of Erlangen, Germany.

You can get the latest infos about Malaga on the Malaga homepage,
at <http://home.arcor.de/bjoern-beutel/malaga>.


= Legal Status of Malaga ======================================================

Malaga is free software; you may redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later 
version, as published by the Free Software Foundation.

Malaga is distributed in the hope that it will be useful, but WITHOUT ANY 
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR 
A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License, version 2, should be in "GPL.txt";
if not, you may download it from http://www.fsf.org.


= Requirements ================================================================

Malaga should be easily portable to nearly every POSIX system on which an
ANSI/ISO-C-Compiler is running, and which supports the Unicode UTF-8
format. Older versions also ran on Win32 systems; this is no longer
supported by the author, but may still work.

Malaga is available as a ".tgz" (GNU tar + GNU zip) archive. For extraction in
POSIX systems, you need to have GNU tar, version 1.11.2 or later,
installed. It is freely available from <http://www.gnu.org/software/tar>. 

Malaga uses Unicode support routines from GLib, so you need to have GLib,
version 2.0 or later, installed on your computer system. You can get GLib for
free from <http://www.gtk.org>.

For the GUI-based display of analysis data, you need to have GTK+, version 2.8
or later, installed on your computer system. You can get GTK+ for free from 
<http://www.gtk.org>.

In the source distribution, the documentation is included as a Texinfo file. 
You'll need GNU Texinfo, version 4.0 or later, to translate it to DVI or HTML.
The Info files are already included. You can get GNU Texinfo for free from 
<http://www.gnu.org/software/texinfo>.

There is a Malaga interface to the editor Emacs, "malaga.el", written in Emacs
Lisp. It provides "malaga-mode" that supports editing Malaga grammar files, 
"malaga-project-mode" that supports editing Malaga project files, and
"malaga-process-mode", a mode for interactive work with "malaga" and "mallex"
that also supports debugging. You can get GNU Emacs for free from
<http://www.gnu.org> and XEmacs from <http://www.xemacs.org>.


= Directories and Files of the Malaga Package =================================

The Malaga distributions currently contain then following files and
directories:

 "README.txt": This document.

 "GPL.txt": The GNU General Public License, version 2.

 "CHANGES.txt": Information about changes in the past and recent versions of
   the Malaga package.

 "INSTALL.txt": The installation guide.

 "*.c" / "*.h": The source text for the library "libmalaga" and for the
   programs "malaga", "mallex", "malrul", "malmake", "malshow", and "malsym". 

 "configure", "config.guess", "config.sub", "install-sh", "ltmain.sh":
   Files needed for automatic configuration.

 "configure.in": The source file to create "configure" by means of GNU's
   "autoconf". You may need this if you modify the malaga source code. 

 "Makefile.in": A file for the command "make" to create the executable files of
   Malaga automatically. This is converted to "Makefile" by "configure".

 "malaga.texi": The Texinfo documentation file for Malaga.

 "malaga.info*": The Info files for Malaga (online documentation)

 "malaga.el": An Emacs Lisp file which supports working with Malaga from Emacs.
  
 "grammars/": Some Malaga sample grammars. Each grammar has a project file 
   (ending in ".pro"). If you want to test a grammar, change to the 
   corresponding directory, enter the command "malmake PROJECT_FILE" to
   translate the grammar's source files into executables and finally start 
   malaga by entering "malaga PROJECT_FILE".
   Do not forget to add the ending ".pro" to the project file name.
   If you are working with Emacs, and you have executed the Emacs Lisp file
   "malaga.el", you can translate a grammar by typing "M-x malmake" 
   (then you'll be asked for the project file name), and you
   can test it by entering "M-x malaga" (enter the project file name again).
  
   There are several subdirectories for the sample grammars:
  
   "grammars/formal/": Some formal grammars that only differ in their
     morphology rule files (the files ending in ".mor"). They are:

     "same_count_with_noise.pro": A grammar for all words that consist of n
       "a"s and n "b"s behind and any number of "c"s spread in anywhere in the
       word.

     "choose_count.pro": A grammar for all words that consists of m "a"s,
       followed by n "b"s, followed by k "c"s, where k = m or k = n.

     "same_count_mixed.pro": A grammar for all non-empty words that consist of
        as many "a"s as "b"s.

     "max_count.pro": A grammar for all words that consists of k "a"s, followed
       by l "b"s, followed by m "c"s, where m = max{k, l}.

     "palindrome.pro": A grammar for all non-empty palindromes built of the 
       letters "a", "b", "c", "d", and "e".

     "growing_blocks.pro": A grammar for all words that consist of alternating
       blocks of "a"s and "b"s, where each block must be as least as long as
       the one before.

     "quadratic.pro": A grammar for all words that consists of n^2 "a"s, where
       n may be any cardinal number.

     "repeat_word.pro": A grammar for all words that consist of a letter
       sequence built of "a", "b", "c", "d" and "e", and which is written
       twice.
    
   "grammars/german/": A syntax grammar named "german.pro" that recognises a 
     small subset of German sentences. It uses a small full form lexicon.
     The directory also contains a file "sentences", which is a list of German
     sentences that are recognised by the grammar. The grammar also returns
     information about the sentence structure.
     The grammar can handle alternative valency frames, separate verb prefixes,
     perfekt forms, adverbial subclauses and some other features.
    
   "grammars/numeral/": The grammar "numeral.pro" recognises English numerals. 
    It returns the numbers they stand for.


= End of file =================================================================
