qmail-superbounce            (c) 2001 Jacek Konieczny <jajcus@pld.org.pl>
-------------------------------------------------------------------------

I. Introduction
---------------------

qmail-superbounce is an external bouncer for qmail. It is invoked by
(specially patched) qmail-send and fed with standard bounce message.
The bounce message is then processed by qmail-superbounce and sent to
the sender of the bounced message.

qmail-superbounce can do three things with the bounce:

	1. Make it MIME message, with the original message as attachment
	2. Change the "Date: " header field to the local time
	3. Translate it to other language, according to the recipient's
	domain

It could probably do something more, I didn't thought about.

YOU WILL NEED PATCHED QMAIL FOR qmail-superbounce TO WORK!

The patch is available in the doc directory.

II. Configuration
---------------------

qmail-superbouce uses three config files:

<CONTROLDIR>/me	
This is a standard qmail configuration file, see qmail documentation for
details.

<CONTROLDIR>/superbounce
This file contains configuration options for qmail-superbounce. It can
contain any of these (one per line):
	mime	  --- put bounced message into MIME attachment, 
			QP-encode 8bit characters 
	i18n	  --- try to translate bounce message
	localtime --- change "Date: " to localtime
	maxsize=n --- send only n bytes of bounce message

WARNING: Don't use "mime" with "maxsize" options, or "i18n" witout "mime" or
you will get illegal messages. This may work, but may fail in suprising way.
As you see it is also not possible to use "maxsize" with "i18n" in a safe way.

<CONTROLDIR>/superbounce-domains
Contains domain/locale pairs used to choose the translation.

<CONTROLDIR> is the directory where qmail configuration files are. It is
given at compile-time. Usually /var/qmail/control.

III. TODO 
---------------------

- More translations. Unfortunately, this is the thing I am not able to
  do by myself. 

- Better documentation (in real English) :-)

- Something more?

IV.  Copyright
---------------------

This is free software. It is protected by the GNU General Public License
(GPL). Please read it (COPYING file), before using this program.

V. Contact, bugs, etc.
---------------------

Pleas send all of these to me:
	Jacek Konieczny <jajcus@bnet.pl>
	

