This document contains information about the SimpleMail internet e-mail transport.
Your Newton must be Internet Enabled before you can use SimpleMail; you need the Newton Internet Enabler:
´ NIE 1.1 for MP120, MP130
´ NIE 2.0 for MP2000, MP2100, eMate
Follow the directions given on the webpage to download it to your MessagePad.
Follow the directions in the NIE folder to set up a link to your Internet Service Provider (ISP) using Internet Setup.
Apple didn't support NIE on the MP120 because of the limited system memory on that platform. (Adding card memory doesn't help.) You can use NIE 1.1 with the MP120, but remember this limitation.
If you don't already have the latest MessagePad System Update, you should install that too. (Tap the Extras drawer's Information button, then tap Memory Info in the list that appears, to open a slip which displays your ROM Version.) The latest versions are:
MP120 2.0 (516263)
MP130 2.0 (526205)
MP2000 2.1 (717145)
MP2100 2.1 (717260)
eMate 300 2.1 (737041)
Follow the directions given on the webpage to download it to your MessagePad.
Installing SimpleMail is easy. Just download the SimpleMail.pkg package to your MessagePad.
If you install SimpleMail on a PC card, the SimpleMail transport will go away when the card is removed and return when it is replaced. However, owing to a feature of the approved installation process, SimpleMail will put the dreaded "Grip of Death" on the card.
For this reason it's recommended you install SimpleMail on the Internal store.
SimpleMail requires a "Text Stationery" extension to view text messages in the In/Out Box and will install one automatically if it isn't already in the Extras drawer's Extensions folder. SimpleMail will only work with its own version of the "Text Stationery" extension.
You should delete any existing "Text Stationery" item from your Extensions folder before installing SimpleMail 3.1 the first time.
This will not affect any items already in your In Box.
The Monaco.pkg contains a monospaced Monaco 9- and 12-point font good for viewing messages in the In/Out Box. Its use is optional - you don't need to download it if storage space is tight.
The Help.pkg contains a condensed version of this book. To access it, tap SimpleMail Prefs' Information button and in the list that appears tap Help. Its use is optional - you don't need to download it.
You should have already created an Internet Setup and added it to your worksite - see your NIE documentation. The Internet Setup holds the username and password used to log in to your ISP.
SimpleMail needs to know:
If you've already entered an E-Mail address, skip this section.
You can add several E-Mail addresses to your owner card. SimpleMail lets you choose which applies to your e-mail account. This allows you to use more than one e-mail transport, each with its own independent account details, in the one owner card.
However, if you want to do this be aware that most other e-mail transports don't let you choose the E-Mail address for an account - they just use the first one you entered. If you want to use EnRoute's inet, for example, you need to ensure the address for it occurs first. The easiest way to do this is delete all E-Mail entries from your owner card, and re-enter first the inet address and then the SimpleMail address.
If you have more than one mail account, for example at work or university and home, you can add them all as SimpleMail items to your Owner card. SimpleMail will check them all in turn when receiving mail, so you don't have to manually connect to each one.
Refer to your MessagePad User's Manual for guidance with e-mail and the InOut Box.
SimpleMail extends the usual set of e-mail functions. Firstly, it lets you address a message to an individual without having to create an entry for them in the Names application.
SimpleMail adds a couple of items to the Tag button's popup list.
Many e-mail applications hard-wrap text when sending it. (They insert newline characters at the end of each line on the sender's screen.) This can make paragraphs appear broken or badly formatted to the recipient if displayed on a smaller screen such as the MessagePad's.
To unwrap message text:
The text is unwrapped into paragraphs.
Tap Undo to restore the original message text.
When replying to a message you can quote text from the original by selecting it before tapping Reply. However, selecting more than a screenful isn't easy, so SimpleMail lets you select the entire text of a message. (You can delete unwanted text more easily in your reply.)
To select all message text:
(If you don't have a selection, Select All won't appear in the list.)
When connecting to receive mail, SimpleMail lets you browse the mail on your server rather than fetching each message immediately. See Preferences.
When connecting : Browse mail
Just a summary of each message is fetched - you see the subject, sender, date, message size and Remote status in the In Box overview.
The progress slip disappears but SimpleMail remains connected. A blinking star appears at the top of the screen.
You view a message by tapping its entry in the overview as usual - SimpleMail fetches just that message.
To fetch multiple Remote items:
If your preferences are set to "Delete from In Box and server", Remote messages you delete from the In Box are also deleted immediately from the server.
To disconnect from the server when you've finished browsing:
´ If you have more than one e-mail address, remember to choose the appropriate owner in the routing slip when you mail something. That way the recipient will reply to the right address.
´ When you reply to or forward a message, your e-mail address in the new message will be the one which received the original message unless you change it in the routing slip.
´ There are a couple of problems you may experience if you have more than one owner card.
1. Some shareware registration schemes naïvely assume you will have only one owner card, and when you switch to another unregister your shareware. (Schemes like Foundation Systems' NewtonID avoid this problem by registering shareware against a global (virtual) owner.)
2. You need to be able to distinguish your names in the sender picker, for example:
Royce Walthrop (Home)
Royce Walthrop (Work)
but recipients of your messages may be confused by these extraneous characters or words when they read your name in the message's addressing information - for example:
Date: Mon, 22 Jun 1998 12:32 +0100
Subject: NS Objects
From: Royce Walthrop (Work)
To help you out, SimpleMail will strip the first set of parentheses in your owner name when addressing a message, so for example:
Royce Walthrop (Home) -> From: Royce Walthrop
Royce Walthrop (Work) (x2117) -> From: Royce Walthrop (x2117)
To set SimpleMail's preferences:
Available only with Newton 2.1
Check this if you want received items to be put away to applications that can automatically receive them.
Check this if you want to leave messages on the server after fetching them.
Otherwise messages are deleted automatically after being fetched.
Check this if you want to delete a message from the server when you delete it from your In Box.
If you're connected for browsing mail, Remote messages are deleted immediately. If you're not connected, or the message belongs to another server, it will be deleted next time you log in to the server.
When "Delete from In Box and server" is not checked, the routing button's Delete action has no effect on messages on the server.
Check this if you want to disconnect immediately after sending the contents of your Out Box.
Otherwise SimpleMail looks for mail for your In Box after sending.
Check this if you want to remove internet addressing information from the start of received messages, and decode text and attachments.
Otherwise messages are left in their raw form.
Tap "Put Away text to" to specify where multiple selections should be put away to. In the list that appears, tap your choice.
Tap "When connecting" to choose how you want to receive messages.
Tap "Receive" to choose what kind of messages you want to receive.
NOTE Abbreviated messages will not be deleted from the server even if your preference is not to "Leave mail on server".
NOTE Message size in this context is the number of characters in the message, which occupy 2 bytes each in the Newton OS. A 5K text message will occupy 10K on your MessagePad store.
Tap "When Sending" to set when you want to send an item.
Tap "After sending" to select what to do with an item after it is sent. In the list that appears, tap your choice.
Tap "File read items in" to choose where to file received items that you have already read. In the list that appears, tap your choice.
NOTE Items aren't actually filed until you close then re-open the InOut Box.
Tap Mail Font to choose the font used for displaying your message text. In the slip that appears, select the appropriate information.
Tap Auto Delivery to set the schedule when you want your MessagePad to send and receive mail. In the slip that appears, select the appropriate information.
Tap Add to add the specified time and days to the schedule.
To remove a scheduled time, tap the time in the window then tap Remove.
Tap Enabled to turn on or off the automatic delivery of mail.
Remember to set your preferences not to "Disconnect after sending" if you want to receive messages automatically.
´ If your preference is When connecting : Browse mail:
´ Text attachments will replace the original body of a message.
´ SimpleMail will not forward attachments.
´ The Preferences slip is too tall for the MP1x0 display in landscape orientation.
If your question isn't answered here, re-read the NIE Users Guide, particularly the Troubleshooting section.
Q: SimpleMail sends an attachment with every message, which recipients can't read. How can I disable this "feature"?
A: The attachment is Newton data, readable by other SimpleMail users. For example, you can mail a note including ink and sketches. If you want to send text only, check the "Text Only" box in the routing slip when you mail a message.
Q: When I try to connect I get a message saying "You need to set your owner SimpleMail information before you can connect to the mail server." but I'm sure it's all filled in correctly. What's missing?
A: You're probably not connecting as the right owner. The owner name shown in the routing slip (top left corner) must be the one you've set up for SimpleMail. You can run the Diagnostic package to check whether you really have set everything correctly.
Q: When I'm trying to receive SimpleMail, everything seems okay until the status slip says "Checking for mail" and then I'm alerted to a "POP -ERR". Why?
A: The POP host rejected your login information. Re-check your POP username and password in the Owner card's SimpleMail setup slip.
Q: When I'm trying to receive SimpleMail, my modem just hangs up when the status slip says "Looking up host...", but there's no error message. What's going on?
A: Your POP host couldn't be found on the net. Check the POP Host info in your owner card.
If you find some aspect of SimpleMail not up to snuff, or if you have helpful suggestions, please feel free to let me (Simon Bell) know.
Visit my website for the latest version, related packages, and links to other useful sites.
Thanks and kudos go to Jason Harper for ViewFrame. Debugging has never been so painless.
This document was inspired by one created by Peter Woodbury Rand using Newt'sCape 2.0. Thanks Peter!
While I have done extensive testing to make sure SimpleMail is well-behaved, I cannot take responsibility for its use or misuse. If you don't like being responsible for trying SimpleMail, don't!
SimpleMail is copyright ©1997-98 by Simon Bell. All rights reserved.
Apple, MessagePad and Newton are trademarks of Apple Computer, Inc., registered in the U.S. and other countries.