Testing OmniMoni
----------------

If you just want to see a sample of what OmniMoni can do the run the
Demonstration script.  If wish is in your path then just run:

	wish -f Demonstration


If you want to try OmniMoni out without installing you should set the
environmental variable OMNIMONI_LIB to the pics directory.  In sh or
bash you can do this as:

	OMNIMONI_LIB=`pwd`/pics
	export OMNIMONI_LIB

After this you can just run OmniMoni as:

	wish -f `pwd`/bin/omnimoni.tcl -f config_file

For testing purposes you can use any of the sample configuration files
in the demos directory or create your own.



Installing OmniMoni
-------------------

You should just have to run the install script "install.tcl".  If
tclsh is not in the place the script expects it or if you use a
different Tcl interpreter then run the script as:

	tclsh install.tcl

This script will ask you some questions and then install OmniMoni,
it's necessary files, and the man page.  If you are installing it
system wide then you will probably need to be root to do this.

After running the installation script you will need to create a
configuration file.  By default this file goes in ~/.omnimoni.  There
are a number of samples in the demos directory.



If you do not wish to run my installation script or if it does not
work for some reason, here's what it does:


1.  It finds out where "wish" is and prepends a line to the OmniMoni
src file "src/omnimoni.tcl".  The line it prepends is:

	#!$wish_path/wish -f


2.  It finds out which, if any, of the GIF files you wish to use.  If
you want to use any, then it asks where they should be installed. If
they are not being installed in "/usr/local/lib/omnimoni", then it
also create a launcher shell script that sets the environmental
variable "OMNIMONI_LIB" to the specified lib path and then runs
OmniMoni.
	Also, depending on what GIF files are installed, it updates
the manual page to reflect this in the "FILES" section.  It does this
by appending the lines:


.TP
.BI omnimoni_lib_path/omnimoni.big.gif
The large picutre show while OmniMoni parses the confuration file.


and/or the lines:


.TP
.BI omnimoni_lib_path/omnimoni.small.gif
The small picture show after OmniMoni is done parsing the
configuration file.


to the file "man/omnimoni.man.part1", it then append
"man/omnimoni.man.part2" to it as well.


3.  It finds out the bin and man path for omnimoni and omnimoni.1
respectively.


4.  Finally, the scipts does the following:

	A.  installs omnimoni.big.gif and/or omnimoni.small.gif are
put in omnimoni_lib_path wish 444 permissions.

	B.  installs the created man page into the man path as
"omnimoni.1" with 444 permissions.

	B.  if a launcher shell script was necessary it installs that
in the bin path as "omnimoni" with 755 permissions and installs the real
"src/omnimoni.tcl" file in the omnimoni_lib_path as "omnimoni.tcl"
with 555 permissions.  If a launcher shell script was not necessary
then it just installs the "src/omnimoni.tcl" script into the bin path
with 755 permissions.
