Mail/GnuPG version 0.06
=======================

Use GnuPG::Interface to process and/or create PGP signed or encrypted
email.

(See the inline documentation for more information)

This is a 0.06 release.  It works for me and at least one or two other
people.  It may not work for you.  If it doesn't, patches are
appreciated.

There is a known issue where some messages may not verify properly
because they use a fuzzy encoding like Quoted-Printable, and may
decode slightly differently in different places.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules (and their dependencies):

GnuPG::Interface
IO::Handle
MIME::Entity
File::Temp
MIME::Parser
Mail::Address

GnuPG
cut(1)

SUPPORT/REPORTING BUGS/PATCHES

Please send all bugs/issues/patches to 
    bug-Mail-GnuPG@rt.cpan.org

COPYRIGHT AND LICENCE

Copyright 2003 Best Practical Solutions, LLC

This program is free software; you can redistribute it and/or modify
it under the terms of either:

    a) the GNU General Public License as published by the Free
    Software Foundation; version 2
    http://www.opensource.org/licenses/gpl-license.php

    b) the "Artistic License"
    http://www.opensource.org/licenses/artistic-license.php

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See either the
GNU General Public License or the Artistic License for more details.

NOTES

RFC1847 - Security Multiparts
http://www.ietf.org/rfc/rfc1847.txt

RFC2015 -  MIME Security with PGP 
http://www.ietf.org/rfc/rfc2015.txt

KNOWN ISSUES

 #2718 - https://rt.cpan.org/Ticket/Display.html?id=2718

  Mail::GnuPG assumes the signature is calculated on the decoded MIME
  data (which is the only thing it can get from MIME::Entity).  Jörn
  Reder is working on a solution.

TODO

- Get rid of 'cut' dependency.
- Consider nicer/prettier interface
- Use GnuPG::Interface's internal passphrase handling
- Add tests
- Use GnuPG::Handle->{direct} to pass files directly to gpg

AUTHOR

Robert Spier
rspier at cpan.org

Large Contributions from:
    Jörn Reder 
    joern at zyn.de