SimpleMail 4.3 User’s Guide This booklet tells you how to set up and use the SimpleMail internet e-mail transport. For the background on Newton e-mail, please refer to Apple’s Newton E-Mail guide [1]. Getting started There are several things you need to do in order to use e-mail. ■ ■ ■ You need to create an Internet setup using the Newton Internet Enabler (NIE) [5] so that your Newton device can communicate with your Internet Service Provider (ISP) or intranet.
Installation System Update If you don’t already have the latest Newton System Update [4], you should install that first. To find out your system version: 1 2 Open the Extras Drawer and tap the Information button. In the list that appears, tap Memory Info. A slip appears showing you your ROM Version at the bottom left. When Apple abandoned Newton on 27 February 1998, the versions were: US & International English German MP120 2.0 (516263) 2.0 (536205) MP130 2.0 (526205) 2.0 (536205) MP2000 2.1 (717145) 2.
▲WARNING Apple didn’t support NIE on the MP120 because of its limited system memory. (Adding PC card memory doesn’t overcome this limitation.) You can use NIE 1.1 with the MP120, but you may need to freeze all non-mail packages to free up enough memory for NIE to operate, and you may not be impressed by its performance. ▲ Modem Enabler If you’re using a modem to connect to your ISP, you need the appropriate Modem Enabler [6]. Enablers for common modems are built-in to Newton.
PaperStationery.pkg 2.1 This package only works with Newton 2.1. This alternative to the TextStationery package offers improved scrolling performance. vCard vCardDecoder.pkg Install this package to to have vCard (.vcf ) enclosures converted to Name cards which may be viewed in your In Box and put away. Images ImageDecoder.pkg ImageStationery.pkg Install both these packages to be able to view JPEG and GIF format image enclosures in your In Box.
Sounds AudioDecoder.pkg AudioStationery.pkg Install both these packages to be able to hear AIFF (Macintosh), .wav (Windows), muLaw (MIME audio/basic) and GSM format sound enclosures in your In Box. When viewing a sound (sic) you can use the Tag button to put it away, after which you can choose it as a system alert sound. Currently there is no encoder for sending Newton sound in these formats. Monaco The Monaco.
• Your e-mail username & password for receiving mail. • The addresses of your ISP’s POP or IMAP and SMTP hosts. Add your e-mail address If you’ve already entered your own E-Mail address, skip this section. 1 2 3 4 Go to Owner Info in the Extras Drawer. Tap the owner you want to modify. Tap Add and in the list that appears, tap E-Mail. In the slip that appears, enter the appropriate information. • Enter the address you want people to reply to and set the type of address to EMail or Internet.
3 4 Tap Add and in the list that appears, tap SimpleMail. In the slip that appears, enter the appropriate information. • Tap E-Mail to choose your e-mail address (the one you want to appear in outgoing messages). You can only choose from E-Mail addresses you’ve already entered in this owner card. When you come to mail something you have a chance to change this if you need to. The remaining information can be obtained from your ISP. • Against Username enter your POP or IMAP e-mail login username.
• Against SMTP Host enter your SMTP host’s name. If you need to specify a port number other than SMTP’s usual 25, append a colon and the number to the host name. • If your SMTP account requires authentication, check the “Authenticate” box., then tap the Set SMTP Login button and in the slip that appears enter your SMTP login username and password. 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.
• Enter the address you want people to reply to when you’re mailing from this worksite. “None” means there will be no Reply-To address in your messages and your owner card E-Mail address will apply as usual. • Against SMTP Host enter your SMTP host’s name. If you need to specify a port number other than SMTP’s usual 25, append a colon and the number to the host name. • If your SMTP account requires authentication, check the Authenticate box.
appended to your message as a vCard, check the Enclose card box. SimpleMail lets you address a message to an individual without having to create an entry for them in the Names application. 1 2 Tap To, Cc or Bcc in the routing slip, and in the list that appears tap Individual. In the slip that appears, enter the appropriate information. SimpleMail stores all enclosures in received messages, even though you may not be able to view them.
SimpleMail adds a few 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 when displayed on a smaller screen such as the MessagePad’s. To unwrap message text: 1 2 Open the e-mail message, or check it in the overview. Tap the Tag button and in the list that appears tap Unwrap. The text is unwrapped into paragraphs.
When connecting to receive mail, SimpleMail lets you browse the mail on your server rather than fetching each message immediately. You choose this behaviour in SimpleMail Prefs. Browsing 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 small star appears at the top of the screen.
like Foundation Systems’ NewtonID avoid this problem by registering shareware against a global (virtual) owner.) 2.
Basic Check Leave mail onn server if you want to leave messages on the server after fetching them. Otherwise messages are deleted automatically after being fetched. Check Delete from In Box and server 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.
Otherwise messages have an Envelope part which contains the original internet header. 2.1 Tap Open InOut as to select whether the In Box or Out Box should be opened when you tap the InOut icon. In the list that appears, tap your choice. Note Open InOut as applies only to Newton 2.1. ◆ • • • • • Tap When connecting to choose how you want to receive messages. Browse mail - a summary of each message is retrieved from the server and shown in the In Box overview.
Sending NTE Tap Text encoding to enable a Newton Text Encoding (NTE) module. In the list that appears, tap your choice. Note Text encoding applies only to SimpleMail-NTE. NTE modules are packages you install separately. They perform language encoding for communications applications - they can also be used by Newt’sCape, for example. ◆ Check Prefix reply wih originator if you want replies to be prefixed with a line saying who sent the original message.
Leave quote text blank if you don’t want to quote excerpts from a message in this way. Tap Always Cc to select recipients you’d like always to receive a copy of your messages. In the list that appears, tap your choice. You can change the Cc field for individual messages when you actually route the item. To remove this preference choose Other Names and uncheck all selected names. If you want to send an x-face with all your messages, enter its definition in the Face block. An x-face is a 48x48 icon.
Tap You have mail to specify a sound to be played when mail download is complete. In the list that appears, tap your choice. Check Enable no mail alert if you want an alert to be displayed when you are receiving but there is no mail for your In Box. Otherwise SimpleMail silently returns control to Newton, which is more suitable for unattended scheduled operation. Tap Timestamp with to select the time zone with which you want received messages to be stamped.
• • • • • Tap Receive to limit the number and type of messages you want to receive.
Tap the Add button to add your filter to the list. Tap a filter to select it, then tap Remove to remove a filter from the list. During the receive process, filter criteria are tested in the order they appear in the list and the first that matches has its action applied. Currently there is no way to reorder the list other than removing and re-adding filters. Check the Enabled checkbox to enable filtering. If this box is unchecked then all messages will be received in full.
Check The usual suspects to capture useful checkpoint data. Check Account information to capture your mail account data as Mail V extracts it from your owner card. Check All I/O to capture Mail V’s conversation with the mail server. Check ViewFrame to create a log in ViewFrame. This option does not appear if ViewFrame is not installed. Check NTK Inspector if your Newt is tethered. This is the preferred option since the log is then on your desktop.
Frequently Asked Questions If your question isn’t answered here, reread the NIE Users Guide, particularly the Troubleshooting section. Q A Q A Q A Q A Q 22 SimpleMail sends an attachment with every message, which recipients can’t read. How can I disable this “feature”? 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.
A Unfortunately SimpleMail doesn’t do this. You have to Receive then Send manually. Q Occasionally SimpleMail reports a server error 999, which is not a valid POP or SMTP error code. What does it mean? A SimpleMail uses 999 when reporting a POP -ERR response and the cause of the error cannot be identified. Diagnostic Diagnostic is a separate package which shows you all SimpleMail’s settings so you can check them over in one place.
Feedback If you find some aspect of SimpleMail not up to snuff, or if you have helpful suggestions, please feel free to let me know: Simon Bell Acknowledgements Thanks and kudos go to Jason Harper for ViewFrame. Debugging has never been so painless. This book was inspired by one created by Peter Rand using Newt’s Cape 2.0 [7]. Legal While I have done extensive testing to make sure SimpleMail is well-behaved, I cannot take responsibility for its use or misuse.
References Apple no longer hosts Newton manuals or developer tools. It does, however, host Newton system software on its Older Software web page. 1 Newton E-Mail Guide 2 MessagePad User’s Manual 3 Newton FAQ 4 Newton System Updates 5 Newton Internet Enabler 6 Modem Enabler 7 Newt’sCape Web Browser 8 SimpleMail http://www.unna.org/unna/apple/documentation/misc/UsingE-Mail(NIE2.0).pdf http://www.unna.org/unna/apple/documentation/2x00/2000UsersManual.PDF http://www.chuma.
Contents Getting started Installation System Update Newton Internet Enabler Modem Enabler SimpleMail Configuration Add your e-mail address Add mail host information Add mail host information to a worksite Add an e-mail signature Using Electronic Mail Unwrap Select All Delete a message on the server Browsing And finally… Preferences Basic Sending Receiving Filter Debug Limitations & Known Problems Frequently Asked Questions Diagnostic Feedback Acknowledgements Legal References 26
