
        README mxman
       ===============
       ( 23 Aug 1993 )



'MXMAN' is yet another motified version of standard MIT xman client.
The base code I used is xman version 3.1.5 from X11R5 distribution.
All motif changes were delimited by #ifdef MOTIF (At the end, I found
this of little value, and simply made the code messy.  I believe
mxman should start its own life separately from xman).


Installing mxman:
-----------------

If you have SGI workstations, I have provided mxman binaries that you
can install directly on your SGI machines.  Since SGI didn't shipped
X11R5, and Motif 1.2 for IRIX 4.xx, mxman for IRIX 4.xx was statically
linked, and it's about 2.5 meg in size 8-(.  The mxman binary for IRIX
5.xx is less than 100K.

Installing mxman on SGI workstation running IRIX 4.xx:

1. su
2. inst -f ./dist.irix4

Installing mxman on SGI workstation running IRIX 5.xx:

1. su
2. inst -f ./dist.irix5

To remove mxman from your SGI systems use the command:
	versions remove mxman

For other machines, you need to build mxman first.


Building mxman:
---------------

You need to have Motif dev 1.2.x, and X11R5.

1. Modify Imakefile for your environment.
2. mmkmf (or xmkmf ?)
    or
   Modify Makefile.irix5 to create the Makefile suitable for your 
   environment.
3. make 

4. make install to install it on your machine.

Selecting the right app-defaults file:
- - - - - - - - - - - - - - - - - - - -
Some display hardware have limited colors, and fonts available.  
In that case you can choose the plain MXman.ad.plain, and add colors/fonts
as needed.  For SGI workstations, you should use the MXman.ad.sgi
to enable SGI look and feel feature.  For something in between,
you can try MXman.ad.color.

SGI specific features:
- - - - - - - - - - - -
1. You can enable/disable SGI look and feel using this resource:
      mxman*sgiMode: true/false
2. You can select scheme to use:  (IRIX 5.xx only)
      mxman*scheme: Lascaux/VanGogh etc.


Other files:
- - - - - - -
The script Makedist is specific to SGI, and the program gendist is 
usually not distributed outside SGI.  Hence, if you don't have gendist
the following two files are not useful:  Makedist, mxman.spec.
Makedist is the script used to generate ./dist.irix[45].
I have included those files in the tar file for completeness.



KNOWN BUGS:
-----------

0. All xman bugs.
1. Once in a while mxman prints XmScrollbar warning.


POSSIBLE ENHANCEMENTS:
----------------------

1. Badly needed multi-column XmList.
2. Hypertext linking from SEE ALSO to other man pages.
3. Print the current man page.
4. Copy/Paste from man page window to X Cut buffer.
5. ?



USUAL DISCLAIMER:
-----------------
THIS SOFTWARE IS PROVIDED "AS IS" WITH NO WARRANTIES OF ANY KIND
INCLUDING THE WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A
PARTICULAR PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR
TRADE PRACTICE.


To contact me:
--------------

Ivan Hajadi
Silicon Graphics, Inc.
hajadi@sgi.com

