MWLIB INSTALLATION INSTRUCTIONS
-------------------------------

Valid for Version:	0.2
Last Revised:		2004-05-22


Read the README file if you want general information about mwlib

Contents
--------

1. Requirements
2. mwlib installation
3. Next steps


1. Requirements
---------------

These are the minimum requirements to use mwlib on your webserver:

	- Webserver with PHP support
	  Known to work: Apache 1.x/2.x, Microsoft IIS
	
	- PHP 5.x (also beta versions)

The following components are recommended:

	- mySQL


2. mwlib installation
---------------------

NOTE: the following steps are also valid for mwlib updates.

mwlib may be installed on a per-website-basis or only once (into the php lib folder) 
for the whole server.
It's recommended that you install only one copy of mwlib, as updates are easier 
to apply. Please keep in mind though, that backwards compatibility may not always be 
kept in future versions.

The following steps are explained under the assumption that you use a UNIX OS. Replace 
them by equivalent steps for your Operating Sytem.


	Step 1: Copy gzipped tarball to installation location
	-----------------------------------------------------
	
		Case 1 system wide installation 
		------
		% cd /usr/local/lib/php
		
		Case 2 per-website-installation 
		------
		% cd /any/dir/readable/by/webserver

	% cp /home/dir/to/tarball/mwlib-m.m-20xx-xx-xx.tar.gz .

	Step 2: Unpacking
	-----------------
	
	% tar xzf mwlib-m.m-20xx-xx-xx.tar.gz
	
	The current working directory should now contain a subdir called 'mwlib-m.m'.
	Check using 'ls'.
	
	% ls
	
	Step 3 (optional): add symbolic link 'mwlib' for easier updating
	----------------------------------------------------------------
	
	NOTE: only perform this step if you do a clean install or if you know that
	      your older projects using mwlib will also work with this version!
	
	Create a symbolic link called 'mwlib' to make it easy to update your mwlib to 
	newer versions. The idea is to let point 'mwlib' always to the preferred installed
	version of mwlib. This enables you to switch the version for all projects by 
	re-setting the 'mwlib' symlink.
	
	Type:
	
	% ln -s mwlib-m.m mwlib
	
	If one of your projects relies on a certain mwlib version, just include it with 
	the full version information.


3. Next steps
-------------

You're now ready to make use of the mwlib framework. I suggest that you download
the sample website from my website and follow the instructions in SETUP-SITE to 
learn how you can set up a simple website using mwlib.

Afterwards you may want to read documentations about modules, the templating system, 
etc.