Am 11.10.2013 17:05 schrieb Kevin A. McGrail: > On behalf of the PMC, the ASF SpamAssassin Project is pleased to > announce the availability of our third release candidate for 3.4.0. Hi all!
thanks for that great software first! I found two minor issues in perl documentation and attach a patch. There is an other documentation issue in Conf.pm (found by debian lintian): --- lintian output: W: spamassassin: manpage-has-errors-from-man usr/share/man/man3/Mail::SpamAssassin::Conf.3pm.gz 1749: warning [p 25, 4.5i, div `an-div', 0.2i]: can't break line N: N: This man page provokes warnings or errors from man. N: N: "cannot adjust" or "can't break" are trouble with paragraph filling, N: usually related to long lines. Adjustment can be helped by left N: justifying, breaks can be helped with hyphenation, see "Manipulating N: Filling and Adjusting" and "Manipulating Hyphenation" in the manual. N: N: "can't find numbered character" usually means latin1 etc in the input, N: and this warning indicates characters will be missing from the output. N: You can change to escapes like \[:a] described on the groff_char man N: page. N: N: Other warnings are often formatting typos, like missing quotes around a N: string argument to .IP. These are likely to result in lost or malformed N: output. See the groff_man (or groff_mdoc if using mdoc) man page for N: information on macros. N: N: This test uses man's --warnings option to enable groff warnings that N: catch common mistakes, such as putting . or ' characters at the start of N: a line when they are intended as literal text rather than groff N: commands. This can be fixed either by reformatting the paragraph so that N: these characters are not at the start of a line, or by adding a N: zero-width space (\&) immediately before them. N: N: At worst, warning messages can be disabled with the .warn directive, see N: "Debugging" in the groff manual. N: N: To test this for yourself you can use the following command: N: LANG=en_US.UTF-8 MANWIDTH=80 man --warnings -E UTF-8 -l <file> >/dev/null N: N: Severity: normal, Certainty: certain Andreas
Index: spamassassin-3.4.0.rc3/lib/Mail/SpamAssassin/Conf.pm =================================================================== --- spamassassin-3.4.0.rc3.orig/lib/Mail/SpamAssassin/Conf.pm 2013-10-12 22:44:34.000000000 +0200 +++ spamassassin-3.4.0.rc3/lib/Mail/SpamAssassin/Conf.pm 2013-10-12 22:54:35.000000000 +0200 @@ -2620,11 +2620,11 @@ for example C<From:addr:raw> or C<From:raw:addr> is currently the same as C<From:addr> . -=over 4 - For example, appending C<:addr> to a header name will result in example@foo in all of the following cases: +=over 4 + =item example@foo =item example@foo (Foo Blah) Index: spamassassin-3.4.0.rc3/lib/Mail/SpamAssassin/Plugin/DNSEval.pm =================================================================== --- spamassassin-3.4.0.rc3.orig/lib/Mail/SpamAssassin/Plugin/DNSEval.pm 2013-10-12 22:55:30.000000000 +0200 +++ spamassassin-3.4.0.rc3/lib/Mail/SpamAssassin/Plugin/DNSEval.pm 2013-10-12 22:57:13.000000000 +0200 @@ -318,6 +318,8 @@ _check_rbl_addresses(@_, $_[1]->all_from_addrs()); } +=over 4 + =item check_rbl_from_domain This checks all the from addrs domain names as an alternate to check_rbl_from_host
