KMail Power Tools installation
----------------------------

   0. Pre-requisites: Perl packages MIME::Parser, MIME::WordDecoder & GnuPG::Interface
      (new _optional_ requirement since 0.3), Kdialog
      Note: in Mandriva, MIME::Parser resides in the 'perl-MIME-tools' package.
            in Debian based distros, it can be found in the 'libmime-perl' package.
   1. Uncompress the tarball in a temporary directory.
   2. Install the files system wide by: make install (as root).
       This will copy kmailpt.pl to /usr/local/bin, and the icons to /usr/share/icons/.
   3. You may repeat 4 times this step:
          * Create a new filter in kmail (Settings/Configure filters) with the following settings:
          * General tab
                o Filter Criteria
                      + Select "Match all the following"
                      + <any header> [Contains] .
                        (yes dot, this will match any mail)
                o Filter Actions: choose [Pipe Through], then use:
                      1. to remove all attachments:
                        /usr/local/bin/kmailpt.pl -a
                        (warning: this will remove all attachments without any prompt)
                      2. to ask the user which attachment to remove:
                        /usr/local/bin/kmailpt.pl -q
                      3. to detach attachments:
                        /usr/local/bin/kmailpt.pl -d
                      4. to store the email decrypted:
                        /usr/local/bin/kmailpt.pl -g
                      + Note: you can also add the following options:
                        -m to add the md5 sum of the file to the disclaimer
                        -s to add the file size to the disclaimer
                        -g to store the result decrypted
                        -p to make use of gpg-agent.
          * Advanced tab
                o uncheck "Apply this filter to incoming messages" and "Apply this filter to sent messages"
                o check "Apply this filter on manual filtering", "If this filter matches, stop processing here", "Add this filter to the Apply Filter menu" and "Additionaly add this filter to the toolbar"
                o choose a beautiful Icon for this filter. For example, for my "remove attachments" filter, I chose "/usr/share/icons/attach_delete.png", and for my "detach attachments" filter, I chose "/usr/share/icons/attach_save.png". For my "decrypt email" filter, I found decrypted.png.
                o you may also select a keyboard shortcut to run it
          * [Rename] this filter to "Remove all attachments", "Remove attachments", "Detach attachments" or "Decrypt email" depending on the filter action you entered.
          * Press [OK] ;-)