.\" wing requests are required for all man pages.
.Dd July 23, 2000
.Os Debian GNU/Linux
.Dt whitelist 5
.Sh NAME
.Nm pygs
.Nd the PYthon Gateway Script
.Sh SYNOPSIS
pygs 
-t recipient@domain1
-s sender@domain2
[-e envelope@domain3]
[-d]
[-T]
[-V]
[-l logfile]
[-w whitelist]
[-h]
.Sh DESCRIPTION
NOTE: this man page is to be continued :)

pygs read from stdin a nntp article, sending it to recipient@domain1 a rfc822 compliant email setting Resent-Sender: sender@domain2 and envelope envelope@domain3 if exists, else sender@domain2.
.Sh OPTIONS
.Tp 0.5i
.B \-t 

\" The following requests should be uncommented and
.\" used where appropriate.  This next request is
.\" for sections 2 and 3 function return values only.
.\" .Sh RETURN VALUES
.\" This next request is for sections 1, 6, 7 & 8 only
.\" .Sh ENVIRONMENT
.\" .Sh FILES
.Sh EXAMPLES
There is some documetation in /urs/share/doc/pyg

I created mailgate user (moderator of local.moderated ng).
Every article posted in local.moderated is sent to mailgate, 
in its .procmailrc I've put:

.Bd
.Li :0 bhc
.Li \ * ^To: *local-moderated
.Li | $HOME/pygs -t kalfa@localhost -e mailgate@students.cs.unibo.it -s 'cosimo@students.cs.unibo.it'
.Ed

where kalfa@localhost is the recipient (it usually is a mailing list)

an header extract from kalfa@localhost mbox:

From mailgate@students.cs.unibo.it
From: whosentnntparticle@domain4
To: kalfa@localhost
Resent-Sender: cosimo@students.cs.unibo.it

note that sender and envelope are different. rfc822 says that Sender: have to be a human user (not a program or similia). envelope can mailgate user.

.

.\" This next request is for sections 1, 6, 7 & 8 only
.\"     (command return values (to shell) and
.\"       fprintf/stderr type diagnostics)
.\" .Sh DIAGNOSTICS
.\" The next request is for sections 2 and 3 error
.\" and signal handling only.
.\" .Sh ERRORS
.\" .Sh SEE ALSO
.\" .Sh STANDARDS
.\" .Sh HISTORY
.Sh AUTHORS
Cosimo Alfarano <alfarano@students.cs.unibo.it>
.Sh BUGS
Boh. send any bug to the author
.An , please.