X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README;h=81a94abea80d0851b38e0fabbb30586e43f8ca74;hb=3c0243c9e94a1185749b53a334b3358fa0d5bd8f;hp=f5336b61d45ebbf4af3ffebba551e4e9ce937ad0;hpb=c3272a33c8f86710f4cb4a48a13bed268aca6a49;p=elisp%2Fepg.git diff --git a/README b/README index f5336b6..81a94ab 100644 --- a/README +++ b/README @@ -1,56 +1,35 @@ * What's this? -EasyPG is yet another GnuPG interface for Emacs. It consists of three -parts: transparent file encryption utility, Gnus/PGG backend, and -elisp library to interact with GnuPG. +EasyPG is yet another GnuPG interface for Emacs. It consists of two parts: + +- "The EasyPG Assistant" which provides basic GUI of GnuPG +- "The EasyPG Library" which enables use of various features of GnuPG + +NOTE: EasyPG is not a fork or a re-implementation of Gnus/PGG. * Requirements -** GNU Emacs 21.4 or later / XEmacs 21.4 or later +** GNU Emacs 21.4 or later, XEmacs 21.4 or later ** GnuPG 1.4.3 or later -** Gnus 5.10.8 or later (optional) - * Quick start ** Installation -$ ./configure -$ sudo make install - -** Transparent file encryption utility - -EasyPG provides transparent file encryption utility similar to -crypt++, alpaca.el, hedgehog. To try this, add the following line to -your ~/.emacs and C-x C-f ~/test.txt.gpg. - -(require 'epf) + $ ./configure + $ sudo make install -** Gnus/PGG backend +Add the following line to your ~/.emacs -EasyPG provides an implementation of the backend interface of -Gnus/PGG. To use EasyPG instead of pgg-gpg, install pgg-epg.el and -add the following line to your ~/.gnus. + (require 'epa-setup) -(setq pgg-scheme 'epg) +Then you can do some cryptographic operations on dired. -* Advantages over other competitors - -There are many competitors of EasyPG such as Mailcrypt, Gnus/PGG, -gpg.el, etc. EasyPG has some advantages over them. - -** EasyPG avoides potential security flaws of Emacs - -See "Security consideration" section. - -** GnuPG features are directly accessible from Emacs - -Other competitors provide only specific features of GnuPG since they -still support PGP 2.*, 5.*, 6.*. As the name indicates, EasyPG is -inspired by GPGME (GnuPG Made Easy), and the library interface is -close to GPGME. With EasyPG you can benefit from a lot of features of -GnuPG. + M-x dired + (mark some files) + : e (or M-x epg-dired-do-encrypt) + (select recipients and click [OK]) * Security consideration @@ -69,6 +48,6 @@ in gc_sweep phase. If GC happens before `fillarray', passphrase strings may be moved elsewhere in memory. Fortunately, there is gpg-agent to cache passphrases in more secure -way, so EasyPG dares *not* to cache passphrase. Elisp programs can -set `epg-context-passphrase-callback' to cache user's passphrases. - +way, so the EasyPG library dares *not* to cache passphrase by itself. +Elisp programs can set `epg-context-passphrase-callback' to cache +user's passphrases.