Version 0.96.2 of qmail-autoresponder is now available at:
	http://untroubled.org/qmail-autoresponder/
------------------------------------------------------------------------------
Changes in version 0.96.2

- Fixed up the multi-line strings that no longer compile with recent
  compilers.

Development of this version has been sponsored by FutureQuest, Inc.
ossi@FutureQuest.net  http://www.FutureQuest.net/
-------------------------------------------------------------------------------
qmail-autoresponder
Rate-limited autoresponder for qmail
Bruce Guenter <bruceg@em.ca>
Version 0.96.2
2005-06-27

This is a simple program to automatically respond to emails.

It is based on some ideas (but little or no code) from a similar
autoresponder by Eric Huss <e-huss@netmeridian.com>, and ideas presented
in the qmail mailing list.

Features:
- Limits rate of automatic responses (defaults to a maximum of one
  message every hour).
- Will not respond to nearly every type of mailing list or bulk email.
- Will not respond to bounce messages or MAILER-DAEMON.
- Bounces looping messages.
- Can insert the original subject into the response.
- Can copy original message into response.
- Can use links in the rate-limiting data directory to limit inode usage
  to a single inode.

A mailing list has been set up to discuss this and other packages.
To subscribe, send an email to:
	bgware-subscribe@lists.untroubled.org
A mailing list archive is available at:
	http://lists.untroubled.org/?list=bgware

Development versions of qmail-autoresponder are available via Subversion at:
	svn://bruce-guenter.dyndns.org/qmail-autoresponder/trunk

Installation:

- Make sure the latest version of bglibs from
  http://untroubled.org/bglibs/ is compiled and installed.
- Build the sources by running "make"
- Run the "instshow" command to see what will be installed (optional).
- After the package has been compiled, run the following commands as root:
	./installer
	./instcheck
  These commands will produce no output if there are no errors.

Usage (file-based):

Put "|qmail-autoresponder DIRECTORY" into your ".qmail" file before
other delivery instructions.  DIRECTORY is the directory into which
rate-limiting information will be stored, and is expected to contain a
"message.txt" file containing a pre-formatted response (including
headers).  Any instance of "%S" in the message file will be replaced
with the original subject.

Usage (MySQL):

Put "|qmail-autoresponder-mysql USERNAME DOMAIN" into your ".qmail" file
before other delivery instructions.  All data (including the message)
will be pulled from the MySQL table.  See schema.mysql for a table
schema.  This program reads MySQL options from the "qmail-autoresponder"
group.  If $MYSQL_USER, $MYSQL_HOST, $MYSQL_PASS, $MYSQL_DB, or
$MYSQL_SOCK are set in the .qmail file, they override the defaults in
the MySQL configuration file.  The parameters "USERNAME" and "DOMAIN"
are used as keys into the MySQL tables.  DOMAIN may be replaced with
"$HOST", and USERNAME may be replaced with "$EXT", "$DEFAULT" or "$USER"
depending on the installation (quoting is required).

A mailing list has been set up to discuss this and other packages.
To subscribe, send an email to:
	bgware-subscribe@lists.untroubled.org
A mailing list archive is available at:
	http://lists.untroubled.org/?list=bgware

This program is Copyright(C) 2005 Bruce Guenter, and may be copied
according to the GNU GENERAL PUBLIC LICENSE (GPL) Version 2 or a later
version.  A copy of this license is included with this package.  This
package comes with no warranty of any kind.
