@DATABASE SimpleMail.guide @$VER: SimpleMail.guide 0.3 (05.12.2001) @AUTHOR David Rey @INDEX "Index" @NODE "Main" "Welcome to SimpleMail!" SimpleMail 0.13 (public ALPHA) © 2000-2001 by Hynek Schlawack & Sebastian Bauer Released under the GNU Public License @{" Introduction     " LINK "INTR" 0} - About SimpleMail @{" Requirements     " LINK "REQS" 0} - System requirements and software needed @{" Copyright        " LINK "COPY" 0} - Legal stuff @{" Installation     " LINK "INST" 0} - Installing SimpleMail on your hard drive @{" Quickstart       " LINK "TUTO" 0} - Getting SimpleMail started in 5 minutes @{" Main Window      " LINK "MA_W" 0} - How to receive and send mail, copy it, etc. @{" Configuration    " LINK "CO_W" 0} - Configuring SimpleMail to your tastes @{" Address book     " LINK "AB_W" 0} - Saving useful addresses @{" Write            " LINK "WR_W" 0} - Writing e-mail messages @{" Editor           " LINK "EDIT" 0} - About the internal editor @{" Read             " LINK "RE_W" 0} - Reading e-mail messages @{" Mail transfers   " LINK "TR_W" 0} - Downloading and sending messages @{" Startup options " LINK "OPTI" 0} - Shell options @{" ARexx interface " LINK "AREX" 0} - The ARexx interface @{" FAQ     " LINK "TIPS" 0} - Read this! @{" Technical stuff  " LINK "TECH" 0} - How SimpleMail is archiving your messages @{" Authors          " LINK "INFO" 0} - How to contact the Authors, useful links @{" Thanks to        " LINK "CRED" 0} - Those who keep supporting the developers @{" History " LINK "HIST" 0} - The story so far... @ENDNODE @NODE "INTR" "Introduction" INTRODUCTION Welcome to SimpleMail, an electronic mail ("E-mail") client for your Amiga. The program and the general usage is very similar to YAM's, although YAM is currently much more powerful. However, SimpleMail has (or should have in the future) some features which YAM doesn't offer yet. Please note this is an ALPHA release. Don't expect too much at these early stages - SimpleMail is still very limited and has probably lots of bugs. But it is getting better... :-) Current features of SimpleMail: - Very simple @{" installation " LINK "INST" 0} process. - Easy operation using buttons, menus, the keyboard and drag&drop within a freely customizable interface, thanks to @{" MUI " LINK MUI}. - Comprehensive main window, offering quick access to your @{" address book " LINK "AB_W" 0} and sporting threaded views. - Any number of @{" user-defined folders " LINK "FO_W" 0}, which can also be arranged in groups. - Hierarchical @{" address book " LINK "AB_W" 0}, including groups and tons of data for each entry. - Built-in POP3 & SMTP clients, which can check any number of different mail servers in one connection, preselect messages for download and (optionally) use SSL/TLS based encryption for added security. - Automatic message handling, using @{" filters " LINK "CO_F" 0}. - Built-in support for UUencode and MIME for sending and receiving binary data. - HTML mail compatible, thanks to the built-in HTML client based on the @{" SimpleHTML " LINK SimpleHTML} engine. - ARexx port @ENDNODE @NODE "REQS" "Requirements" REQUIREMENTS Hardware - Amiga Computer - at least 2 MB RAM - 68020 CPU or higher Software - AmigaOS 3.0+ - AmiTCP/IP compatible stack (AmiTCP, Miami[DX], Genesis...) - @{" MUI " LINK MUI} 3.8 or higher - 3rd party MUI custom classes: BetterString - http:\//www.p2p-it.dk/duff/MCC_BetterString.LZX NList - http:\//www.aphaso.de/download/MCC_NList0_90.lha NListtree - http:\//www.aphaso.de/download/MCC_NListtree18.8.lha PopPlaceHolder - http:\//us.aminet.net/pub/aminet/dev/mui/MCC_Popph.lha TextEditor - http:\//www.p2p-it.dk/duff/MCC_TextEditor.LZX - (optional) OpenURL - http:\//www.cc.jyu.fi/~sintonen/bin/OpenURL31.lha - (optional) PGP 2.6.x - http:\//us.aminet.net/pub/aminet/util/crypt/PGPAmiga-2.6.3is.lha - (optional) AmiSSL - http:\//tesla.rcub.bg.ac.yu/~antony/AmiSSL/ @ENDNODE @NODE "COPY" "Legal issues" LEGAL STUFF SimpleMail is Copyright © 2000-2001 by Hynek Schlawack & Sebastian Bauer and released under the GNU Public License. See @{" here " LINK INFO} if you are a developer and want to join the effort, get access to the CVS or just obtain the sources. @ENDNODE @NODE "MUI" "MUI" This application uses MUI - MagicUserInterface (c) Copyright 1993-96 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the installation according to personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "MUIXXusr.lha" (XX shows the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY Support and online registration is available at http:\//www.sasg.com/ @ENDNODE @NODE "INST" "Installation" INSTALLATION To install SimpleMail, just drag the "SimpleMail" drawer you found after uncompressing the archive to the place you want. No assign or further operation is necessary - you can open the drawer and double click the SimpleMail icon to run the program. Exception: you might have some old MUI custom classes lying around that will be used by SimpleMail; make sure you're using the latest versions of those mentioned under @{" Requirements " LINK REQS}. @ENDNODE @NODE "TUTO" "Quickstart" QUICKSTART This chapter is meant to be a step-by-step guide to the way SimpleMail is configured and is mostly aimed to first time users. If you're a former YAM user or are otherwise familiarised with email, you probably won't need to read this at all. 1. Before we go ahead, you need this info from your Internet Service Provider: - your e-mail address - the Internet address of your mail server (also known as "POP3" or "SMTP server") - your password, required to log in on the mail server As an example, we'll explain how to setup a single account for an user called "Ralf Schumacher", living in Germany. His e-mail address is "ralf@provider.de" and the address of his mail server is "mail.provider.de". His password is "formula1". 2. Start SimpleMail by double clicking its icon. After a short time, the main window should appear, containing three listings -the folder list, the message list and a cut-down version of the address book- and a row of buttons. 3. The program must be configured before you can do anything else. Choose "Configuration..." from the "Settings" menu or just click the "Config" button at the top-right corner to open the Configuration window. 4. The sheet which then appears is called "User". Here you can select your folder directory and set the adjustment for daylight saving time. If daylight saving time applies to you at the time of installation, turn it on here. Leave the folder directory as it is for now, and select the "-/-" entry under "Accounts" in the left list to create a new account. 5. Here is where you must enter the absolutely vital information needed for you to be able to send and receive email. Following our example, we enter this under "User": Name: Ralf Schumacher E-Mail Address: ralf@provider.de then this under "Receive": POP3 server: mail.provider.de Login: ralf Password: formula1 and lastly, this under "Send": SMTP server: mail.provider.de 6. Some mail servers require you to download your email before letting you to send any. If this applies to you, just tick the gadget "Log into POP3 server first". 7. Save the settings now by clicking on [Save]. SimpleMail should now have enough data to allow you to send and receive email. 8. After saving the settings, you're back in the main window. Click the [New] button (fifth button from the left) - the Compose Message window will open. As a quick test, type your own address into the "To" text field (like "ralf@provider.de"), and then something to indicate the subject of your message into the "Subject" text field. As you press in this field, you're brought to the large blank area where you can type the actual message. You can attach a file to your message if you want. To quickly add some files to your message, just press the "Attach" button in this window - a file requester will appear to allow you to select the files you want. After the selection has been done, you are presented with the current message composition in a more verbose way - which by the way you can activate at any time using the "Show Attachments" button. 9. Assuming you are not currently online (your TCP/IP stack is not running), click on [Send later]. This moves the message to the "Outgoing" folder instead of sending it immediately as [Send now] would try to do. 10. Now start your TCP/IP stack and go online. Open the "Outgoing" folder by clicking on "Outgoing" in the folder list contained in the main window. The message is already selected, so send it by clicking the "Send" button at the top. The transfer status window will appear and report the progress as SimpleMail logs in on the mail server and sends your message. 11. As you've probably noticed, the mail has vanished from the 'Outgoing' folder, and can be found now in the "Sent" folder. The letter picture in the list has a little stamp on it now, which means that the message has been sent successfully. 12. When you double-click the message, the Read Message window will open. You should be able to recognize the text written by you. The lines in the upper part of the message have been inserted by SimpleMail and contain data needed for mail transfer (the so-called "headers"). 13. Since you've written the mail to yourself, it's time to check your account for new mail. Close the Read Message and then click the "Fetch" button at the top of the main window. 14. The transfer status window you saw before opens again and you can watch how SimpleMail downloads your mail from the mail server. Provided that everything runs as it should, you will now be able to read your email in the "Incoming" folder. If you've made it this far without any major problem, you should now know the basic operation of SimpleMail. Keep reading the following chapters for further information about the single topics related to SimpleMail. @ENDNODE @NODE "MA_W" "Main window" MAIN WINDOW SimpleMail's main window is laid out like thus: Menu bar: @{" Project " LINK "MAM1" 0} @{" Folder " LINK "MAM2" 0} @{" Message " LINK "MAM3" 0} @{" Settings " LINK "MAM4" 0} .--------------------------------------------------------. | @{" Toolbar " LINK "MA02" 0} | |________________________________________________________| | | | | @{" Folder list " LINK "MA00" 0} | @{" Message list " LINK "MA01" 0} | | | This shows the contents | |- - - - - - - - -| of the selected folder | | Status bar | | |-----------------| | | | | | @{" Address book " LINK "AB_W" 0} | | | | | `--------------------------------------------------------' @ENDNODE @NODE "MA00" "Main window - Folder list" @TOC "MA_W" Main window - FOLDER LIST The following four standard 'mailbox' folders are always present: Incoming: This mailbox holds new messages addressed to you. Whenever you download new mail, this is where the new messages will go initially. You can however redistribute incoming messages to other folders, as desired, using @{" filters " LINK "CO_F" 0}. Outgoing: This mailbox holds the messages which you have written and which you intend to transmit the next time you go online. Sent: Here you can see the messages which you have already sent. Messages are moved to this mailbox (from "Outgoing") when they are actually transmitted. Again, you can use @{" filters " LINK "CO_F" 0} to transfer sent messages to other folders. Deleted: This mailbox contains messages marked for deletion. Usually, messages are not actually deleted from the hard disk until you quit SimpleMail. This allows you to recover messages deleted earlier in the session. Using the @{" Folder menu " LINK "MAM2" 0} you can create more folders (and folder groups) to hold messages which you have received and/or sent, so you can arrange your email in whatever way you like. The folder list contains two columns: one for the name of the folder, and another one for the total number of messages in every folder. The column widths can be adjusted by using the mouse to drag the thin line separating the column headings in the folder list itself. You can rearrange the folders using the @{" Drag&Drop " LINK "Drag" 0} technique. To see the contents of any particular folder, just click on that row in the folder list -- the message list will then appear at the right. Double clicking an entry in the list opens the @{" Edit folder " LINK "FO_W" 0} window, where you can edit some properties for the selected folder. Under the folder list there is a status bar listing the total, new and unread messages in the currently selected folder. There is also a button at the right side of this status bar, allowing you to switch to & from the "alternative" view of the main window: the folder list will disappear, and this status bar will jump to the top. Also, an additional pop-up gadget will appear now at the right side of the status bar, allowing you to select another folder easily and see some stats. @ENDNODE @NODE "MA01" "Main window - Message list" @TOC "MA_W" Main window - MESSAGE LIST The message list has seven columns: Message status: An icon showing the @{" status " LINK "MA0S" 0} of the message (new, unread, read, etc.) Sender/Recipient: Displays the e-mail address or the name of the sender or recipient of the message, depending on the type of mailbox. If the message was sent to several people at the same time, a little icon will appear in front of the name, showing three tiny heads. Subject: Subject of the message. Reply address: Contents of the Reply-To: header in the message. If the header is missing, this field will be blank. Date: The date and time that the message was posted, calculated according to the local time (for you). For this to work, both you and the sender must have set your correct @{" timezone " LINK "CO00" 0}. Size: Size of the message, in bytes. Filename: Name of the file containing this message. The column widths can be adjusted by using the mouse to drag the thin lines separating the column headings in the message list itself. The order of the columns can also be modified by dragging the column headers with the mouse. You can also turn on/off individual columns using the pop-up menu that will appear if you keep the right mouse button pressed while the pointer is over the headings. A little arrow in one of the column headings shows how the messages are sorted. One click on a column heading causes the messages to be sorted according to this criteria. A second click on the same heading reverses the order of sorting (Z->A instead of A->Z). To set the second sort key, keep the key pressed while clicking on the column heading. Please note the From/To fields are always used as a sort criteria; this part of SimpleMail still needs some work. :o) A double click on an entry in the list opens a @{" Read Message window " LINK "RE_W" 0} and displays the corresponding message. You can use the mouse to move messages to another folder. Click on an entry and drag up/down (holding the left mouse button) to mark a block of messages. Then click and @{" drag " LINK "Drag" 0} the marked block to the left, into the folder list, and drop it onto the chosen folder. @ENDNODE @NODE "MA0S" "Status Icons" @TOC "MA_W" STATUS ICONS Message status Icon ------------------------------------------------------------------------ New messages back of envelope with an glowing yellow spot New, unread message downloaded the last time mail was collected. Unread messages back of envelope Messages which have not yet been read. Read messages opened envelope Messages which have already been read. Answered messages opened envelope with a green left-pointing arrow Messages which have already been answered Forwarded messages opened envelope with a red right-pointing arrow Messages which have been forwarded to a third party. Unsent messages front of envelope Messages in "Outgoing", ready to send Held messages envelope (front) with a red 'H' Messages in "Outgoing" which need further work before sending. Sent messages stamped envelope Messages which have already been sent. Failed messages torn envelope Messages which failed, due to an error encountered in transmission. Messages with attachment(s) paper clip Messages with one or more files attached. Locked messages Key Messages which have been encrypted with PGP Status report little sign with the letter 'i' Automatic reply from the mail server or the recipient's mail program Important message exclamation mark Message flagged as important by the sender Marked message light bulb Message "marked" by the user for some reason @ENDNODE @NODE "MA02" "Main window - toolbar" @TOC "MA_W" Main window - TOOLBAR The toolbar gives you easy access to the most frequently used functions. .---.---.---.---. .---.---.---. .---.---. .---.---. .---.---. | 1 | 2 | 3 | 4 | | 5 | 6 | 7 | | 8 | 9 | |10 |11 | |12 |13 | `---^---^---^---' `---^---^---' `---^---' `---^---' `---^---' The following table shows the equivalences between buttons (position and label), keyboard shortcuts and menu items. Button Shortcut Equivalent to menu... ----------------------------------------------------------------------- 1 [Read] D, @{" Message/Read " LINK "MAM3" 0} 2 [Edit] E @{" Message/Edit " LINK "MAM3" 0} 3 [Delete] L, @{" Message/Delete... " LINK "MAM3" 0} 4 [GetAdd] T 5 [New] N 6 [Reply] R 7 [Forward] W 8 [Fetch] H 9 [Send] S 10 [Filter] I 11 [Filters] F @{" Settings/Filters... " LINK "CO_F" 0} 12 [Abook] A 13 [Config] C @{" Settings/Configuration... " LINK "MAM4" 0} @ENDNODE @NODE "MAM1" "Main window - Project Menu" @TOC "MA_W" Main window - PROJECT MENU Project/About... Shows @{" Copyright Information " LINK "COPY" 0} for this program. Project/About MUI... Shows copyright and version information for @{" MUI " LINK "MUI" 0}. Project/Quit Exit from SimpleMail. @ENDNODE @NODE "MAM2" "Main window - Folder Menu" @TOC "MA_W" Main window - FOLDER MENU Folder/New Group... Creates a new folder group and inserts it at the end of the folder list. Groups can hold folders as well as another folder groups. This way you can arrange your folders in groups and keep your folder list clean and tidy. By default, groups are named "New Group". To rename them, you shall use the @{" configuration panel " LINK "FO_W" 0} accordingly. Folder/New Folder... Creates a new folder and inserts it at the end of the folder list. A requester will open asking for the name, path and type of folder that should be created. Folder/Delete... Removes the current (user defined) folder, asking for confirmation first. If the folder is actually a folder group, any folders in it will move one place up in the hierarchy, i.e. they will NOT be deleted. Folder/Settings... Opens a @{" configuration panel " LINK "FO_W" 0} where you can modify the properties of the current folder. Folder/Order » Save|Reset Saves or restores the order of the folders in their @{" list " LINK "MA00" 0}. Note this order is also saved when modifying the folder settings. Folder/Check single account If you have set up several POP3 servers, you can use this function to check any single account. @ENDNODE @NODE "MAM3" "Main window - Message Menu" @TOC "MA_W" Main window - MESSAGE MENU Message/Read Loads the selected message into a @{" Read window " LINK "RE_W" 0}. Message/Edit Allows you to edit a message you have composed earlier. Message/Move... Moves one or more messages into another folder. Not yet implemented. Message/Copy... Copies one or more messages to another folder. Not yet implemented. Message/Delete... Moves one or more messages to the 'Deleted' folder (from which they can be recovered if needed). The key can be used as a shortcut. @ENDNODE @NODE "MAM4" "Main window - Settings Menu" @TOC "MA_W" Main window - SETTINGS MENU Settings/Show folders This switch allows you to select whether the folder list should appear or not in the main window, acting as a toggle between the "normal" and "alternative" view of the main window. Settings/Show address book This switch allows you to select whether the address book should appear or not in the main window. Settings/Configuration... Opens the @{" configuration window " LINK "CO_W" 0}, in which you can change SimpleMail's settings. Settings/Filters... Opens the @{" Edit Filters " LINK "CO_F" 0} window, where you can edit your current filters or add a new one. Settings/MUI... Opens the settings window for @{" MUI " LINK "MUI" 0}, where you can specify virtually all of the visual features of SimpleMail, including fonts, palette, screen mode, background, borders, gadgets, keyboard shortcuts and so on. Please see the MUI documentation for more information. SimpleMail utilises several MUI classes which were not in the original release of MUI. For this reason, some settings are not made in SimpleMail's configuration window, but in MUI's. These MUI modules are: TextEditor: internal editor as well as message display in Read Message window. Options: fonts, colours, cursor, separator, keybindings, spell checker. NListtree: structured lists, i.e. folder and message lists, address book, sheets in config window Options: appearance of lines and group icons. PopPlaceHolder: items using pop-up placeholders under Config/Phrases BetterString: general one-line text input field. Options: font, palette, cursor. @ENDNODE @NODE "FO_W" "Edit Folder" @TOC "MA00" EDIT FOLDER Apart from the four mailbox folders "Incoming", "Outgoing", "Sent" and "Deleted", you can create any number of user-defined folders. These folders are useful e.g. to archive received and/or sent mail, or to administrate mailing lists. Name The name of the folder will appear in the folder listing in the main window. Example: SimpleMail Path This is the path in which the messages of the actual folder will be saved. Usually this is a subdirectory in the basic "/.folders" directory, but you can specify any other place, like another hard disk partition for example. Example: SimpleMail_ml Type Here you choose if the folder is for received and/or sent mail. This influences the column titles and whose address is displayed in the message list. If you select "mailing list", the message list for this folder will be threaded by default. @ENDNODE @NODE "CO_W" "Configuration" CONFIGURATION Even at these early stages, SimpleMail has already quite several options which can be set up in the configuration window. The program options are initially divided into 9 sheets which can be selected at the left part of the configuration window. @{" User     " LINK "CO00" 0} - Basic information: folder directory and timezone @{" Accounts       " LINK "CO01" 0} - SMTP and POP3 settings for mail transfer @{" Receive mail   " LINK "CO02" 0} - Controlling the way mail is downloaded @{" Write          " LINK "CO03" 0} - Wordwrap settings @{" Reading        " LINK "CO04" 0} - Header layout options @{" Reading plain " LINK "CO05" 0} - Main layout options for reading email @{" Reading HTML " LINK "CO06" 0} - Image download filter for HTML mail @{" Phrases " LINK "CO07" 0} - Options related to message quoting @{" Signatures     " LINK "CO08" 0} - Signature and tagline settings The same three buttons appear on each sheet: [Save] Use this to save all changes to the hard disk, so they will survive a reboot of the computer. [Use] With this the changes are temporary and apply only until SimpleMail is closed. [Cancel] Discard any changes. @ENDNODE @NODE "CO00" "Configuration - User" @TOC "CO_W" Configuration - USER (Essential information needed for SimpleMail to work) The time and date displayed by SimpleMail in the message list is always converted to your local time. This guarantees correct sorting of messages from all over the world sent out from different time zones. The time zone is part of the message's date and specifies the difference between local time and Greenwich Mean Time (GMT). Usually SimpleMail will get the time zone from your Locale settings. Should the time zone have a special value (e.g. a difference of half an hour) it can be defined in the environment variable ENV:TZ. Examples : GMT+1 (for Germany) GMT (for the U.K.) GMT-5 (for U.S. EST e.g. New York City) [ ] Add adjustment for daylight saving time This option is to be activated during daylight saving time. By doing so, one hour will be added to the time zone value. Folder directory Here you can select the directory where your folders will be stored by default when they are created. @ENDNODE @NODE "CO01" "Configuration - Accounts" @TOC "CO_W" Configuration - ACCOUNTS (Information needed for internet mail-transfer) Here you can add new accounts both for sending and receiving email. There is currently no limit for the number of accounts you can create. Note that every account can be for the same user on a different server, or a different user on the same server. Either way, you can check for new mail with a single mouse-click by clicking "Fetch" in the main window. Click on [Add new account] to insert the data required for a new e-mail account. With [Remove account] you can (obviously) delete accounts. ---- User ---------------------------------------------------------------- Name You should enter your real name here. E-Mail Address Guess what you should enter here! :) Reply Address Usually this field should remain empty. The default Reply-To address is your e-mail address. ONLY if you want to use a different address you should enter that here. ---- Receive ------------------------------------------------------------- POP3 Server The Internet address of your system's mail server. This server which normally is a computer of your ISP (Internet Service Provider) must be capable of working with the POP3 protocol. Example: mail.provider.uk Port Since the port number of the POP3 service is 110 in most cases, this is the default value. If yours is different, enter that number here. Example: 110 Login Insert the User ID for the POP3 server here. In most cases this will be identical to the username in your e-mail address. However there are exceptions, so check the instructions from your ISP. (SimpleMail then constructs the full account name in the form \@.) Example: sebauer Password The password which is asked by your mail server. This password is possibly but not necessarily identical to the password you use to log into your ISP (e.g. using PPP). Example: codingismylife [ ] Active Turn this option on to have the selected POP3 server checked for new mail every time you push the "Fetch" button. If you don't want this e-mail account to be checked automatically when using this button, switch off this option and instead use the menu item "Folder/Check single account" in the main window. [ ] Delete mails If this option is activated, new mail will be deleted after downloading it from the mail server. The messages will be deleted only after they have been successfully saved to your computer. If the POP3 account is used by several people, or if you'd like to access your account at a later time from another computer, turn this option off. [ ] Avoid duplicates If you decide not to have SimpleMail delete the mail on the server after downloading, it will be downloaded again the next time SimpleMail gets your mail, so every message will appear twice in your mail folder. To prevent this, turn this option on - as long as this option is activated, SimpleMail will keep track of all your downloaded messages in the '.uidl.' file, using special commands of the POP3 server to avoid downloading the same message twice. If the POP3 server supports these UIDL commands, this check will be done rather quickly. If the server doesn't support these commands, SimpleMail will try to read the Message-ID field using the TOP command instead of the UIDL commands. In case the mail server doesn't support any of these commands, this option shall be turned off. [ ] Secure If this option is activated, the whole communication process between SimpleMail and your mail server will happen under SSL encryption, or more exactly under the TLS protocol as described in RFC #2595, using port 995 instead of the usual 110. In a nutshell, this adds extra security to prevent the common eavesdropping and hijacking attacks which POP is subject to. If your POP3 server does not support this, you'll receive an error message while checking for new mail - in that case, switch this option off. Also, note this requires AmiSSL to work. ---- Send ---------------------------------------------------------------- SMTP Server The Internet address of the system you're sending your mail to. This server which usually is a computer of your ISP (Internet Service Provider) must be capable of handling the SMTP protocol. Example: smtp.provider.de Port Since the port number of the SMTP service is 25 in most cases, this is the default value. If yours is different, enter that number here. [ ] Use SMTP AUTH Enable this if you're using a server which requires authentication (ask your ISP if in doubt). You will need an additional login and password in this case, to be entered in the Login/Password fields above. [ ] Secure Enable this to use a secure SSL/TLS connection with the SMTP server. In this case, SimpleMail will use the SMTP STARTTLS extension as described in RFC #2487 to request an authenticated communication with the SMTP server, trying to protect the communication from the typical man-in-the-middle attack coming from any system routing the communication. If your SMTP server does not support this, you'll receive an error message while trying to send email - in that case, switch this option off. Again, this requires AmiSSL to work. [ ] Log into POP3 server first Some Internet Service Providers require you to log into your POP3 server before you are allowed to send email, as this step requires you to identify yourself and thus helps keeping SMTP abusers out. If your ISP requires this, tick this box. [ ] Use IP as domain Enable this if you keep getting requesters like "X-Authentification-Error: pD957C509.dip.t-dialin.net claimed to be t-online.de" when trying to send your email -- this will force SimpleMail to use your current IP instead of the domain part of your email address while talking to your mail server. @ENDNODE @NODE "CO02" "Configuration - Receive mail" @TOC "CO_W" Configuration - RECEIVE MAIL (Setup for downloading mail) ---- Preselection -------------------------------------------------------- After establishing a link with the POP3 server, you might be interested in using a @{" preselection window " LINK "TR_W" 0} showing a list of all new mail in the POP3 mailbox. This allows you to decide whether to download, delete or leave a message on the server, according to its size, topic or sender. For pre-selection to work properly, the server must support the TOP command (which most of them do). disabled: pre-selection is never used only sizes: all messages will be displayed but only their sizes will be shown. The advantage of this method is that it is pretty fast. enabled: every message will be displayed in pre-selection Size limit If pre-selection is activated, messages which exceed the value given here in size will be highlighted. This way you avoid downloading messages with huge attachments. If you want all messages to be listed, select "All messages". ---- Automatic operation ------------------------------------------------- Check for new mail every [xx] minutes Here you can specify a time interval after which SimpleMail will automatically recheck your mail server for new mail. To deactivate this option, just enter zero. Example: 15 minutes @ENDNODE @NODE "CO03" "Configuration - Write" @TOC "CO_W" Configuration - WRITE (Wordwrap settings) ---- Editor -------------------------------------------------------------- Word wrap While you are writing a new message, the message will be formatted to make sure that no line has more characters than the value specified here. You can also choose if SimpleMail should insert line breaks as you type or if this should be postponed until you send the message. Example: 76 By default, wordwrapping is disabled. ---- Replying ------------------------------------------------------------ [ ] Wrap before quoting If this option is activated, SimpleMail will wordwrap the message you are replying to, according to the wordwrap setting entered above. @ENDNODE @NODE "CO04" "Configuration - Reading" @TOC "CO_W" Configuration - READING (Settings for message header layout) ---- Header Configuration ------------------------------------------------ If "Show all headers" is selected, all the headers will be displayed. On the other side, you can unselect all the options if you don't want to see any header, or select only some of them at the left. If you want to see some headers not listed here, enter their names in the text field under "Additional headers" one by one, pressing after each one. Example: X-Mailer In-Reply-To By default, all the "From", "To", "CC", "Subject", "Date" and "Reply-To" headers are displayed. In the Read Message window, the selected headers will be displayed in the order you set here. @ENDNODE @NODE "CO05" "Configuration - Reading plain" @TOC "CO_W" Configuration - READING PLAIN (Fonts and colours for the Read Message window) ---- Fonts --------------------------------------------------------------- Proportional Font This font will be used to display the headers. You can still select a fixed-width font, if that's what you really want. :) Fixed Font If you select one, this font will be used to display the message body in the Read message window. Fixed-width fonts are usually better suited for this task, as proportional fonts will break about any fancy ASCII signature or table you will read. :) ---- Colours ------------------------------------------------------------- Here you can select the palette colours for the various items composing the Read Message window: background, plain text, quoted text, old quoted text (two generations old instead of one) and text which is part of a link, like e-mail and WWW addresses. Colours can be "finetuned" using the colour wheel. [ ] Wordwrap plain text If this option is activated, very long lines going beyond the right border of the Read window will be wordwrapped. This is irrelevant for headers, which are always wordwrapped if needed. [ ] Underline links Tick this option to make links (e.g. e-mail and WWW addresses) to be displayed underlined. This also includes links appearing in the message headers. [ ] Use graphical smilies If this option is activated, those ever-popular ASCII smilies like ":)", ":D", ":-(" and others will be converted to a cute graphic, as seen in popular websites like amiga.org. Have fun! @ENDNODE @NODE "CO06" "Configuration - Reading HTML" @TOC "CO_W" Configuration - READING HTML If you use to receive email in HTML format, here you can tell SimpleMail from which addresses you don't mind to download images linked in the HTML body. If you try reading some HTML mail, only if the FROM: address of the message is mentioned here, the built-in SimpleHTML engine will try to download images, and of course only if you are online at the time. Example: sebauer@t-online.de (SimpleMail will only try to download & show images in HTML mail coming from this address). @ENDNODE @NODE "CO07" "Configuration - Phrases" @TOC "CO_W" Configuration - PHRASES (Welcome/Close phrases used when writing email) With SimpleMail you can set a welcome, intro or close text for your messages according to the recipient of your message, including the texts used when replying or forwarding a message. This way, you can not only customize SimpleMail to e.g. use generic german texts when writing to any #?.de domain, but also to automagically use some funny text when posting to a certain mailing list, use a more serious tone if you're replying to your boss, or pretend to be the perfect lover when corresponding with your significative other. Keep readin'! ;^D Use on addresses which contain Enter here the pattern that the TO: field of your outgoing message should be compared to. If the contents of the TO: field of your message match this pattern, the appropriate set of phrases will be used, depending on whether you're writing, replying or forwarding a message. If this field remains empty, this set of phrases will be used by default is case no other set apply. Example: #?.(de|ch|at) (Addresses of countries with German mother tongue) ---- Write --------------------------------------------------------------- Welcome SimpleMail will insert this text at the beginning of every new message you write (except for answers and forwarded messages). You can define a line break by inserting '\\n'. Example: Hi!\\n Welcome with address If you use the addressbook to start a new message, SimpleMail will use this welcome text instead. Click on the pop-up button to select a variable from the list. Example: Hello %r,\\n Close This text is inserted at the end of every new message you write, just before the signature separator. You can insert a line break with '\\n'. Example: bye,\\nSebastian Bauer ---- Reply --------------------------------------------------------------- Welcome, Intro, Close Whenever you reply to a message, SimpleMail will automatically insert these in your reply. Example: [Welcome] Hello %f,\\n [Intro] On %d, you wrote:\\n [Close] Regards ---- Forward ------------------------------------------------------------- Initial (NYI) This text will be added at the beginning of the original text of any message you forward whenever this set of phrases apply. Click on the pop-up button to select from a list of variables which can be inserted (for example %r stands for the name of the recipient, %s stands for the subject, etc.). When the text is inserted into the message, SimpleMail replaces the variables with their values, which are taken from the forwarded message. Example: *** Forwarded message, originally by %n on %d: ***\\n Finish (NYI) This text will be inserted at the end of a forwarded message (but before the close phrase). Click on the pop-up button to select a variable from the list (for subject, date, sender, etc.). Example: *** End of forwarded message ***\\n @ENDNODE @NODE "CO08" "Configuration - Signatures" @TOC "CO_W" Configuration - SIGNATURES (Definition of signatures and taglines) With SimpleMail, you can define as many signatures as you want (e.g., one signature for private mail, another one for business, another one for a certain mailing list, etcetera). Use signatures Tick this box if you really want to use signatures. Use taglines Tick this box is you want SimpleMail to automatically add a random tagline to every email you write. Simply insert a %t in the signature and it will be replaced by a random tagline found in .taglines when composing a mail. Add new signature Click here to define a new signature and then enter a name and the text for it. [Remove signature] Obviously, this gadget allows you to remove a signature already defined. If more than one signature is defined and the use of signatures is activated, a pop-up button will appear in the Compose Message window to let you select which one you would like to use in the message that is being written. @ENDNODE @NODE "CO_F" "Editing filters" EDITING YOUR FILTERS The purpose of a mail filter is to process mail according to some criteria defined by the user. Whenever a mail matches a specified pattern, it can trigger certain actions. Currently SimpleMail's filters can only move emails to another folder. There isn't any fixed limit to the number of filters your can create, though. The list on the left shows the names of the filters defined so far. Click on a name to bring up its details on the right, on [New] to create a new filter, or use [Remove] to delete one of them. Please note that filters are executed in top-to-bottom order. [Add new rule] allows you to define a new rule, selecting what part of the e-mail should be scanned for a given search pattern. You can use as many rules as you want, and they accumulate in a "If all these rules are true for this email, then do this" fashion. To start with, you can select a header you want to be searched for a given pattern. You can choose either select "Sender" (to look in the "FROM:" field) or "Subject". (If you want to check a different header, select "Header" instead and then type the header that should be scanned, without any trailing colon.) Then, you must enter the search pattern you want to use. Alternatively, you can also enter a rule that will turn true if the email has attachments, or is matching a given status (read, forwarded, etc.). You don't need to type the whole pattern, as SimpleMail will use a pair of surrounding "#?" pattern matching characters there to look in the header for the string you have typed. Still, the search pattern may contain AmigaDOS wildcards such as ?, #?, (a|b) or [abc]. Please note that the search pattern [RED]#? will filter all messages beginning with R, E or D. To filter email coming from a mailing list (for example, a mailing list related to SimpleMail), you'd better use the search pattern "SimpleMail" (without the quotes) or have the filter compare the "Reply-To" field with the address of the mailing list, provided the mailing list sets this header correctly. Examples: Sender contains sebauer Subject contains simplemail-usr Header Reply-To contains plemail-usr Status is Replied Remember, case is not important here! [Apply now] Applies this filter immediately to the contents of the currently selected folder. This way you can see if your newly created filter works like it should before saving your settings. [ ] Apply on request If this option is activated, the filtering process will be started by clicking on the [Filter] button in the main window. This way you can also process old messages which do not necessarily have to be in the Incoming folder. [ ] Apply to new mails Activate this option to have all new mail processed by this filter. Processing will be initiated automatically after receiving new mail. [ ] Apply to sent mails Activate this option to have all sent mail processed by this filter. Processing will be initiated automatically after sending mail. [ ] Move to Folder Here you can instruct SimpleMail to move any email matching the above rules to another folder. Select the folder with the pop-up button at the right. @ENDNODE @NODE "AB_W" "Address Book" ADDRESS BOOK The main window for the address book looks like this: .--------------------------------------------------------------------. | @{" toolbar " LINK "AB_B" 0} | |____________________________________________________________________| .--------------------------------------------------------------------. | Name | Alias | Description | Address | |-----------|--------------|-------------------|---------------------| | Sebastian | sba | SimpleMail author | sebauer@t-online.de | | | | | | | | | | | | | | | | `--------------------------------------------------------------------' You can click and drag the column dividers to change their size, or the headers to reposition them. Double click on an entry to see or edit the information in the @{" edit address " LINK "EA_W" 0} window. An entry must contain at least the real name and the email address. The point of the Alias is to save typing; you can put a short nickname, or initials, into the "To" field of an email message and let SimpleMail to look in your addressbook for a likely candidate. For this to work, however, the alias obviously has to be unique for that entry. Individual entries can be arranged into groups, which are like subdirectories, used to keep the address book clearly arranged. Use @{" drag & drop " LINK "Drag" 0} to move an entry from one group into another. @ENDNODE @NODE "AB_B" "Address book - Toolbar" @TOC "AB_W" Address book - TOOLBAR [Save] Saves the address book to your hard disk. [Person] [Group] Both buttons open the @{" edit address " LINK "EA_W" 0} window to let you add a new entry to the address book. However, the appearance of the window depends on the type of entry, since the information stored is different. [Edit] This also opens the edit address window, to see or edit the information stored. Again, the layout depends on the type of entry. [Delete] Deletes the selected entry from the address book. [To:] Uses the selected entry as the primary recipient of a new email. [CC:] (NYI) Uses the selected entry as secondary recipient of a new email. [BCC:] (NYI) Uses the selected entry as recipient of a hidden copy of a new email. @ENDNODE @NODE "EA_W" "Entering addresses" @TOC "AB_W" Address book - ENTERING ADDRESSES In this window a single address book entry can be edited. According to the kind of entry (person or group) you will see a different set of editing fields. Click on [Ok] to accept the changes, or [Cancel] if you change your mind. PERSON ------ ---- Personal ----------------------------------------------------- Alias (applies to both person or group) An 'Alias' is a convenient short name that identifies the address book entry unambiguously. Its function is to save typing - you can start to type the alias into the TO: field of a message, and SimpleMail fills in the details when sending the message. Example: Seb Real Name The person's first name and surname. Example: Sebastian Bauer Description (applies to both person or group) Any comment you'd like to enter to describe the current entry. Homepage The URL for the person's homepage in the World Wide Web. SimpleMail can connect to this address via your browser, provided that OpenURL is installed. All you have to do is to click on the button to the right of the text field. Example: http:\//sf.net/projects/SimpleMail Date of birth The person's date of birth. Enter it in the format DD-MMM-YYYY. Example: 12-Dec-1967 Sex Additional info just in case the real name is ambiguous and/or your memory fails. :) Portrait Here you can select a picture (preferably a portrait) of the person. By using the datatypes library you may use any kind of picture format as long as you've installed the datatypes needed for displaying it. This picture will show up whenever you read a message written by this person. Download You can find a steadily growing number of portraits of other users of SimpleMail at the SimpleMail homepage. SimpleMail can access this data bank automatically; all you need to do is to input the name and/or the e-mail address, connect to the Internet and click the floppy disk button. SimpleMail starts by getting a list of available photos and searching it for the named person. If found, any information missing from the address book entry (currently, only name and e-mail address) is made good and the picture downloaded and saved in the gallery. If you want to add your picture to the collection, please visit http:\//simplemail.sourceforge.net/index.php?body=gallery and enter your details. Please note you will need a browser with HTTP upload support to be able to upload your photo. E-Mail addresses The internet addresses to use to send e-mail to this person. Example: sebauer\@t-online.de Sebastian.Bauer\@in.stud.tu-ilmenau.de ---- Private ------------------------------------------------------------- Street Street and house number of the postal address. Example: 43 High street City / ZIP City and (ZIP) postcode. Example: Shrewsbury SY1 3PE State / Country Example: Shropshire, England Phone number(s) One or more phone numbers (voice, FAX, mobile phone). Example: 08154711 ---- Work ---------------------------------------------------------------- Same fields as in "Private", with just the Title and Organization fields added. ---- Notes --------------------------------------------------------------- Enter here any info you would like to store about this person for an easy reference in the future. GROUP ----- Only the Alias and Description fields apply in this case. @ENDNODE @NODE "WR_W" "Compose Message window" WRITING MESSAGES This window will appear when you choose to write a new message or answer or forward an existing message. There isn't any fixed limit to the number of Compose Message windows you can open simultaneously, besides your ability to discern what is what under all that clutter. :) Above the large @{" text editor " LINK "EDIT" 0} field there are at least three header fields and a toolbar. From This field is automatically filled with your name and email address. You can use the pop-up button to select another account, in case you have defined several of them in the configuration. To Insert here the main recipient you wish to send this message to. You can use names or aliases from the address book or even full e-mail addresses in case the recipient does not exist in the address book. If you wish to enter several recipients, you shall separate them by inserting commas. To insert an address book entry, just drag that entry from the address book listview over the main window and drop it over this field (you could also open the full-view address book window and drag&drop entries from there, but why should you bother? :). Alternatively, you can also open the address book window, select and entry and then select the [To:] button, but remember this will spawn a new Compose Message window! If SimpleMail cannot find a name or alias you've inserted manually into this field, the screen will flash as soon as you press the . You can change an alias to an e-mail address manually by clicking on the [<] button to the right. Example: jdoe, boss\@work.whyme.com Subject What the mail is all about. As the mail is answered there will be a "Re:" inserted in front of the original subject, whereas if an email is being forwarded, a "(fwd)" will be added to the subject. The toolbar contains the following gadgets: Copy Places a copy of the marked text on the clipboard. Cut Cuts the marked text and saves it to the clipboard. Paste Inserts the text currently in the Clipboard at the current cursor position. Undo Undoes the last change made in the editor Redo Restores the change just undone with [Undo]. Attach Opens a file requester to let you select some file or files to attach to the message. Show Attachments Forces the Compose Message window to be more verbose about the internal structure of the message, showing a listview with the MIME type that SimpleMail has selected for your attachments, as well as other info and additional buttons. *Please note* this is still experimental, and the MIME type used for attachments is always "application/octet-stream". Encrypt Push this button if you want this message to be PGP encrypted. When you try to send this email, SimpleMail will list the PGP keys in your keyring to let you select the key that should be used. Also, if you have defined two or more signatures in the configuration and the signature usage is activated, an additional pop-up gadget will appear to let you select the signature you want to use with this message. At the bottom of the window you will see a row with four gadgets: Send now Prepares the message for sending, copies it to the Outgoing folder and tries to send the mail immediately. For this option to work correctly there must be a TCP/IP stack already running and online. Send later Prepares the message for sending and copies it to the Outgoing folder. Use this button when you're working offline. Hold The message will be prepared as described in [Send later] and copied to the Outgoing folder, but will be held back and NOT sent. Use this button for unfinished messages (e.g. if you'd like to make some additions to the email at a later time and you don't want it to be sent by mistake). Cancel Click here in case you've changed your mind. Beware, any information introduced so far in the window will be lost! @ENDNODE @NODE "EDIT" "Editor features" THE INTERNAL EDITOR SimpleMail uses the efficient MUI class "TextEditor.mcc" of messages. Many aspects of the editor such as key bindings, spell checking or fonts can be changed in the 'TextEditor' sheet of the @{" MUI configuration " LINK "MAM4" 0}. Albeit you can modify the key bindings, here is a list of the important default settings: go to the start of the text go to the end of the text go to the start of the line go to the end of the line previous page next page previous word next word cut copy paste undo redo suggest a word (not yet supported by SimpleMail) delete the character delete to start of line delete to end of line delete to start of word delete to end of word quit editor The TextEditor homepage can be found at: http:\//www.DIKU.dk/students/duff/TextEditor/index.html @ENDNODE @NODE "RE_W" "Read Message window" READING MESSAGES This window opens when you choose to read a message. There isn't any fixed limit for the number of Read Message windows you can open simultaneously. The window is laid out as shown: Menu bar: @{" Project " LINK "REM1" 0} @{" Mail " LINK "REM2" 0} .--------------------------------------------------. .--------. | @{" Toolbar " LINK "RE_B" 0} | | Sig. # | `--------------------------------------------------' `--------' .-------------------------------------------------------------. | | | Message headers | | | |-------------------------------------------------------------| | | | Message body | | | `-------------------------------------------------------------' .-------------------------------------------------------------. | Icons representing attachments | `-------------------------------------------------------------' Message headers The amount of information displayed in the header list for the selected message is set in the @{" configuration " LINK "CO04" 0}. If you want to copy some of the lines to the clipboard, click and drag with the mouse to highlight the lines -- the copy action is automatic and the highlighting disappears. You can also click on email addresses appearing here to automatically open a new Compose Message window with the selected address already filled in as recipient. Message body The largest part of the window shows the message body. Only text is shown here; if the message contains several parts (e.g. some text with a sound sample attached), some icons will appear at the bottom of the window to let you browse among them at your leasure. Navigation within the message is usually done with the Cursor up/down keys. You can also use Shift-Up/Down to jump up/down one page at a time. To copy part of the message to the clipboard, click and drag with the mouse to highlight the text. The copy action is automatic and the highlighting disappears. If you click on an e-mail address, a new Compose Message window opens and the address is automatically copied into the TO: header. A double click on a URL, be it either http:\// or ftp:\//, calls openurl.library (if present) to start your favourite browser and go to this address. Lastly, you can also use a mouse wheel to navigate the Read Message window. Icons representing attachments If the message being read contains attachments, the bottom part of the Read window will be occupied by icons representing those. Provided you have OS3.9 installed and DefIcons is running, double clicking an icon will trigger a certain action, for instance launch UnArc to uncompress an LhA archive. @ENDNODE @NODE "RE_B" "Read Message window - toolbar" @TOC "RE_W" Read Message window - TOOLBAR The toolbar in the Read Message window contains the following gadgets: Previous Displays the previous message, i.e. the one above the current message in the main window. Shortcut:

Next Displays the next message, i.e. the one below the current message in the main window. Shortcut: Save Opens a file requester to let you save on disk the part of the email that is currently being displayed. Delete Deletes the current message and loads the next one into the Read window. BEWARE: whilst both the "Delete" gadget and the "Message/Delete" menu item in the main window move the message to the "Deleted" folder, this gadget removes the message IMMEDIATELY, i.e. the message can not be recovered. Reply Use this to reply to the current message. The "Subject:" and "To:" fields are filled in automatically and the original message is quoted. Forward Use this to forward the contents of the message to another recipient. The subject and the message body are automatically copied and a new message header is created. The phrase set selected for forwarding defined in the @{" configuration " LINK "CO07" 0} is inserted appropriately. (NYI) @ENDNODE @NODE "REM1" "Read Message window - Project Menu" @TOC "RE_W" Read Message window - PROJECT MENU Project/About... Project/About MUI... Project/Quit They serve the same purpose as those in the Project menu in the main window. @ENDNODE @NODE "REM2" "Read Message window - Mail Menu" @TOC "RE_W" Read Message window - MAIL MENU Mail/Show raw format... This item will run Multiview to show the contents of this email in raw format, i.e. "as is". Print visible mailpart Will sent to the printer the currently selected part of the email in all its entirety, using datatypes. @ENDNODE @NODE "TR_W" "Mail Transfers" MAIL TRANSFERS When fetching or sending email, SimpleMail opens a tranfer window which allows you to have some control over the process. If preselection is enabled, SimpleMail displays a list of the messages available for download. Messages which exceed the pre-set maximum size will be listed. Two explanatory status symbols may appear next to the message -- a little trashcan means that the message will be deleted from the server, whilst the floppy disk icon indicates that the message will be downloaded. There are therefore the following possibilities: Diskette Trashcan Action ---------------------------------------------------------------------- yes yes The message will be downloaded and then deleted from the server. yes no The message is downloaded, but not deleted. no no The message remains in the server, and is not downloaded. no yes The message is deleted immediately! The preferred action for unsolicited commercial email. Meaning of the buttons: Ignore Clears both the diskette and trashcan icons for all selected messages, i.e. no action is done on them. Download Sets the diskette icon and clears the trashcan icon for all selected messages -> download, but leave on server. Delete Clears the diskette icon and sets the trashcan icon for all selected messages -> do not download, but delete from server! Download & Delete Sets both the diskette and trashcan icons for all selected messages -> download and then delete from server. Start The selection stage ends and the actual mail transfer begins. Abort The mail transfer is terminated immediately. [ ] Ignore not listed mails If this gadget is activated, all the messages not listed above will be left in the server and won't be downloaded. In the two lower status lines you can see how many bytes and how many messages have been transferred so far, and at what rate. @ENDNODE @NODE "Drag" "Drag & Drop" DRAG & DROP Like many modern programs, SimpleMail supports drag&drop. This means that you can grab an object with the left mouse button and drop it over another object by releasing the mouse button to trigger some operation. SimpleMail supports the following drag&drop operations: Source Destination Operation ----------------------------------------------------------------------- Message list Folder list Move messages Message list Address book Add new person to address book Folder list Folder list Rearrange folders Attachment list Attachment list Rearrange attachments Address book Address book Rearrange entries Address book Recipient field Get recipient from address book Address book Editor window Insert address in letter @ENDNODE @NODE "OPTI" "Startup options" STARTUP OPTIONS SimpleMail supports a couple of startup options which can be used from the Shell: MAILTO=address Creates a new message for the specified recipient on startup. You can enter an alias or the real name of a person that can be found in your address book, and let SimpleMail to fill the details for you. SUBJECT=subject Sets the subject for the new message. Examples: SimpleMail MAILTO sebauer@t-online.de SUBJECT "SimpleMail is cool!" SimpleMail MAILTO "Hynek Schlawack" SUBJECT "A love letter for you :)" SimpleMail MAILTO "Sebastian Bauer, Hynek Schlawack" SUBJECT Wonderful! @ENDNODE @NODE "AREX" "ARexx interface" AREXX INTERFACE SimpleMail sports an ARexx interface supporting a growing number of @{" commands " LINK "REX2" 0} which can be called through the ARexx port "SIMPLEMAIL.1". With the help of ARexx scripts, you can, for instance, let it do things automatically. Explanation for the syntax templates of the ARexx commands: /A The parameter is compulsory /K The parameter must be preceeded by the keyword /N Numerical argument or result /M Argument or result is a list of zero or more elements Be careful when passing arguments containing spaces. For instance, subj = 'Just testing' MAILWRITE MAILTO ralf@provider.de SUBJECT subj won't work, as there is a space in the variable. Better use this instead: MAILWRITE MAILTO ralf@provider.de SUBJECT "'subj'" @ENDNODE @NODE "REX2" "Supported ARexx commands" SUPPORTED AREXX COMMANDS GETSELECTED VAR/K,STEM/K => NUM/N/M Get positions of selected messages in the current folder. The message on top of the list gets position 0. HIDE Switches SimpleMail to iconified state. MAILWRITE MAILTO/K,SUBJECT/K Opens a new Write Message window using the recipient and subject provided, if any. MAILTO can be either an email address or an alias (or even group name) that can be found in the addressbook - SimpleMail will resolve aliases and group names as appropriate. MAINTOFRONT Brings the main window to the front. SETMAIL NUM/N/A Selects the current message in the current folder, NUM is 0 to n-1. SHOW Brings SimpleMail back from its iconified state into full view. @ENDNODE @NODE "TIPS" "FAQ" FAQ ---- Project Administration ---------------------------------------------- - Why do you write a completely new mailer instead of just take part on the YAM development, as YAM is under GPL? Because when we started developing SimpleMail, YAM wasn't under GPL and no one knew if it ever would be. As we are both students of computer sciences we decided to write our own mailer to gain some experience, and that's the reason why we are still developing it. Another reason is that it would probably be more work to rewrite YAM than to write our own mailer. And last but not least, it's fun to code and to create something new and own. - Will SimpleMail be as powerful as YAM? Yes, SimpleMail will have all the functions that YAM has, but less bugs and many new features you have missed all this time. - I don't like MUI, will you make a ReAction/ClassAct version? I think nobody thinks that MUI is perfect but there is a very big variety of public MUI classes that are vital for SimpleMail. However, much like SimpleMail is portable concerning platforms, it is also portable concerning the GUI, so there is a possibility that as SimpleMail reaches a more mature status (no alpha/beta anymore) we provide also a version based on other GUI engines. No promises, though. We hope that maybe one of you ReAction fans could do it when the time comes? - Will you include news support? (NNTP) Rather not, as we think that it is better to build two separate programs, because adding news support would be too inconvenient for users who don't want it. Wait for SimpleNews instead. ;) - Will you make a version for the AmigaDE? Yes, we hope so. - Will there be a port for Windows/MacOS/QNX/Linux/... ? We think that the source code of SimpleMail is quite portable, so it should be no problem to get it ported to other platforms. However, we cannot do everything, so once SimpleMail leaves the alpha/beta stages behind, feel free to contact us if you want to port it to your favourite platform. - Where can I download the sources? They are available on request from the @{" Authors " LINK INFO}. ---- Everyday use -------------------------------------------------------- - How can I snapshot the position and size of windows? Start the MUI settings interface by selecting "Settings/MUI...", then select the "Windows" section and make sure the third of the little system gadget buttons is activated. After saving the settings, every window will have an additional system gadget in the upper right corner -- one click on this gadget will snapshot the current size and position of the window for future sessions. - What does "NYI" mean? I find this here and there through the guide... Not Yet Implemented. This abbreviature is used to note something that still doesn't work as it should, or not at all. - How can I mark a mail as "Important"? NYI :) - Can I use PGP to sign/encrypt messages? You can encrypt messages with PGP 2.6.x, but you won't be able to edit the message once it gets queued to be sent. This problem will be addressed very soon. - Can I use SimpleMail as an external mailer from my browser? Yes. See the @{" Startup options " LINK "OPTI" 0} for more info. - How about implementing this and this and...? (David) Please bear with the developers. SimpleMail is only a hobby, and intelligent as they are, they're very busy students, also working in other projects :-) Currently SimpleMail is being developed at a slow but also continuous pace. Please be patient. :-) In the meantime, feel free to enter feature requests and report bugs at the SourceForge site. See the @{" Authors " LINK "INFO"} chapter for more info. - The style of this guide seems familiar... Well, I (David) used YAM.guide as inspiration. Why should I reinvent something so well done? :) Feel free to send suggestions to david@saug.org - This FAQ does not resolve my problem. Well, as long as your problem is related to SimpleMail ;) feel free to join the SimpleMail-Usr mailing list to get feedback from the authors as well as from other SimpleMail users. See the @{" Authors " LINK "INFO"} chapter for more information. @ENDNODE @NODE "TECH" "Technical" TECHNICAL File structure In the program directory the following files and directories can be found: SimpleMail The program itself SimpleMail.info The program icon SimpleMail.guide This documentation in AmigaGuide format .config The @{" configuration " LINK "CO_W" 0} file Images/ Icons used in the folder and message lists, the toolbars and the graphical smilies, all of them in IFF/ILBM format .portraits/ Pictures of people mentioned in the address book .folders/ Folder directory incoming/ The Incoming folder directory outgoing/ The Outgoing folder directory sent/ The directory for sent mail deleted/ The directory for mail marked for deletion folderX/ The @{" user-defined archive folders " LINK "FO_W" 0} (X is a number) .uidl. Used to @{" avoid duplicates " LINK "CO01" 0} .config Configuration of this folder .index Index of this folder's messages .addressbook.xml The @{" address book " LINK "AB_W" 0}, in XML format .signatures Your personal @{" signatures " LINK "CO08" 0} Each message is saved as a separate file of which the filename is constructed by joining the date the file was saved and a running number for that day. The mail status is saved as a suffix. For every folder there exists an index which contains the headers of every message in the directory. There is also a configuration file which holds the settings for that particular folder. @ENDNODE @NODE "INFO" "Further Information about SimpleMail" FURTHER INFORMATION ABOUT SIMPLEMAIL @{B}SimpleMail sources@{UB} are available on request from the authors: Sebastian Bauer Hynek Schlawack Developers wanting to join the effort are welcome! The @{B}latest version@{UB} is always available at http:\//www.simplemail.de.vu If you want to discuss SimpleMail related issues with other users, by all means join the @{B}SimpleMail mailing list@{UB} for users. To subscribe, send a mail to SimpleMail-usr-request\@freelists.org with "subscribe" (without the quotes) as the subject. Your subscription request will be processed ASAP. @{B}Bug reports@{UB} can be entered from here: http:\//sourceforge.net/tracker/?group_id=15322&atid=115322 @{B}Feature requests@{UB} have also a place at http:\//sourceforge.net/tracker/?atid=365322&group_id=15322&func=browse Please take some time to browse the bugs already reported to avoid duplicated reports. Ditto for feature requests! :) The @{B}SimpleMail User Gallery@{UB} is located at http:\//simplemail.sourceforge.net/index.php?body=gallery @ENDNODE @NODE "CRED" "Credits" Authors @{b}Sebastian Bauer@{ub} @{b}Hynek Schlawack@{ub} Additional programming advice @{b}Jörg Strohmayer@{ub} Icon Artists Homepage banners provided by @{b}Richard "zeg" Wagenführer@{ub} Toolbar icons & additional banners provided by @{b}Martin Merz@{ub} Smiley gfx courtesy of @{b}Richard Kapp@{ub} SimpleMail.guide @{b}David Rey @{ub} based upon the YAM 2.2 guide by @{b}Marcel Beck@{ub} Programmers @{b}Stefan Stuntz@{ub} (MUI) @{b}Allan Odgaard@{ub} (TextEditor.mcc, BetterString.mcc) @{b}Carsten Scholling@{ub} (NList.mcc, NListtree.mcc) @{b}Marcin Orlowski@{ub} (Popplaceholder.mcc) And all the people who keep submitting bug reports! @ENDNODE @NODE INDEX "Index" @{CODE} A... @{" Address Book " LINK AB_W} @{" Address book - Toolbar " LINK AB_B} @{" ARexx interface " LINK AREX} B... @{" Bug reports " LINK INFO} C... @{" Compose Message window " LINK WR_W} @{" Configuration " LINK CO_W} @{" Configuration - Accounts " LINK CO01} @{" Configuration - Phrases " LINK CO07} @{" Configuration - Reading " LINK CO04} @{" Configuration - Reading HTML " LINK CO06} @{" Configuration - Reading plain " LINK CO05} @{" Configuration - Receive mail " LINK CO02} @{" Configuration - Signatures " LINK CO08} @{" Configuration - User " LINK CO00} @{" Configuration - Write " LINK CO03} @{" Credits " LINK CRED} D... @{" Drag & Drop " LINK DRAG} E... @{" Edit Folder " LINK FO_W} @{" Editor features " LINK EDIT} @{" Entering addresses " LINK EA_W} F... @{" FAQ " LINK TIPS} @{" Filters, Editing " LINK CO_F} @{" Further Information about SimpleMail " LINK INFO} H... @{" History " LINK HIST} I... @{" Installation " LINK INST} @{" Introduction " LINK INTR} L... @{" Legal issues " LINK COPY} M... @{" Mail Transfers " LINK TR_W} @{" Main window " LINK MA_W} @{" Main window - folder list " LINK MA00} @{" Main window - Folder Menu " LINK MAM2} @{" Main window - message list " LINK MA01} @{" Main window - Message Menu " LINK MAM3} @{" Main window - Project Menu " LINK MAM1} @{" Main window - Settings Menu " LINK MAM4} @{" Main window - toolbar " LINK MA02} @{" MUI " LINK MUI} Q... @{" Quickstart " LINK TUTO} R... @{" Read Message window " LINK RE_W} @{" Read Message window - toolbar " LINK RE_B} @{" Requirements " LINK REQS} S... @{" SimpleMail - English documentation " LINK MAIN} @{" Sources, how to get them " LINK INFO} @{" Startup options " LINK OPTI} @{" Status Icons " LINK MA0S} T... @{" Technical " LINK TECH} @{BODY} @ENDNODE @NODE "HIST" "History" HISTORY 0.13 (thirteenth alpha) - released on 2001/12/07 - Included a real manual at last. Thanks to David Rey! - SMTP over SSL. - POP3 connections can be made secure with the STLS command now. (RFC 2595) - Primitive ARexx-port. - Support for playing sounds. - Taglines. - Folders holding unread mails are hilighted now. - Localisation. 0.12 (twelfth alpha) - released on 2001/11/11 - Fix for the MUI exploit where pipes could be used for malicious purposes combined with escape sequences - Messages can now be encrypted, again with PGP 2.6.x. - The columns in the message list can now be turned on/off on an individual basis; their status is saved via "Save Prefs" - Better email address completer - A small menu in the Read Message window makes it possible to see the message in raw format. - The mouse wheel support in the Read Message window is now more tolerant. - Icons for attachments are better identified now if you have OS3.9 and DefIcons is running: you can double-click an icon to trigger  an action, for instance launching UnArc to extract an archive as used by the default DefIcons config. - You can now print messages and plain text attachments. 0.11 (eleventh alpha) - released on 2001/09/23 - UIDL POP3 command support, so mails won't be downloaded twice - Improved startup time - Several bugfixes 0.10 (tenth alpha) - released on 2001/09/10 - Configurable headers for the Read window - Can read message/rfc822 content type properly - Can decrypt encrypted PGP messages using PGP 2.6.x - Minor improvements - Improved filters - Wordwrapping for composed messages 0.9 (ninth alpha) - released on 2001/09/03 - Improved addressbook - Predefined text phrases - Periodical mail download - Now requires the popplaceholder MUI custom class 0.8 (eighth alpha) - released on 2001/08/01 - SSL support for POP3 servers. Requires AmiSSL. - POP3 servers can be individually deactivated, and they are ignored. - Menu bar in the main window; needs to grow though. - A new Read setting, so that smilies can be replaced with images (images created by Richard Kapp). - Groups can be deleted now 0.7 (seventh alpha) - released on 2001/06/29 - The attachment icons required OS3.5+ to be displayed - Signature support - Configurable greetings text when writing new mails - The fonts and colors for reading email can be configured now - Hierarchical folders and folder images 0.6 (sixth alpha) - released on 2001/06/05 - Improved e-mail account configuration (multiple SMTP servers) - Can log into POP3 servers before sending email - The address book is now stored in XML format - Initial filter support - New folders can be created within the GUI, and their settings are stored immediately. - Lots of bugfixes 0.5 (fifth alpha) - released on 2001/02/25 - Added email preselection. - Supports 8-bit MIME email (if a SMTP server doesn't support them, they will be encoded on the fly). - Improved the Read Message window, making extensive use of the SimpleHTML engine. - Button images are cached now - Added support for the new SimpleMail User Gallery 0.4 (fourth alpha) - released on 2001/02/25 - Multiple POP3 servers - Images for replied/forwarded emails - Faster QP/Base64 routines - Some images have been redrawn - Fixed problems with special chars in real names - Many other bugfixes 0.3 (third alpha) - released on 2001/02/05 - Added a "Forward" button - The main window has two different views, which are easily switchable. - Improved Compose Message window (got some images) - The "To" button in the address book works correctly now. - Group mails (mails with multiple recipients), mails with attachments and important mails can now be easily identified. - Added a small context menu for the mailtree list; mails can now be marked, and forced to remain held. - Added the possibility to use your IP addresss as your domain in the HELO/EHLO dialog (no X-Authentification warning headers anymore). - Added SMTP AUTH according to RFC 2554. - It is now possible to specify which port you would like to use on the servers instead of the default 25 and 110. - Other smaller improvements and bugfixes 0.2 (second alpha) - released on 2001/01/14 - Buttons have now images. - Can display HTML email now, using the SimpleHTML engine. - Index files for folders - Mails can have different statuses (new, read, pending, sent). - Support for mail threads. - The address book is now more complete - Bugfixes and smaller enhancements. 0.1 (first alpha) - released on 2000/12/24 - Initial alpha. @ENDNODE @NODE "SimpleHTML" SimpleHTML is a tool by Sebastian Bauer that allows you to browse HTML documents offline. SimpleHTML supports only a little subset of the HTML tags, but it is powerful enough to browse most HTML documentation, for example. The SimpleHTML engine is already built-in in SimpleMail to allow you to easily read HTML mail, i.e. you don't need to go and install SimpleHTML separately. Still, if you want to give SimpleHTML a try (which is probably a good idea anyway :), the latest version should be always available in Sebastian's homepage: http:\//home.t-online.de/home/sebauer/ @ENDNODE