https://issues.apache.org/SpamAssassin/show_bug.cgi?id=6707

             Bug #: 6707
           Summary: PerMsgStatus get_decoded_body_text_array() incorrect
                    documentation
           Product: Spamassassin
           Version: 3.3 SVN branch
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: dev@spamassassin.apache.org
        ReportedBy: guent...@rudersport.de
    Classification: Unclassified


The documentation for M::SA::PerMsgStatus get_decoded_body_text_array() is
incorrect. It claims to return an array of "lines of the body".

What it actually returns is an array with chunks of all textual MIME-parts.

More precisely, it (used to) return an array of all textual MIME-parts, each
MIME-part in a string (member of the array) of its own. Since 3.3, long-ish
MIME-parts are broken up into chunks between 1024 and 2048 bytes.

See M::SA::Message get_decoded_body_text_array() for the actual code.

See bug 5717 for the "split into chunks" issue.


The directly related M::SA::Conf rawbody rule documentation has been changed
already, not to talk about "lines", and that multiline RE modifiers might be
needed. Breaking up MIME-parts into chunks is not mentioned, though. Might be
worthwhile to add here, or reference the PerMsgStatus docs -- since REs don't
match, if the target sub-string happens to span a chunk boundary, even though
the message would match the RE.

-- 
Configure bugmail: 
https://issues.apache.org/SpamAssassin/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

Reply via email to