MOXFM INSTALLATION GUIDE
________________________

Moxfm has been compiled and installed on Linux
1.2.x w/ Metrolink Motif 1.2.4, HP-UX 9.03 w/
Motif 1.2 and IRIX 5.3 w/ Motif 1.2. I hope
it will compile and run on many other platforms
as well, please report any successes on other
systems as well as problems to me
(mai@x4u2.desy.de). Of cource, I am very
interested in patches, too.

I have received a report that moxfm does not
compile and run on Solaris systems. This probably
applies for other SVR4 platforms as well. As I
don't have access to any Sun workstation I can't
fix it myself, but I am still hoping that someone
will do it for me :-).

The installation of moxfm should be fairly simple.

First edit the Imake.options file to adapt it to
your system. You might want to change the following
defaults:

  -	the directories, where moxfm's configuration
  	files and the bitmaps are going to be installed

  -	Normally, moxfm will use "magic headers" to
  	determine the file types. If you want moxfm
  	to determine the file types by suffixes of
  	the file names only, don't #define MAGIC_HEADERS.
  
  -	You might need to tell the compiler where to
  	look for Motif and libXpm headers and
  	libraries.
  	
  -	If you have a Linux system and want to access
  	devices as floppies or CD-ROM thru moxfm, you
  	probably want to install the usermount utility
  	by #defining MAKE_USMOUNT. You will have to
  	customize the userfstab file. For this, read
  	the usermount(1) man page.
  
  -	If you want to compile moxfm with the GNU C
  	compiler gcc and gcc is not the default compiler
  	of your system, #define USE_GCC. You should
  	try this option if your default compiler is
  	unable to compile moxfm (e.g. some HP
  	compilers).
  	
Having done this, type
	./MakeMakefiles
to generate the makefiles and check the dependencies.

Compile moxfm by simply saying
	make
	
If you get error messages, try to compile with gcc,
to #undef MAGIC_HEADERS if necessary, or to #define
USE_STATVFS (if system supports the statvfs system
call in stead of statfs). If you need to make any
changes in the source code or in the Imakefiles to
compile moxfm, please report to mai@x4u2.desy.de.

You install moxfm by becoming root and typing
	make install
	make install.man

CAUTION: If you have a previous
version of moxfm installed on your system, you might
want to backup your customized configuration
files first.

If you want to install the moxfm binaries, man pages
and application defaults file in different
directories than the default ones, simply copy
src/moxfm, src/moxfm.man, Moxfm.ad and eventually
the files in usermount/ by hand. You have to
'make install' anyway in order to install the
pixmaps and configuration files, whose target
directories you can specify in Imake.options,
and in order to generate an application defaults
file.
(Note: If you know about a way to specify the
target directories in the Imake.options file in
a portable way, please tell me :-)

If everything goes smoothly, you should have an
moxfm binary installed in your X bin directory,
along with some other stuff (note the directories
may not be identical on your system, it is up to
imake to install these things in the correct place):

/usr/X11/lib/X11/moxfm/
	bitmaps				Some bitmaps
	pixmaps				Some pixmaps
	dot.xfm				Default config files
/usr/X11/lib/X11/app-defaults/Moxfm	application defaults
					for moxfm (important!)
/usr/X11/man/man1/moxfm.1x		the manual page

