-----BEGIN PGP SIGNED MESSAGE-----

PGPCLIP version 1.5
Distribution ZIP: pgpclp15.zip

Lloyd's PGP-to-Windows-Clipboard Interface

Platform: Windows 3.x Windows 95+
(tested as of this release only on Windows 95.  I
believe it will function identically under Windows
3.x/98/2000)

This Readme.txt was created May 3, 2000.



STATUS
======
Freeware by Lloyd Standish.  If you use it, I would
appreciate an email with your comments.  This would help
motivate me to upgrade PGPCLIP.  My PGP public key is in
a file called STANDISH.ASC in this distribution and can
be verified by email or on my father's webpage.



DISCLAIMER
==========
Use entirely at your own risk.  I assume absolutely no
responsibility for any consequences of the use of this
program, and make no guarantees.

If PGPCLIP makes email encryption so easy that you use
PGP when you otherwise wouldn't, and the use of
encryption is illegal in your country, don't complain to
me if you get shot by a firing squad! <g>



DISTRIBUTION
============
Freely redistributable in its original form.  The ZIP
file may be rearchived to include distribution
information, including a descriptive file.

For those that worry about malicious alteration of the
PGPCLIP package, I have included a detached signature
(pclip.asc) of the workhorse file, pclip.exe.  It
should give a "good signature from Lloyd Standish"
message when verified.

The batch files are open for your inspection, but if you
wish you can request by email a PKZIP-generated list of
CRC32's for every file in the LATEST version zip archive.
I will not be providing any kind of support for outdated
versions.  You can compare this list with the CRC32's for
the files in your copy of PGPCLIP.  You can also simply
download a new copy of PGPCLIP from my father's webpage
or Simtel.Net or its mirrors.

Full Clipper/C source code is included.  If you modify
this package, please do not redistribute it.  Send your
modifications to me for possible inclusion in the next
release.



CONTACT INFO
============
Internet:

standish@sol.racsa.co.cr

(In case the above email address is changed, you can try
instead:  lmstan@sedona.net)

http://users.sedona.net/~lmstan/Products.htm


mailing address:
Lloyd Standish
Zapotal de Nandayure
Guanacaste
Costa Rica

(Producers of Organically-Grown Cane Syrup Candies)


DESCRIPTION
===========
These are a set of batch files and a Clipper executable
to create a convenient interface between any Windows
email program or text editor, etc., and Phillip
Zimmermann's famous PGP (Pretty Good Privacy) encryption
program.

The interface is achieved by using the WINDOWS CLIPBOARD.
One COPIES or CUTS text to the Clipboard, executes the
desired command from a START menu shortcut, then PASTES
the results back into the email or text editor message.

This extremely simple system works great!  It's fast,
easy, and completely open to customization and
modification by changing or adding very simple batch
files.  In my opinion there may be no easier or more
convenient way to use PGP with all the popular Windows
email programs and text editors.

Since most people will use this to work with signed
and/or encrypted email rather than with text editors,
from now on I will refer only to its use with Windows
email programs.



LIMITATIONS
===========
1. The Windows Clipboard content cannot exceed 64K bytes.
   64K is big enough for most email messages.

2. Only ASCII characters should be present in the
   Clipboard when PGPCLIP commands are executed.
   Specifically, null characters (ASCII 0) will be taken
   to mark the end of the Clipboard.  All text following
   the first null will be lost.  Null characters are not
   allowed, to my knowledge, in email, except in a
   binary file attachment.

3. Special text attributes like boldfaced and variable
   font size are lost in the process.



REQUIREMENTS
============
1. A properly-installed copy of PGP, version 2.6.1 or
   later.  Any incompatibilities with prior or future PGP
   version syntax changes can easily be fixed by making
   simple changes to the provided batch files.

2. A basic understanding of public key encryption as
   implemented by PGP.

3. Windows 3.1 or later.  Tested on Windows 95.

4. An email program that can use the Windows Clipboard.

5. Ability to COPY, CUT, and PASTE to and from the
   Windows Clipboard.


INSTALLATION
============

You will want to be able to access the PGPCLIP commands
while you are running your Windows email program. I think
the most convenient way is to create START menu shortcuts
to each of the PGPCLIP batch files.  You could use
desktop shortcuts instead, but that would make quite a
bit of desktop clutter, and would not be as easily
accessible from email programs as the START menu is.

The following instructions assume you will install the
shortcuts into a new START menu shortcut folder.

1. Copy all the PGPCLIP files into your PGP directory.

2. Create a new START menu folder for the shortcuts to
   the PGPCLIP batch files.  One way to do this is to
   open the Windows Explorer and go to the \Windows\Start
   Menu folder.  (Hint: Right-click on START, then
   click on Explore.)  Open the subfolder in which the
   new folder will reside (probably 'Programs').  Click
   on File/New/Folder. I suggest the name "PGPCLIP" (how
   original!) for the new folder.

3. Add shortcuts to each of the PGPCLIP batch files to
   the new Windows START menu shortcut folder. Still in
   the Windows Explorer, with the new PGPCLIP shortcut
   folder highlighted, click on File/New/Shortcut.  At
   the "Command Line" prompt, you can either type in the
   exact DOS path to the PGPCLIP batch file (ex.
   C:\PGP\SCRYPTCB.BAT), or click on BROWSE to locate the
   batch file.

   When prompted for a name for the shortcut, I recommend
   you use the following descriptive names rather than
   the cryptic <g> batch file names.

   After you add each shortcut, specify that each DOS
   task 'close on exit.'  To do this, right-click on the
   shortcut, select "Properties," then the "Program" tab
   to click on the "Close on Exit" checkbox.

BATCH FILE       SUGGESTED SHORTCUT NAME

1. ADDKEYCB.BAT: Add a Public Key from the Clipboard
2. EXKEY2CB.BAT: Extract a Public Key to the Clipboard
3. CLSIGNCB.BAT: Clearsign Clipboard
4. DCRYPTCB.BAT: Check Signature of Signed Clipboard
5. DCRYPTCB.BAT: Decrypt Clipboard
6. DCRYPTRO.BAT: Decrypt Clipboard, Special View-only
7. SCRYPTCB.BAT: Encrypt and Sign Clipboard
8. SCRYPTRO.BAT: Encrypt and Sign Clipboard, View-only

<optional>

9. DCRYPT2.BAT:  Decrypt Normal/RO Check Signature
   Combines DCRYPTCB and DCRYPTRO in one command.  If you
   install this command, you do not need 4, 5, and 6
   above.

10. RECLSIGN.BAT: Refresh Clipboard's Clear Signature



GENERAL PROCEDURE FOR USE
=========================
1. From your email program, COPY or CUT (See Command
   Description below) all or part of the email to the
   Windows Clipboard (CTRL+A, CTRL+C).

2. Click on the desired PGPCLIP command in the START menu.
   The results will be in the Windows Clipboard.

3. If necessary, PASTE the Clipboard results back into
   your email message.



COMMAND DESCRIPTION
===================
1. ADDKEYCB.BAT
   Adds a new public key to your public keyring from any
   email or other text.  COPY the text that contains the
   new key(s) to the Clipboard and execute. Note that PGP
   can add multiple keys, and will ignore superfluous
   text around the key blocks.

2. EXKEY2CB.BAT
   Extracts a public key from your public keyring to the
   Clipboard.  Execute, and then PASTE the ASCII key into
   your email message.

3. CLSIGNCB.BAT
   "Clear Signs" the content of the Windows Clipboard.
   The result will be in the Clipboard.  See your PGP
   documentation for an explanation of clear signing.
   CUT to the Clipboard, execute this command from the
   START MENU, then PASTE back into the email.


4 and 5. DCRYPTCB.BAT
   Decrypts the Clipboard content or checks its signatures,
   returning the result to the Clipboard. COPY to the
   Clipboard if checking a "clear" signature (text
   already readable), otherwise CUT. Then execute.  If
   you are just checking a clear signature, you will the
   see the signature verification results in the DOS
   output screen.  Otherwise, you will want to PASTE the
   readable text now in the Clipboard back into the
   message. (The temporary file created for this
   operation is wiped before it is deleted.)

6. DCRYPTRO.BAT
   Decrypts or unsigns the Clipboard content for
   "special view-only", WITHOUT writing decrypted text to
   the Windows Clipboard.  This is faster than having to
   PASTE the decrypted plaintext from the Clipboard into
   a message to read it. However, you might find that
   text pasted into your Windows email program is nicer
   to look at.

   This option avoids any possibility that your email
   program write your decrypted text to disk, which
   probably wouldn't happen with #4 anyway unless you are
   short on memory, or choose "Save Changes" when you
   exit your email program.

   This view-only option is "special" because, instead of
   using PGP's -m (MORE) switch to display the text, this
   command displays the decrypted message using the
   excellent LESS utility (ported to DOS-WINDOWS from
   Unix).  Unlike PGP's internal MORE, LESS allows you to
   scroll the text in EITHER DIRECTION.  See the file
   LESS.HLP for a summary of LESS's text editing options.

   I have examined LESS's source code and believe that no
   temporary storage files are used that could leave
   remnants of your decrypted message on the hard drive.
   However, if the use of LESS gives you fits of paranoid
   anxiety, follow the instructions in DCRYPTRO.BAT to
   modify it to use PGP's inconvenient one-way MORE
   output instead.

7. SCRYPTCB.BAT
   Encrypts and Signs Clipboard. CUT or COPY to the
   Clipboard. Execute. PASTE back to the same or a
   new email message.

   If you use your email program's text editor to
   compose messages and you want to keep a readable copy
   of the message on your computer, I suggest you store
   your "plaintext" messages in a special email folder.
   You wouldn't SEND any of those plaintext messages.
   When ready to encrypt/sign/send a message, COPY it to
   the Clipboard, run the appropriate PGPCLIP command,
   then PASTE it into a NEW email message, and SEND
   that.

   If you DON'T want to leave a readable copy of a
   message on your computer, and still want to be able to
   decrypt and read the messages you send, include
   yourself as one of the message recipients.

8. SCRYPTRO.BAT
   Same as SCRYPTCB, except that when the receiver
   decrypts the message, it will be for view-only, with
   no writing to disk.  PGP's internal MORE (forward-only
   reader) will be used by the decrypting PGP, which is
   less convenient than LESS.EXE, the reader used by
   PGPCLIP's DCRYPTRO.BAT, since LESS.EXE allows
   forward-backward scrolling.

   In general, use this option when you cannot trust the
   receiver to be careful not to leave copies of the
   decrypted text (plaintext) on a computer that might be
   used by someone else.  WARNING: This will NOT prevent
   a knowledgeable, determined recipient from making a
   plaintext disk copy if he really wants it.  This PGP
   feature is provided to prevent accidents.  Consult
   your PGP docs.

   For responsible receivers using PGPCLIP, it is better
   to use the regular SCRYPTCB.BAT command, to
   encrypt/sign, since it allows the user to either
   decrypt to the Clipboard (DCRYPTCB.BAT) or decrypt
   read-only (DCRYPTRO.BAT) to read using the convenient
   LESS.EXE.  (see DCRYPTRO.BAT)


<Optional>

9. DCRYPT2.BAT
   Combines functionality of DCRYPTCB and DCRYPTRO in one
   command, but you have to answer a query. For those who
   usually use SCRYPTRO and seldom need SCRYPTCB.

10. RECLSIGN.BAT
   Recalculates a new clear signature for an
   already-clearsigned Clipboard.  Suppose you wrote a
   message and clearsigned it for sending.  But then
   you notice something you want to change.  But any
   change will botch the signature!  No problem.  Just
   make your changes, CUT the entire message with
   signature included to the Clipboard, run this option,
   and PASTE the Clipboard back to the message.  This
   will take off the old signature and put on a new one.
   It simply runs DCRYPTCB.BAT followed immediately by
   CLSIGNCB.BAT.



SOURCE
======
Take a look at the batch files to see how you can
customize the commands, and make new commands.
Remember that the PGPCLIP commands cannot handle putting
non-ascii (binary) characters into the Clipboard (and
neither probably can your email program.)  Therefore you
will want to always instruct PGP to create ASCII
output.  Consult your PGP docs.

The core of PGPCLIP is a Clipper executable: Clipb.exe,
source code included.

Syntax:

CLIPB(<cFilename> <cMode> [cWipeOnly])

cMode=  "READ" or "R": Reads the Clipboard into cFilename

cMode= "WRITE" or "W": Writes the cFilename content to Clipboard,
       and then wipes and deletes cFilename.  If cWipeonly
       is sent, the Clipboard is not written, but the
       file is still wiped and deleted.



TO DO
=====
This Clipper program could have better been a compact C
language program.  Unfortunately I couldn't recompile the
C source code because my Borland Turbo C++ 3 compiler
choked on the inline assembler format.

If you want to help replace the Clipper executable with
a compact C executable, please modify the included C
source to be C-callable (it is currently only callable
from Clipper), and rewrite the trivial CLIPB.PRG in C.
Send me a copy, and I will add it to the next release.
Alternatively, you might just write to me explaining how
to adapt the inline assembler to allow compiling by
Borland TC.

I would also like to provide a Windows installation file
that would create the START menu shortcut folder and the
shortcuts.  If anyone would like to write this and send
it to me for inclusion in PGPCLIP, I would be grateful.



CHANGE HISTORY
==============
Version 1.5 May 3, 2000
1. Corrected the position of the 'pause' command in the 2
   encryption batch files (scryptcb.bat and scryptro.bat)
   to allow one to view the PGP output before the DOS
   window closes.  This allows the user to verify that
   the correct recipient's public key was used for
   encryption (important).

2. Streamlined batch files, and fixed error and run
   messages from batch files and clipb.exe.

3. Added clear signature to this readme.txt.

Version 1.4 April 30, 2000
Removed embedded ZIP file (with detached signature file)
from the distribution ZIP file, to comply with Simtel.Net
(major FTP site) policy.  Fixed batch files to correctly
pause to display error messages.

Version 1.3 April 29, 2000
Corrected errors in readme.txt.  Rewrote the
INSTALLATION section to avoid confusion. (No functional
changes.)

Version 1.2 April 26, 2000
Replaced Clp2file.exe and File2clp.exe with a single
executable with a mode switch, further reducing the ZIP
file size.

Version 1.1 April 25, 2000
Replaced protected-mode FILE2CLP.EXE with a smaller
real-mode version.

Version 1.0  April 17, 2000
First release


<eof>


-----BEGIN PGP SIGNATURE-----
Version: 2.6.3ia
Charset: cp850

iQCVAwUBORC85wHzAAhjWwaZAQE+agQAlniRu8G+heDSptmsmJ6MaXD9GNU2yAyC
R0SHXSmltayR9Jo2BgwQYzhEwpkQYSlfO5Yf36KPx1kWh/vCzdm+kULntp5fvwwP
uD1eZMzEr+qE4NMLdUmMNxoDVy349sRs2YAc94h+K9YC7S0MqO9zG4gf90pcrPGy
nPHenEKRwrs=
=McDz
-----END PGP SIGNATURE-----
