Installation Instructions for the Miranda™ System under MacOS X
In order to install the Miranda system, you should be in the same
directory as the downloaded file
mira-2032-MacOSX.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-2032-MacOSX.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.