RSSyl: Allow use of .netrc by libcurl. Bug/enhancement #3309, by Vincent Pelletier
[claws.git] / src / plugins / perl / cm_perl.pod
index fd522952c581edd1249164bc68516082acca747a..bb190a338e8f535697bfc9fffa6a20eb2fbf8fda 100644 (file)
@@ -2,7 +2,6 @@
 
 cm_perl -- A Perl Plugin for Claws Mail
 
-
 =head1 DESCRIPTION
 
 This plugin provides an extended filtering engine for the email
@@ -192,7 +191,7 @@ Returns a true value if the messages has one or more tags.
 Corresponds the 'test' internal filtering rule. In particular, it
 accepts the same symbols, namely:
 
-=over 
+=over
 
 =item %%
 
@@ -245,11 +244,12 @@ Filename -- should not be modified
 =item regexpcase WHERE WHAT
 
 The matching functions have a special syntax. The first argument
-is either any of to_or_cc, body_part, headers_part, message, to,
-from, subject, cc, newsgroups, inreplyto, references, or tag (those
-strings may or may not be quoted), the patter matching works on
-that area. If it is any other string (which must then be quoted),
-this string is taken to be the name of a header field.
+is either any of to_or_cc, body_part, headers_part, headers_cont,
+message, to, from, subject, cc, newsgroups, inreplyto,
+references, or tag (those strings may or may not be quoted), the
+pattern matching works on that area. If it is any other string
+(which must then be quoted), this string is taken to be the name
+of a header field.
 
 The second argument is the string to look for. For match,
 matchcase, regexp and regexpcase we have case sensitive normal
@@ -299,7 +299,7 @@ This is a I<final> rule.
 
 =item mark_as_read
 
-Mark the message as read 
+Mark the message as read
 
 =item mark_as_unread
 
@@ -537,23 +537,23 @@ If the SECTION is omitted, "LOG_MANUAL" is assumed.
 Changes the filter log verbosity for the current mail. VERBOSITY
 must be any of
 
-=over
+=over 2
 
-=item *
+=item C<0>
 
-0
+Be silent
 
-=item *
+=item C<1>
 
-1
+Log MANUAL type
 
-=item *
+=item C<2>
 
-2
+Log Action type
 
-=item *
+=item C<3>
 
-3
+Log MATCH type
 
 =back
 
@@ -584,20 +584,20 @@ recognized:
 
 =over
 
-=item 0
+=item C<0>
 
 logging disabled
 
-=item 1
+=item C<1>
 
 log only manual messages, that is, messages introduced by the
 C<filter_log> command in filter scripts
 
-=item 2
+=item C<2>
 
 log manual messages and filter actions
 
-=item 3
+=item C<3>
 
 log manual messages, filter actions and filter matches
 
@@ -633,16 +633,16 @@ sure you get the idea..
 
  #-8<----------------------------------------------------
  # -*- perl -*-
+
  # local functions
+
  # Learn ham messages, and move them to specified folder. This is
  # useful for making sure a bayes filter sees ham as well.
  sub learn_and_move {
      execute('put command to learn ham here');
      move(@_);
  }
+
  # Two-stage spam filter. Every email that scores higher than 15
  # on SpamAssassin gets moved into the default trash folder.
  # All mails lower than that, but higher than SpamAssassin's
@@ -658,15 +658,15 @@ sure you get the idea..
      }
      if($value >= $threshold) {mark_as_read; move '#mh/mail/Spam';}
  }
+
  # Perl script execution starts here.
+
  # Some specific sorting
  learn_and_move '#mh/mail/MailLists/Claws Mail/user'
    if matchcase('sender','claws-mail-users-admin@lists.sourceforge.net');
  learn_and_move '#mh/mail/MailLists/Sylpheed'
    if matchcase('list-id','sylpheed.good-day.net');
+
  # Implement imcomming folders using addressbook
  # attributes. Target folders for specific email addresses are
  # stored directly in the addressbook. This way, if an email
@@ -687,7 +687,7 @@ sure you get the idea..
  # An example of a whitelist: If the from-address is in my
  # "office" addressbook, move the mail to folder #mh/mail/office
  learn_and_move '#mh/mail/office' if from_in_addressbook("office");
+
  # If the from-address is in any other addressbook, move the
  # mail to folder #mh/mail/inbox/known
  learn_and_move '#mh/mail/inbox/known' if from_in_addressbook;