README to Web-interfaces for mgetty+sendfax


Content:
- sending faxes with coverpage and shortmessage
- reading faxes
- forwarding faxes

Normal Infos:
the package is created for web, the cgi-bins are thought to be located in
the user-Directory (should be possible with apache, roxen... not with old
CERN-versions!!)

If you take the package at it is, you should get the following structure:

mgetty+sendfax/
		INSTALL.README
		create
	  	givg3.in
	  	givgif.in
	  	givsmallgif.in
		hline.gif
		index.html
	  	index.in
		m+slogo.gif
		m+slogo2.gif
		muster.html
		readme.txt
		shortfax.in
		shortmsg.html
	  	showas.in

To install the Package read the INSTALL.README

Send a fax
==========

features
* sending several files in a fax
* adding a coverpage
* adding a short additional message for the receipient

configuration
addapt the variables in shortfax.pl to your system-requirements.

new in this version:
nothing

View your fax
=============

features
* get a list of all available faxes
* view them as a gif 100%
* view them as a small gif ('small' has to be configured!)
* get a g3-file for an external viewer (sending a specified content-type)
* decide how many gifs should be the maximum for one page, before you get
  only a list of available pages

new
* some changes in shortfax.pl
* forwarding of faxes

notes
The pictures are only created, when they are ordered. The advantage is: that
you can start immediately with ordering fax-pages, and don't have to wait
for all the 20 Pages of the fax to be converted, before you can choose
one.
Already available gifs will not be created twice. Disadvantage: you have
to clean up your Directory from time to time!

configuration
view INSTALL.README
there is a simple create-File inkludet now!

todo
* add the java-output (this will take some time ;) )
* security
* deleting faxes (I don't like this idea...)
* enter changes in a fax and send it back (or whatever, e.g. filling out a
  formular which was sent via fax)


Known BUGS:
===========
There are problems with CERN-Server and Location, it doesn't work, I get
only a server-error-message back (document follows).


SECURITY:
========

Nothing has been done to make anything secure at the moment!!
You can use the features of your webserver to protect the pages with
passwords (or hatever).
For example:
protect: shortfax.pl, webviewer/index.pl (if you think that's not enough,
you can protect all .pl-files)


Thanks:
=======
Thanks to
Hans Aschauer,
Thorsten Zoerner (Thorsten.Zoerner@banedon.vervan.sub.org),
Marc Grimme (grimme@informatik.uni-muenchen.de)
for their good ideas and solutions (they send me several versions in C,
and shell-Scripts) - I didn't use them, because I wanted a perl-script ;)
But I got lots of interesting ideas from these scripts!
