README:

CONTENTS:
=========
			INTRODUCTION
			AVAILABILITY
			PREREQUISITES
			INSTALLATION
			WARRANTY
			COPYING
			CONTACT DETAILS
			


INTRODUCTION:
=============

This is Web HylaFAX gateway 1.0 - a simple, quickly hacked together
web (HTML) interface for :-

	- sending faxes using an already configured and running Hylafax server
	- checking the status of an already configured and running  
	  Hylafax server


AVAILABILITY:
=============
This package is available at :-
	ftp://duffus.iafrica.com/pub/linux/faxgw/web-hylafax-gw-1.0.tar.gz


The most recent version of this software (probably still version 1.0) 
is available in the directory :-

	ftp://duffus.iafrica.com/pub/linux/faxgw/

Here, you will find the package :-
		web-hylafax-gw-1.0.tar.gz	
or whatever the latest version is and this README file.
	




PREREQUISITES:
==============

1. Hylafax
---------- 
It is assumed that the HylaFAX FAX server software (at least the fax
sending part) is already up and running on the server that Web
HylaFAX gateway 1.0 is to be installed.

Obtaining and configuring hylafax is beyond the scope of this package.
Hylafax (as source or pre-built binaries) is available from :-
	ftp://ftp.sgi.com/sgi/fax/

Included in the Hylafax distribution (source or compiled) is a set of 
installation/configuration instructions. Further installation/configuration
instructions are available from :-
	http://www.hylafax.org/setup.html

A FAQ on Hylafax is available from :-
	http://www.hylafax.org/HylaFAQ/index.html


2. Webserver
------------
The box is running a web server that is configured to support CGIs.


3. Perl
-------
Perl needs to be available on the box. The software was developed and
tested with perl version 5.004_04. However, it dose nothing fancy, so it
should work on older perl versions.



INSTALLATION:
==============

Unpack this distribution file (web-hylafax-gw.tgz) in a temporary working 
area (eg /usr/src) as follows :- 

	tar -zxvf web-hylafax-gw-1.0.tar.gz

OR (if your tar dose not support automatic gunzipping) use 

	gzip -d web-hylafax-gw-1.0.tar.gz | tar -xvf

This will produce a subdirectory called :-
	
		web-hylafax-gw

off the current directory.

Change into this directory (web-hylafax-gw) and view the file INSTALL 
for further installation instructions.



WARRANTY:  (there isn't one!)
=========

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL
I BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


COPYING:
========

This software is software is distributed under the GNU GENERAL PUBLIC LICENSE,
as detailed in the file COPYING.



CONTACT DETAILS:
================

Nic Tjirkalli
EMAIL:		nic@uunet.co.za
URL  :		http://duffus.iafrica.com/~nic