		       INSTALLATION GUIDE TO MALAGA 6.13
			    (C) 1995 Bjoern Beutel

Malaga should be easily portable to nearly every POSIX system on which an
ANSI/ISO-C-Compiler is running. It also runs on Win32 systems after being
compiled using the MinGW GCC compiler.

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>. 
For extraction on Win32 systems, you need to have 
- either 7-Zip (free, <http://www.7-zip.org>), 
- or PowerArchiver 6.1 (free, <http://www.sfsu.edu/ftp/win/utils>, 
- or WinZip (commercial, <http://www.winzip.com>).

For the graphical display of analysis data, you need to have GTK+, version 1.2
or later, installed on your computer system. You can get GTK+ for free from 
<http://www.gtk.org>. The Win32 binary distribution comes along with the needed
GTK+ DLLs. You can get GTK+ 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>. The Win32 binary distribution doesn't
include the documentation; you'll have to download it from 
<http://www.linguistik.uni-erlangen.de/~bjoern/malaga>.

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/software/emacs> and XEmacs from <http://www.xemacs.org>.


= Installing the Malaga Source Distribution ===================================

1. All the files you need to install Malaga are stored in a file called
  "malaga-6.13.tgz". Move to the directory where you want tho create the Malaga
  directory, copy the file "malaga-6.13.tgz" to this directory and enter the
  following commands to unpack the original files:

     tar zxf malaga-6.13.tgz

   You will now discover a new directory "malaga-6.13" which contains all 
   directories and files you need.
 
2. Change to the directory "malaga-6.13" and enter "./configure". 
   Malaga will be configured for your system.

3. Enter "make".
   The source files will be compiled and the executables will be linked.

4. Enter "make install".
   The executables, the Malaga library, the Malaga header file and the
   Malaga Info files will be installed. You'll probably need to be in 
   supervisor mode to have write access to the directories concerned.

5. If you are using Emacs, add the line

   (require 'malaga "...malaga-6.13/malaga.el")

   to the file ".emacs" in your home directory, so the Malaga extensions will
   be loaded automatically if you are starting Emacs.
   (Use the absolute path for "...malaga-6.13".)

6. When using Malaga, make sure that the environment variable "LANG" describes
   the right character set. This is needed for recognition of language-specific
   letters.


= Installing the Malaga Win32 Binary Distribution =============================

1. All the files you need to install Malaga are stored in a file called
  "malaga-6.13-win32.tgz". Extract this file using either PowerArchiver or
  WinZip or 7-Zip. 

2. Add the directory "...malaga-6.13-win32\bin" to your command path.
   (Use the absolute path for "...malaga-6.13-win32".)

3. If you are using Emacs, add the line

   (require 'malaga "...malaga-6.13-win32/malaga.el")

   to the Emacs configuration file "C:\.emacs", so the Malaga extensions will 
   be loaded automatically if you are starting Emacs.  
   (Use the absolute path for "...malaga-6.13-win32".)

4. When using Malaga, make sure that you have activated the code page that
   corresponds to the codepage of the grammar you're using.

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