Blob Blame History Raw
		       INSTALLATION GUIDE TO MALAGA 7.12
			    (C) 1996 Bjoern Beutel

Malaga should be easily portable to nearly every POSIX system on which an
ISO-C90-Compiler is running.

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.
If you want to translate it to DVI, you'll also need TeX on your computer. 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/software/emacs> and XEmacs from <http://www.xemacs.org>.


= Installing the Malaga Source Distribution on POSIX systems ===================

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

     tar zxf malaga-7.12.tgz

   You will now discover a new directory "malaga-7.12" which contains all 
   directories and files you need.
 
2. Change to the directory "malaga-7.12" 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-7.12/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-7.12".)

6. Make sure that your terminal program (or Emacs) is using the UTF-8 character
   set.


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