From: Gerfried Fuchs Date: Wed, 17 Feb 2010 19:54:53 +0000 (+0100) Subject: Imported Upstream version 2.8.1 X-Git-Tag: upstream/2.8.1 X-Git-Url: https://git.deb.at/w?a=commitdiff_plain;h=e00b448decbb827e74f67c983bc553761b3aabc1;p=pkg%2Ft-prot.git Imported Upstream version 2.8.1 --- diff --git a/ChangeLog b/ChangeLog index fab8d70..2ae8d38 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2009-12-20 21:38 Jochen Striepe + + * t-prot.1: Fix rendering for anyone out there using UTF-8. Many + thanks (and a very merry Christmas) to Alfie. + 2009-12-19 22:18 Jochen Striepe * t-prot: Release as v2.8. diff --git a/t-prot.1 b/t-prot.1 index 468ed0a..bc920fa 100644 --- a/t-prot.1 +++ b/t-prot.1 @@ -1,10 +1,10 @@ -.\" $Id: t-prot.1,v 1.135 2009/12/18 21:53:17 jochen Exp $ +.\" $Id: t-prot.1,v 1.136 2009/12/20 21:38:41 jochen Exp $ .\" .TH T-PROT "1" "August 2009" "T-PROT" .SH NAME t-prot \- TOFU Protection - Display Filter for RFC 2822 messages .SH SYNOPSIS -.BI "t-prot [" OPTIONS "]..." +.BI "t\-prot [" OPTIONS "]..." .SH DESCRIPTION .PP This program is a filter to improve the readability of @@ -22,19 +22,19 @@ 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 +.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 +.I http://www.escape.de/users/tolot/mutt/t\-prot/t\-prot.sl .SH OPTIONS .TP .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 -.B -a +.B \-a or -.BR --ftr-ad . +.BR \-\-ftr\-ad . .br This option is also needed if you do not want signature lengths to be counted wrong or fullquotes get undetected when an ad footer is @@ -53,12 +53,12 @@ footer file found in the directory specified with (which is mandatory for this option). The comparison is done by perl's .B index() function (please try -.I perldoc -f index +.I perldoc \-f index for details). .sp .IR NOTE : This option is not needed if -.B --ftr-ad +.B \-\-ftr\-ad is specified. .TP .BR "\-\-bigq" [=n[,x]] @@ -71,7 +71,7 @@ Input consists just of the message's body. There are no RFC 2822 header lines. .IP .IR NOTE : -This does not work with --pgp-short, and multipart messages will not +This does not work with \-\-pgp\-short, and multipart messages will not be detected due to missing headers. .TP .B "\-c" @@ -137,7 +137,7 @@ With this option enabled t-prot makes footer detection really greedy: Should be helpful with broken list servers, or even if your email provider munges the bodies of your messages. .br -Works similar to --ftr-ad, just that it is intended for mailing list footers. +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 @@ -153,7 +153,7 @@ Displays a short help text with a summary on all options, and exits. .TP .BR "\-i" =FILE "input file": -Defines a file for input; the default input is from '-' i.e. STDIN. +Defines a file for input; the default input is from '\-' i.e. STDIN. .TP .B "\-k" "anti Kammquote": @@ -287,7 +287,7 @@ use of it when called from within your MUA to work as desired. Hides TOFU as given by some Microsoft mailers. (You all surely know these fullquotes beginning with .br -"----- Original Message -----" +"\-\-\-\-\- Original Message \-\-\-\-\-" .br and some header lines...) .TP @@ -333,7 +333,7 @@ As an example for usage with put this line into your alias file and invoke .BR newaliases : .sp -notofu: |"/usr/local/bin/t-prot -mt -p=user@mydomain" +notofu: |"/usr/local/bin/t\-prot \-mt \-p=user@mydomain" .sp This will bounce messages for if any TOFU is detected inside the message, and deliver it to otherwise. @@ -388,7 +388,7 @@ than 4. Consider this old-fashioned, but we actually do *like* RFC conformance.) .sp .IR NOTE : -The line containing "-- " ist not counted when testing for an overlong +The line containing "\-\- " ist not counted when testing for an overlong signature, but it is included when displaying how many lines were deleted. .TP .B "\-s" @@ -440,7 +440,7 @@ The environment variables and .I LANG are read and respected when interpreting output by mutt or gnupg -(unless they are overruled by the --locale option). T-prot's own +(unless they are overruled by the \-\-locale option). T-prot's own output is English regardless of any locale setting. .SH EXIT STATUS On program exit, t-prot uses exit codes from @@ -484,7 +484,7 @@ Please point these people to the page There are several ways to fine-tune t-prot's performance: .PP Some command line options are quite grave a performance hit -- do not -use -k and especially --ms-smart if you are content without them. +use \-k and especially \-\-ms\-smart if you are content without them. .PP Checking for special footers is very costly as well. Put as few footer files as absolutely needed in any footer directory. @@ -514,7 +514,7 @@ your line is empty you match unconditionally. .PP .TP .IR Q : -I use the options -l and -L to supress mailing list footers when +I use the options \-l and \-L to supress mailing list footers when displaying messages in .BR mutt (1). This does work sometimes, but sometimes it does not: the footer is not @@ -525,7 +525,7 @@ detected as too long (which they aren't). This might occur if the message is badly encoded, so mutt cannot resolve all encoded characters, e.g. if you have an encoded message on a mailing list, and majordomo appends a mailing list footer in a different encoding -(or even plain us-ascii). "-- " simply does not match "--=20". +(or even plain us-ascii). "\-\- " simply does not match "\-\-=20". .br Another problem are non-us-ascii characters. Just avoid them, and everything should work fine. @@ -545,13 +545,13 @@ instruction: .sp #v+ .br -This line is protected from being filtered by t-prot !!!!!!! +This line is protected from being filtered by t\-prot !!!!!!! .br -#v- +#v\- .br Text coming now is not. .SH AUTHOR -Written by Jochen Striepe . +Written by Jochen Striepe . .SH COPYRIGHT All of the documentation and software included in the t-prot releases is copyrighted by Jochen Striepe (except when explicitly stated otherwise). @@ -630,7 +630,7 @@ t-prot team with some useful info, please: .I display_filter facility, just set display_filter to something like .IP -"tee ~/foobar | t-prot " +"tee ~/foobar | t\-prot " .PP and include ~/foobar in the bug report -- this way we might reproduce the bug much easier if you are using a different environment than we do. @@ -640,7 +640,7 @@ with, what perl version t-prot runs on your system, and what else might be important to enable us reproducing the bug. .PP Send your bug report to -.IR . +.IR . Thank you. .SH TODO Fix bugs (see the