Contents Page, Previous Chapter

APPENDICES

Appendix A - Sources

Anonymous ftp (ftp.qualcomm.com)

QUALCOMM has an anonymous ftp server (ftp.qualcomm.com) that has information and software related to Eudora. These are located within the "quest" direc tory. Included are POP3, Ph, and password changing servers, current product information and more.

Eudora Information

The information in this manual was correct at the time of production. However, things happen very quickly in the electronic wo rld, meaning that some of this information may already be out of date. For the very latest information about Eudora, send e-mail to eudora-info@qualcomm.com.

Obtaining a POP Server

If you would like to run a POP server on your own UNIX s ystem, we suggest you use "popper" Popper is available via anonymous ftp from ftp.qualcomm.com.

VAX/VMS systems may try the "Multinet" package from TGV, or IUPOP3, available via anonymous ftp from ftp.indiana.edu.

For VM/CMS users, there is a port of "popper" available via anonymous ftp from vmd.cso.uiuc.edu (cd to the "POPD" directory).

Ph Server Source Code

A server for the "Ph" protocol is available via anonymous ftp from ftp.qualcomm.com.

Password Change Server

Three sample U NIX servers for Eudora's "Change Password" command are available via anonymous ftp from ftp.qualcomm.com.

Windows Sockets Products

Demos of Windows Sockets 1.1 compliant stacks and applications are available via anonymous ftp from sunsite.unc.ed u in the directory micro/pc-stuff/ms-windows/winsock.

Serial Line IP (SLIP)

Information and applications regarding Serial Line IP (SLIP) are available via anonymous ftp from biochemistry.cwru.edu in the directory /slip.

PC Speaker

If y ou want the new mail sound notification to work with the speaker that comes with your PC, you need to install the PC speaker driver. This driver is available via anonymous ftp from ftp.qualcomm.com. It's the file SPEAK.EXE in the directory quest/eudora/ windows/utils. This is a self-extracting archive, so just run it on your PC to produce the necessary files and instructions.

Appendix B - Shortcuts

a. Modifier Keys (SHIFT & CTRL)

Many operations in Eudora can be a ffected by holding down one or more "modifier" keys. Eudora uses the [SHIFT] and [CTRL] keys as modifiers. The [SHIFT] key is usually used to make an operation to reverse option settings.
[SHIFT] + Queue or Send button< DD>Bring up Change Queueing dialog.
[SHIFT] + Reply
Toggles the "Reply to all" option in the Switches dialog. If the Reply to all option is turned on, Shift + Reply generates a reply to the sender only. If the Reply to all option is turned off, Shift + Reply generates a reply to all addresses in the message header.
[SHIFT] + Transfer
Send a copy of the current message to the selected mailbox and retains the original message in the original mailbox.
[SHIFT] + Open a messag e
Show all headers.

[CTRL] + Keys
Act as hotkeys to perform quickly some operations. The complete list is reported below.

[CTRL] + [A] Select all
[CTRL] + [B] Move window behind all other windows
[CTRL] + [C] Copy
[CTRL] + [D] Delete message
[CTRL] + [E] Queue/Send an outgoing message
[CTRL] + [F] Open Find window (search for message)
[CTRL] + [G] Find again
[CTRL] + [H] Attach docume nt to outgoing message
[CTRL] + [I] Open In mailbox
[CTRL] + [K] Make nickname
[CTRL] + [L] Open Nicknames window
[CTRL] + [M] Check mail
[CTRL] + [N] New message
[CTRL] + [P] Print message
[CTRL] + [Q] Quit Eudora
[CTRL] + [R] Reply to message
[CTRL] + [S] Save contents of topmost window
[CTRL] + [T] Send queued messages
[CTRL] + [U] Open Ph window
[CTRL] + [V] Paste
[ CTRL] + [W] Close message
[CTRL] + [X] Cut
[CTRL] + [Z] Undo
[CTRL] + ['] Paste as quote

b. Other Important keys

Arrow keys
Depending on the settings in the Switches dialog, can move you from one mes sage to another in a mailbox. If the Plain Arrows in the Switches dialog is turned on, up/left arrow take you to the previous message, while down/right arrow take you to the next message. If the Ctrl-Arrows option in the Switches dialog is turned on, [CTRL] + up/left arrow take you to the previous message, while [CTRL] + down/right arrow take you to the next message.

[ENTER] key
Select the outlined button in any dialog, alert, or window and opens the selected messag e(s) in mailbox.

[ESC] key
Stop any operation currently in progress.

[DEL] key
Delete the character to the right of the insertion point.

[HOME] key
Scroll to the beginning of the window.

[END] key
Scrolls to the end of the window.

[PGUP] & [PGDN] keys
Scroll up or down through the window.

Appendix C - Mail Transport

Introduction

Eudora uses Simple Mail Transfer Protocol (SMTP) to transfer your outgoing mail to your SMTP server machine, which in turn uses SMTP to send your mail to the world at large. Mail from the world at large arrives on your Post Office Protocol (POP) server, where it waits for Eudora to pick it up with Post Office Protocol, version 3 (POP3). The mai l Eudora sends and receives is constructed in accordance with RFC 822 and RFC 1521 (MIME).

Outgoing Mail

When you send an e-mail message to someone, Eudora uses SMTP to send the mail to your local SMTP server computer. That computer then sends the mail to your addressee's computer, also (usually) by means of the SMTP protocol.

Why doesn't Eudora talk directly to your addressee's computer? For one thing, it would take a lot longer for your mail to leave your PC, bec ause your PC would have to call up each addressee's computer and deliver your mail. For another, some computers are "hard to find"; it's much better to let another computer "hunt" for your addressee than to make your PC do it. Finally, sometimes your ad dressee's computers won't be available when you want to send mail. The SMTP server handles this by holding your mail until the other computer is ready to accept it, eliminating the inconvenience of having unsent messages hanging around on your PC.

Incoming Mail

When somebody sends you mail, other computers use the SMTP protocol to deliver the mail to your POP server. Your POP server puts mail in your "mail drop", where it stays until the Eudora program picks it up. When you check your mail, Eudora uses POP3 to pick up your mail and move it to your PC.

Why doesn't Eudora use SMTP to receive your mail? SMTP works best when the computers it knows about are always ready for mail. Unless you wanted to run Eudora and your PC 24 hours per day, seven days a week, SMTP wouldn't work very well for you. It also doesn't work well in lab environments, where you might use any number of different PCs.

More Information

If you want to know more about the Internet in general, consult the book Internetworking with TCP/IP, by Douglas Comer, 1988, Prentice-Hall ISBN 0-13-470154-2 025.

If you want to know more about SMTP, RFC 822, POP3 and MIME, the official standards are:

RFC 821, "Simple Mail Transfer Protocol", by Jonathan B. Postel

RFC 8 22, "Standard for the Format of Internet Text Messages", by Dave Crocker

RFC 1225, "Post Office Protocol, Version 3", by Marshall Rose

RFC 1521, "Multipurpose Internet Mail Extensions", by Ned Freed and Nathaniel Borenstein

You can find the RFC's by anonymous ftp to nic.ddn.mil; see Internetworking with TCP/IP for details.

MIME

"MIME" stands for Multipurpose Internet Mail Extensions. MIME serves two major purposes - it allows mail applications to tell one another what sort of data is in mail, and it also provides standard ways for mail applications to encode data so that it can be sent through the Internet mail system.

MIME Encoding

The Internet uses the "SMTP" protocol to move mail around. SMTP is limited to the US-ASCII character set (see Appendix C). This is a problem for people who speak languages other than American English and so need accented characters or non-American letters, or for people who want to u se special symbols like the bullet.

MIME provides a way around this restriction. It offers two encodings, "quoted-printable" and "base64". These encodings use US-ASCII character codes to represent any sort of data you like, including spe cial characters or even non-text data.

Quoted-printable is used for data that is mostly text, but has special characters or very long lines. Quoted-printable looks just like regular text, except when a special character is used. The special cha racter is replaced with an "=" and two more characters that represent the character code of the special character. So, a bullet in quoted-printable looks like "=95".

However, there are some other things that quoted-printable does. For on e, since it uses an "=" to mean something special, equal signs must themselves be encoded (as "=3D"). Second, no line in quoted-printable is allowed to be more than 76 characters long. If your mail has a line longer than 76 characters, the quoted-printa ble encoding will break your line in two, and put an "=" at the end of the first line, to signal to the mail reader at the other end that the two lines are really supposed to be one. Finally, a few mail systems either add or remove spaces from the ends o f lines. So, in quoted-printable, any space at the end of a line gets encoded (as "=20") to protect it from such mail systems.

Let's try an example. Here's a passage of text that you might type on your PC:

«Il est démontré, disait-il, que les cho ses ne peuvent être autrement; car tout étant fait pour une fin, tout est nécessairement pour la meillure fin.»

Without any encoding, this might show up on your recipient's screen as:

+Il est dimontri, disait-il, que les ch oses ne peuvent btre autrement; car tout itant fait pour une fin, tout est nicessairement pour la meillure fin.;

This corruption happens because SMTP cannot handle the special characters. However, if you and your recipie nt both have MIME, quoted-printable encoding would be used, and your text would show up properly:

«Il est démontré, disait-il, que les choses ne peuvent être autrement; car tout étant fait pour une fin, tout est nécessairement pour la meillure fin.»

While your mail was actually in transit, however, it would have looked like:

=ABIl est d=E9montr=E9, disait-il, que les choses ne peuvent =EAtre =
autrement; car tout =E9tant fait pour une fin , tout est n=E9cessairement =
pour la meillure fin.=BB

Base64 encoding is another way to protect binary data from the SMTP mail system. However, Base64 makes no attempt to be legible, and is most appropriate for non-text data.

MIME Labelling

The other important part of MIME is that it lets mailers communicate what kind of data is in a message (or part of a message). The primary mechanism used for this is the Content-Type header.

          Content-Type: text/plain; chars

et=iso-8859-1

A content-type header is divided into three parts; the content type, the content subtype, and the parameters. In this case, the content type is "text" meaning the message contains mostly legible text. The content subtype is "plain" which means there aren't any formatting commands or anything like that embedded in the text. Finally, "charset=iso-8859-1" is a parameter; in this case, it identifies the character set the message uses.

The major content types are :

text           legible text
image          pictures and graphics
audio          sound
video          moving pictures
message        messages or pieces of messages
multipart      several different kinds of data in a single message 

Practical Issues

There are really only two things you sometimes need to do with Eudora and MIME. One is that it may occasionally be necessary to turn off quoted-printable encoding. Another is that you may want to know how to define mappings between PC file extensions, MIME types, and Macintosh types.

Turning Off Quoted-Printable Encoding

Eudora automatically uses quoted-printable encoding if your mail contains special characters. Eudora also uses quoted-printable encoding for attached plain text files. If your recipients don't have MIME, quoted-printable may hurt more than it helps. If that's the case, just turn off the QP button in the message icon bar when you are sending text files to those recipients.

Mapping Between File Extensions, MIME Types, and Macintosh Types

Eudora has the ability to map between file extensions, MIME types and subtypes, and Mac intosh creators and types. Messages received by Eudora can grab the MIME type/subtype and/or Macintosh creator/type from an attachment and map that into the correct file extension. Also, on outgoing messages, Eudora can make sure that attachments ar e encoded with the correct MIME type/subtype and/or Macintosh creator/type depending on the file extension of the attachment being sent.

Eudora knows about some MIME types. However, since new MIME types are being defined all the time, it may be necessa ry to add to Eudora's knowledge from time to time. Adding new mappings between the various types only requires editing the eudora.ini file with a text editor (like the one that comes with Eudora).

There is a section in the eudora.ini file labelled [Mappings], followed by some entries, one per line. Each entry is called a map. A map defines when the mapping should occur (which can be "in" "out" or "both"), followed by an equal sign and five parameters. These five parameters are (in order) the PC file extension, the Macintosh creator code, the Macintosh type, the MIME type, and the MIME subtype. Here are some sample entries:

[Mappings]
both=gif,,,image,gif
both=mpg,,,video,mpeg
both=doc,MSWD,,,
in=xls,XCEL,,,
out=xls,XCEL,XLS4,,
both=eps,,EPSF,application,postscript

A map marked "in" only tries to match the map to messages that you receive. A map marked "out" only tries to match the map to messages that you send. A map marked "both" tries to match the map to both incoming and outgoing messages.

The first map says that any incoming MIME message that has a part type of "image" and subtype of "gif" will get saved to a file with the extension ".gif." It also specifies that outgoing messages that have an attachment with the file extension ".gif" will get the MIME type of "image" and subtype of "gif" if the encoding method of the message is MIME. The second map is similar to the first map in structure, but uses a different file extension and MIME type a nd subtype.

You can use map entries to move between PC file extensions and Macintosh creator and type as well. The third map says that if an incoming message has an attachment with the Macintosh creator "MSWD" (which is the Macintosh creator for Microsoft Word), then the file extension of the attachment when saved to disk should be ".doc" (the file extension that Word for Windows uses). Since the map is marked as "both," it will also give attachments with the extension ".doc" on outgoing messages the Macintosh creator of "MSWD" if the encoding method of the message is BinHex.

Note that the Macintosh type from this map is empty. This allows multiple types to be recognized with just one mapping. This is nice for "in" maps because it al lows you to cover a range of creator/type pairs with one map. You must be careful in using this type of map with an "out" or "both" mapping, though, because an outgoing attachment that matched this map would have a Macintosh creator, but no Macintosh typ e. Some Macintosh applications cannot open files with a missing type. Microsoft Word for the Macintosh can open files without a type, so this map is fine being marked "both."

Microsoft Excel for the Macintosh is an example of a program that can't open a file with an empty type. This is why there are two maps for Excel (the fourth and fifth maps above). The incoming map for Excel is like the one for Microsoft Word, but the outgoing map explicitly defines the Macintosh type.

The last map shows that you can have both Macintosh creator/type and MIME type/subtype in one entry. This map says that if an incoming message has an attachment that is encoded in MIME and has the "application/postscript" type/subtype, or has a BinHex attachment with the Macint osh type of "EPSF" then the resulting file will have an extension of ".eps". Similarly, if an outgoing message has an attachment with the extension ".eps" and if the MIME encoding is being used for the message, then the attachment will get the "application/postscript" MIME type/subtype. If the message was using the BinHex encoding, then the attachment would get the Macintosh type of "EPSF".

But what happens if an attachment matches more than one map? Eudora will try and find the best ma tch. For example, if you had the following [Mappings] section:

[Mappings]
in=xls,XCEL,,,
in=xlc,XCEL,XLC3,,

and you received a message with an attachment that had a Macintosh creator of "XCEL" and a Macintosh type of "XLC3" (a Microsoft Excel Chart), then the file would get an extension of ".xlc" since the first map only matched th e Macintosh creator, but the second map matched both the Macintosh creator and type.

Eudora can receive attachments that have both a MIME type/subtype and a Macintosh creator/type. Eudora understands attachments with the MIME type/subtype "applicati on/applefile", which has Macintosh creator/type information embedded in it. With this type of attachment, Eudora will consider a match with the Macintosh creator/type as a "better" match than a match with the MIME type/subtype.

Finally, if an incom ing attachment matches two different maps to the same degree (e.g., both maps have the same MIME type/subtype with different file extensions), then Eudora will use the file extension in the first matching map.


Contents Page, Previous Chapter