Copyright and Licensing Information

This manual, the Pegasus Mail Logo and all accompanying software and documentation
are all Copyright (c) 1990-2008, David Harris, All Rights Reserved. No part of this manual
or any extract from any supporting document (for example, the Pegasus Mail help file)
may be reproduced electronically or by any other means without express written permis-
sion of the copyright owner.

If you have questions about the licensing terms covering this manual, or if you wish to re-
port a breach of our licensing terms, please e-mail us at [email protected].

Colophon

This manual was prepared using Adobe FrameMaker 7, and converted to Adobe Portable
Document Format (PDF) using Adobe Distiller 5.0. For fonts, it uses Arial and Times New
Roman, a boring, but easily-legible and widely-available combination of typefaces.
Contents

1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
What is electronic mail?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Terms and concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2: Installing Pegasus Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installing Pegasus Mail on a Memory Stick . . . . . . . . . . . . . . . . . . . . . . . . . 13
Preconfiguring a user mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Running Pegasus Mail for the first time . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Command-line switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Accessing the Internet using Pegasus Mail . . . . . . . . . . . . . . . . . . . . . . . . . . 15
WinPMail, NetWare and the Microsoft Requester . . . . . . . . . . . . . . . . . . . . 16

3: Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Running the program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Now what? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Interface basics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Drag and drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
The Button Panel (also called the “main toolbar”) . . . . . . . . . . . . . . . . . . 19
Customizing the button panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
The floating menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
The StatusBar and WindowBar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Working with multiple file servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4: Sending Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Creating a new message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Addressing your message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Distribution (Mailing) Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Address books. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Aliases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
The Addressing Centre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Address completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Message options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
The Message menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Right-clicking in a message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Using styled text, pictures and formatting in messages . . . . . . . . . . . . . . . . . 30
Basic formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Pictures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Hyperlinks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Special message options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Editor settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
 Custom headers for this message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Sticky settings and default settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Checking your spelling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
The Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Adding attachments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Working with attachments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
How Pegasus Mail decides on encoding. . . . . . . . . . . . . . . . . . . . . . . . . . 37
Attaching other mail messages to a message . . . . . . . . . . . . . . . . . . . . . . 38
Extensions and Message Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Supported address types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Local user addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
User groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Internet addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
NetWare MHS addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
User-defined gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Address overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Mail Merge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Before you start - don't spam!. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Terminology - Records and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Messages and data files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Field numbers and names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Setting up a merge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Quick setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Dry runs - testing your merge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Attachments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Merging and rich text messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Things to watch out for. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

5: Reading and filing your mail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Mail folders and trays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
The Folder Manager window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Preview mode and “Classic” mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Working with your folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Navigating within folders and messages in preview mode. . . . . . . . . . . . 47
The Folders menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Right-clicking in the list of folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Accessing multiple mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Searching for text in your folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Entering the text for which you want to search . . . . . . . . . . . . . . . . . . . . 49
Other search options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Specifying where to search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Specifying search constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Working with search results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Saving and loading searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
The Folder Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Message status indicators (folder view) . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Working with messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Replying to mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Forwarding mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
 Incremental search through a folder’s messages . . . . . . . . . . . . . . . . . . . 58
Selecting messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Quick-select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Grouped views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
The Folder menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Right-clicking within a folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Re-sending a copy-to-self message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Reading messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Message status indicators in the reader. . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Hyperlinks and URLs (World Wide Web links) . . . . . . . . . . . . . . . . . . . 65
Working with attachments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Previewing, opening and saving attachments . . . . . . . . . . . . . . . . . . . . . . 66
Deleting attachments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Replying to, and forwarding attachments . . . . . . . . . . . . . . . . . . . . . . . . . 66
Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Viewing the raw version of the message . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
The Reader menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Right-clicking while reading a message . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Digests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Copying text from a message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

6: Mail and Spam Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

General-purpose rule-based mail filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Using the Filtering Rule Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Using the Full Filtering Rule Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Advanced rule processing options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Flow Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Creating logical operations in your rule sets . . . . . . . . . . . . . . . . . . . . . . 79
Content Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
How it works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Using the Content control dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Editing a Content Control definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
The General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
The Exceptions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
The Message Tests Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
The Actions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Header addition and advanced options . . . . . . . . . . . . . . . . . . . . . . . . 85
Pegasus Mail's Content Control Filtering Language . . . . . . . . . . . . . . . . 85
The types of test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
General layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Making the most of regular expressions . . . . . . . . . . . . . . . . . . . . . . . 89
Matching anywhere within the text . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Spamhalter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Spamhalter vs Content Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Getting started with Spamhalter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Basic operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Status indication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Sorting and grouped views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Using Spamhalter and Content Control together . . . . . . . . . . . . . . . . . . . 92
Copyright information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
 The Global Whitelist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Managing the Global Whitelist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Adding addresses to the whitelist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Specialized address forms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

7: Addressbooks and Distribution Lists . . . . . . . . . . . . . . . . . . . . . . . . 95

Address books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Navigating within the Addressbook Manager window . . . . . . . . . . . . . . 95
Working with addressbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Working with addressbook entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Using address books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
The Addressbook menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Distribution lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Address completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
System-wide addressbooks and System-wide lists . . . . . . . . . . . . . . . . . . . . 101

8: Other addressing aids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Administering users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
The Local User list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Address books and Distribution lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
The Logged-in user list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
MHS Directory services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

9: Notepads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Creating and working with notepads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

10: Noticeboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Posting notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Following up and replying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Deleting notices, expiration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Sending mail to noticeboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

11: Preferences - customizing the way Pegasus Mail operates. . . . . . 107

General settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Basic Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Advanced Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Mailbox location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Extended features (Novell NetWare mode only) . . . . . . . . . . . . . . . . . . . 110
Outgoing mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Messages and replies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Use these settings when creating new messages and replies. . . . . . . . 112
Special settings applying to replies only . . . . . . . . . . . . . . . . . . . . . . . 112
Address completion options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Message formatting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Message editing features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Formatting and use of styling in messages . . . . . . . . . . . . . . . . . . . . . 113
Tabs and margins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Signatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
 Copies to self (outbox) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Copy-to-self filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Encryption. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Sending mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
When sending messages containing rich (formatted) text. . . . . . . . . . 117
Advanced settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Incoming mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Preview mode settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Folder behaviours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Message reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Content viewers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Configuration files affecting content viewers. . . . . . . . . . . . . . . . . . . . . . 123
Hyperlinks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
List Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Reporting/Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
New mail reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
System messages and logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Automatic formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Automatic formatting features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Autoreplacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
NetWare MHS/SMF settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

12: Using Pegasus Mail on the Internet . . . . . . . . . . . . . . . . . . . . . . . . 129

What you need to use Pegasus Mail on the Internet . . . . . . . . . . . . . . . . . . . 129
Online and offline modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Configuring Pegasus Mail for TCP/IP mail. . . . . . . . . . . . . . . . . . . . . . . . . . 130
General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Receiving (POP3) Mail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Polling controls:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Multiple identity controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Editing a POP3 definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
The “General” Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
The “Security” Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
The “Download Controls” page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Server-side mail filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Sending (SMTP) mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Settings controlling the way mail is sent . . . . . . . . . . . . . . . . . . . . . . . 136
Editing an SMTP definition.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
The “General” page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
The “Security” Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
SMTP Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Dialling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
SSL/TLS - Secure mail connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
What the various controls mean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Server certificate fingerprint tracking. . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Suppressing certificate verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Selective download of mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
MultiPOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
13: IMAP4, accessing remote mailboxes . . . . . . . . . . . . . . . . . . . . . . . 143
Defining an IMAP profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
The “Connection” Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
The “Settings” Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Deleted message handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
The “Performance” Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Connection management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Folder status handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Folder list handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
The “Security” Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Accessing an IMAP Mailbox. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Using an IMAP profile Off-line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Restrictions when using IMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
IMAP troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Local issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Remote issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

14: Multiple Identities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Using identities in your mail messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Attaching identities to folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

15: Extensions (“Plugins”) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Telephone message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Mail Merge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Business Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
LDAP directory service lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

16: Message templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

The two types of message template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Using message templates to create mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Creating templates using the template editor. . . . . . . . . . . . . . . . . . . . . . . . . 155
The template script language - general reference . . . . . . . . . . . . . . . . . . . . . 155
String literals and filenames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Optional or omitted parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Textual substitutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Example: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
The template script language - command summary . . . . . . . . . . . . . . . . . . . 157
The TITLE command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
The HELPFILE command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
The STRING command - declaring variables . . . . . . . . . . . . . . . . . . . . . 157
Creating list variables using the STRING command . . . . . . . . . . . . . 158
Using the SET command to set message fields . . . . . . . . . . . . . . . . . . . . 158
Using the SET command to assign values to variables . . . . . . . . . . . . . . 159
The INSERT command - add data to a message . . . . . . . . . . . . . . . . . . . 159
The BODY/ENDBODY commands - insert a block of text into the message
159
The INCLUDE command - include a file or the reply body . . . . . . . . . . 159
The ATTACH command - attach a file to the message . . . . . . . . . . . . . . 160
The PICTURE command - add a picture to a template's prompt dialog . 160
 The TEXT command - add text to a template's prompt dialog. . . . . . . . . 160
The EXTRACT command - parse an e-mail address . . . . . . . . . . . . . . . . 161
The LOOKUP command - get a text item from a list variable. . . . . . . . . 161
The CHAIN command - run one template after another . . . . . . . . . . . . . 161

Appendix A – Command-line options. . . . . . . . . . . . . . . . . . . . . . . . . . 162

Appendix B: Public (System-wide) folders. . . . . . . . . . . . . . . . . . . . . . 163

Defining Public Folder Trees. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Creating public folders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Appendix C – DDE and MAPI services . . . . . . . . . . . . . . . . . . . . . . . . 165

DDE (Dynamic Data Exchange) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
MAPI Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Installing Pegasus Mail’s MAPI support . . . . . . . . . . . . . . . . . . . . . . . . . 165
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

Appendix D – Updates, technical support . . . . . . . . . . . . . . . . . . . . . . 167

Official download sites and web pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Getting technical support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Appendix E – Troubleshooting and FAQs . . . . . . . . . . . . . . . . . . . . . . 168

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Some frequently-asked questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
10 1: Introduction
What is electronic mail?

1: Introduction
What is electronic mail?
Electronic mail is simply the process of sending information from one computer to another.
The information is normally just text, but can also be word-processor files, spreadsheets or
even graphics from drawing programs. Electronic mail is based on a principle known as
“store and forward” — that is, if the addressee is not there when you send the message, the
message is stored until he is, at which time it is passed on (or “forwarded”) to him. Where
Internet Messaging services like ICQ and AOL’s “Instant Messenger” are the Internet-era
equivalents of the telephone, electronic mail is the Internet-era equivalent of the letter —
electronic mail is much faster and cheaper than traditional paper mail, yet it still has the ad-
vantage of allowing recipients to handle it at a time that suits them best. Most people quickly
become addicted to electronic mail (or e-mail, as it is often called), particularly international
e-mail, because it is such an easy way of distributing information efficiently and quickly.

There are many ways of sending and receiving electronic mail: one popular method, for ex-
ample, is using a web-based mail service like Hotmail... But if you want to get the greatest
possible power, speed and flexibility in handling your e-mail, your best approach is always
to install a dedicated e-mail package (also called a “client”) on your computer at home.
Pegasus Mail is such a client, and this manual will help you to get the greatest ease of use and
effectiveness from it.

Pegasus Mail is an electronic mail system for use on single PCs and on supported Local Area
Networks such as Novell NetWare. It is designed to be as easy as possible to use, without
sacrificing any power or functionality. While there are versions of Pegasus Mail for other
computer systems, this manual describes the version designed specially for Microsoft Win-
dows. The Windows version of Pegasus Mail has served the Internet community since 1993,
and for historical reasons is often called “WinPMail” — we will use this “familiar name” for
it in most places within this manual. With WinPMail you can send mail to users running other
versions of Pegasus Mail, and via message transports such as SMTP , to users all around the
world.

Terms and concepts

Throughout this manual, we will use certain conventions and terms to describe operations or
features:

<F10> Anything set in angle brackets is a single key you should press: so this example tells
you to press Function Key 10. <R> would mean to press the ‘R’ key.

Field A field is an area of the screen where the program expects you to enter text; fields
appear as outlined white areas on the screen, and when they are active, will contain a
flashing bar (the cursor). Only one field is ever active on the screen at a time: you can
move to the next field by pressing the <Tab> key, or to the previous field by holding the
<Shift> key and pressing <Tab>. While editing the text in a field, you can correct mis-
takes using the <Backspace> key or the arrow keys.

Filename From time to time, Pegasus Mail might ask you for a filename, usually when you
need to save information to a diskette or when retrieving information. Because of con-
straints imposed by the MS-Windows file system, there are certain restrictions on the
characters you can use in the names you give your files - in particular, you cannot use the
characters ‘/’, ‘\’, or ‘:’ in a filename, and you should avoid using the character ‘~’ if at
 1: Introduction
Terms and concepts
11

all possible. Pegasus Mail will usually allow you to specify a file in another directory
using either the usual DOS path syntax (d:\path\filename.ext), or the so-called UNC For-
mat (\\SERVER\VOL\PATH\NAME). You can use long filenames in most places in the
program where you are asked for a filename — any exceptions to this rule are specifi-
cally noted where they apply in this manual.

Headers Electronic mail messages are divided into two parts: headers and message body:
the headers are special lines at the start of the message, which are formatted so that both
you and the computer can read and make sense of them. Examples of headers are the To:
field, specifying the addressee, and the Subject: field, which describes briefly the con-
tents of the message. The message body is meaningful only to people — the computer
will not usually attempt to interpret it. In this manual, we use the term header to mean
any of the special machine-readable fields at the start of the message.

Attachments As well as having a body part, an e-mail message can also have attachments,
or files that are included with the body as part of the message. In this manual, we don’t
make any specific distinction between attachments in mail you receive, and attachments
to the messages you send — we assume that any differences will be obvious from the
context in which the term is used.

Menu A menu is a list of options from which you can choose an action. Pegasus Mail is
menu-driven — that is, you control it by choosing what you want to do next from a
menu. To choose a menu option you can either click the mouse in the Menu Bar at the
top of the Pegasus Mail window, or press the <Alt> key then move the selector to the
item you want and press <Enter>: the menu will open and you can choose any item by
clicking it, or by scrolling the selection bar to it using the arrow keys and pressing
<Enter>. Some menu options will show either an arrow or a keystroke at the right of the
menu window. An arrow means that there is another menu “below” the selection, which
can be opened by selecting it. If a keystroke appears at the right of a menu entry, it is
called an accelerator (also called a hotkey) for that entry, which means that you can acti-
vate the menu choice without opening the menu, simply by pressing the key. As an
example you can press <Ctrl+N> (hold down the <Ctrl> key and press N) anywhere in
Pegasus Mail to start a new message.
12 2: Installing Pegasus Mail
System requirements

2: Installing Pegasus Mail

System requirements
To run Pegasus Mail for Windows, you need a computer configured as follows:

• Microsoft Windows 98, ME, 2000, XP or NT4. Windows 95 is not supported.

• Around 7MB free disk space for the program, as well as whatever space is required to
store mail as you use it. Over time your mailbox can become very large — we recom-
mend that you install Pegasus Mail on a volume that has at least 500MB available at all
times.

• 8MB RAM over and above the basic requirements of the Windows operating system. In
practical terms, this means a minimum of 16MB on Windows 98, 32MB on Windows
ME, 64MB on Windows NT4, or 128MB on all other versions of Windows.

• A properly-configured Internet connection. This can be any type of Internet connection

supported by Windows, including ADSL and Cable modem connections, LAN connec-
tions and conventional modems. An Internet connection is only required if you plan to
send Internet mail — it is quite possible to use Pegasus Mail without an Internet connec-
tion to send mail between users on a Local Area Network (LAN).

• Pegasus Mail has built-in support for Novell NetWare Local Area Networks: to use this
support, you must be running a version of Novell NetWare later than v3.12 and be run-
ning a genuine Novell workstation client package on your computer — Pegasus Mail
cannot use Microsoft’s NetWare client software because the Microsoft software does not
properly support Novell’s interfaces. Pegasus Mail has separate modules providing spe-
cific support for Novell NDS systems and for older NetWare bindery-based systems.

Installation
To install Pegasus Mail simply run the W32-XXX.EXE distribution file (where XXX are
three digits representing the version of Pegasus Mail). This file is a self-extracting installer -
when you run it, it will launch straight into a conventional Windows installation procedure,
which should be quite familiar. To run W32-XXX.EXE, either double-click it in a Windows
Explorer or My Computer listing, or else click the Start button on the taskbar, then enter
d:\path\W32-XXX.EXE, replacing d:\path with the name of the directory where W32-
XXX.EXE is located. The setup program will ask you a couple of simple questions, including
where you would like it to install Pegasus Mail. You can install Pegasus Mail anywhere, but
we recommend that you accept the default it suggests. The installer will also give you the op-
portunity to create shortcuts for Pegasus Mail – we strongly recommend that you do this.

Using the Program Files directory By default, Pegasus Mail does not suggest installing it-
self into the standard Windows Program Files directory structure, because Microsoft are
quite specific that programs and data should not be mixed, and Pegasus Mail’s multi-user op-
erating modes make a number of assumptions about where data can be found. There is no rea-
son, however, why you cannot install Pegasus Mail in Program Files if you wish - in most
cases, it will not significantly affect either the operation of the program or of your system. If
you are unsure, though, we recommend that you accept the default installation directory,
since this is guaranteed to work correctly.