New upstream bugfix release

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

diff --git a/t-prot.1 b/t-prot.1
index 7a328f8b260273ec137710f846f97f49ba704f91..4c2d767e3a667f9debe08d57f1f8d58405111e98 100644 (file)
--- a/t-prot.1
+++ b/t-prot.1
@@ -1,6 +1,6 @@
-.\" $Id: t-prot.1,v 1.182 2010/04/09 06:45:35 jochen Exp $
+.\" $Id: t-prot.1,v 1.185 2010/07/02 15:48:33 jochen Exp $

 .\"
 .\"

-.TH T-PROT "1" "April 2010" "T-PROT"
+.TH T-PROT "1" "July 2010" "T-PROT"

 .SH NAME
 t-prot \- TOFU Protection - Display Filter for RFC 5322 messages
 .SH SYNOPSIS
 .SH NAME
 t-prot \- TOFU Protection - Display Filter for RFC 5322 messages
 .SH SYNOPSIS


@@ -52,10 +52,10 @@ then have a peek at the Detection Options section. You may accept or
 reject/bounce messages depending on t\-prot's result.
 .SH INPUT/OUTPUT OPTIONS
 .TP
 reject/bounce messages depending on t\-prot's result.
 .SH INPUT/OUTPUT OPTIONS
 .TP

-.BR "\-i" " FILE"
+.BR "\-i" "=FILE"

 Defines an input file; default is '\-' i.e. STDIN.
 .TP
 Defines an input file; default is '\-' i.e. STDIN.
 .TP

-.BR "\-o" " FILE"
+.BR "\-o" "=FILE"

 Defines the output file; default is STDOUT.
 .TP
 .B "\-\-body"
 Defines the output file; default is STDOUT.
 .TP
 .B "\-\-body"


@@ -118,9 +118,9 @@ little *too* greedy.
 .sp
 .IR NOTE :
 This requires a directory with footer files to be given with option
 .sp
 .IR NOTE :
 This requires a directory with footer files to be given with option

-.BR "\-A" " DIRECTORY".
+.BR "\-A" "=DIRECTORY".

 .TP
 .TP

-.BR "\-A" " DIRECTORY"
+.BR "\-A" "=DIRECTORY"

 "ad footer directory":
 Defines the directory which contains the advertisement list footers (one
 footer per file) which are to be tested when removing them with options
 "ad footer directory":
 Defines the directory which contains the advertisement list footers (one
 footer per file) which are to be tested when removing them with options


@@ -143,7 +143,7 @@ option.
 .sp
 .IR NOTE :
 This requires a directory with footer files to be given with option
 .sp
 .IR NOTE :
 This requires a directory with footer files to be given with option

-.BR "\-L" " DIRECTORY".
+.BR "\-L" "=DIRECTORY".

 .B \-l
 is not needed if
 .B \-\-ftr\-ml
 .B \-l
 is not needed if
 .B \-\-ftr\-ml


@@ -159,9 +159,9 @@ Works similar to \-\-ftr\-ad, just that it is intended for mailing list footers.
 .sp
 .IR NOTE :
 This requires a directory with footer files to be given with option
 .sp
 .IR NOTE :
 This requires a directory with footer files to be given with option

-.BR "\-L" " DIRECTORY".
+.BR "\-L" "=DIRECTORY".

 .TP
 .TP

-.BR "\-L" " DIRECTORY"
+.BR "\-L" "=DIRECTORY"

 "list footer directory":
 Defines the directory which contains the mailing list footers (one footer
 per file) which are to be tested when removing them with the options
 "list footer directory":
 Defines the directory which contains the mailing list footers (one footer
 per file) which are to be tested when removing them with the options


@@ -182,7 +182,7 @@ or
 Blocks of quotes with more than n lines will be shrunk to x lines.
 Defaults are 30 for n and 10 for x.
 .TP
 Blocks of quotes with more than n lines will be shrunk to x lines.
 Defaults are 30 for n and 10 for x.
 .TP

-.BR "\-c" " [n]"
+.BR "\-c" "[=n]"

 "compress":
 Squeezes a sequence of blank lines to just n blank lines. n defaults to 2.
 .TP
 "compress":
 Squeezes a sequence of blank lines to just n blank lines. n defaults to 2.
 .TP


@@ -203,6 +203,14 @@ prey for
 Squeezes a sequence of four or more dots, exclamation marks, or question marks
 to only three dots or marks, respectively.
 .TP
 Squeezes a sequence of four or more dots, exclamation marks, or question marks
 to only three dots or marks, respectively.
 .TP

+.BR "\-\-fixind"
+Fix broken quotes to adhere to RFC 3676 by removing spaces between quote
+characters and adding a space after them.
+.br
+.IR NOTE :
+This may produce false positives if spaces in between quote characters
+are intended (thus changing the quoting level, see RFC 3676 for details).
+.TP

 .B "\-\-groupwise"
 Hides TOFU as produced by Novell Groupwise.
 .TP
 .B "\-\-groupwise"
 Hides TOFU as produced by Novell Groupwise.
 .TP


@@ -352,7 +360,7 @@ Hides all mail header lines.
 Subject lines with multiple reply prefixes (Re: and translations into other
 languages) get squeezed to only one prefix.
 .TP
 Subject lines with multiple reply prefixes (Re: and translations into other
 languages) get squeezed to only one prefix.
 .TP

-.BR "\-S" " [n]"
+.BR "\-S" "[=n]"

 "supression of overlong signatures":
 Signatures are to be n lines (not including the one containing dash-dash-space)
 or less. If there are more, it is probably not that spirited after all.
 "supression of overlong signatures":
 Signatures are to be n lines (not including the one containing dash-dash-space)
 or less. If there are more, it is probably not that spirited after all.


@@ -400,13 +408,8 @@ test to avoid false positives for Microsoft style TOFU on such messages.
 .TP
 .B "\-t"
 "TOFU deletion":
 .TP
 .B "\-t"
 "TOFU deletion":

-Hides "traditional style" TOFU, where each line begins with an
-indent string like "> ".
-.br
-(You may edit the indent pattern in the script itself to suit your needs,
-but it is surely
-.I not
-recommended at all.)
+Hides "traditional style" TOFU, where each line begins with the
+indent string ">".

 .TP
 .B "\-w"
 "whitespace deletion":
 .TP
 .B "\-w"
 "whitespace deletion":


@@ -415,13 +418,13 @@ CAVEAT: This may lead to interesting effects with crossposts
 between mailing lists or with undetected signature attempts.
 .SH DETECTION OPTIONS
 .TP
 between mailing lists or with undetected signature attempts.
 .SH DETECTION OPTIONS
 .TP

-.BR "\-P" " MESSAGE"
+.BR "\-P" "=MESSAGE"

 "user defined bounce message for picky delivery": 
 You may specify your own bounce message to be returned when we try to deliver
 an email and bounce it because there is TOFU inside. See
 .BR "\-p" .
 .TP
 "user defined bounce message for picky delivery": 
 You may specify your own bounce message to be returned when we try to deliver
 an email and bounce it because there is TOFU inside. See
 .BR "\-p" .
 .TP

-.BR "\-p" " [ADDRESS]"
+.BR "\-p" "[=ADDRESS]"

 "picky delivery":
 If we really find some TOFU, abort with exit code 
 .IR EX_UNAVAILABLE .
 "picky delivery":
 If we really find some TOFU, abort with exit code 
 .IR EX_UNAVAILABLE .


@@ -694,7 +697,7 @@ and the part about "display_filter",
 .BR perl (1),
 .BR aliases (5),
 .sp
 .BR perl (1),
 .BR aliases (5),
 .sp

-RFCs 2045-2049 and 5322,
+RFCs 2045-2049, 3676 and 5322,

 .sp
 .I http://freshmeat.net/articles/t\-prot/
 (a nice, solid introduction),
 .sp
 .I http://freshmeat.net/articles/t\-prot/
 (a nice, solid introduction),