The Mail::SpamAssassin::PerMsgLearner SYNOPSIS is basically a complete example. $mail should contain your entire mail message, $id should be either undef or a unique id of your own providing to identify the message (if it is undef then the message-id from the mail message will be used.) $isspam should be 1 if you want the message to be learned as spam or 0 if you want it to be learned as ham. YOu can omit the $forget or provide 0, if it is 1 then the message will un-learned rather than learned. The  $status->did_learn(); will return a true value if the message was actually learned: it might be not learned if the message was already seen for instance.

/J\