Installing Miranda™ under Linux

In order to install the Miranda system, you should be in the same directory as the downloaded file
	mira-2042-i686-Linux.tgz
and you must be root (type su, or sudo before each command). If you have a previous version of Miranda installed you should first remove (or move) the old miralib directory which will be at /usr/lib/miralib or /usr/local/lib/miralib.

To install Miranda execute the following command, as root:-

	tar xpzf mira-2042-i686-Linux.tgz -C /
To run the miranda system, for which you do not need to be root, say
	mira
There is online help information (say /help ) and an online manual (say /man ). To access the manual directly from a UNIX shell say
	mira -man

Explanation

You will have installed the following files:-

/usr/bin/mira
    An executable copy of the miranda system.

/usr/bin/just, /usr/bin/mtotex
    Text formatting programs, useful in connection with Miranda literate scripts (see Miranda online manual).

/usr/share/man/man1/mira.1, /usr/share/man/man1/just.1, /usr/share/man/man1/mtotex.1
    The UNIX manual pages for mira, just, mtotex.

/usr/lib/miralib
    A directory containing various auxiliary files and directories to which mira needs access when it is running. When the mira program is executed it will look for this first at /usr/lib/miralib and then at /usr/local/lib/miralib - if it does find it in either place it will exit with a panic message. This behaviour can be overriden either by calling mira with an explicit flag, thus:

	mira -lib pathname ...
where pathname is the address at which the miralib directory is stored - or by setting an environment variable MIRALIB. [For more detailed information, there is a section about flags and setup files in the online manual, look under `UNIX/Miranda system interface'.]

There is a collection of example programs, in a directory called ex, under the miralib directory. It has a README file in it. Within a Miranda session, saying

	/cd <ex>
will take you into the examples directory. Say
	!ls
to see what is in there.