Translated manuals
Peics/Empics Light 1.23 manual
- Introduction
- System requirements
- Installation
- How to start
- Using the program
- Settings dialog box (PEICS.INI configuration file)
- Miscellaneous
1. Introduction
Peics is a PGP-shell that runs as an EMSAPI plug-in extension to Eudora 3.0.
Empics is a program that attaches to previous Eudora versions. This
manual describes them both, because they are very similar. So please read
"Empics" instead of "Peics" if you are using that version.
PGP (Pretty Good Privacy, written by Philip Zimmermann)
is a DOS-program and a very good public key encryption of text files.
Eudora from QUALCOMM is a very popular mailprogram for MS-Windows.
Peics is just an interface between these programs. It does not replace
either of them.
Without a PGP-shell it's cumbersome to reply to coded mail. You have to save
the received mail in a file; go to DOS; PGP-decode it; return to Windows
if you prefer a Windows editor; type an answer; go back to DOS;
PGP-code the file; and then return to Windows, paste the encrypted message
in Eudora and send the file. With Peics you can run PGP from Eudora's menu
or by pushing a button on Eudora's toolbar.
Peics finds out what to do. First it copies the data in the current window
to a textfile on disk. Then it starts PGP.EXE in a DOS-box and specifies the right
command-line to decode or encrypt the text.
The decoded text is returned in the current window if possible.
Otherwise you can paste it into an editor of your choice. The encrypted text is
always put in the current window.
Peics Pro is not freeware nor shareware. You will need a
license from Comerwell Software
to use it. Peics Light is freeware for private non-business use and shareware
for commercial use, so if you use it at work you should buy a license. Then
you can also use Peics Pro, instead.
You do not have to read the entire manual. I'm sorry for writing so much.
Read at least sections 2, 3, 4 and the start of section 5. Then run the
program, see if and how it works. Then run the program and see if and how it works.
If you can't figure something out, read the appropriate section and try again.
2. System requirements
The unzipped package uses around 300 kByte disk space (both programs and manual).
The program is about 120 kByte and uses almost no extra memory. You do not
need any VBX-control libraries or additional DLL.
Do not expect, that it will always work with beta versions of Eudora.
Peics(16)
You need a 80286 computer (or better) and MS-Windows 3.1 or Windows95.
I do not think this version runs on OS/2 Windows.
It seems that Peics does not get a notification message that PGP
has terminated. I will try to find out exactly what fails but
I do not have OS/2 -- which complicates things.
For Peics you will need Eudora(16) 3.0 or later, for Empics(16) please use
Eudora(16) 1.5.2, 1.5.4, 2.1.2 or 2.2.
It does not run with 32-bit versions of Eudora.
Peics(32)
You need a 80386 computer (or better) and Windows95 or NT and
Eudora(32) 3.0 or later. For Empics(32) you need Eudora(32) 1.5.4 or 2.2.
The 32 bit version does not work with Eudora (16).
Although it should also work with the 16 bit PGP
you may want to try pgp 2.6.3i compiled for win32, available from
the International PGP homepage
for everyone outside the USA or Canada.
Return to top
3. Installation
Unzip the ZIP-file with PKZIP version 2.04g (or later). In this ZIP-file
you will find another ZIP-file (PEICS.ZIP) and a signature (SIG) file.
Unzip PEICS.ZIP and copy the program Peics(16) (= PEICS16.DLL) or
Peics(32) (= PEICS32.DLL) and PEICSLT.LIC to Eudora's PLUGINS directory.
PEICSLT.LIC will be shown when you run the program for the first time.
If you don't like to have those files in the plugins directory, you can also
create a subdirectory PEICS under PLUGINS. Peics searches them there if the
directory exists. The main PEICS??.DLL must be in PLUGINS, because Eudora must load it.
Peics reads module information from Eudora, which will be saved in
the [ModuleDefinition] section in PEICS.INI.
Peics knows about specific Eudora versions. If you use another,
you'll see a dialog box from which you can choose a module definition.
If everything worked fine, you can save the module definition for later use.
This information is saved in the [SelectedModDefinition] section in PEICS.INI.
This version can load a language module. A German module will soon be
on the language
support page. The file must be named "pl16?*.dll" (16-bit) or "pl32?*.dll"
(32-bit). The "?*" is a language identifier, so the 32-bit German version will be
"pl32de.dll". The first file that matches this name will be loaded from the PLUGINS
directory (or the PEICS directory if that one exists). You can also set the name
in PEICS.INI.
Peics will use the internal English data if the file cannot be found.
If Eudora is currently running, the new addition of this software will
not show up. Close Eudora and re-launch.
Empics Installation differences
Eudora versions under 3 do not load Plug-in DLL's, so Empics must load itself.
This implies a different installation procedure.
- Copy the files
-
The program Empics(16) is EMPICS16.EXE and Empics(32) is both EMPICS32.EXE
and MP32.DLL. You can copy the program where you like, but it's maybe a
good idea to make a PEICS directory under the EUDORA directory and copy
all files there. The files PEICS.INI and PEICSLT.LIC are the same for
both Empics and Peics, so they have PEICS in the name (so please do not
read "EMPICS" here :-).
- Adding Empics icon
-
Open Eudora's program group. Choose "File | New..." in Windows
program manager, select "OK", choose "Browse" and
select the Eudora directory. Select the program file (EMPICS16.EXE or
EMPICS32.EXE).
- The first run of Empics
-
Now you should first launch Eudora. Then click the just created icon to
start Empics. It should find Eudora. If it does not find a known version,
you will see the module dialog box as described above under Peics Installation.
When you exit Eudora (and Empics), the complete pathname of the module
(EUDORA.EXE) is saved, so that it can be started automatically. Next time
you can run Empics and it will load Eudora.
PGP Configuration
If you have installed PGP correctly, the plug-in
should work now. Check that you have the environment variable
PGPPATH set to the PGP-directory. Peics(16) searches in this directory
for PGP.PIF or PGP.EXE. Peics (32) only searches for PGP.EXE.
If it does not find any, it searches the DOS PATH. If it still
cannot find anything, you will get the "Peics settings..."
dialog box, where you can set the correct path to the
PGP.EXE (or PGP.PIF) file.
If you choose [Cancel] the search fails and the program stops.
In Windows 3.x
On a 80386 PC (or better) you can edit/create PGP.PIF to run in a DOS-Window
[instead of full screen textmode]. As well, you can choose to keep the
DOS-box open after PGP has terminated.
Then you can see the results of PGP. There's a PGP.PIF file
included in this distribution. I do not promise
that it works, but it might be a good starting point for creating your own.
In Windows 95
Windows 95 does not have a PIF-editor anymore [although PIF-files are still
supported], but you can set the options for the file PGP.EXE instead.
In "My computer" click on the pgp icon; choose "File | Properties" from the
menu; choose "Program" and un-check "Close on exit". For the 32-bit
international PGP program, you cannot set this. Instead you can tell Peics
to keep the window open. This is a good alternative
which also works for PGP (16).
Temporary files
Both Peics and PGP need to create temporary files, which may contain the
texts being encrypted. A parameter in PGP's configuration file tells them
where those files should go to.
Peics first reads PGP's configuration file (CONFIG.TXT or PGP.INI) from
the directory specified by the PGPPATH environmental variable.
If it finds a TMP= entry, it will use that directory, otherwise it uses
the directory specified by the TMP environmental variable.
This is exactly how PGP does this.
See section "Setting Parameters in the PGP Configuration File"
in PGPDOC2.TXT (PGP's documentation).
It's recommended to set the TMP parameter in PGP's CONFIG.TXT or PGP.INI
to a RAM-drive, because this will guarantee that there are no stale
(chunks of) files left on the disk when the system or the program hangs.
If the directory for temporary files has not been found, yet, then Peics
tries the TEMP environmental variable and the PGPtempdir
parameter in PEICS.INI.
If the files exist on start-up, you will be prompted if they can be overwritten.
If you choose "Cancel" the program terminates without overwriting them.
More users
If you use Eudora with more users (and more pop-accounts), you may have
specified a command-line for Eudora in Program Managers "File | Properties".
Then each user can have his own start-up icon and his own mail directory.
Eudora passes the mail-directory+PLUGINS as the configuration directory
to Peics. So if C:\MAIL\BILL is your mail directory, C:\MAIL\BILL\PLUGINS is
passed to Peics, but Peics will also search in the mail directory
(e.g.: "C:\MAIL\BILL"). So each user can have his own configuration PEICS.INI
in his mail directory. (See section 6. PEICS.INI)
The license file PEICSLT.LIC will be searched in this configuration directory
and in the PLUGINS directory under the Eudora directory. If you have a
license for more users, then you'd better store the file under the Eudora
directory. If you have a license for yourself put it in your own configuration
directory. Peics shows where it searched the file if it cannot be found.
If it finds a file, it does not search for other PEICSLT.LIC files.
- More users, Empics differences
-
Empics passes its command-line to Eudora, so copy the command-line setting
from Eudora's start-up icon, if you want to have the same configuration,
when running Empics. Empics reads the 'local' (user) configuration from
the directory specified on the command-line , like Peics. The PLUGINS
directory does not exist in previous Eudora versions, so Empics does not
search there.
4. How to start
Start Eudora. It will load Peics, if the DLL is in
the PLUGINS directory. [If Eudora is currently running, the new
addition of this software will not show up. Close Eudora and re-launch.]
- Empics differences
-
If Eudora is already running, then Empics will attach, otherwise it will
first launch Eudora. You can also unload Empics from Eudora by choosing
the "File | Exit PGP extension..." menu item.
Return to top
5. Using the program
This program is not a complete PGP-shell. If you need special features use
another PGP-shell or go to the DOS-commandline. This program is intended for
the common tasks. It can encrypt and decode mail, sign and check a signed
message and add a
public key to the public keyring. The program finds out what
to do. This EMSAPI program offers 2 different ways to run PGP:
- The EMSAPI interface from the "Edit | Message plugins >" menu.
- The window interface from the "Run PGP..." or the button on the
right side of the toolbar.
Note: Early Eudora versions did not have the EMSAPI, so you cannot use
method 1, unless you have Eudora 3 or later.
Every time you use PGP you will have to follow these instructions:
- Open the window where your text is.
- Run PGP in one of the ways shown before.
The plug-in shows a dialog box with what it expects it should do.
It shows a part of the text to encrypt/decrypt. If it is the text from
another window, you will recognize it here.
Choose [OK] if you agree to run PGP.
- When PGP has finished, close the DOS-window or type EXIT in DOS.
You should read PGP's results from the DOS-window, so you'd better
keep it open.
- After closing the DOS-box you see the changed text or a dialog box
that tells what happened. If PGP returned an error code it will be shown
here, but not in plain text. Usually this does not happen. If it does,
PGP has already written an error message on screen.
Some definitions:
An "output window" is a window that has a "To:" field
and is created with a "New", "Reply", or "Forward" menu-selection. In this window
you can edit text.
An "input window" is a window with only text. It is created for incoming
messages and can not be edited. In Eudora 3.0 you can
turn of this read-only mode though.
The next sections assume that you are at section 2 of the description
above.
If Peics found a PGP MESSAGE BEGIN/END block, it will
show a "Decode" dialog box.
This will decode the text from the BEGIN/END block.
Peics copies the text to the window where it came from. If this is an
an input window you can only read
the text. Everything else you try to do (forward, reply, save),
will be done on the original encrypted text.
As well as reading and scrolling you can copy a selection to the clipboard
(Edit|Select All and Edit|Copy).
If you have sent an encrypted message from an output window you can later decode
it, provided that you have also encrypted for yourself. But Eudora marks this
output window
as read-only, so you can only read the (decoded) text,
as in the input window.
If you have set the INI-setting CopyToReadOnly = 0, then Peics shows a
dialog box that lets you choose where you want your decoded text to go.
It can copy the text to the
clipboard (the default, [Yes]) or ([No])
to the textwindow, where it came from. If you chose to copy the text
to the clipboard, you can paste your decoded text from the clipboard into
an editor of your choice.
Incoming text attachments can be passed to PGP for decoding. I added this because some
other mailer extensions put the encrypted text in an attachment. Moreover some
keymailers send keys as attachment. The converted text will be put in the text
in place of the "Attachment Converted: FILENAME" text. This enables
you to decode more than one attachment in a message. Simply "run PGP" on them again.
The program reads the attached file and scans for a "-----PGP BEGIN" to see
what it should do with the file. Then it does exactly what it normally does
with a text in the window. It copies the text to a file (PEICS.ASC);
passes that to PGP and inserts the result in the original text. If there's
no PGP MESSAGE, KEY or SIGNATURE block in the file, then Peics just
ignores the attachment. Attachment decoding can be turned off in the
"Peics settings..." dialog box.
Now please do not start mailing me, saying that you cannot encrypt attachments
that you make. I shall add this some time in the future, but I do not know
when.
Key in decoded text
After decoding Peics scans the decoded text for a key.
If it found one you will be prompted if you like to add it to your
public keyring. See section 5c. Adding a new key.
There's an easier way to decode if you want to reply to an encrypted
message. See section 5d. Reply to coded mail.
If Peics finds no coded or signed text in an output window
, it shows an Encrypt-dialog box with the previously typed text
and the recipient name from the "To:"-field. You can change this name,
if the keyname is different. It's very convenient to have the e-mail address
in the public key. PGP uses this name to find the key of the recipient.
Peics extracts the e-mail address from the text in the "To:" field, if it finds
an '@' sign.
Here you can add options, if you need. Put them in the editbox before the
recipients name (e.g.: -s hans will sign the message encrypted for "hans".).
If you set "AlwaysSign" in PEICS.INI every
message that must be encrypted will be signed.
The default PGP-options are "-aetw".
The program reads the "Cc:" (Carbon copy) field from the message
window and adds those names to the "Encrypt for" field in the "Run PGP..."
dialog box. If you have checked the "Encrypt for self" option in
PEICS.INI, then the name of the sender (you:-) will
also be added to this list. This makes it easy to encrypt every message
for your self (so that you can at least read all mail encrypted by you ;-).
If you delete the recipients' name or if there was none in the "To:"-field,
you will see the "ClearSign" header.
(See section 5e. Clearsign a message).
If you keep the [Shift] key down while starting the dialog box, then the
nicknames in the "To:"- and "CC:"-fields will be expanded.
These Peics Settings affect encrypting: "AlwaysSign",
"Encrypt for self", "EncryptFor"
and "Nicknames".
Note: Peics Pro offers a more complete dialog box with checkboxes for most options
and a list box for the keys.
If there's a "PGP PUBLIC KEY BEGIN/END" block in the text, you can add it to the
public keyring. Peics will pass the complete message to PGP.
After running PGP there's nothing to do for Peics.
PGP has showed already what it did.
Peics can also add the key from Eudora Pro's finger window.
Use the EMSAPI interface to start the Peics dialog box. The window interface
cannot find the finger window, so Empics cannot do this.
This is a very common usage, so I made it as easy as possible.
Part of this is very similar to what is covered
in section 5a. Decoding.
- Select "Message | Reply" (or push the Reply button) for a received
encrypted mail.
- Select "Message | Run PGP..." (or push the key button).
This will decode the mail after removing the '>'-signs.
(See section 5a. Decoding).
- Back in Eudora you have the decoded text with the '>'-signs inserted.
- Now you can type your reply. When you are finished you can encrypt again.
(See section 5b. Encrypting).
5e. Clearsign a message
If Peics cannot find an encrypted or signed message in an
output window and you do not have a name in the "To:"-field, then
it will clearsign your message. (PGP-parameters: -sta +clearsig=on)
Clearing the "Encrypt for" field in Peics's dialog box will also turn
on clearsigning. If you had already a name in the "To:"-field, this is
easier.
In the "Sign from" parameter in the
"Peics settings..."
dialog box you can specify which secret key must be used for signing.
Note 1: Before running PGP, Peics sends two menucommands to the message window:
"Edit | Select All" and "Edit | Wrap Selection".
This will insert carriage returns in the text. If this is not done now,
Eudora will insert them just before sending the message and the signature
will fail because the text has changed.
Note 2: This is done on every message in an output window
.
If Peics found a SIGNATURE BEGIN/END block it will pass this
block to PGP and insert the text that PGP returns. This makes it
possible to check more signatures in one message.
After the first text has been checked it is returned in the message
but without the SIGNATURE BEGIN/END BLOCK. The next time you run PGP
the next message will be checked and so on.
You must check the signature on PGP's output. Peics does not show
anything.
5g. The "Edit | Undo"-function
If you have PGP'd and notice you have made an error, do not worry.
The "Edit | Undo" menu selection restores the window text
that appeared before PGP was started.
As soon as you change anything in the text, you cannot undo the PGP action
anymore, because the Undo function will undo the last change, as usual in Eudora.
Note that "Edit | Undo" is disabled when you are not in the
part of the window, where the text is. So if the cursor is in the subject-field,
first move to the text and then choose Undo.
You cannot undo an Add-key action.
5h. The Skip button
You will see a "skip" button in the dialog box, when Peics found an encrypted
or signed text (5a, 5f). If you push it, Peics will move to
the next PGP BEGIN/END block or to the next attached file. If it cannot
find more of these, it will show a "Nothing to do" message.
Return to top
You do not have to read this chapter unless you have special wishes. The
default settings work fine for 80 % of the users, but the remaining 20%
may wish to change Peics's configuration to suit their preferences.
To change or review the configuration select the menu "Special | Message Plugins Settings..."
and choose "Peics PGP-Eudora interface" from the plug-ins list.
Peics first reads the INI-file from the Windows directory,
then from the Eudora directory and then from the directory, that's
passed by Eudora. This is a usually a "Plugins" directory
below the Eudora directory or below the mail directory, specified
as command-line parameter for Eudora.
The latter is usually used to give each user his own configuration.
Every time it reads an INI-file, it overrides the previous settings. This
makes it easy to create a system-wide configuration and a user-specific
configuration. I've included an INI-file
with the default settings. If you agree with them you
do not need the file because the program sets them internally
before reading the first INI-file. You can check the settings
in the Settings dialog box or by keeping the [CAPSLOCK] key down,
while Peics is being loaded.
Here are the options that are currently supported (with their defaults):
- [Settings]
- In this section you can specify settings for Peics and its interface
to Eudora. They are in the upper left group box "Peics settings" in the
dialog box.
- ChgToTempDir = 0
(Change dir to temp)
- By default Peics specifies a full path to the file, that is to be
handled by PGP. If you use the long "C:\WINDOWS\TEMP" name as your
directory for temporary files (tempdir), then you may soon run out of
command-line space.
If you check this option, then Peics will make the tempdir the current
directory, so it only has to pass PEICS.ASC, instead of
"C:\WINDOWS\TEMP\PEICS.ASC". If you do this, then check that PGP.EXE does not
have its working directory specified to another directory, because then
windows will change to that directory and PGP will not be able to find the
file, that Peics made. You can check this in PGP.PIF (Win3.1) or in
"File | Properties" for PGP.EXE in "My Computer".
- UseToolbar = 1
(Not in the dialog box)
-
A click on the button on the right side of the toolbar
should start the "Run PGP..." dialog. You can disable this feature by
setting the value in PEICS.INI to 0. If you set it to -1, then the
Window interface is not used at all. You can still use the EMSAPI
interface, though. This can be handy for testing.
- CopyToReadOnly = 1
(Not in the dialog box)
- Normally (if set to 1), Peics will copy the decrypted text to
a read-only window. If cleared (= 0), you are prompted were you want
the text to go to (Clipboard or window), like in previous versions.
Note that you can still "Select All" and "Copy" the text window to the
clipboard. All operations that Eudora does (forward, save,..) are done on
the original text.
- AnsiOem = 0
(AnsiOem conversion)
- If you turn this on, then Peics will do an AnsiToOem conversion before
creating the file for PGP. After PGP has run it does an OemToAnsi conversion.
You may need this if you use special characters as in French, German, etc.
Windows uses the Ansi character set, while DOS uses the Oem definition, so
if you exchange mail with someone who does not use Windows (they exist!)
and if you use those special characters, then you can try to turn on this
option. Then PGP will maybe not complain about failing signatures and you can
better read PGP's output. If you do not understand, what this is all about,
leave it set to = 0.
- ConvertAttach = 1
(Convert incoming attachments)
- Decoding of incoming attachments can be disabled by
un-checking this option.
- NickNames = 0
(Expand nicknames)
- Normally Peics does only do a NickName expansion if you keep the
shift key down while starting the "Run PGP" dialog box. If you set NickNames
(=1), then nicknames will always be converted.
- LangMod =
(Not in the dialog box)
-
Here you can specify the full pathname of a language module DLL.
(See Installation.)
Return to top
- [PGP Settings]
- In this section you can specify settings for Pgp and its interface
to Peics. These are in the group box "PGP settings" in the dialog box.
- ProgPGP =
(PGP program)
- Here you can specify a program that should be run instead of PGP.EXE or PGP.PIF.
It will be searched in the same directories as PGP.
In the dialog box you can push the "Browse" button to find the file.
If you have Viacrypt's PGP, you can set its filename (optionally with path) here.
(And do not forget to pay me if you use Peics commercially ;-).
- PGPtempdir =
(PGP temp. dir)
- You can set PGPtempdir to the directory where you want Peics to create
and read the files that PGP will process. This overrides the value set in the
environment variables TMP and TEMP. Normally it's better to change the
TMP parameter in PGP's configuration file, because then PGP will use the
same directory for its temporary files.
- PGPPATH =
(Not in dialog box)
- Here you can specify the directory where the PGP files (e.g.: PUBRING.PGP)
are. This overrides the environmental variable PGPPATH. Peics(32) also sets
this value in the environment for PGP, so PGP will automatically use the
same directory. This makes multi-user PGP configurations possible.
- EncryptForSelf = 1
(Encrypt for self)
- If you check this option, then Peics adds the name of the sender to the
"Encrypt for"-field when it has to encrypt a message. This is good if you
want to be able to read what you have encrypted.
- EncryptFor =
(Encrypt for)
- Normally Peics extracts the e-mail address of the sender from the "From:"
field in the dialog box. This option overrides this, so the name you type
here is used instead. The name is used for "Encrypt for self" and "Sign from"
actions.
- KeepOpen = -1
(Console (textmode) window for PGP)
- The 32-bit version has a KeepOpen option. It affects the behaviour
of the consolewindow in which PGP runs. It was necessary because I couldn't
set this property for the 32-bit PGP.
These 3 radiobuttons you will see in the dialog box:
-1 ; handled by Windows
0 ; created by Peics; close yourself
1 ; created by Peics; close automatically
when: 1) there are no errors
2) PGP has to encrypt or sign
The values (-1, 0, 1) are used in the INI-file.
If you choose 0 or 1, you have to close the window by clicking on the console
window or by pressing a key. The closebutton does not work in these cases.
KeepOpen does not work if you use a PGP.PIF file.
If you set KeepOpen >= 0, then PEICS does not search for a PGP.PIF file unless
you specify it explicitly in PEIC.INI.
Return to top
- [PGPflags]
- In this section you can specify default flags for Pgp.
These options are in the "PGP flags" group box in the upper right corner of the
dialog box.
- AlwaysSign = 0
(Always sign)
- If you check this option (1), then Peics will sign every
message, that must be encrypted, with the first key on your secret keyring.
- SignFrom = 0
(Sign from)
- If you check this option, Peics will add a "-u userID" to the command-line
for PGP. This tells PGP to use "userID" to find the secret key for signing.
You will only need this if you have more than one secret key on your keyring.
- [ModuleDefinition]
-
This section describes the loaded mailer module, that Peics found.
The "FullModName" entry is used by Empics to start the program.
- [SelectedModDefinition]
-
This section describes the module information, that Peics knows about.
It is selected from the list when the loaded module does not exactly match
any of the known modules. It has the same keys as the [ModuleDefinition] section.
Return to top
The version number of Peics increases by 0.01 on minor changes.
Versions with new features get the next 0.x0 number. In this case the manual
will be updated too. The time stamp always has the version number.
1:23 means version 1.23.
Peics(32) is compiled for i486 and runs on both 80386 and 80486
(and better) processors. Peics(16) runs on a 80286 based computer too.
Choose "Help | About Peics..." to get the
"About Peics" dialog box. Here you can see which version you have
(and who made this program ;-). It also shows your license information.
In the file PeicsPro???.ZIP (??? = version number) you should find
another ZIP-file and a signature:
Length Size Ratio Date Time Name
------ ----- ----- ---- ---- --------
139582 139582 0% 21-04-97 01:23 PEICS.ZIP
152 152 0% 21-04-97 01:23 PEICS.SIG
------ ------ --- -------
139734 139734 0% 2
In the file PEICS.ZIP you should find these files:
Length Size Ratio Date Time Name
------ ----- ----- ---- ---- --------
138256 58464 58% 21-04-97 01:23 PEICS16.DLL Peics(16)
120864 59742 51% 21-04-97 01:23 PEICS32.DLL Peics(32)
48201 17334 65% 26-04-97 01:23 MANUAL.HTM This manual
3870 2038 48% 19-04-97 01:23 PEICSLT.LIC License file
5887 2472 59% 24-02-97 01:23 PEICS.INI Configuration
545 161 71% 24-02-97 01:23 PGP.PIF PIF file for win3.1
2562 1158 55% 26-04-97 01:23 REGISTER.DOC Registration info
591 362 39% 26-04-97 01:23 REGISTER.TXT Registration form
------ ------ --- -------
314007 138986 56% 8
These 3 files are in the Empics distribution instead of the Peics DLLs:
131088 53772 59% 26-04-97 01:23 EMPICS16.EXE Empics(16)
26144 12412 53% 25-04-97 01:23 EMPICS32.EXE Empics(32) EXE
116768 57512 51% 26-04-97 01:23 MP32.DLL Empics(32) DLL
Empics(32) consists of 2 parts: an EXE-file (EMPICS32.EXE) and a DLL
(MP32.DLL). This is the only way to do window subclassing between
different processes in Win95.
EMPICS32.EXE maps its DLL in Eudora's address space and the DLL does the
actual interfacing. Direct interfacing between programs is not allowed.
The file sizes and dates in the actual ZIP-file may be a bit different,
because I do not update this manual on every program update.
You can use the file PEICS.SIG to check if you have the original files.
You need my public key (for pgpeudra@comerwell.xs4all.nl)
for this.
You can get it:
- From the keyservers
- From Comerwell's homepage
- By "Finger comerwel@xs4all.nl", but (AFAIK) Eudora Light cannot do this.
Eudora Pro can and Peics can add the key from Eudora's window to the keyring.
Use the EMSAPI interface to start the Peics dialog box. The window interface
cannot find the finger window.
- By mail from
comerwel@xs4all.nl. There's just a
"vacation" mailer, that sends a short information file with my key. Please type
subject "key", because I hope to make a real keymailer once again. Your message
will be ignored :-(, so you'd better not type any.
Receiving the key by finger (Eudora Pro) or by mail is the easiest,
if you have already installed Peics, because Peics can
add the key to your public keyring.
To check the signature type at the DOS-commandline:
pgp peics.sig peics.zip
and PGP will show if the file has been changed. Of course this is no
guarantee for the correctness of the program. It only shows that it's not
corrupted. This is a good virusprotection too.
Every registered user (who wants this :-) will get an e-mail when I made
a new version.
You can regularly check the
announce
page to see if there are new versions announced.
Of course I shall post in the new
comp.security.pgp.announce
newsgroup, when I have a new version.
This part will may be outdated soon, but you can use it as a starting point.
If you need information about PGP or about other shells, you may find these
links useful:
The PGP-newsgroups:
7d. A brief history
For those interested, here's a brief history. Others read
"Copyrights, licence & disclaimer". I first thought about
writing this program when I saw someone struggling with both Eudora and PGP
in spring '95. I looked for some PGP-shells, but couldn't find anything
really convenient. It should be easier. The friend who worked with both
programs learned to handle them and did not really need it anymore.
- 17th november 1995:
-
At 11 p.m. I decided to write the program. Now another
friend had some real problems with this situation and worse, I got binhex-
encoded files that were hard to decode on my Linux system. Of course this
could be solved in any way, but now I thought it would be better to make
life easier.
- Version 0.12:
-
6th December: This was the first publicly available version after some
testversions for friends only. It has just the basic features like
encoding, decoding and adding a key. No special PGP-features like
signing messages.
- Version 0.13:
-
The previous version did not run with Eudora light 1.52, so I
had to work again. Bad news for me, that QUALCOMM changed a lot.
All windows' classnames have changed.
- Version 0.15:
-
The "Edit | Undo"-function works with Eudora Light, too. And I added an extra check
on the window where the text should go to after PGP has run. Someone reported
that he got this text the wrong window.
- Version 0.20:
-
+Clearsign text and check signatures
+Pass command-line options to Eudora
+Scan for key after decoding
+Choose where to copy decoded text (clipboard or window)
- Version 0.26:
-
+Some bugfixes
+Better error reporting
- Version 1.00:
-
+32-bit version
+button on toolbar
+handling of incoming attachments
+INI-file with some new options
7e. Copyrights, licence & disclaimer
This is probably the most boring part of every manual, but it has to be, so
here we go. Note that you should (still) read Empics instead of Peics,
if you are using that program.
LEGAL ISSUES
============
In plain English:
- I do not promise that this software works. (But if you find any bugs,
please let me know!)
- If you are using this software for your personal non-commercial needs,
you do not have to pay me and you can use it as freeware. If you want to use
it in a company, educational or government institution, consider it shareware.
- If you like to sell this program on its own or together with something
else, please contact me, because I like money too ;-). Besides I think it is
a bad idea to sell it, because everyone who can use this program has e-mail
and can get it for free.
- You may not pretend that you wrote this software.
In legalese:
The author makes NO WARRANTY or representation, either express or implied,
with respect to this software, its quality, accuracy, merchantability, or
fitness for a particular purpose. This software is provided "AS IS", and you,
its user, assume the entire risk as to its quality and accuracy.
Peics is copyright © 1995, 1996, 1997 Hans Bausewein, Hengelo, Nederland
All Rights Reserved except as specified below.
Permission is hereby granted to use, copy and distribute this program
for non-commercial use, without fee, subject to these conditions:
- Distribute only the complete ZIP-file as stated in
"7b. Files in this distribution"
with this file "MANUAL.HTM" included, and this copyright and
no-warranty notice unaltered. The signature must remain valid.
If you add files, add them to PEICS118.ZIP, not
to PEICS.ZIP (because that would invalidate the signature PEICS.SIG).
- Permission for use of this software is granted only if the user accepts
full responsibility for any undesirable consequences; the author accepts
NO LIABILITY for damages of any kind.
- The copyright notes in this document or in the programs "About PEICS"
dialog box are NOT changed, removed, hidden or made invisible in
any way.
NO WARRANTY
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
I do not sell the program. You can get it from the internet, yourself. This
means, you can easily get the latest version. For me it saves a lot of time
and administrative work. I like programming much more.
Instead I sell a license to use the program. This no-nonsense license offers
you:
- Free updates/upgrades of every PGP-Eudora interface I publicly release
within 1 year from the date of purchase of the license. If I change my
distribution policy, you are sure you will get them without having to pay
again. I do not guarantee, that I make those programs
(although it's more probable, if I get paid well :-).
I wrote "publicly release", because I'd like to have the option
to make specialized software (e.g. for companies), that I cannot publish.
Features for common use will be released publicly.
- Licenses can be used for both Empics and Peics. As noted in 1, you only
have to pay me once.
- Permission to use those programs subject to the conditions in
7e.
- Permission to make as many copies as you like, provided that the number
of running copies of the program do not exceed the number stated in the
license.
- Registration on a mailinglist, that I maintain at my own Linux system.
I cannot guarantee continuation of this mailinglist, but I shall try.
Please go to the
registration
page for up-to-date information. If you intend to purchase the
license, register yourself. If you use Eudora 2.2 or later, you
can fill out a registration form in a dialog box, accessible from the
"Register" button in the "About Peics..." dialog box.
You will get an automatic reply within a few days and temporary
try-out license. I shall send the permanent license when I got your payment.
Prices
A license for 1 copy for commercial use costs f50,- (Dutch guilders), which
is (now) about $30. Every additional additional copy for the same company
will cost f10,- extra. Please add costs for payment and 17.5 % VAT
(Value Added Tax) if you are in the EU. Companies can get an invoice,
which will save them the VAT. People outside the EU do not have to pay VAT.
Instead they have to import the license, which could imply they have to pay
local taxes. Contact me for site licenses that exceed 50 copies.
Do not forget the e-mail address on the note for your registration. Otherwise
I shall not know who paid.
Postbank number 7525347 or: ABN-AMRO number 40.78.38.309
Comerwell Software
Hengelo
The Netherlands
Note that this is not a postal address but a bank account.
I also have a bank account in Germany and the USA (NY).
See up-to-date information on my homepage.
Comerwell Software is registered at the Chamber of Trade (Kamer van
Koophandel, KvK) Enschede at number 06072135. If Peics is bought for
a registered company in the EU, you must send me a copy of the registration
before I can send you an invoice.
Remarks, comments, good ideas and mental support are very welcome.
Maybe I may not reply immediately, subject to other work loads.
Please note this before you e-mail to me:
- Send mail about this program to
pgpeudra@comerwell.xs4all.nl. I still like to find my personal mail ;-).
Besides it's easier to have all Peics mail together.
- If you have a question, please
read the FAQ
before sending mail to me. I do not like to answer the same questions all the time.
- The
bugs page
has information on bug reports and fixes.
- Don't forget to mention which version (16/32, Peics/Empics, Pro/Light)
you use and with which Eudora version.
- I shall not add very much to Peics Light. If you need more, please first
read the information about Peics Pro.
- I do not like to get large attached files by mail, because I have a slow
and expensive line to the internet.
- Please do not use the new "text/enriched" feature of Eudora, because my
Elm mailer does not understand those codes and it causes some problems for
pgp decoding.
I would like to acknowledge Charles
H. Tupper in Vancouver, Canada for his kind offer to undertake considerable
time and effort to review and revise this Manual's English grammar to improve
clarity and readability.
This Manual last revised - 97 - March 3
Hans (pgpeudra@comerwell.xs4all.nl)
Return to top