@(#)README	$Revision: 1.6 $	$Date: 1995/05/19 12:25:32 $

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

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

If you use qmr, and you like it, please send a picture postcard to

	Ross C Linder
	P.O Box 101
	Bromhof
	2154
	South Africa

If you hate qmr, email me why so I can learn.

	ross@mecalc.co.za

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.5.src.taz", 
"X11-QMR-1.5.dbin.taz" and "X11-QMR-1.5.sbin.taz"

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

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

Here is the output from ldd for the dynamic version of qmr.

        libXm.so.2 (DLL Jump 2.0) => /usr/X11/lib/libXm.so.2.0.0
        libXpm.so.4 (DLL Jump 4.5) => /usr/X11/lib/libXpm.so.4.5
        libXt.so.6 (DLL Jump 6.0) => /usr/X11/lib/libXt.so.6.0
        libX11.so.6 (DLL Jump 6.0) => /usr/X11/lib/libX11.so.6.0
        libc.so.4 (DLL Jump 4.6pl27) => /lib/libc.so.4.6.27

and the static version.

        libXpm.so.4 (DLL Jump 4.5) => /usr/X11/lib/libXpm.so.4.5
        libXt.so.6 (DLL Jump 6.0) => /usr/X11/lib/libXt.so.6.0
        libX11.so.6 (DLL Jump 6.0) => /usr/X11/lib/libX11.so.6.0
        libc.so.4 (DLL Jump 4.6pl27) => /lib/libc.so.4.6.27


The src contains all the sources for qmr, as well as a copy of my
new motif help system that uses NCSA's libhtmlw


   Making:
   --------

    Edit the makefile and add any flags needed for the path to libhtmlw.

    I installed the include files for HTML in /usr/include/libhtmlw
    and the library in /usr/X11R6/lib/libhtmlw.a

    Next just run make.

    This will produce qmr qmr.dynamic, 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.

    With X11R5 ..

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

    With X11R6

	ln -s /usr/X11R6/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 creates the directory /usr/lib/X11/help/X11-QMR and copies
   all the help files to that location.
   

   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.

