SimpleMail 3.1 User's Guide

 

 

This document contains information about the SimpleMail internet e-mail transport.

 

Installation

Configuration

Using e-mail

Preferences

 

 

Installation

 

Newton Internet Enabler

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.

 

System Update

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)

Get it here.

Follow the directions given on the webpage to download it to your MessagePad.

 

 

SimpleMail

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.

 

 

Text Stationery

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.

 

 

Monaco

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.

 

 

Help

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.

 

 

 

Configuration

 

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:

 

Add an e-mail address

If you've already entered an E-Mail address, skip this section.

 

  1. Tap Owner Info.
  2. Tap your owner name.
  3. Tap Add and in the list that appears, tap E-Mail
  4. In the slip that appears, enter the appropriate information.
    • Enter the address people should reply to, for example simple@dial.pipex.com and set the type of address to E-Mail or Internet. Alternatively, if your ISP appears in the address picker, choose that and just enter your mailbox name (the part before the "@") in the address field.
    • Ignore the "Set E-Mail Password" button.

 

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.

 

 

Add mail server information

 

  1. Tap Owner Info.
  2. Tap your owner name.
  3. Tap Add and in the list that appears, tap SimpleMail
  4. In the slip that appears, enter the appropriate information.
    • Tap "E-Mail" to choose your e-mail address. You can only choose from E-Mail addresses you've already entered in this owner card.
    • Against "POP User" enter your e-mail user name, for example bell99.
    • If your account requires APOP login authentication, check the Use APOP box.
    • Tap the Set POP Password button and in the slip that appears enter your e-mail password.
    • Against "POP Host" enter your POP host's name, for example pop.isp.com.
    • Against "SMTP Host" enter your SMTP host's name, for example smtp.isp.com.

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.

 

 

 

Using Electronic Mail

 

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.

  1. Tap To:, Cc: or Bcc: in the routing slip, and in the list that appears tap Individual.
  2. In the slip that appears, enter the appropriate information.

 

SimpleMail adds a couple of items to the Tag button's popup list.

Unwrap

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:

  1. Open the e-mail message, or check it in the overview.
  2. Tap the Tag button and in the list that appears tap Unwrap.

The text is unwrapped into paragraphs.

Tap Undo to restore the original message text.

 

Select All

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:

  1. Select some of the e-mail message text.
  2. Tap the Tag button and in the list that appears tap Select All.

(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.

Browsing

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:

  1. Tap the checkbox next to each item you want to fetch.
  2. Tap the Receive button and in the list that appears tap SimpleMail.

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:

  1. Tap the star at the top of the screen and in the list that appears tap SimpleMail.
    SimpleMail's progress slip is re-opened.
  2. Tap the Stop button in the progress slip.
    Any messages which are still Remote are deleted from the In Box - but not from the server.

 

 

And finally

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)

 

 

Preferences

To set SimpleMail's preferences:

  1. Tap InOut Box.
  2. Tap the Information button and in the list that appears, tap SimpleMail Prefs.
    A slip appears.
  3. Select the appropriate information.

 

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.

 

 

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.

 

 

 

Limitations & Known Problems

 

If your preference is When connecting : Browse mail:

  1. If you've created multiple SimpleMail items in your owner card, only the first account will be browsed.
  2. Tapping Receive/SimpleMail in the In Box overview with no selection will always re-fetch all message summaries.
  3. Any attempt to Send will be queued for later execution; you can't change hosts while connected.

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.

 

 

 

Frequently Asked Questions

 

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.

 

 

 

Feedback

 

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.

 

 

 

Acknowledgements

 

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!

 

 

 

Legal

 

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.