@node Top
@top PGG
-This manual describes PGG. PGG is an interface library between Emacs
-and various tools for secure communication. PGG also provides a simple
-user interface to encrypt, decrypt, sign, and verify MIME messages.
+\e$B$3$l$O\e(B PGG \e$B$N%^%K%e%"%k$G$9!#\e(BPGG \e$B$O!"0BA4$JDL?.$N$?$a$NMM!9$J%D!<%k$H\e(B
+Emacs \e$B$NCg$r<h$j;}$D%$%s%?%U%'!<%9$G$9!#$^$?!"\e(BPGG \e$B$O!"\e(BMIME \e$B%a%C%;!<%8\e(B
+\e$B$N0E9f2=!"I|9f2=!"=pL>!"8!>Z$N$?$a$NC1=c$J%f!<%6%$%s%?%U%'!<%9$bDs6!$7$^\e(B
+\e$B$9!#\e(B
@menu
-* Overview:: What PGG is.
-* Prerequisites:: Complicated stuff you may have to do.
-* How to use:: Getting started quickly.
+* Overview:: PGG \e$B$H$O\e(B
+* Prerequisites:: \e$B$"$i$+$8$a$7$F$*$/$Y$-J#;($J;vJA\e(B
+* How to use:: \e$B$H$C$H$H;H$$;O$a$h$&\e(B
* Architecture::
* Parsing OpenPGP packets::
* Function Index::
@node Overview
@chapter Overview
-PGG is an interface library between Emacs and various tools for secure
-communication. Even though Mailcrypt has similar feature, it does not
-deal with detached PGP messages, normally used in PGP/MIME
-infrastructure. This was the main reason why I wrote the new library.
+PGG \e$B$O!"0BA4$JDL?.$N$?$a$NMM!9$J%D!<%k$H\e(B Emacs \e$B$NCg$r<h$j;}$D%$%s%?%U%'!<\e(B
+\e$B%9$G$9!#F1MM$N5!G=$O\e(B Mailcrypt \e$B$b;}$C$F$$$^$9$,!"\e(BMailcrypt \e$B$O\e(B PGP/MIME
+\e$B$N%$%s%U%i$GDL>oMQ$$$i$l$k\e(B detached PGP \e$B%a%C%;!<%8$r<h$j07$&$3$H$,$G$-$^\e(B
+\e$B$;$s!#$3$l$,!";d\e(B(\e$B:n<T\e(B)\e$B$,?7$7$$%i%$%V%i%j$r=q$$$?<g$JM}M3$G$9!#\e(B
-PGP/MIME is an application of MIME Object Security Services (RFC1848).
-The standard is documented in RFC2015.
+PGP/MIME \e$B$O\e(B MIME Object Security Services (RFC1848) \e$B$N<BAu$G$9!#$=$NI8=`\e(B
+\e$B$O\e(B RFC2015 \e$B$G5-=R$5$l$F$$$^$9!#\e(B
@node Prerequisites
@chapter Prerequisites
-PGG requires at least one implementation of privacy guard system.
-This document assumes that you have already obtained and installed them
-and that you are familiar with its basic functions.
+PGG \e$B$r;H$&$?$a$K$O>/$J$/$H$b\e(B1\e$B$D$N%W%i%$%P%7!<J]8n%7%9%F%`$N<BAu$,I,MW$G\e(B
+\e$B$9!#$3$N%^%K%e%"%k$G$O!"$"$J$?$,$=$N$h$&$J%W%m%0%i%`$r$9$G$K<hF@!"%$%s%9\e(B
+\e$B%H!<%k$7$F$$$F!"4pK\E*$J;H$$J}$rCN$C$F$$$k$3$H$r2>Dj$7$^$9!#\e(B
-By default, PGG uses GnuPG, but Pretty Good Privacy version 2 or version
-5 are also supported. If you are new to such a system, I recommend that
-you should look over the GNU Privacy Handbook (GPH) which is available
-at @uref{http://www.gnupg.org/gph/}.
+\e$B%G%#%U%)%k%H$G$O!"\e(BPGG \e$B$O\e(B GnuPG \e$B$r;H$$$^$9!#$7$+$7!"\e(BPGP (Pretty Good
+Privacy) \e$B$N%P!<%8%g%s\e(B2\e$B$^$?$O\e(B5\e$B$b%5%]!<%H$7$^$9!#$b$7!"$"$J$?$,$3$N$h$&$J\e(B
+\e$B%7%9%F%`$K47$l$F$$$J$$$N$G$"$l$P!"\e(BGNU Privacy Handbook (GPH) \e$B$r@h$KFI$^\e(B
+\e$B$l$k$3$H$r$*A&$a$7$^$9!#\e(BGPH \e$B$O!"\e(B@uref{http://www.gnupg.org/gph/} \e$B$G8+$k\e(B
+\e$B$3$H$,$G$-$^$9!#\e(B
@node How to use
@chapter How to use
-The toplevel interface of this library is quite simple, and only
-intended to use with public-key cryptographic operation.
+\e$B$3$N%i%$%V%i%j$N:G>e0L%$%s%?%U%'!<%9$O$H$F$bC1=c$G!"8x3+80$K$h$k0E9f$NA`\e(B
+\e$B:n$N$_$rA[Dj$7$F$$$^$9!#\e(B
-To use PGG, evaluate following expression at the beginning of your
-application program.
+PGG \e$B$r;H$&$?$a$K$O!"$"$J$?$N%"%W%j%1!<%7%g%s%W%m%0%i%`$NKAF,$G<!$N\e(B S \e$B<0\e(B
+\e$B$rI>2A$7$^$9!#\e(B
@lisp
(require 'pgg)
@end lisp
-If you want to check existence of pgg.el at runtime, instead you can
-list autoload setting for desired functions as follows.
+\e$B$"$J$?$,\e(B pgg.el \e$B$NB8:_$r3NG'$7$?$$$J$i!">e5-$NJ}K!$G$O$J$/0J2<$N$h$&$K!"\e(B
+\e$BI,MW$J5!G=$K$D$$$F\e(B autoload \e$B$N%j%9%H$r@_Dj$9$k$3$H$b$G$-$^$9!#\e(B
@lisp
(autoload 'pgg-encrypt-region "pgg"
@node User Commands
@section User Commands
-At this time you can use some cryptographic commands. The behavior of
-these commands relies on a fashion of invocation because they are also
-intended to be used as library functions. In case you don't have the
-signer's public key, for example, the function @code{pgg-verify-region}
-fails immediately, but if the function had been called interactively, it
-would ask you to retrieve the signer's public key from the server.
+\e$B$3$N;~E@$G!"$"$J$?$O$$$/$D$+$N0E9f$K4X$9$k%3%^%s%I$r;H$&$3$H$,$G$-$^$9!#\e(B
+\e$B$3$l$i$N%3%^%s%I$N5sF0$O5/F0J}K!$K0MB8$7$^$9!#$3$l$i$N%3%^%s%I$O%i%$%V%i\e(B
+\e$B%j4X?t$H$7$FMxMQ$5$l$k$3$H$b$"$k$+$i$G$9!#Nc$($P!"$"$J$?$,$"$k=pL><T$N8x\e(B
+\e$B3+80$r;}$C$F$$$J$$$H$-!"\e(B@code{pgg-verify-region} \e$B$H$$$&4X?t$OB(:B$K<:GT\e(B
+\e$B$7$^$9$,!"$3$l$,BPOCE*$K8F$S=P$5$l$?>l9g$K$O!"%5!<%P$+$i8x3+80$r%@%&%s%m!<\e(B
+\e$B%I$9$k$+$I$&$+!"$"$J$?$K3NG'$7$^$9!#\e(B
@deffn Command pgg-encrypt-region start end recipients &optional sign
-Encrypt the current region between @var{start} and @var{end} for
-@var{recipients}. When the function were called interactively, you
-would be asked about the recipients.
+@var{recipients}\e$B08$N%a%C%;!<%8$K$D$$$F!"\e(B@var{start}\e$B$H\e(B@var{end}\e$B$N4V$G;XDj\e(B
+\e$B$5$l$?8=:_$NHO0O$r0E9f2=$7$^$9!#BPOCE*$K8F$P$l$k$H!"<u?.<T$rJ9$+$l$^$9!#\e(B
-If encryption is successful, it replaces the current region contents (in
-the accessible portion) with the resulting data.
+\e$B0E9f2=$K@.8y$9$k$H!"8=:_$NHO0O$NFbMF$,\e(B(\e$B2DG=$JItJ,$K$D$$$F\e(B)\e$B0E9f2=$5$l$?Fb\e(B
+\e$BMF$KCV$-49$($i$l$^$9!#\e(B
-If optional argument @var{sign} is non-@code{nil}, the function is
-request to do a combined sign and encrypt. This currently only work
-with GnuPG.
+\e$B%*%W%7%g%s0z?t\e(B @var{sign} \e$B$,\e(B non-@code{nil} \e$B$J$i$P!"=pL>$H0E9f2=$,F1;~$K\e(B
+\e$B9T$o$l$^$9!#8=:_!"$3$N5!G=$O\e(B GnuPG \e$B$G$@$1F0:n$7$^$9!#\e(B
@end deffn
@deffn Command pgg-decrypt-region start end
-Decrypt the current region between @var{start} and @var{end}. If
-decryption is successful, it replaces the current region contents (in
-the accessible portion) with the resulting data.
+@var{start}\e$B$H\e(B@var{end}\e$B$N4V$G;XDj$5$l$?8=:_$NHO0O$rI|9f2=$7$^$9!#I|9f2=$K\e(B
+\e$B@.8y$9$k$H!"8=:_$NHO0O$NFbMF$,\e(B(\e$B2DG=$JItJ,$K$D$$$F\e(B)\e$BI|9f2=$5$l$?FbMF$KCV$-\e(B
+\e$B49$($i$l$^$9!#\e(B
@end deffn
@deffn Command pgg-sign-region start end &optional cleartext
-Make the signature from text between @var{start} and @var{end}. If the
-optional third argument @var{cleartext} is non-@code{nil}, or the
-function is called interactively, it does not create a detached
-signature. In such a case, it replaces the current region contents (in
-the accessible portion) with the resulting data.
+@var{start}\e$B$H\e(B@var{end}\e$B$N4V$N%F%-%9%H$K=pL>$7$^$9!#\e(B3\e$BHVL\$N%*%W%7%g%s0z?t\e(B
+@var{cleartext} \e$B$,\e(B non-@code{nil} \e$B$G$"$k$+!"$"$k$$$OBPOCE*$K8F$P$l$?>l9g!"\e(B
+detached signature \e$B$O:n$i$l$^$;$s!#$=$N$h$&$J>l9g!"8=:_$NHO0O$NFbMF$,\e(B(\e$B2D\e(B
+\e$BG=$JItJ,$K$D$$$F\e(B)\e$B=pL>$5$l$?7k2L$KCV$-49$($i$l$^$9!#\e(B
@end deffn
@deffn Command pgg-verify-region start end &optional signature fetch
-Verify the current region between @var{start} and @var{end}. If the
-optional third argument @var{signature} is non-@code{nil}, or the function
-is called interactively, it is treated as the detached signature of the
-current region.
+@var{start}\e$B$H\e(B@var{end}\e$B$N4V$NHO0O$r8!::$7$^$9!#\e(B3\e$BHVL\$N%*%W%7%g%s0z?t\e(B
+@var{signature} \e$B$,\e(B non-@code{nil} \e$B$G$"$k$+!"$"$k$$$OBPOCE*$K8F$P$l$?>l9g!"\e(B
+detached signature \e$B$H$7$F<h$j07$o$l$^$9!#\e(B
-If the optional 4th argument @var{fetch} is non-@code{nil}, or the
-function is called interactively, we attempt to fetch the signer's
-public key from the key server.
+4\e$BHVL\$N%*%W%7%g%s0z?t\e(B @var{fetch} \e$B$,\e(B non-@code{nil} \e$B$G$"$k$+!"$"$k$$$OBP\e(B
+\e$BOCE*$K8F$P$l$?>l9g!"8x3+80$r%5!<%P$+$i<hF@$7$^$9!#\e(B
@end deffn
@deffn Command pgg-insert-key
-Retrieve the user's public key and insert it as ASCII-armored format.
+\e$B%f!<%6$N8x3+80$r<hF@$7$F!"\e(BASCII-armored \e$B%U%)!<%^%C%H$GA^F~$7$^$9!#\e(B
@end deffn
@deffn Command pgg-snarf-keys-region start end
-Collect public keys in the current region between @var{start} and
-@var{end}, and add them into the user's keyring.
+@var{start}\e$B$H\e(B@var{end}\e$B$N4V$NHO0O$K$"$k8x3+80$r=8$a!"%f!<%6$N80NX\e(B
+(keyring)\e$B$KDI2C$7$^$9!#\e(B
@end deffn
@node Selecting an implementation
projects / elisp / gnus-doc-ja.git / commitdiff