In order for the scripts to work, before you start you will need the following:
/bin/sh, mktemp, grep and egrep, sed, cat, split, and the latest version of
either GNU GPG, or PGP 6. Other versions of pgp _may_ work, but I have not
tested them. The system binaries mentioned are installed by default on any
recent FreeBSD system.

The filters assume that you will have your pgp binaries in stalled in /bin,
or PREFIX/bin.


Installation is quite simple:

./configure [--help|--prefix=/path]	# /usr/local is the default
make install

The Makefile will install the scripts to PREFIX/libexec. To make use of them
you will have to modify your Pine config. First make a backup of your config,
then start Pine and type M for "Menu" (if you're not already there), S for
"Setup," and C for "Config." Assuming that /usr/local is your PREFIX, to verify
and/or decrypt files, put the following in your display-filters option, exactly
as shown:

_LEADING("-----BEGIN PGP SIGNED ")_ /usr/local/libexec/ppf_verify _TMPFILE_
_LEADING("-----BEGIN PGP MESSAGE")_ /usr/local/libexec/ppf_decrypt _TMPFILE_

I highly recommend using _LEADING() instead of _BEGINNING(). Not only is it
faster, but it will prevent someone from hiding another message before their
pgp-signed message.

To sign and/or encrypt messages that you send, put the following in your
sending-filters option:

/usr/local/libexec/ppf_sign
/usr/local/libexec/ppf_encrypt _RECIPIENTS_

To sign or encrypt a file, when you choose ^X to send, you should see the
following options:

Send message (unfiltered)?
 ? Help         Y [Yes]         ^P Prev Filter  ^R Background
^C Cancel       N No            ^N Next Filter

To sign or encrypt, use the ^N or ^P options to rotate to the desired filter,
then type y (for Yes), or just hit Enter. If you regularly sign or encrypt
your mail, you might want to choose the "compose-send-offers-first-filter"
option from the Composer Preferences menu.

Other options you may find useful are:
enable-8bit-esmtp-negotiation
character-set=iso-8859-1

Be sure to read the help for those options, and test them out in your
environment before sending anything critical. Of course, iso-8859-1 is
not going to be an appropriate choice for everyone, you'll have to weigh
your alternatives.

Finally, in order to use the ppf_mime "filter" to verify messages whose pgp
signatures are attached to the message with MIME type application/pgp, you
will need to choose the enable-unix-pipe-cmd option, since there is no way to
do this task with a real filter at this time.

If you're installing these filters on a multi-user system, you might want to
make a symlink in /usr/bin or /usr/local/bin for the PREFIX/libexec/ppf_mime
script to make it easier to use. Personally, I just create a symlink in $HOME
in a directory that's in my $PATH. Once that preparation is done, to verify
the signature of a MIME encoded e-mail, choose the | (Pipe) option, then ^W
for Raw Text, then type in the filter name:

Pipe RAW message 1 to : ppf_mime
^G Help                       ^W Shown Text   ^R With Delimiter
^C Cancel      Ret Accept     ^Y Free Output

While this procedure is a little cumbersome the first time through, the good
news is that Pine will offer these choices as the defaults for subsequent
invocations of the | command during that same session. Once you've viewed
the processed message output, just type E (Exit Viewer) and you're back to the
message view you were in previously.

