AUTHOR:

This software has been written by Torsten Hilbrich 
<mail2news@myrkr.in-berlin.de>

LICENSE:

All programs are licensed under the term of the GPL.  You can find
this license in the file GPL.

INTRODUCTION:

mail2news-daemon is a client-server based mailing list to newsgroup
gateway system.  It consists of the following programs:

- mail2news-daemon

The server side which reads the mail article from the client,
transforms it into a news article and submits it to the news server.

You need the following perl packages:

   * News::Article

- mail2news-client

The client side which reads the mail article from standard input,
sending it to the server, and reporting any error message from the
server.

The client uses a timeout of 10 seconds for working with the server.
If the timeout is reached, an error code of EX_TEMPFAIL (75) is output
to indicate a temporary delivery problem.

If you call the mail2news-client directly from a MTA this hould keep
the mail message in the mail queue to be later tried again.  The MDA
maildrop is reporting the error code from an external program directly
to the parent process (usually a MTA) which leads to the same
behaviour.  procmail seems to log an error message and execute the
next action.  This could mean that the message is delivered in the
normal input or even thrown away, depening on your procmail
configuration.

- news2mail

A script which can be used to transform messages posted into a
moderated newsgroup to be send as email.  It removes some newsgroup
specific headers, especially Newsgroup which might confuse other
systems.  

It works as a filter reading standard input and sending the result to
standard output.

This script is *NOT* installed by the makefile, it is provided as an
example.

INSTALLATION:

The Makefile has targets 'all' and 'install' to help you installing
this package.  If you have a Debian system, use the target 'debian'
instead.

CONFIGURATION:

The mail2news-client needs no configuration unless you want to change
the location of the socket used for communication between client and
server.  See the manual page mail2news-client(1) for more information.

The mail2news-daemon is started by the system-v startup script (named
mail2news in this directory (installed as /etc/init.d/mail2news-daemon
when using the Debian package).  More information about this daemon
can be found in the mail2news-daemon(8) manual page.

The daemon can be configured using the /etc/mail2news.conf file, see
mail2news.conf(5) for more information.

# $Id: README,v 1.3 2003/10/26 10:05:01 torsten Exp $