PORTABLE MICROQL DISTRIBUTION NOTES
-----------------------------------

CONTENTS

1) INTRODUCTION
2) LICENSE
3) PORTABILITY
4) DISTRIBUTION + INSTALLATION
5) FINALLY


1) INTRODUCTION:

This document explains how PORTABLE MICROQL is distributed, and how it 
can be installed.  I kindly ask you to reference PORTABLE MICROQL if you 
publish results based on calculations performed with PORTABLE MICROQL. If 
you use and/or modify PORTABLE MICROQL, please send me an e-mail 
(gfeller@ito.umnw.ethz.ch). For more legalese see 2).


2) LICENSE:

	Portable MICROQL (V1.x) -- Chemical Speciation Calculations
	Copyright (C) 1998  Michael Gfeller
		e-mail: gfeller@ito.umnw.ethz.ch
		WWW:    http://www.ito.umnw.ethz.ch/SoilProt/
		
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 1, or (at your option)
    any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

	
3) PORTABILITY

I try hard to make the source code of PORTABLE MICROQL portable and compile 
it on as many operating systems as I have access to (incl.  compiler).  
Since time is always a limiting factor, I might not have enough of it to 
find out why a specific compiler on a certain platform won't compile or 
link PORTABLE MICROQL. If this is the case I wait until there is a demand 
for PORTABLE MICROQL, then I try to solve the problem.


4) DISTRIBUTION + INSTALLATION

PORTABLE MICROQL is distributed in chunks so that it doesn't take up too 
much bandwidth on the internet.  

Documentation is always in PDF format: use Adobe Acrobat Reader to view and 
print it (http://www.adobe.com/acrobat, or (possibly) an ftp-site near 
you).  If you like you can obtain the document source code from me (usually 
LaTeX).

The binary and examples are always distributed together in an archive file 
suitable for the target platform.  For Apple Macintosh and Windows NT/95 
this is most likely a self-extracting archive: double click or execute to 
unpack.  For UN*X-like systems, this is most likely a tar'ed and gzip'ed 
file: if you are using GNU tar, unpack with tar -zxvf archive_name.tar.gz.

The source is always distributed as mql_source.tar.gz.  You should be able 
to unpack it with ports of gzip and tar for your operating system (e.g., 
there is MacGzip and there is also a port of tar for the Mac).

Archive files unpack into the following directory structure (relative to 
where you unpack from):

microql/bin
microql/examples
microql/source

Note that there might be more subdirectories in the future, but the basic 
idea remains the same.

There are - at present - no preference or other setup files, you only need 
the binary of PORTABLE MICROQL, which can be accomodated anywhere you like.


5) FINALLY

It is our approach to let the user find and critically evaluate equilibrium 
constants.  This ensures - in our opinion - that equilibrium constants are 
adapted to the problem at hand and not blindly used from a database.  We do 
it the same way, i.e. there is no database attached to PORTABLE MICROQL. 
Compilations of equilibrium constants we are using include Smith, R.M. and 
Martell, A.E. Critical Stability Constants.  Volumes 1-6.  Plenum Press, 
New York and the IUPAC Stability Constants Database (Academic Software, 
http://www.acadsoft.co.uk).

Hopefully, you find PORTABLE MICROQL useful -- give me a feedback if you 
find the time.







-------------
michael gfeller, Schlieren, 10.2.1998