MOSFLM 7.0.7
============

This release has many bug fixes compared to version 7.0.6, and is 
designed to fully support the new interface, iMosflm. This version 
of Mosflm is available with or without the old X11 style gui - we 
encourage people to use iMosflm instead of the old-style interface; 
if you encounter any problems with this, please let us know so that 
we can address them.

This program can be copied either as a pre-built executable (available
for some popular platforms) or in a build-it-yourself form (see the
appropriate directories).

We strongly recommend using the pre-built executables unless you have a 
properly installed copy of CCP4 version 6.0 or later. Even then, it is 
likely that you will gain very little by building your own copy.

Dependencies
============
It's easiest to install CCP4 before installing Mosflm, so that the
appropriate crystallographic files are present. 

The copies of Mosflm that have the old-style X11 GUI have been linked 
dynamically; this means that you need the libraries on your local machine
as well as the Mosflm executable to run them. In particular, you need to have
the X11 library and (probably) the gfortran "shared objects"; installing the 
gcc/gfortran developer packages normally provides the latter.

Compiler notes
==============
(i) I have found over many years that the compilers distributed with any 
version of Red Hat, Fedora or Centos Linuxes are unreliable and not capable 
of producing a properly working executable of Mosflm. I prefer to build my 
own compilers (a "bootstrap" build) on any of these systems and find that 
they then perform as advertised. 

(ii) gfortran/gcc 4.2 and 4.3 seem to be be good compilers that are able to 
produce reliable executables of Mosflm. There still seem to be some issues 
with gfortran/gcc 4.4, so I don't recommend using that at the moment. 

(iii) The Intel compilers ifort and icc for Mac OS X and Linux Intel-based 
machines give fast, stable executables and are well worth installing 
(as a time-limited free download) as an alternative to gfortran/gcc 4. I 
include a method to use them; the Intel Mac and 64-bit Linux executables 
in the "pre-built" directory have been built with the ifort compiler; the 
Mac version also uses gcc, and the Linux version uses icc.

General notes
=============
I recommend not building the program yourself. The pre-built executables have
been built using stable compilers and they have been well-tested. You will 
gain very little (probably nothing) by compiling the code yourself!

To build the program, download the file mosflm707.tgz, then; 

	gunzip mosflm707.tgz      } These two steps can be combined on Linux
	tar xvf mosflm707.tar     } and OSX with "tar xvzf mosflm707.tgz"
	cd mosflm707                                    *
	./build

and it should build.


DON'T try "configure;make;make install" or any similar combination -
it won't work.

You need to have at least CCP4 version 5.0 installed to build MOSFLM, 
including the xdl_view X-windows libraries. I recommend installing the 
newest version you can find - currently 6.1.2.

The build-it-yourself version will not link with the now obsolete CCP4 
version 4. 

The build-it-yourself version does not contain source code for the
REFIX autoindexing routine, but does have the DPS autoindexing
code. If you wish to build MOSFLM version 7.0.7 yourself, and want
REFIX, then e-mail Andrew Leslie (andrew@mrc-lmb.cam.ac.uk) or me 
(harry@mrc-lmb.cam.ac.uk) directly and ask for it. The file for
inclusion (refix_all.for) has changed so old versions will probably
not work.

Autoindexing using REFIX is not supported in iMosflm and will not be 
in the future.

The file 'mosflm.hlp' should be copied to the directory $CCP4_HELPDIR
so that the online help facility works.

Harry Powell 
harry@mrc-lmb.cam.ac.uk

18th December 2010
==============================================================================