@(#)README	$Revision: 1.5 $	$Date: 1994/12/20 01:26:03 $

========================================================================

Thanks for acquiring a copy of the X11-QMR distribution. Enjoy it.

If you use qmr, and you like or hate it, please send me a short email
note to that effect. It makes for great brownie points.

Also if you would like to send a small donation to me, that would be
very much appreciated.

Please send all donations (or other correspondence) to:
	Ross C Linder		Email:  ross@wanda.iaccess.za
	P.O Box 101			
	Bromhof
	2154			Ph: +27 (11) 793-4818 (SADT !!)
	South Africa

Upgrading
----------

If you are upgrading from an version prior to 1.3 of qmr, make sure that
you remove $HOME/QMR/config as the format of this file has changed.

In any event, use the "Edit" "Environment" menu option to correctly
set up your working environment.

Be sure to replace existing data as the binary format of the data files
has changed a little.

Installation
------------

This file comes with "X11-QMR-1.4.src.taz", 
"X11-QMR-1.4.dbin.taz" and "X11-QMR-1.4.sbin.taz"

The dbin contains only the dynamic executable, you will need to have
your own copy of Metrolink Motif ver 1.2.4.

The sbin contains the static execuatble of qmr. This requires no third
party products, and if freely distributable.

The src contains all the sources for qmr, as well as a copy of the
ComboBox widget by Harald Albrecht.

You can get the the primary source of this widget from
ftp.informatik.rwth-aachen.de (137.226.112.172)
The source is in: /pub/packages/ComboBox/ComboBox.tar.gz

To make the ComboBox widget a little more portable, I changed all the
caddr_t references to XtPointer's.


   Making:
   --------

    Before making the binaries, edit the makefile and set the flags
    needed for your environment. The default is for Linux. NOTE ! you
    will need Motif to compile qmr. Defaults are provided for HP-UX
    and SCO.

    Next just run make.

    On Linux this will produce qmr qmr.dynamic, and qmr.uid
    on other "commercial" systems this will produce qmr and qmr.uid

   Installing qmr:
   ---------------

    If you have Motif installed on Linux, you can rename qmr.dynamic
    to qmr. This will use the dynamic libraries, resulting in a much
    smaller execuatble.

    If you do not have Motif, you may need to create the following
    symbolic link.

    ln -s /usr/X386/lib/X11 /usr/lib/X11

    Use the simple install script "qmr.install". You must be root.

   What does qmr.install do ?
   --------------------------

   The install script "qmr.install", copies the pc fonts to the X fonts
   dir, and adds aliases for them. This is only done if they are not
   already there.

   Next it copies qmr (The binary) to /usr/local/bin

   Next it copies qmr.uid to /usr/lib/X11/uid

   Finally it copies qmr.8 to /usr/man/man8
   

   What do users need ?
   --------------------

    Make the following directories in each users home dir.

    	$(HOME)/QMR
    	$(HOME)/QMR/UP
    	$(HOME)/QMR/DOWN


That's it, qmr should run.

