]> git.deb.at Git - pkg/t-prot.git/blob - t-prot.1
polish debconf translation
[pkg/t-prot.git] / t-prot.1
1 .\" $Id: t-prot.1,v 1.185 2010/07/02 15:48:33 jochen Exp $
2 .\"
3 .TH T-PROT "1" "July 2010" "T-PROT"
4 .SH NAME
5 t-prot \- TOFU Protection - Display Filter for RFC 5322 messages
6 .SH SYNOPSIS
7 .BI "t\-prot [" OPTIONS "]..."
8 .SH DESCRIPTION
9 .PP
10 This program is a filter to improve the readability of internet
11 messages (emails and usenet posts) by *hiding* some annoying parts,
12 e.g. mailing list footers, signatures, and TOFU (see definition below),
13 as well as squeezing sequences of blank lines or punctuation.
14 The program also detects TOFU or a high quoting ratio in a message (so
15 you may take appropriate action, e.g. when submitting messages to a mailing
16 list or a news server).
17 .br
18 The filter is written in Perl and relies on input to be a single
19 message conforming to RFC 822 or its successors, RFC 2822 and RFC 5322.
20 In messages conforming to MIME (RFCs 2045-2049) t\-prot handles text/plain
21 parts, others are not touched.
22 .PP
23 Already reformatted messages are handled well: the script was
24 initially designed to cope with the output of the MUA mutt (which
25 is the reason for not using standard CPAN modules for handling
26 messages).
27 .PP
28 T\-prot offers example configuration files for mutt, Heirloom mailx
29 and metamail. Also coming with the t-prot package is the example
30 S-Lang macro t\-prot.sl for using t-prot from within slrn. There is
31 a proof\-of\-concept filter for INN2, which you will have to adapt
32 to the needs of the news site you host. For use with sendmail's
33 alias(5) file, please see below (the option
34 .BR "\-p" " provides an example line)."
35 .SH OPTIONS
36 .PP
37 If you do not specify any options, t\-prot does ... nothing. Every
38 feature you want must be turned on explicitly.
39 Admittedly, we have quite a number of options for t\-prot. To limit
40 confusion they are grouped into five sections: Input/Output Options,
41 Advertisement And Mailing List Footers, Filtering Options, Detection
42 Options, and Other Options. While the others should be quite clear,
43 filtering and detection might deserve a word (or two).
44 .PP
45 If you want to tune the appearance of your mail from within your MUA
46 (or news messages from within your NUA), then go for the Filtering
47 Options section.
48 .PP
49 If you want to use t\-prot to check on mails before they are submitted
50 to mailing lists, fed to your news server, or delivered by your MDA,
51 then have a peek at the Detection Options section. You may accept or
52 reject/bounce messages depending on t\-prot's result.
53 .SH INPUT/OUTPUT OPTIONS
54 .TP
55 .BR "\-i" "=FILE"
56 Defines an input file; default is '\-' i.e. STDIN.
57 .TP
58 .BR "\-o" "=FILE"
59 Defines the output file; default is STDOUT.
60 .TP
61 .B "\-\-body"
62 Input consists just of the message's body. There are no RFC 5322 header
63 lines.
64 .IP
65 .IR NOTE :
66 This does not work with \-\-pgp\-short, and multipart messages will not
67 be detected due to missing headers.
68 .TP
69 .B "\-\-lax\-security"
70 Allow insecure writing method. DO NOT USE UNLESS YOU REALLY KNOW WHAT
71 YOU ARE DOING. (This ugly workaround is needed for some early mutt versions
72 and should NEVER be used as a default, otherwise it will probably turn into
73 a security issue.)
74 .sp
75 You can use this option safely to enable
76 .B "\-o"
77 /dev/null (or other files which cannot be changed with the user's
78 privileges).
79 .TP
80 .BR "\-\-max\-lines" =x
81 Maximum number of lines a message may count (with headers). If the message
82 is longer than x lines, the message will not be processed but printed
83 unmodified. Exit status will be EX_DATAERR except when called with \-Mmutt.
84 .SH ADVERTISEMENT AND MAILING LIST FOOTERS
85 .TP
86 .B "\-a"
87 "commercial signature":
88 Hides "footers" (signatures) from commercial email providers.
89 .br
90 This option compares the last lines of the message body with any
91 footer file found in the directory specified with
92 .BR "\-A" " DIRECTORY"
93 (which is mandatory for this option). The comparison is done by perl's
94 .B index()
95 function (please try
96 .I perldoc \-f index
97 for details).
98 .sp
99 .IR NOTE :
100 This option is not needed if
101 .B \-\-ftr\-ad
102 is specified.
103 .TP
104 .B "\-\-ftr\-ad"
105 "enable aggressive ad footer matching":
106 With this option enabled, t-prot makes footer detection really greedy: We
107 assume that commercial email providers aren't even frightened to append
108 changing texts *under* their ads which are appended to the message body.
109 Because these texts even have changing lengths we simply detect the
110 lines of the footer *anywhere* in the body of the message and assume that
111 everything below belongs to the footer. (Man, if life where always that
112 easy! ;)
113 .br
114 With this option even GMX ads should be easy to hide -- you buy this with
115 a slight performance hit (which is the reason this option is disabled by
116 default), and with the possibility that sometimes the algorithm is just a
117 little *too* greedy.
118 .sp
119 .IR NOTE :
120 This requires a directory with footer files to be given with option
121 .BR "\-A" "=DIRECTORY".
122 .TP
123 .BR "\-A" "=DIRECTORY"
124 "ad footer directory":
125 Defines the directory which contains the advertisement list footers (one
126 footer per file) which are to be tested when removing them with options
127 .B \-a
128 or
129 .BR \-\-ftr\-ad .
130 .br
131 This option is also needed if you do not want signature lengths to be
132 counted wrong or fullquotes get undetected when an ad footer is
133 appended at the bottom of the message (especially when using 
134 .B "\-S"
135 or
136 .BR "\-t" ).
137 .TP
138 .B "\-l"
139 "list signature":
140 Hides "footers" (signatures) from mailing lists. Footer detection works like the 
141 .B "\-a"
142 option.
143 .sp
144 .IR NOTE :
145 This requires a directory with footer files to be given with option
146 .BR "\-L" "=DIRECTORY".
147 .B \-l
148 is not needed if
149 .B \-\-ftr\-ml
150 is specified.
151 .TP
152 .B "\-\-ftr\-ml"
153 "enable aggressive mailing list footer matching":
154 With this option enabled t-prot makes footer detection really greedy: Should
155 be helpful with broken list servers, or even if your email provider munges
156 the bodies of your messages.
157 .br
158 Works similar to \-\-ftr\-ad, just that it is intended for mailing list footers.
159 .sp
160 .IR NOTE :
161 This requires a directory with footer files to be given with option
162 .BR "\-L" "=DIRECTORY".
163 .TP
164 .BR "\-L" "=DIRECTORY"
165 "list footer directory":
166 Defines the directory which contains the mailing list footers (one footer
167 per file) which are to be tested when removing them with the options
168 .B \-l
169 or
170 .BR \-\-ftr\-ml .
171 .br
172 This option is also needed if you do not want signature lengths to be
173 counted wrong or fullquotes get undetected when a mailing list footer is
174 appended at the bottom of the message (especially when using 
175 .B "\-S"
176 or
177 .BR "\-t" ).
178 .SH FILTER OPTIONS
179 .TP
180 .BR "\-\-bigq" [=n[,x]]
181 "shrink big quotes":
182 Blocks of quotes with more than n lines will be shrunk to x lines.
183 Defaults are 30 for n and 10 for x.
184 .TP
185 .BR "\-c" "[=n]"
186 "compress":
187 Squeezes a sequence of blank lines to just n blank lines. n defaults to 2.
188 .TP
189 .B "\-\-diff"
190 Tolerate unified diff (see 
191 .BR diff (1)
192 and
193 .BR patch (1))
194 appended after the signature (which usually makes the signature too long
195 to be valid).
196 .sp
197 Also, protect diff standard output from hiding (which would otherwise be easy
198 prey for
199 .BR "\-t" ).
200 .TP
201 .B "\-e"
202 "ellipsis":
203 Squeezes a sequence of four or more dots, exclamation marks, or question marks
204 to only three dots or marks, respectively.
205 .TP
206 .BR "\-\-fixind"
207 Fix broken quotes to adhere to RFC 3676 by removing spaces between quote
208 characters and adding a space after them.
209 .br
210 .IR NOTE :
211 This may produce false positives if spaces in between quote characters
212 are intended (thus changing the quoting level, see RFC 3676 for details).
213 .TP
214 .B "\-\-groupwise"
215 Hides TOFU as produced by Novell Groupwise.
216 .TP
217 .B "\-k"
218 "anti Kammquote":
219 Tries (not too aggressively) to fix those broken zig-zag-shaped lines
220 wrapped around by some MUAs which are known as "Kammquoting" in German.
221 .IP
222 .IR NOTE :
223 This option is considered stable by now. However, sometimes Kammquotes
224 should have been removed but weren't. Please send a bug report if this
225 happens to you (after carefully reading the BUGS and REPORTING BUGS
226 section of this man page, that is).
227 .IP
228 Please also note that enabling this option is quite a performance hit.
229 .TP
230 .BR "\-\-kdiff" =n
231 Minimum length difference between two lines for wrapped line detection on
232 Kammquotes. For details, please see the source code.
233 .br
234 Anyway, lower values make the algorithm more aggressive, higher values
235 make Kammquotes harder to detect. Default is 20.
236 .sp
237 Requires
238 .BR "\-k" .
239 .TP
240 .BR "\-\-kmaxl" =n
241 Maximum line length for wrapped line detection on Kammquotes. For
242 details, please see the source code.
243 .br
244 Anyway, higher values make the algorithm more aggressive, lower values
245 make Kammquotes harder to detect. Default is 80.
246 .sp
247 Requires
248 .BR "\-k" .
249 .TP
250 .BR "\-\-kminl" =n
251 Minimum line length for wrapped line detection on Kammquotes. For
252 details, please see the source code.
253 .br
254 Anyway, lower values make the algorithm more aggressive, higher values
255 make Kammquotes harder to detect. Default is 65.
256 .sp
257 Requires
258 .BR "\-k" .
259 .TP
260 .BR "\-\-locale" =LOCALE
261 Specify which locale to use for correct parsing of your MUA's formatting
262 of the displayed message (usually it is the locale your MUA uses). Right
263 now this option is only used when
264 .I "\-Mmutt"
265 is specified, but this may change in future. You need the Perl module
266 .I "Locale::gettext"
267 for this feature.
268 .sp
269 .IR NOTE :
270 If you use
271 .B mutt
272 or
273 .B gnupg
274 with locales, t-prot will only work correctly if you specify the corresponding
275 locale string. Alternatively, you can use the environment variables
276 .IR LC_ALL ,
277 .IR LC_MESSAGES ,
278 or
279 .I LANG
280 to specify the locale string.
281 .sp
282 .IR "NOTE also" :
283 You also have to make sure you are running t-prot
284 with matching
285 .B gnupg
286 and 
287 .B mutt
288 versions. T-prot detects
289 .B gnupg
290 and
291 .B mutt
292 locales of the recent stable versions of those programs, earlier versions
293 might not work well with a recent version of t-prot. There are patches available
294 to make t-prot fit into environments with some other
295 .B mutt
296 and
297 .B gnupg
298 versions.
299 .TP
300 .BR "\-M, \-\-mua" =MUA
301 "mail user agent":
302 Turn on special treatment for some mail user agents. (Right now only 
303 .BR mutt (1)
304 is supported, but more might be added in future.)
305 .IR Caveat :
306 If your MUA is supported by this feature you must ensure t-prot makes
307 use of it when called from within your MUA to work as desired.
308 .TP
309 .B "\-m"
310 "Microsoft TOFU":
311 Hides TOFU as given by some Microsoft mailers. (You all surely know these
312 fullquotes beginning with
313 .br
314 "\-\-\-\-\- Original Message \-\-\-\-\-"
315 .br
316 and some header lines...)
317 .TP
318 .B "\-\-ms\-smart"
319 Burn CPU cycles trying to be smart with MS style TOFU: If there are PGP
320 signed parts inside the TOFU, the text still might conceal other message
321 parts and therefore should not be deleted.
322 .sp
323 Please note that this is probably just a waste of time because most
324 MS Outlook users who do produce this kind of TOFU won't care about
325 making their messages the least bit readable or even predictable. So
326 this option will probably just be interesting for mutt message hooks
327 (to activate it on demand when you
328 .BR know " the sender tries to write legible messages)."
329 .sp
330 Requires
331 .BR "\-Mmutt" " and"
332 .BR "\-m" .
333 .TP
334 .B \-\-pgp\-move
335 Move PGP verification output to bottom; requires
336 .BR "\-Mmutt" .
337 .TP
338 .B \-\-pgp\-move\-vrf
339 Move PGP verification output to bottom only if verification shows a good signature
340 and the signature could be verified as authentic (using a trust path). If there is
341 any problem with the signature, the PGP output should not be moved so the user is
342 more likely to notice. Requires
343 .BR "\-Mmutt" .
344 .sp
345 .IR NOTE :
346 If gpg is terminated before finished (e.g. hitting Ctrl-C, or using
347 .IR kill (1)),
348 we cannot always detect if the check was interrupted. Though t-prot tries
349 to be smart, there will be false positives.
350 .TP
351 .B \-\-pgp\-short
352 Hide non-relevant PGP key uids; requires
353 .BR "\-Mmutt" .
354 .TP
355 .B "\-r"
356 "rip header off":
357 Hides all mail header lines.
358 .TP
359 .B "\-\-reply"
360 Subject lines with multiple reply prefixes (Re: and translations into other
361 languages) get squeezed to only one prefix.
362 .TP
363 .BR "\-S" "[=n]"
364 "supression of overlong signatures":
365 Signatures are to be n lines (not including the one containing dash-dash-space)
366 or less. If there are more, it is probably not that spirited after all.
367 So with this option you trade it for a
368 .B truely
369 nice line.
370 .br
371 If no n is given, default is 4. (We do not recommend using a value other
372 than 4. Consider this old-fashioned, but we actually do *like* RFC
373 conformance.)
374 .sp
375 .IR NOTE :
376 The line containing "\-\- " ist not counted when testing for an overlong
377 signature, but it is included when displaying how many lines were deleted.
378 .TP
379 .B "\-s"
380 "signature deletion":
381 Hides signatures, i.e. all lines after a "signature dashes" line,
382 i.e. a line with three characters: dash-dash-space (no more, no less).
383 .TP
384 .B "\-\-sani"
385 Sanitize headers "To:", "From:" and "Subject:": Quoted-printable gets
386 fixed to the corresponding chars. German Umlauts are translated to their
387 "ae", "oe", "ue" pendants.
388 .br
389 Useful e.g. for searching by subject within MUAs like Berkeley mailx.
390 .TP
391 .BR "\-\-sigsmax" [=n]
392 "maximum number of tolerated signatures":
393 Here you can define how many signatures you accept to be treated as such.
394 (Most significant behaviour is when microsoft style quotes are removed.
395 Experts please see the code for the more subtle implications of this
396 option.)
397 .br
398 Leave empty or specify zero to have an unlimited number of sigs. 
399 Default is 1.
400 .TP
401 .B "\-\-spass"
402 "SpamAssassin workaround":
403 SpamAssassin (available at
404 .IR http://spamassassin.org/ ") often is configured that it adds some"
405 lines to the message body containing information about the spam criteria
406 which were found matching for the message. This option enables an extra
407 test to avoid false positives for Microsoft style TOFU on such messages.
408 .TP
409 .B "\-t"
410 "TOFU deletion":
411 Hides "traditional style" TOFU, where each line begins with the
412 indent string ">".
413 .TP
414 .B "\-w"
415 "whitespace deletion":
416 Hides trailing whitespace (sequences of space and tab).
417 CAVEAT: This may lead to interesting effects with crossposts
418 between mailing lists or with undetected signature attempts.
419 .SH DETECTION OPTIONS
420 .TP
421 .BR "\-P" "=MESSAGE"
422 "user defined bounce message for picky delivery": 
423 You may specify your own bounce message to be returned when we try to deliver
424 an email and bounce it because there is TOFU inside. See
425 .BR "\-p" .
426 .TP
427 .BR "\-p" "[=ADDRESS]"
428 "picky delivery":
429 If we really find some TOFU, abort with exit code 
430 .IR EX_UNAVAILABLE .
431 Otherwise redirect the message to ADDRESS if given.
432 .sp
433 Intended for use from within mail delivery agents (MDAs) or mail transport 
434 agents (MTAs), or even from within INN, so the message bounces if TOFU is
435 detected, and does not get on *your* nerves. :) 
436 .sp
437 As an example for usage with
438 .BR sendmail ,
439 put this line into your alias file and invoke
440 .BR newaliases :
441 .sp
442 notofu: |"/usr/local/bin/t\-prot \-mt \-p=user@mydomain"
443 .sp
444 This will bounce messages for <notofu@domainname> if any TOFU is detected
445 inside the message, and deliver it to <user@mydomain> otherwise.
446 .I Note
447 that TOFU is only detected if you specify
448 .B "\-t"
449 respectively
450 .BR "\-m" .
451 .sp
452 .B PLEASE be careful not to bounce messages to mailing lists!
453 .TP
454 .BR "\-\-check" [=FLAGS]
455 Run checks. If successful, print an error message and quit with
456 an appropriate exit code. Useful e.g. for rejecting messages from
457 within INN2.
458 .IP
459 Flags are separated by commas (no whitespaces), and can be the
460 following (right now just one flag):
461 .IP
462 .IR ratio [=n]
463 .br
464 If the quoting ratio is n or more, the message is rejected. Must be
465 between 0 and 1, or else it is entirely disabled. Default is 0.75
466 (i.e., 75% of the message lines are quotes).
467 .TP
468 .B "\-d, \-\-debug"
469 Print envelope info to syslog when bouncing TOFU contaminated email.
470 Default syslog facility is mail.debug. Requires
471 .BR \-p .
472 .SH OTHER OPTIONS
473 .TP
474 .B "\-h, \-\-help"
475 Displays a short help text with a summary on all options, and exits.
476 .TP
477 .B "\-v, \-\-version"
478 Prints the current version number and exits.
479 .SH ENVIRONMENT
480 The environment variables
481 .IR LC_ALL ,
482 .IR LC_MESSAGES ,
483 and
484 .I LANG
485 are read and respected when interpreting output by mutt or gnupg
486 (unless they are overruled by the \-\-locale option). T-prot's own
487 output is English regardless of any locale setting.
488 .SH EXIT STATUS
489 On program exit, t-prot uses exit codes from
490 .I /usr/include/sysexits.h
491 and thus behaves in a manner that sendmail and others understand when
492 calling t-prot.
493 .sp
494 Currently, the codes used are
495 .RS 20
496 .PD 0
497 .TP
498 EX_OK
499 .TP
500 EX_USAGE
501 .TP
502 EX_DATAERR
503 .TP
504 EX_UNAVAILABLE
505 .TP
506 EX_SOFTWARE
507 .TP
508 EX_IOERR
509 .PD
510 .RE
511 .sp
512 If, however, perl fails to compile and execute t-prot, perl's normal
513 exit codes will be returned.
514 .SH TOFU?
515 TOFU is an abbreviation which mixes German and English words;
516 it expands to "text oben, full-quote unten" which means
517 "text above - full quote below" and describes the style of so
518 many users who let their mailer or newsreader quote everything
519 of the previous message and just add some text at the top;
520 obviously they think that quoted text must not be changed at all.
521 This is quite annoying as it needlessly sends a lot of data
522 even when it is not required. Some editing of messages is desired.
523 Please point these people to the page 
524 .I http://www.river.com/users/share/etiquette/edit.html
525 - thank you!
526 .SH PERFORMANCE
527 There are several ways to fine-tune t-prot's performance:
528 .PP
529 Some command line options are quite grave a performance hit -- do not
530 use \-k and especially \-\-ms\-smart if you are content without them.
531 .PP
532 Checking for special footers is very costly as well. Put as few footer
533 files as absolutely needed in any footer directory.
534 .PP
535 All PGP related options are eating up lots of CPU time. Try to avoid them
536 on unsigned and unencrypted messages.
537 .PP
538 When calling t-prot from within mutt, you might use mutt's folder-hook
539 and message-hook facilities to turn options on only when needed, e.g. to
540 set up a different footer directory for each mailing list folder.
541 .SH TROUBLESHOOTING
542 .TP
543 .IR Q :
544 I want to make my mailing list footer files match more different mailing
545 list footers. Can I use regular expressions, or how can I accomplish
546 that?
547 .TP
548 .IR A :
549 Nope, regexp's do not work here. The comparison is made by the perl
550 builtin
551 .IR index ()
552 function (see 
553 .B perldoc
554 for more detailed info), so you must exactly match the beginning of the
555 line. The longer the line you specify, the more precise the match; if
556 your line is empty you match unconditionally.
557 .PP
558 .TP
559 .IR Q :
560 I use the options \-l and \-L to supress mailing list footers when
561 displaying messages in
562 .BR mutt (1).
563 This does work sometimes, but sometimes it does not: the footer is not
564 detected, and therefore full quotes are not deleted and signatures are
565 detected as too long (which they aren't).
566 .TP
567 .IR A :
568 This might occur if the message is badly encoded, so mutt cannot resolve
569 all encoded characters, e.g. if you have an encoded message on a mailing
570 list, and majordomo appends a mailing list footer in a different encoding
571 (or even plain us-ascii). "\-\- " simply does not match "\-\-=20".
572 .br
573 Another problem are non-us-ascii characters. Just avoid them, and 
574 everything should work fine.
575 .br
576 See the preceding Q+A for a solution.
577 .PP
578 .TP
579 .IR Q :
580 I want to write a message which contains parts that should *not* be 
581 deleted even when filtered with t-prot. Is this possible?
582 .TP
583 .IR A :
584 Yes, but please do not spread word of it. Make unobstrusive use of the
585 .I
586 verbatim
587 instruction:
588 .sp
589 #v+
590 .br
591 This line is protected from being filtered by t\-prot !!!!!!!
592 .br
593 #v\-
594 .br
595 Text coming now is not.
596 .SH AUTHOR
597 Written by Jochen Striepe <t\-prot@tolot.escape.de>.
598 .SH COPYRIGHT
599 All of the documentation and software included in the t-prot releases
600 is copyrighted by Jochen Striepe (except when explicitly stated otherwise).
601 .PP
602 Copyright \(co 2001-2010 Jochen Striepe. All rights reserved.                     
603 .PP
604 Redistribution and use, with or without modification, are permitted
605 provided that the following conditions are met:
606 .PP
607 1. Redistributions of source code must retain the above copyright notice,
608 this list of conditions and the following disclaimer.
609 .PP
610 2. All advertising materials mentioning features or use of this software
611 must display the following acknowledgement:
612 .PP
613   This product includes software developed by Jochen Striepe and others.
614 .PP
615 3. Neither the name of the author nor the names of any contributors may
616 be used to endorse or promote products derived from this software without
617 specific prior written permission.
618 .PP
619 THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY
620 EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
621 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
622 DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY
623 DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
624 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
625 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
626 ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
627 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
628 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
629 .SH IDEAS AND INSPIRATION
630 Many good ideas, bug reports and support from (in alphabetical order) Bjoern
631 Buerger, Bjoern Laessig, Christian Borss, Gerfried Fuchs, Martin Neitzel, Martin
632 Dietze, Matthias Kilian, Ralf Doeblitz, Sven Guckes and many more (see the
633 ChangeLog for active contributors). Many thanks to all of them!
634 .sp
635 Many thanks to Gerhard H. Wrodnigg who uses a TOFU protection script
636 in order to keep the responses to his cancel bot reasonably short.  The
637 entire inspiration for this hack came from the "TOFU protection" line of
638 his script on many usenet postings.
639 .SH AVAILABILITY
640 You can get the latest version from
641 .IR http://www.escape.de/users/tolot/mutt/ .
642 .SH BUGS
643 There is a problem when mutt gives a PGP verified or even a multipart
644 message to t-prot: The information where the PGP encrypted/signed data
645 or even attachments begin and end is plainly embedded in the text, not
646 really cleanly recognizable for t-prot. The problem should be worked
647 around by now, please send a bug report if it does not work for you.
648 .SH "REPORTING BUGS"
649 Please note that t-prot development happens on
650 .BR "current stable perl versions only" . 
651 If you do run t-prot on earlier (or unstable) perl versions, you might
652 encounter perl compiler bugs (or funny t-prot behaviour). One solution
653 is to upgrade your perl, another is simply to write a bug report. If
654 you do not run a current perl version, please include this information
655 in your bug report.
656 .PP
657 Please do
658 .I not
659 report a bug if
660 .br
661  * you found it in the TODO file coming with the distribution. We do
662 know those and try to fix them as soon as possible.
663 .br
664  * you have an old t-prot version. If you encounter a problem, first
665 see if there is a new t-prot version which fixes the issue. If you
666 upgraded to the latest version and it still occurs, a bug report is
667 just great.
668 .PP
669 If you noticed a bug when processing a message and want to provide the
670 t-prot team with some useful info, please:
671 .br
672  * if invoking t-prot by mutt's
673 .I display_filter
674 facility, just set display_filter to something like
675 .IP
676 "tee ~/foobar | t\-prot <your options>"
677 .PP
678 and include ~/foobar in the bug report -- this way we might reproduce
679 the bug much easier if you are using a different environment than we do.
680 .br
681  * provide information on what command line options you use t-prot
682 with, what perl version t-prot runs on your system, and what else might
683 be important to enable us reproducing the bug.
684 .PP
685 Send your bug report to 
686 .IR <t\-prot\-bugs@tolot.escape.de> .
687 Thank you.
688 .SH TODO
689 Fix bugs (see the 
690 .I BUGS
691 section). Beside that, all main features should be implemented by now.
692 See the TODO file for more information.
693 .SH "SEE ALSO"
694 .BR mutt (1),
695 .BR muttrc (5)
696 and the part about "display_filter", 
697 .BR perl (1),
698 .BR aliases (5),
699 .sp
700 RFCs 2045-2049, 3676 and 5322,
701 .sp
702 .I http://freshmeat.net/articles/t\-prot/
703 (a nice, solid introduction),
704 .br
705 .I http://got.to/quote/
706 (German language),
707 .br
708 .I http://www.river.com/users/share/etiquette/edit.html
709 (the Learn To Edit Messages HowTo has found a new home).
710