Imported Debian patch 2.13.1-1

[pkg/t-prot.git] / t-prot.1

diff --git a/t-prot.1 b/t-prot.1
index bc920facfa8cddccd57807390c13d9c71cf58f5c..035f9b975cad773157ef0891848a9d5fb0bd6e73 100644 (file)
--- a/t-prot.1
+++ b/t-prot.1
@@ -1,8 +1,8 @@
-.\" $Id: t-prot.1,v 1.136 2009/12/20 21:38:41 jochen Exp $
+.\" $Id: t-prot.1,v 1.148 2010/02/07 14:31:14 jochen Exp $
 .\"
-.TH T-PROT "1" "August 2009" "T-PROT"
+.TH T-PROT "1" "February 2010" "T-PROT"
 .SH NAME
-t-prot \- TOFU Protection - Display Filter for RFC 2822 messages
+t-prot \- TOFU Protection - Display Filter for RFC 5322 messages
 .SH SYNOPSIS
 .BI "t\-prot [" OPTIONS "]..."
 .SH DESCRIPTION
@@ -13,19 +13,17 @@ e.g. mailing list footers, signatures, and TOFU (see definition below),
 as well as squeezing sequences of blank lines or punctuation.
 .br
 The filter is written in Perl and relies on input to be a single
-message conforming to RFC 822 or its successor, RFC 2822. Messages
-conforming to RFCs 2045-2049 should be treated reasonably correct.
+message conforming to RFC 822 or its successors, RFC 2822 and RFC 5322.
+Messages conforming to RFCs 2045-2049 should be treated reasonably correct.
 .PP
 Already reformatted messages are handled well: the script was
 initially designed to cope with the output of the MUA mutt (which
 is the reason for not using standard CPAN modules for handling
 messages).
 .PP
-For easy usage, you can download a file to be included in your ~/.muttrc:
-.I http://www.escape.de/users/tolot/mutt/t\-prot/muttrc.t\-prot
-.br
-And here is an example S-Lang macro to use t-prot from within slrn:
-.I http://www.escape.de/users/tolot/mutt/t\-prot/t\-prot.sl
+For easy usage, you can include the file muttrc.t\-prot in your
+~/.muttrc. Also coming with the t-prot package is the example S-Lang
+macro t\-prot.sl for using t-prot from within slrn.
 .SH OPTIONS
 .TP
 .BR "\-A" =DIRECTORY
@@ -76,7 +74,7 @@ be detected due to missing headers.
 .TP
 .B "\-c"
 "compress":
-Squeezes a sequence of blank lines to two blank lines at maximum.
+Squeezes a sequence of blank lines to just two blank lines.
 .TP
 .BR "\-\-check" [=FLAGS]
 Run checks. If successful, print an error message and quit with
@@ -89,10 +87,10 @@ following (right now just one flag):
 .IR ratio [=n]
 .br
 If the quoting ratio is n or more, the message is rejected. Must be
-between 0 and 1, or else it is entirely disabled.
+between 0 and 1, or else it is entirely disabled. Default is 0.75
+(i.e., 75% of the message lines are quotes).
 .TP
 .B "\-d, \-\-debug"
-"debug":
 Print envelope info to syslog when bouncing TOFU contaminated email.
 Default syslog facility is mail.debug. Requires
 .BR \-p .
@@ -144,11 +142,9 @@ This requires a directory with footer files to be given with option
 .BR "\-L" =DIRECTORY.
 .TP
 .B "\-\-groupwise"
-"delete Groupwise style TOFU":
 Hides TOFU as produced by Novell Groupwise.
 .TP
 .B "\-h, \-\-help"
-"help":
 Displays a short help text with a summary on all options, and exits.
 .TP
 .BR "\-i" =FILE
@@ -308,7 +304,7 @@ Requires
 .BR "\-\-max\-lines" =x
 Maximum number of lines a message may count (with headers). If the message
 is longer than x lines, the message will not be processed but printed
-unmodified.
+unmodified. Exit status will be EX_DATAERR except when called with -Mmutt.
 .TP
 .BR "\-o" =FILE
 "output file":
@@ -431,7 +427,6 @@ CAVEAT: This may lead to interesting effects with crossposts
 between mailing lists or with undetected signature attempts.
 .TP
 .B "\-v, \-\-version"
-"version info":
 Prints the current version number and release date, and exits.
 .SH ENVIRONMENT
 The environment variables
@@ -556,7 +551,7 @@ Written by Jochen Striepe <t\-prot@tolot.escape.de>.
 All of the documentation and software included in the t-prot releases
 is copyrighted by Jochen Striepe (except when explicitly stated otherwise).
 .PP
-Copyright \(co 2001-2009 Jochen Striepe. All rights reserved.                     
+Copyright \(co 2001-2010 Jochen Striepe. All rights reserved.                     
 .PP
 Redistribution and use, with or without modification, are permitted
 provided that the following conditions are met:
@@ -586,8 +581,8 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .SH IDEAS AND INSPIRATION
 Many good ideas, bug reports and support from (in alphabetical order) Bjoern
 Buerger, Bjoern Laessig, Christian Borss, Gerfried Fuchs, Martin Neitzel, Martin
-Dietze, Ralf Doeblitz, Sven Guckes and many more (see the ChangeLog for active
-contributors). Many thanks to all of them!
+Dietze, Matthias Kilian, Ralf Doeblitz, Sven Guckes and many more (see the
+ChangeLog for active contributors). Many thanks to all of them!
 .sp
 Many thanks to Gerhard H. Wrodnigg who uses a TOFU protection script
 in order to keep the responses to his cancel bot reasonably short.  The
@@ -600,7 +595,7 @@ You can get the latest version from
 There is a problem when mutt gives a PGP verified or even a multipart
 message to t-prot: The information where the PGP encrypted/signed data
 or even attachments begin and end is plainly embedded in the text, not
-really cleanly recognizeable for t-prot. The problem should be worked
+really cleanly recognizable for t-prot. The problem should be worked
 around by now, please send a bug report if it does not work for you.
 .SH "REPORTING BUGS"
 Please note that t-prot development happens on
@@ -654,7 +649,7 @@ and the part about "display_filter",
 .BR perl (1),
 .BR aliases (5),
 .sp
-RFCs 2045-2049 and 2822,
+RFCs 2045-2049 and 5322,
 .sp
 .I http://got.to/quote/
 (German language),