1 files changed, 75 insertions, 0 deletions
diff --git a/debian/whitelist.5 b/debian/whitelist.5
new file mode 100644
index 0000000..d129243
--- /dev/null
+++ b/debian/whitelist.5
@@ -0,0 +1,75 @@
+.\" 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.
+