@database YAM.guide @master yamdev:YAM_e.guide @$VER: YAM.guide 2.0 (11.10.98) @author "Marcel Beck" @(c) "" @index HeddleyAutoIndex @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "YAM - English documentation" @{b}============================================= Y A M (Yet Another Mailer) VERSION 2.0 =============================================@{ub} Prerelease 6 © 1998 by Marcel Beck @{" Introduction    " link "INTR" 0} - About YAM @{" Requirements    " link "REQS" 0} - System requirements and software needed @{" Copyright       " link "COPY" 0} - Legal stuff @{" Installation    " link "INST" 0} - Installing YAM on a hard disk @{" Quickstart      " link "TUTO" 0} - Getting YAM 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 YAM to suit your own needs @{" 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 @{" Search          " link "FI_W" 0} - Finding a particular message @{" Users           " link "US_W" 0} - Defining multiple users @{" Starting options" link "OPTI" 0} - Tooltypes and shell options @{" ARexx Interface " link "REXX" 0} - Controlling YAM from within other programs @{" Tips & tricks   " link "TIPS" 0} - Some useful hints @{" Technical stuff " link "TECH" 0} - About YAM's way of archiving messages @{" What is e-mail? " link "MAIL" 0} - Introduction to electronic mail @{" Headers         " link "HEAD" 0} - About the structure of a mail header @{" Mail protocols  " link "PROT" 0} - Some information about SMTP and POP3 @{" What is MIME?   " link "MIME" 0} - About MIME @{" PGP             " link "PGP" 0} - Encrypting e-mail using public keys @{" Netiquette      " link "NETI" 0} - How to behave to be liked by your fellow users @{" New functions   " link "Changes/MAIN" 0} - What's new in YAM 2.0 @{" The future      " link "PLAN" 0} - Planned improvements @{" Author          " link "INFO" 0} - How to contact the Author @{" Thanks to       " link "CRED" 0} - Those who supported development of YAM 2.0 @endnode @node "INTR" "Introduction" @{b}@{u}INTRODUCTION@{ub}@{uu} YAM (Yet Another Mailer) lets you send and receive @{"electronic mail" link "MAIL" 0} over the Internet and maintain archives of messages in your computer. The idea for YAM came to me in 1995, when I first tried using E-mail. The programmes available then were either powerful but complicated to configure, or else used a graphical interface but with few functions. The goal therefore was to program a cross between AdMail and AirMail, with a few ideas from Pegasus Mail. The unexpectedly enthusiastic response to Version 1.2 led to a steady development of YAM culminating in this Version 2.0, which is much more than just an upgrade for the popular Version 1.3.5. @{b}@{u}Features of YAM@{ub}@{uu} Straightforward @{"installation" link "INST" 0} and @{"configuration" link "TUTO" 0}, taking only a few minutes. Easy operation using buttons, menus or keyboard. Context-sensitive online Help using help bubbles and AmigaGuide. Provision for up to 16 different @{"Users" link "US_W" 0}, who can each have their own folders and define their own preferences. Up to 96 @{"user-defined folders" link "CO03" 0}, which can be compressed or have passwords set. Hierarchical @{"Address book" link "AB_W" 0} with groups and distribution lists as well as comprehensive descriptions for each entry. Freely customisable interface, thanks to @{"MUI" link "MUI" 0}. A choice of MagicWorkbench icons or @{"NewIcons" link "NEWI" 0}. Inbuilt @{"POP3" link "PROT" 0} Client, which can check up to 16 different post servers in one connection and also allows prior selection of the messages to be downloaded. Messages can be written or answered offline and then sent to the post server using the inbuilt @{"SMTP" link "PROT" 0} client. Powerful @{"text editor" link "EDIT" 0} for writing E-mails providing several type styles, @{"glossary" link "DI_W" 0} and spellchecking. Comprehensive @{"search capabilities" link "FI_W" 0}, for example a full text search through all articles using a single query. Automatic sorting of the post with up to 100 @{"filters" link "CO04" 0}. Archiving or diversion of specified articles, automatic replies or the deletion of advertising are just a few of the possible applications of the filters. Support for @{"PGP" link "PGP" 0} encryption and signing of messages as well as read and receive authentication. Inbuilt support for UUencode and @{"MIME" link "MIME" 0} for sending and receiving binary data and automatic recognition of over 20 datatypes. Event-sensitive starting of @{"macros" link "CO14" 0} and comprehensive @{"Arexx" link "REXX" 0} support. Localised for many languages. @endnode @node "REQS" "Requirements" @{b}@{u}REQUIREMENTS@{ub}@{uu} @{u}Hardware@{uu} - Amiga Computer - at least 2 MB RAM - 68020 CPU or higher @{u}Software@{uu} - Kickstart 3.0 or higher - Workbench 3.0 or higher - @{"MUI 3.8" link "MUI" 0} or higher - AmiTCP-compatible Stack (AmiTCP, Miami or TermiteTCP) - optional: XPK-module for compression of articles - optional: PGP 2.6 or 5.0 for encryption and signing messages - optional: Archiver for compressing folders, @{i}e.g.@{ui} LhA - optional: Program for spell-checking, @{i}e.g.@{ui} AlphaSpell @endnode @node "COPY" "Legal issues" @{b}@{u}LEGAL STUFF@{ub}@{uu} @{u}Copyright notice@{uu} The copyright for this software belongs to Marcel Beck. This archive may be distributed only if complete and unchanged. In particular the documentation and this copyright notice must not be removed. @{u}Distribution@{uu} This software is freely distributable, on the following conditions: - Each distribution must include all data contained in this archive. - Distribution via BBSs, internet, software libraries such as the Fred Fish disk collection or the Aminet CD-ROMs and similar electronic media is allowed. - Disk magazines and any other retailers who charge an extra fee for data transmission or copying are not allowed to distribute this software without the author's explicit permission. @{u}Disclaimer@{uu} By using this program the user accepts full liability for any damage that could possibly be caused by its usage or misuse. The author of this software cannot be held responsible for any damage. @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 "NEWI" "NewIcons" @{b}@{u}NewIcons@{ub}@{uu} The NewIcons provided with Yam were drawn by Ash Thomas. I have provided a complete set with program icons, appicons and toolbar icons all drawn in the standard 32 colour palette, this means that you wont loose any pens. The icons do get updated, so if you email me I will send you the latest version. Suggestions and constructive criticism is also appreciated. You can also catch me on IRC (IRCNet and ANet) on channel #amiga as Abstruse. Many thanks to Paul "lanky" Demark for all the emails, irc chats, suggestions and improvements, I have also added status newicons (the little icons) which complete the set. Before I get swamped with emails asking how I got a pattern into the window borders on the preview picture: check out Birdie (currently 1.5) on aminet, or at http://www.vgr.com/birdie/ This is version 0.8 of the icons (they aren't complete, as yam isnt complete either), but this version is much better than v7. The icons dont move down and right a pixel, they animate just like newicons do. I have also drawn them so you can turn off text (via mui) and they will stay the same size. Text wasn't needed (icons are suppose to replace text) and they look very professional now. email: ash@absurd.demon.co.uk url: www.absurd.demon.co.uk @endnode @node "INST" "Installation" @{b}@{u}INSTALLATION@{ub}@{uu} @{u}Installation by using the installer@{uu} Open the 'Install' folder, double-click the icon 'English' and follow the instructions given by the installer. If you have already installed an older version of YAM please restart your Amiga after the installation of YAM 2.0. @{u}Manual installation@{uu} If you don't have the Amiga installer or for some reason you are unable or unwilling to use it, proceed as follows: - Create a directory for YAM on your hard disk. - Copy the files 'YAM', 'YAM_english.guide' and '.taglines' as well as the directories 'Icons' and 'Rexx' to this new directory. Rename the guide file to 'YAM.guide' - Copy the English catalog file 'YAM.catalog' to the directory 'LOCALE:Catalogs/English' - Copy all MUI-libraries (mcc/mcp) from the directory 'MUI' to 'MUI:libs/MUI' - Create an entry in your 's:user-startup' assigning 'YAM:' to the directory you have created for YAM 2.0, for example 'Assign YAM: Work:Internet/Yam' - Reboot your Amiga @endnode @node "TUTO" "Quickstart" @{b}@{u}QUICKSTART@{ub}@{uu} This chapter is meant to be a step-by-step guide to the way YAM 2.0 works. It is assumed that you already have installed YAM 2.0 on your system and that you're using Miami as your TCP/IP software. @{fg shine}1.@{fg text} Get the following information from your internet provider: - your e-mail address - the internet address of the mail-server (so called POP- or SMTP-server) - your password, required to log in on the mail server As an example here's the setup for a fictitious user named 'John Doe' living in Britain. His e-mail address is 'jdoe@provider.uk' and the address of his mail-server is 'mail.provider.uk'. His password is 'nguz56'. @{fg shine}2.@{fg text} Start YAM by double-clicking its icon. After the copyright window has closed, the main window should open with two listings (folder list & message list) and a row of buttons. @{fg shine}3.@{fg text} The program must be configured before you can do anything else. Choose 'Configuration' from the 'Settings' menu or simply click the button with the question mark to open the configuration window. The sheet which then appears is called 'First Steps' and this is where you must enter the information needed for data transfer. Following our example this is: Real Name: John Doe Email address: jdoe@provider.uk POP3 server: mail.provider.uk Password: nguz56 Time zone: GMT For security reasons the password textfield only shows stars, one for each character you type. If daylight saving time applies to you at the time of installation switch on the adjustment for it (right beneath the time zone). @{fg shine}4.@{fg text} YAM allows you to define a text passage which will be appended to all of your e-mail as a complimentary closing phrase. To define it you have to click on 'Write' in the list on the left hand side of the configuration window. On the page appearing now select the text field 'Greetings phrase', delete the original text by hitting RAmiga-X and insert something such as: Kind regards,\\n Joe The control string \\n forces a new line after the word 'regards'. @{fg shine}5.@{fg text} Save the settings now by clicking on [Save]. YAM now has sufficient data to allow you to write your first message. @{fg shine}6.@{fg text} After saving the settings you`re back in the main window. Click the button 'Write' (sixth button from the left) or choose 'New' from the 'Message' menu. The editor window will open. Insert the e-mail address of the recipient into the 'To' textfield (like 'jdoe@provider.uk'). Normally of course you would put someone else's address, but right now you want to test the system, so put your own address in instead. Insert two or three words to indicate the subject into the 'Subject' textfield. ('Test' will do nicely for this one!) Now click in the large blank area and type the actual message. If you were using YAM in a normal way, and wish to send copies (including hidden copies) to anyone, this can be done by clicking on `Options', thus activating the third of the three sheets (Message, Attachments, Options) of the Write window. @{fg shine}7.@{fg text} Assuming you are not currently online (Miami is not running), click on [Send later]. This sends the message to the 'Outgoing' folder as opposed to transmitting the message right away [Send now]. @{fg shine}8.@{fg text} Now start Miami and connect to the internet. Open the 'Outgoing' folder by clicking on 'Outgoing' in the folder list contained in the main window. Send the message by clicking the 'Send' button (fifth button from the right hand side). The transfer status window will appear and report progress as YAM logs in on the mail-server and sends the message. @{fg shine}9.@{fg text} As you`ve probably noticed the mail has vanished from the 'Outgoing' folder. Don`t panic! It has been moved to the 'Sent' folder. The letter symbol in the list has a little stamp on it now, which means that the message has been sent successfully. @{fg shine}10.@{fg text} When you double-click the message the read 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 YAM and contain data needed for mail transfer (the so-called "headers"). @{fg shine}11.@{fg text} Since you`ve written the mail to yourself you should start looking for new mail now. Click the read window to the background or close it, then click on the 'Get' button (sixth button from the right hand side). @{fg shine}12.@{fg text} The transfer status window you saw before opens again and you can watch how YAM downloads your mail from the mail-server. Provided that everything runs as it should a requester will open up with the message that you have received new mail. You can read the mail in the 'Incoming' folder. If you`ve made it this far without major problems you now know the essential functions of YAM. For further explanations and more detailed information on single topics please read the following chapters. @endnode @node "MA_W" "Main window" @{b}@{u}MAIN WINDOW@{ub}@{uu} YAM's main window is laid out as shown: Menu bar: @{"Project" link "MAM1" 0} @{"Folder" link "MAM2" 0} @{"Message" link "MAM3" 0} @{"Settings" link "MAM4" 0} @{"Scripts" link "MAM5" 0} ________________________________________________________ | @{"Toolbar" link "MA02" 0} | |________________________________________________________| | | | | | @{"Message list" link "MA01" 0} | | @{"Folder list" link "MA00" 0} | | | | This shows the contents | | | of the selected folder | | | | |_________________|______________________________________| |________________________________________________________| ^ status bar @endnode @node "MA00" "Main window - folder list" @toc "MA_W" @{b}@{u}Main window - FOLDER LIST@{ub}@{uu} The following four standard 'mailbox' folders are always present: @{fg shine}Incoming@{fg text}: 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, by the use of @{"filters" link "CO04" 0}. @{fg shine}Outgoing@{fg text}: This mailbox holds the messages which you have written and which you intend to transmit when you are next online. @{fg shine}Sent@{fg text}: Here you can see the messages which you have already sent. Messages are moved to this box (from 'Outgoing') when they are actually transmitted. Again you can use @{"filters" link "CO04" 0} to transfer sent messages to other folders. @{fg shine}Deleted@{fg text}: This box contains messages marked for deletion. Normally messages are not actually deleted from the hard disk until you quit YAM. This allows you to recover messages deleted earlier in the session. In the @{"Configuration" link "CO03" 0} you can create up to 96 more folders to hold messages which you have received or sent, so you can arrange the mails in whatever way you like. The folder list can have up to five columns: Name of the folder, number of messages (in total, new or unread) as well as the size of the folder in bytes. Which of these columns is actually shown depends on how you set up @{"Lists" link "CO09" 0} in the configuration. The column widths can be adjusted by using the mouse to drag the thin lines separating the column headings in the folder list itself. The order of the columns can be modified by moving the column headers. If the name of the folder is shown in white, this means that the box contains new or unread mail. When the numerical indication is missing, this shows that the folder has not been scanned (which saves storage space). When the folder name is shown centred between two thick bars, it is not an actual folder but rather is acting as a divider to show the grouping of your user-defined folders. To see the contents of any particular folder click on that row in the folder list. The message list appears at the right, maybe after a slight pause. @endnode @node "MA01" "Main window - message list" @toc "MA_W" @{b}@{u}Main window - MESSAGE LIST@{ub}@{uu} The message list can have up to eight columns, the contents being set in the @{"Lists" link "CO09" 0} configuration. @{fg shine}Message status@{fg text}: An icon showing the @{"status" link "MA0S" 0} of the message (new, unread, read, etc.) @{fg shine}Sender/Recipient@{fg text}: E-mail address or, in this case, the name of the sender or recipient of the message, depending on the type of mailbox. When the message was sent to several people at the same time a little icon appears in front of the name, showing three tiny heads. @{fg shine}Subject@{fg text}: Subject of the message. When the messages are sorted according to the subject, the prefixes Re: and AW: are ignored. @{fg shine}Date@{fg text}: The date of posting of the message, 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}. @{fg shine}Filename@{fg text}: Name of the file attached to the message. @{fg shine}Reply address@{fg text}: Contents of the Reply-To: header in the message. If this is missing, then the sender's address is given (the From: header). @{fg shine}Size@{fg text}: Size of the message in Bytes. 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 be modified by moving the column headers. A little arrow in the 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 property. A second click on the same heading reverses the order of sorting (Z->A instead of A->Z). These changes are only temporary; if you want to make them permanent you must use the configuration settings. A double click on an entry in the list opens a @{"Read 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 down (holding the left mouse button) to mark a block of messages. Then click and drag 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" @{b}@{u}STATUS ICONS@{ub}@{uu} @{fg shine}Message status Icon@{fg text} @{b}New messages@{ub} back of envelope with an 'N' New, unread message downloaded the last time mail was collected. @{b}Unread messages@{ub} back of sealed envelope Messages which have not yet been read. @{b}Read messages@{ub} opened envelope Messages which have already been read. @{b}Answered messages@{ub} opened envelope with an 'R' Messages which have already been answered @{b}Forwarded messages@{ub} opened envelope with an 'F' Messages which have been forwarded to a third party. @{b}Unsent messages@{ub} front of envelope Messages in 'Outgoing', ready to send @{b}Held messages@{ub} envelope (front) with an 'H' Messages in 'Outgoing' which need further work before sending. @{b}Sent messages@{ub} stamped envelope Messages which have already been sent. @{b}Failed messages@{ub} torn envelope Messages which failed, due to an error encountered in transmission. @{b}Messages with attachment(s)@{ub} paper clip Messages with one or more files attached. @{b}Locked messages@{ub} Key Messages which have been encrypted with PGP @{b}Status report@{ub} little sign with the letter 'i' Automatic reply from the mail server or the recipient's mail program @{b}Important message@{ub} exclamation mark Message marked as important by the sender @endnode @node "MA02" "Main window - toolbar" @toc "MA_W" @{b}@{u}Main window - TOOLBAR@{ub}@{uu} The toolbar gives you easy access the most frequently used functions. ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ | 1 | 2 | 3 | 4 | 5 | | 6 | 7 | 8 | | 9 |10 | |11 |12 |13 |14 | |___|___|___|___|___| |___|___|___| |___|___| |___|___|___|___| The table shows the equivalences between buttons (position and label), keyboard shortcuts and menu commands. You can choose whether to show icons, labels or both on the buttons: see @{"Settings/MUI" link "MAM4" 0}. @{fg shine} Button Label Shortcut Menu command @{fg text} 1 [Read] @{"Message/Read" link "MAM3" 0} 2 [Edit] E @{"Message/Edit" link "MAM3" 0} 3 [Move] V @{"Message/Move" link "MAM3" 0} 4 [Delete] D, @{"Message/Delete" link "MAM3" 0} 5 [GetAdd] T @{"Message/Save Address" link "MAM3" 0} 6 [Write] W @{"Message/Write" link "MAM3" 0} 7 [Reply] R @{"Message/Reply" link "MAM3" 0} 8 [Forward] O @{"Message/Forward" link "MAM3" 0} 9 [Get] G @{"Folder/Get new mail" link "MAM2" 0} 10 [Send] S @{"Folder/Send queued mail" link "MAM2" 0} 11 [Filter] I @{"Folder/Filter" link "MAM2" 0} 12 [Find] F @{"Folder/Find" link "MAM2" 0} 13 [Addr] A @{"Settings/Address book" link "MAM4" 0} 14 [Config] C @{"Settings/Configuration" link "MAM4" 0} @endnode @node "MAM1" "Main window - Project Menu" @toc "MA_W" @{b}@{u}Main window - PROJECT MENU@{ub}@{uu} @{u}Project/About@{uu} Shows @{"Copyright Information" link "COPY" 0} for this program. @{u}Project/About MUI@{uu} Shows copyright and version information for @{"MUI" link "MUI" 0}. @{u}Project/Check Version@{uu} Fetches information about the newest version of YAM from the YAM homepage. Make sure that you are online before calling this function. YAM then tells you whether there is an update for your version. The button [To Homepage] will then start an @{"ARexx script" link "CO14" 0} which connects your browser to the YAM homepage. @{u}Project/Restart@{uu} Forces a "warm start" of YAM. In this way when there are several defined @{"users" link "US_W" 0} you can re-enter with another username. @{u}Project/Hide@{uu} This switches the program to iconified mode. The icon shows the @{"status" link "MA0S" 0} of the incoming mailbox (empty, old mail, new mail). The periodic mail check and any @{"ARexx" link "REXX" 0} scripts remain active. The appearance of the mailbox icons can be changed, if you want. All you have to do is to put new files @{b}new.info@{ub}, @{b}old.info@{ub}, @{b}empty.info@{ub} and @{b}check.info@{ub}into YAM's Icons directory. @{u}Project/Quit@{uu} Exit from YAM. @endnode @node "MAM2" "Main window - Folder Menu" @toc "MA_W" @{b}@{u}Main window - FOLDER MENU@{ub}@{uu} @{u}Folder/Select@{uu} » All|None|Toggle Selects all messages in the current folder, clears any selections or toggles them (@{i}i.e.@{ui} exchanges selected and unselected items). @{u}Folder/Search@{uu}... Opens the @{"Search window" link "FI_W" 0}, which enables you to find any particular message. @{u}Folder/Filter@{uu} Applies the user-defined @{"Filter" link "CO04" 0} to all messages in the current folder. Filters are of the form 'On @{i}query@{ui}, take @{i}action@{ui}', the options being defined in the configuration settings. @{u}Folder/Empty trash@{uu} Actually deletes the messages in the 'Deleted' folder. @{u}Folder/Update index@{uu} Scans the directory for the current folder and builds a new index file. Normally YAM updates the index file automatically, as needed. However it can be useful to update the index after a crash or in the event of a problem. @{u}Folder/Flush indices@{uu} Removes the indices of the user defined folders, which is helpful if you're low on memory. If you change to one of these folders at a later time, the index is reloaded from the hard disk. @{u}Folder/Import@{uu} Allows the import of a mail file created by a different application. The file must be in standard UUCP mailbox format, such as is generated by external mail-server client programs like AmiPOP or IMAP clients. Such a file may contain several messages which are identified by their 'From: ADDRESS DATE' headers. @{u}Folder/Export@{uu} Saves all the messages in the current folder to a single file, so that they can be read by a different Mailer program. (See also under Import.) @{u}Folder/Send queued mail@{uu} Transmits all messages in the Outgoing mailbox (except for those which are on 'Hold'). @{u}Folder/Exchange mail@{uu} First fetches new mail from your mail-server and then sends the messages in the outgoing mailbox. This simply combines the actions of 'Get new mail' and 'Send queued mail'. @{u}Folder/Get new mail@{uu} Attempts to connect to the mail-server, checks whether there is new mail waiting and if so downloads it to the 'Incoming' mailbox. If you have specified more than one @{"POP3 server" link "CO02" 0}, they will each be tested in turn. @{u}Folder/Check single account@{uu} If you have set up several POP3 servers, you can use this function to check any one single server. @endnode @node "MAM3" "Main window - Message Menu" @toc "MA_W" @{b}@{u}Main window - MESSAGE MENU@{ub}@{uu} @{u}Message/Read@{uu} Loads the selected Message into the @{"Read window" link "RE_W" 0}. @{u}Message/Edit@{uu} Allows you to edit a message you have composed earlier. @{u}Message/Move@{uu} Moves one or more Messages into another folder. You can also do this by dragging the message(s) from the message list into the @{"folder list" link "MA00" 0} and dropping them onto the desired destination. @{u}Message/Copy@{uu} Copies one or more messages to another folder; the copies are identical to the original apart from their names. @{u}Message/Delete@{uu} Moves one or more messages to the 'Deleted' folder (from which they can be recovered if needed). If you want messages actually to be deleted immediately then check "Remove messages immediately" in the @{"Miscellaneous" link "CO15" 0} configuration settings. The key works as a shortcut for Menu/Delete, while forces immediate deletion from the hard disk, regardless of configuration settings. @{u}Message/Print@{uu} Sends the readable part (text and headers) of the message(s) to the printer. @{u}Message/Save@{uu} Saves the text (and headers) of one or more messages, creating a separate file for each message. Should you want to save the messages in their original (UUCP) format, use @{"Folder/Export" link "MAM2" 0}. @{u}Message/Attachments@{uu} » Save Saves the attached files from one or more messages in a directory you select. @{u}Message/Attachments@{uu} » Crop Deletes, without further warning, the MIME attachments from one or more messages, in order to save storage space. A notice about the deleted data is written into any message cropped in this way. @{u}Message/Export@{uu} Saves one or more messages to a single file, so that they can be read by a different Mailer program. (See also under Import.) @{u}Message/Write@{uu} Opens the @{"Write window" link "WR_W" 0}, in which you can compose a new message. @{u}Message/Reply@{uu} Use this to reply to a message which someone has sent to you. Subject and recipient headers are filled in automatically and the original text is quoted. It is also possible to select several messages which will all be quoted in the same reply and sent back to the original senders ("Multi-reply"). @{u}Message/Forward@{uu} This lets you send on the contents of an e-mail to another recipient. The subject and the body text are copied across whereas a new message header is created. At the beginning and the end of the quoted text YAM inserts the phrases for forwarding, which you can define in the @{"Reply" link "CO07" 0} settings in the configuration. You can also select multiple messages, in which case these are combined into a single forwarded message ("Multi-forward"). @{u}Message/Bounce@{uu} This lets you send on a message to another recipient, with no changes at all. Only the To: field of the header is changed and a couple of Resent: fields are added. The phrases defined for forwarded messages are not used here. @{u}Message/Save address@{uu} The address of the sender of the selected message (or the recipient, depending on which mailbox is in use) is added to your @{"address book" link "AB_W" 0}. If multiple messages are selected or if a message has several recipients, then you get the option of creating a new distribution list. @{u}Message/Set status@{uu} » unread|read|hold|queued This changes the status of one or more messages. Thus you can release held messages in the Outgoing mailbox or mark unread messages as read. @{u}Message/Change subject@{uu} This alters the subject of one or more messages, so you can amend irrelevant Subject: fields in messages you have received. To preserve the capability of tracing a thread back, the original subject is saved in the message header as X-Original-Subject. @{u}Message/Send@{uu} Makes a connection to the mail server and transmits the selected messages. If you want to send all the messages in the Outgoing folder, then it is better to choose @{"Folder/Send queued mail" link "MAM2" 0}. @endnode @node "MAM4" "Main window - Settings Menu" @toc "MA_W" @{b}@{u}Main window - SETTINGS MENU@{ub}@{uu} @{u}Settings/Address book@{uu}... Permits you to edit the entries in the @{"Address book" link "AB_W" 0}. @{u}Settings/Configuration@{uu}... Opens the @{"Configuration window" link "CO_W" 0}, in which you can change YAM's settings. @{u}Settings/Users@{uu}... Starts the @{"User window" link "US_W" 0}, where you can add new program users ("Multi-User"). @{u}Settings/MUI@{uu}... Starts the settings window for @{"MUI" link "MUI" 0} where you can specify virtually all of the visual features of YAM, including fonts, palette, screen mode, background, borders, gadgets, keyboard shortcuts and so on. Please see the MUI documentation for more information. YAM utilises several MUI classes which were not in the original release of MUI. For this reason, some settings are not made in YAM's configuration window but rather in that for MUI. These MUI modules are: @{b}NListviews:@{ub} some of the lists in YAM, @{i}e.g.@{ui} folders, messages. Options: colours, fonts, miscellaneous, scrollbars. @{b}Toolbar:@{ub} icon buttons in the YAM window. Options: labels, spacing, fonts. @{b}TextEditor:@{ub} internal editor as well as message display in the read window. Options: fonts, colours, cursor, separator, keybindings, spell checker. @{b}Listtree:@{ub} structured lists in the Address book. Options: appearance of lines and group icons. @{b}BetterString:@{ub} general one-line text input field. Options: font, palette, cursor. @endnode @node "MAM5" "Main window - Scripts Menu" @toc "MA_W" @{b}@{u}Main window - SCRIPTS MENU@{ub}@{uu} @{u}Scripts/Execute script...@{uu} Lets you select an @{"ARexx" link "REXX" 0}-Script and run it. @endnode @node "CO_W" "Configuration" @{b}@{u}CONFIGURATION@{ub}@{uu} YAM has numerous options which can be set up in the configuration window. The program options are divided into 16 sheets which can be selected by clicking on the corresponding word in the left part of the configuration window. @{" First Steps    " link "CO00" 0} - Essential information for YAM to work: your e-mail address, mail server & time-zone @{" TCP/IP         " link "CO01" 0} - SMTP and POP3 settings for mail transfer @{" New Mail       " link "CO02" 0} - Controlling the way mail is downloaded @{" Folders        " link "CO03" 0} - How messages are saved and archived @{" Filters        " link "CO04" 0} - Automated sorting and filing of messages @{" Read           " link "CO05" 0} - Layout options @{" Write          " link "CO06" 0} - Headers, stock phrases and editor settings @{" Reply          " link "CO07" 0} - Options for quoting messages @{" Signature      " link "CO08" 0} - Signatures... and taglines! @{" Lists          " link "CO09" 0} - Visible columns in folder and message lists @{" Security       " link "CO10" 0} - Encrypting with @{"PGP" link "PGP" 0} and use of remailers @{" Start/End      " link "CO11" 0} - Options for action at start up and termination @{" MIME           " link "CO12" 0} - @{"MIME" link "MIME" 0} viewers for attachments @{" Address book   " link "CO13" 0} - Visible columns, personal data exchange @{" ARexx          " link "CO14" 0} - Setting up your macros @{" Miscellaneous  " link "CO15" 0} - Paths, AppIcon, save/delete, tracking & packing @{" Hidden Options " link "CO_H" 0} - You can't see them :-) The same three buttons appear on each sheet: [@{u}Save@{uu}] Use this to save all changes to the hard disk, so they will survive a reboot of the computer. [@{u}Use@{uu}] With this the changes are temporary and apply only until YAM is closed. [@{u}Cancel@{uu}] Discard any changes. The @{"Menu" link "CO_M" 0} provides some extra possibilities. @endnode @node "CO00" "Configuration - First steps" @toc "CO_W" @{b}@{u}Configuration - FIRST STEPS@{uu} (Essential information needed for YAM to work)@{ub} @{fg shine}-------------------Minimal configuration-------------------@{fg text} @{u}Full Name@{uu} Your real name and surname. Please take care that this field is filled in correctly. Please don't use quotation marks in your name. @{i}Example:@{ui} John Doe @{u}E-mail address@{uu} This is your e-mail address, consisting of your @. @{i}Example:@{ui} jdoe@provider.uk @{u}POP3-server@{uu} 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. If you don`t fill in this entry YAM will use the address of the SMTP-server. @{i}Example:@{ui} mail.provider.uk @{u}Password@{uu} The password which is asked from you by your mail server. This password is possibly but not necessarily identical with the password you use for logging on to your ISP (@{i}e.g.@{ui} using PPP). @{i}Example:@{ui} nguz56 @{fg shine}-------------------------Time zone-------------------------@{fg text} @{u}Timezone@{uu} The time and date displayed by YAM in the message list is always converted to your @{i}local@{ui} 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). Should the time zone have a special value (@{i}e.g.@{ui} a difference of half an hour) it can be defined in the environment variable YAM_TZ. @{i}Examples@{ui}: GMT+1 (for Germany) GMT (for the U.K.) GMT-5 (for U.S. EST @{i}e.g.@{ui} New York City) [] @{u}Add adjustment for daylight saving time@{uu} This option is to be activated during daylight saving time. By doing so one hour will be added to the time zone value. @endnode @node "CO01" "Configuration - TCP/IP" @toc "CO_W" @{b}@{u}Configuration - TCP/IP@{uu} (Information needed for internet mail-transfer)@{ub} @{fg shine}-----------------------Send mail(SMTP)----------------------@{fg text} @{u}Server@{uu} 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 processing the SMTP-protocol. The port number of the SMTP-service is 25 in most cases. If it's different from that it has to be appended to your mailserver's address, separated by a colon. @{i}Example:@{ui} mail.provider.de @{u}Domain@{uu} When sending mails your Amiga has to identify itself to the SMTP-server by giving its address (HELO-command). The SMTP-server decides whether you are allowed to use it by checking this address. Normally YAM identifies itself by sending the domain part of your e-mail address, which functions perfectly well in most cases. However, if you encounter trouble and get an error message from your SMTP-server when trying to send mail, you'll have to edit your domain setting, @{i}e.g@{ui}. by inserting a name for your computer. @{i}Example:@{ui} myamiga.provider.uk [] @{u}SMTP-Server allows 8bit@{uu} Originally only the US-ASCII character set was allowed for use in e-mail, which meant that the users were forced to do without modified vowels. Instead of 'ä' they had to write 'ae'. The reason for that was that many servers only processed the first 7 bits and simply cut off the 8th bit crippling the e-mail by doing so. This problem was solved by introducing the MIME quoted-printable standard, which converts all 'unauthorized' characters to 7 bit before transfer and reconverts them to the original characters on delivery. Modern mail servers don't have problems with non-US-ASCII characters any more, so messages do not necessarily have to be converted. If you are absolutely sure that your server supports 8 bit transfers, you can switch on this option and save a few bits when transferring. The best way to find out if your mail server supports this is to write a message to yourself containing modified vowels and see what happens. @{fg shine}---------------------Receive mail(POP3)---------------------@{fg text} @{u}POP3-Access@{uu} Apart from the primary POP3-server already defined in @{"First steps " link "CO00" 0} you can specify access data for 15 more accounts here; the names appear in the list on the left and clicking on a name brings up the relevant details on the right. Note that the 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. Click on [New] to insert the data required for a new e-mail account. With [Delete] you can (obviously) delete accounts. @{u}Server@{uu} The internet address of the system you wish to fetch mail from. This server, which will be a computer of your ISP (Internet Service Provider) in most cases, must be capable of processing the POP3-protocol. The port number of a POP3-server usually is 110. If your server uses a different port you have to add it to the server address, separated by a colon. @{i}Example:@{ui} pop.provider.de:109 @{u}User-ID@{uu} Insert the user-id for the POP3-server here. In most cases this will be identical with the username in your e-mail address. However there are exceptions, so check the instructions from your ISP. (YAM then constructs the full account name in the form @.) @{i}Example:@{ui} jdoe @{u}Password@{uu} The password which has to be sent to the mailserver for logging on. You can leave this field empty for security reasons. If you do, the password will be asked from you whenever YAM checks for new mail. @{i}Example:@{ui} nguz56 [] @{u}Active@{uu} Switch on this option to have the selected POP3-server checked for new mail. If you don't want this e-mail account to be checked automatically, switch off this option and use the menu function 'Folder/Check single account' from the main window instead. [] @{u}Login using APOP@{uu} Normally the user-id and the password are transmitted as normal text when connecting to a POP3-server. Under certain circumstances this could be a security risk. For this reason modern POP3-servers support the APOP- authentication which transmits the data encrypted with a key which is delivered by the server. If your POP3-server does not support APOP you'll receive an error message when checking for new mail. In that case switch this option off. [] @{u}Delete mail on server@{uu} When 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 again later from another computer, this option can be deactivated. @endnode @node "CO02" "Configuration - New mail " @toc "CO_W" @{b}@{u}Configuration - NEW MAIL@{uu} (Set-up for downloading mail)@{ub} @{fg shine}-------------------------Download--------------------------@{fg text} @{u}Pre-selection@{uu} After establishing a link with the POP3-server a @{"preselection window" link "TR_W" 0} may open 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). @{b}never:@{ub} pre-selection is deactivated @{b}large messages:@{ub} only messages bigger than a size defined by you will be displayed in pre-selection @{b}always:@{ub} every message will be displayed in pre-selection @{b}always, only sizes:@{ub} all messages will be displayed but only their sizes will be shown. The advantage of this method is that it is pretty fast. @{u}Size limit@{uu} If pre-selection is activated messages which exceed the value given here in size will be highlighted. This way you avoid downloading messages with gigantic attachments. The size is given in kilobytes. If you don't want any limitation just insert '0'. In everyday use the settings 'pre-selection= large messages' and 'size limit=100 kb' have proved to be advantageous. With this setting the pre-selection window will only appear if at least one of the new messages exceeds 100 kilobytes in size. [] @{u}Transfer window@{uu} Here you can decide if you want to see the @{"transfer window" link "TR_W" 0} during receiving or sending mail. With 'automatic' it only opens if you manually initialize the transfer, it stays closed when YAM automatically checks for mail. [] @{u}Avoid duplicates@{uu} If you choose not to have YAM delete the mail on the server after down- loading it will be downloaded again next time YAM gets your mail, so every message will appear twice in your mail folder. To prevent this, switch on the 'Avoid duplicates' option . As long as this option is activated YAM keeps track of all your downloaded messages in the '.uidl' file and uses 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 YAM will try to read the message-id using the TOP-command instead of the UIDL- commands. In case the mail-server doesn't support any of these commands this option must be deactivated. [] @{u}Update message status@{uu} If this option is activated all messages in the 'incoming' folder are marked from 'new' to 'unread'. This way you can instantly recognize the new mail that was downloaded the last time you've fetched mail. @{fg shine}--------------------Automatic operation--------------------@{fg text} @{u}Check for new mail every [xx] minutes@{uu} Here you can specify a time interval after which YAM will automatically recheck your mail server for new mail. To deactivate this option simply enter zero. @{i}Example:@{ui} 15 minutes [] @{u}Download large messages@{uu} Whenever new mail is downloaded automatically (every x minutes or using Arexx) the selection window won't pop up since the user is likely to be working with another program at the time or not in front of the computer at all. Mails exceeding the size limit won't be downloaded and will remain on the server if this option is not activated. @{fg shine}------------------------Notification-----------------------@{fg text} [] @{u}Type@{uu} When YAM has downloaded new mail, it will display a requester showing the number of new and deleted messages. [] @{u}Sound@{uu} When YAM has downloaded new mail, it plays a sound file. The datatypes library is used for playing so the soundfile can be of any format (like AIFF or WAVE) as long as you have installed the appropriate datatypes. @{i}Example:@{ui} Data:Audio/Newmail.snd [] @{u}Command@{uu} This is the program to be executed when new mail arrives. Insert the command as you would in a command shell. If it is an Arexx script you have to put the 'rx' command in front of the name of the script. @{i}Example:@{ui} rx YAM:rexx/Newmail.yam @endnode @node "CO03" "Configuration - Folders" @toc "CO_W" @{b}@{u}Configuration - FOLDERS@{uu} (folder settings)@{ub} Apart from the four mailbox folders 'Incoming', 'Outgoing', 'Sent' and 'Deleted' you can create up to 96 more. User-defined folders are useful @{i}e.g.@{ui} for archiving received or sent mail or for administrating mailing lists. With [New] you can create a new custom folder, with [Delete] you can delete it again. Be aware that all mail contained in a folder is lost if the folder is deleted. You can change the order of the folders order (as listed in the lower listing) by using drag and drop. @{u}Name@{uu} The name of the folder will appear in the folder listing in the main window. @{i}Example:@{ui} YAM mailing list @{u}Path@{uu} This is the path in which the messages, the .config file and the .index file of the actual folder will be saved. Usually this is a subdirectory of the actual basic folder directory, but you can specify any other place, like another hard disk partition for example. You should define the path immediately after creating a new folder and it should not be changed at a later time. @{i}Example:@{ui} yam_ml @{u}Max. age@{uu} If you like you can make YAM delete messages exceeding a certain age automatically. To do so insert a value different from zero in this field (which stands for the maximum age of the mail in DAYS). Then switch to the 'Start/Quit' menu and activate the option 'Delete old mail'. N.B.: messages with the status 'new' or 'unread' will not be deleted automatically. @{u}Type@{uu} Here you choose whether the folder is for incoming or sent mail, or whether it is simply going to act as a divider (@{i}i.e.@{ui} title for a group of folders). @{u}Mode@{uu} Folders can be protected with a password and/or be compressed if necessary. There are the following modes available: @{b}normal@{ub} no password protection, no compression + fast - no protection of your e-mail from third persons with access to your computer @{b}simple protection@{ub} simple password protection, no compression + fast - your e-mails are protected within YAM only @{b}compressed@{ub} XPK-compression without password protection + saves hard disk space - slow, no protection of your e-mail @{b}compressed with password@{ub} XPK-compression with password protection + saves hard disk space, good protection - slow The XPK software package is needed for compressing. It is not contained in the YAM archive but can be downloaded @{i}e.g.@{ui} from Aminet for free. The settings for the compression library can be found at @{"Miscellaneous" link "CO15" 0}. @{u}Sort by@{uu} Here the primary order of the messages in the chosen folder is specified. You can have the mail sorted by message date, date received, sender, recipient, subject, size or status. Concerning the message status the messages will be sorted in the following order: new > unread > read > replied > forwarded > error sending > protected > in queue > sent With the option 'Rev' the order will be reversed (@{i}e.g.@{ui} Z-A instead of A-Z) @{u}Then by@{uu} Here the secondary order of the messages in the chosen folder is specified. If for instance mails are sorted by subject primarily messages with the same subject can be sorted by date or author using this second key. @{u}Mailing list support@{uu} Since not all mailing list servers set the reply-to field to the correct address (which would be the mailing-list's address) YAM can do some corrections here. When you reply to a mail contained in this folder YAM checks if the data in the to-field of the original message is the same as the content of the 'To pattern' field. If they match the address contained in the 'To address' field will be inserted as the recipient instead of the recipient's address contained in the original message. @endnode @node "CO04" "Configuration - Filters" @toc "CO_W" @{b}@{u}Configuration - FILTERS@{uu} (user defined mail filters)@{ub} The purpose of a mail filter is to process mail according to criteria defined by the user. Whenever a mail matches a specified pattern it can activate certain actions. Applications for the use of filters are, for example: - automatically moving mail from a mailing list to a specified folder - automatic processing of incoming inquiries by sending pre-defined answers - automatic deletion of unwanted spam (advertising by e-mail, a real pest nowadays) - automatic re-directing of mails to another recipient. You can define up to 100 such filters. The list on the left shows the names of all the filters defined so far. Click on a name to bring up its details on the right, spread across three sheets - Options, Comparison and Action. Click on [New] to create a new filter or use [Delete] to delete one. ----------------------@{b}Options sheet@{ub}---------------------- @{u}Name@{uu} The filter's name is merely for recognition and not of any other use. [] @{u}Remote-Filter@{uu} With a remote filter new e-mail can be checked on the POP3-server without being downloaded completely. The POP3-server must support the TOP-command to be able to process this kind of filter. In contrast to 'normal' filters only the contents of the e-mail headers can be searched for certain patterns. For obvious reasons functions like forwarding or moving e-mails will not work with remote filters. If remote filters are activated they might slow down downloading e-mail but they are handy as a protection against spam or 'mailbombs'. [] @{u}Apply to new mail@{uu} Activate this option to have all new mail processed by this filter. Processing will be initiated automatically after receiving new mail. [] @{u}Apply to sent mail@{uu} Activate this option to have all sent mail processed by this filter. Processing will be initiated automatically after sending mail. [] @{u}Apply on request@{uu} When this option is activated the filtering process will be started by clicking on the filter button in the main window or by choosing 'Filter' from the 'Folder' menu. This way you can also process old messages which do not necessarily have to be in the incoming folder. ----------------------@{b}Comparison sheet@{ub}------------------- @{u}Search in@{uu} Here you can define what part of the e-mail should be scanned for the search pattern. If you want a field of the message header to be searched you can choose one from the list which appears when clicking on the cycle gadget or select 'Other field' and insert the name of the header field into the text field on the right side of the cycle gadget. If 'Message body' is selected the whole message except for the header will be searched. Please note that this type of full text search may take quite a long time when big mails are processed (YAM will have to decode mails in MIME format). @{i}Example:@{ui} Other field: X-Mailer @{u}Comparison@{uu} The instruction comprises the @{b}comparison operator@{ub} and the @{b}search pattern@{ub}. YAM supports the following @{b}comparison operators@{ub}: @{b}=@{ub} the text which is compared must match the search pattern @{b}<@{ub} the text must be less than the search pattern @{b}>@{ub} the text must be greater than the search pattern @{b}<>@{ub} the text must be different from the search pattern @{b}IN@{ub} the text must match a pattern contained in the file which is specified in the text field to the right side of the comparison cycle gadget. Instead of a search pattern itself the name of a file is to be inserted here, containing one or several lines of search patterns. In this way it is possible to create a so-called 'Killfile' containing a list of e-mail addresses. Note that the comparison operators < and > work differently according to the type of field. YAM knows that a message size or date is numeric and sorts these in numerical order but for fields such as 'Subject' alphanumeric order is used, as in a telephone directory, so James < Jim and 12 < 2. The @{b}search pattern@{ub} may contain @{"Amiga-DOS wildcards" link "DOSW" 0} such as ?, #?, (a|b) or [abc]. Please note that the search pattern [YAM]#? will filter all messages beginning with Y, A or M. For filtering mails out of a mailing list (for example a mailing list related to YAM) you would do better to use the search pattern #?YAM#? or have the filter compare the 'To' field with the address of the mailing list. @{i}Example:@{ui} = YAM 1.3.#? @{u}Address/Name@{uu} If you make the filter search a header field containing an e-mail address you can specify here whether the search pattern should be processed on the address (@{i}e.g.@{ui} jdoe@provider.uk) or the author's name (@{i}e.g.@{ui} 'John Doe'). [] @{u}Case sensitive@{uu} Activate this option if you want the filtering process to distinguish between normal and capital letters. [] @{u}Substring search@{uu} If the search pattern consists of only a part of the header field which is to be searched through you must activate this option. YAM will then complete the search pattern with #? internally. It is possible to combine @{b}two search criteria@{ub}. The cycle gadget lets you select how this is to be done: @{b}none@{ub} don't use a second criterion @{b}and@{ub} both criteria must be satisfied @{b}or@{ub} at least one of the two criteria must be met @{b}exclusive or@{ub} either one or the other of the two criteria must apply, but not both ----------------------@{b}Action sheet@{ub}----------------------- [] @{u}Bounce@{uu} Activate this option to have mail matching the search criteria bounced to another person. The new recipient's e-mail address must be inserted into the text field next to the option. @{i}Example:@{ui}jdoe@athome.de [] @{u}Forward@{uu} Activate this option when you want e-mail matching the search criteria to be forwarded to another person. The new recipient's e-mail address must be inserted into the text field next to the option. [] @{u}Reply@{uu} When this option is activated YAM will send an automatic reply to the e-mail matching the search pattern. Insert the file containing the auto- answer text into the text field next to this option. @{i}Example:@{ui} YAM:Auto-Texts/Answer1.txt [] @{u}Execute@{uu} When this option is activated an external program will be executed whenever an e-mail matches the search criteria. YAM will send the path of the e-mail to the external program as a starting parameter. Insert the command line into the text field next to this option. Please note that if you want an Arexx script to be executed you will have to put in the 'RX' command first. @{i}Example:@{ui} rx YAM:Rexx/Subscribe.rexx [] @{u}Play sound@{uu} Activate this option to have a sound played whenever a message matches the search pattern. The sound file is to be inserted into the text field next to this option. YAM uses the Datatypes library for playing the sound. @{i}Example:@{ui} Data:Audio/Ihatespam.wav [] @{u}Move@{uu} If you activate this option YAM will move e-mail matching the search pattern to another folder. You can select the folder with the pop-up button. [] @{u}Delete@{uu} When this option is activated all messages matching the search pattern will be deleted. (You probably guessed that... ;) ) [] @{u}Don't download@{uu} When this option is activated e-mail matching the search pattern will not be downloaded from the mail server. You can use a remote filter together with this option if several persons share the same POP3-account. @endnode @node "CO05" "Configuration - Read" @toc "CO_W" @{b}@{u}Configuration - READ@{uu} (Settings for reading e-mail)@{ub} @{fg shine}-----------------Message header layout-----------------@{fg text} @{u}Header@{uu} If 'full' is selected the full header will be displayed. Select 'none' if you don't want to see any of the header. When you switch to 'selected' you can specify yourself which header fields should be visible in the read window. For specifying the fields you can use any @{"AmigaDOS pattern" link "DOSW" 0}. The fields FROM, TO, DATE and SUBJECT are predefined as default settings. The header layout can also be changed (temporarily) in the read window itself. @{i}Example:@{ui} (From|Subject|Date|X-Mailer) @{u}Sender info@{uu} If a mail's sender is found in YAM's address book, YAM can display additional information in the header part of the read window. If 'data only' is selected YAM will list information like name, date, snail-mail address, description, etc. contained in the address book entry. Select 'data and image' to make YAM display a picture of the sender (of course there's got to be one in the address book ;)) in addition to the other data. [] @{u}Wrap headers@{uu} Choose whether to show a long header on one line or to break it across two or more. In the first case you will need to use the horizontal scrollbar in order to see all of the information. @{fg shine}-----------------Message body layout-------------------@{fg text} @{u}Separate sig.@{uu} It has become a custom to separate the signature from the text of an e-mail using two dashes and a space. If you don't like this way of separation you can define another here. Apart from the setting 'two dashes' you can select between 'separator bar', 'blank line' or even 'no signature' to have no sig. at all. @{u}Colored text@{uu} Text passages embedded in # characters will be highlighted by YAM in a special colour (in the internal editor and in the read window). Here you can define the colour used for that purpose. @{u}Old quotes@{uu} The colour which is used to display quoted text can be selected in the TextEditor module of the MUI preferences. If there are multiple levels of quoting, an alternative colour will be used for the even (2nd, 4th, etc.) levels. You can define that colour here. [] @{u}Use fixed font@{uu} It often makes more sense to use a non-proportional font for reading messages since the layout of any tables will be distorted using proportional fonts. Don't forget to specify the font of your choice in the 'TextEditor' module of YAM's MUI settings under 'Fonts/fixed'. [] @{u}Display all texts@{uu} If this option is activated and the message contains attachments not only the actual message text will be displayed but also the attachments themselves, as long as they are of the 'text' type. @{u}Text styles@{uu} YAM uses the characters _ / * and # to indicate underlined, italic, bold and coloured text. For certain special documents (like source codes) this can make things difficult because some characters are suppressed. So you have the option of switching the rendering of text styles on or off. @{fg shine}--------------------Other options---------------------@{fg text} @{u}Charset translation@{uu} When reading messages this character-set converter is used. In some countries not all letters can be written with the standard ISO-Latin-1 charset of the Amiga. In Poland for example the AmigaPL charset is very popular since it contains the missing characters. YAM supports such charsets for reading and writing messages. In the charset directory there are some examples. A conversion table is set up as follows: 1st line: YCT1 - YAM Charset Translation 2nd line: Description of the converter 3rd line: Resulting charset, @{i}e.g.@{ui} iso-5589-1 further lines: (optional) FROM source charset (e.g. iso-5589-1) (optional) TO target charset (optional) HEADER Old character=New character Characters are defined in hex-code with a $ in front or as actual characters. So a character definition can look like this: $E5=$61 or like this: å=a With the HEADER keyword, the charset conversion is also applied to the messages headers. [] Multiple windows With this option selected, each message which you choose to read will open its own read window. Up to four such windows can be open at the same time. @endnode @node "CO06" "Configuration - Write" @toc "CO_W" @{b}@{u}Configuration - WRITE@{uu} (Settings for writing new messages)@{ub} @{fg shine}--------------------Message Header---------------------@{fg text} @{u}Reply to@{uu} Normally this field should remain empty. The default reply-to address is your e-mail address. If want to use a different address (AND ONLY THEN!!) you can insert that different address here. @{i}Example:@{ui} jdoe@home.uk @{u}Organization@{uu} If you want the name of your organization, school, club or whatever to appear in the header of your message, insert it here. @{i}Example:@{ui} Doe Donut Production Ltd. @{u}Extra headers@{uu} If you need to add one or more special extra lines to the header of your mail for any reason, you can insert these header lines here. If you would like to insert several lines separate them by inserting '\\n'. PLEASE DON'T make use of this feature unless you have the appropriate knowledge of the structure of internet e-mail. @{i}Example:@{ui} Content-Language: uk\\nKeywords:Pattern, YAM, Internet @{fg shine}----------------------Message body---------------------@{fg text} @{u}Welcome phrase@{uu} YAM 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'. @{i}Example:@{ui} Hello,\\n @{u}Closing phrase@{uu} 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'. @{i}Example:@{ui} Kind regards\\n\\nJohn Doe @{u}Charset translation@{uu} This character-set translator is used when writing messages. You can find further information on that in the chapter @{"READ" link "CO05" 0}. @{i}Example:@{ui} YAM:charsets/Latin1toUSASCII (deletes mutated vowels, etc.) @{fg shine}-------------------------Editor------------------------@{fg text} @{u}Word wrap@{uu} When you save a newly written message it will be formatted to make sure that no line has more characters than the value specified here. You can also choose if YAM should insert line breaks as you type or if this should be delayed until you send the message. @{i}Example:@{ui} 76 [] @{u}Wrap as you type@{uu} Activate this option if you would like the internal editor to insert linebreak codes @{i}while@{ui} you're typing the message. This way you avoid unwanted surprises when the text is formatted later on saving the message. But be aware of the fact that the subsequent insertion or deletion of text might be a little less comfortable. @{u}External editor@{uu} If you do not like the internal editor and wish to use another one (thereby forgoing automatic spell checking, text styles and glossary) you can insert it here. Remember to insert the full path for the editor and a possible qualifier such as '-sticky' or '-keepio'. @{i}Example:@{ui} C:Ed or C:CED -keepio [] @{u}Launch immediately@{uu} Activate this option, if you would like the external editor to be launched automatically as soon as you start creating a new message. By doing so you won't have to click on the [Editor] button in the write window. @endnode @node "CO07" "Configuration - Replying" @toc "CO_W" @{b}@{u}Configuration - REPLYING@{uu} (Replying and forwarding messages)@{ub} @{fg shine}----------------------Forwarding----------------------@{fg text} @{u}Initial phrase@{uu} This text will be added at the beginning of the original text of any message you forward. 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, YAM replaces the variables by their values which it reads from the forwarded message. @{i}Example:@{ui} *** Forwarded message, originally by %n on %d: ***\\n @{u}Terminating phrase@{uu} This text will be inserted at the end of a forwarded message (but before the greetings phrase). Click on the pop-up button to select a variable from the list (for subject, date, sender, etc.). @{i}Example:@{ui} *** End of forwarded message ***\\n @{fg shine}-----------------------Replying------------------------@{fg text} @{u}Default reply phrase@{uu} When you reply to a message, YAM can automatically insert three different phrases in the new message: greetings (Open), an introduction to the quoted message (Intro) and a closing phrase (Close). Use the cycle gadget to select one of these phrases and enter it in the field on the right. Click on the pop-up button to select a variable from the list (for subject, date, sender, etc.). @{i}Example:@{ui} [Open] Hello %f,\\n [Intro] On %d, you wrote:\\n [Close] Kind regards @{u}Alternative reply phrase@{uu} Communicating via internet often means writing in another language. For that reason YAM is capable of using an alternative reply phrase set which will be activated automatically whenever the recipient's address corresponds to a user-defined pattern. This way you can for instance use a German version of the reply phrase set for addresses in Germany, Austria and Switzerland while using the English version for all other countries. @{i}Example:@{ui} [Open] Hallo %f,\\n [Intro] Am %d schriebst Du:\\n [Close] Mit freundlichem Gruss @{u}Use with these domains@{uu} Whenever the recipient's address corresponds with this @{"AmigaDOS pattern" link "DOSW" 0} the alternative reply phrases will be used. @{i}Example:@{ui} #?.(de|ch|at) (Addresses of countries with German mother tongue) Mailing list reply phrase To answer a message belonging to a mailing list, another set of phrases is available. They will be used if the message that is being answered is stored in folder for which mailing list support has been activated (@{"folder configuration" link "CO03" 0}). @{i}Example:@{ui} [Open] Hi!\\n [Intro] On %d, %n wrote:\\n [Close] Kind regards [] @{u}Quote message using@{uu} Activate this option to make YAM quote the message you're replying to. The character specified in the editing field to the right plus a space will be put in front of each line of the original message. Click on the pop-up button to select a variable for the sender's initials. @{i}Example:@{ui} %i> [] @{u}Quote empty lines@{uu} Normally the quotation character is inserted at the beginning of empty lines contained in the quoted message. If you don't like that, for any reason, you should deactivate this option. [] @{u}Verify recipient address@{uu} If this option is activated YAM will check if the sender and the recipient have the same address. If the From field of the message header happens to be different from the ReplyTo field of the message header the user (that's you) can choose whom to reply to. That way it's fairly easy to reply privately to a message from a mailing list. [] @{u}Strip signature@{uu} Activate this option to avoid quoting the signature (since you'll delete the signature anyway in most cases). This option will work only when the signature in the quoted message is separated from the actual message by the standard separator '-- '. @endnode @node "CO08" "Configuration - Signature" @toc "CO_W" @{b}@{u}Configuration - SIGNATURE@{uu} (Definition of the signature and taglines)@{ub} You can define and use one standard and up to two alternative signatures within YAM (@{i}e.g.@{ui} one signature for private mail and another one for business). Clicking on the cycle button in the upper left corner of the window you can display and edit the signatures in the small text editor window. [] @{u}use signature@{uu} When this option is activated a signature will be inserted at the end of each message you write. [@{u}Edit in external editor@{uu}] Click on this button to open the external editor you have defined in 'Configuration/Write/External editor' for editing the actual signature. [@{u}Insert random tagline@{uu}] Click on this button to insert the variable '%t' at the actual cursor position in the editor. YAM will replace this variable with a random tagline from the tagline file when processing a new message. [@{u}Insert ENV:Signature@{uu}] Click on this button to insert the variable '%e' at the actual position in the editor. YAM will replace this variable with the content of the environment variable 'SIGNATURE' when creating a new message. That way it is possible to have random values inserted into the actual signature automatically, like the date, or the actual temperature or time or your weight or whatever... @{u}Tagline file@{uu} The tagline database contains tags, little poems or other very important and witty pieces of wisdom which can be selected randomly and be inserted into the signature. There are collections of thousands of these taglines on Aminet. @{i}Example:@{ui} YAM:.taglines @{u}Tagline separator@{uu} Since a tagline can consist of several actual lines the single entries in the tagline file have to be separated from each other. Insert the string that is used for separating one tagline from another in your tagline file into this text field. @{i}Example:@{ui} %% @endnode @node "CO09" "Configuration - Lists" @toc "CO_W" @{b}@{u}Configuration - LISTS@{uu} (Column layout in different lists)@{ub} @{u}Folder list@{uu} Select the items you want to show in the folder list. @{u}Message list@{uu} Select the items you want to show in the message list. [] @{u}Use fixed font@{uu} It often makes more sense to use a non-proportional font since the display might become messed up with proportional fonts. Don't forget to specify the font of your choice in the 'TextEditor' module of YAM's MUI settings under 'Fonts/fixed'. @endnode @node "CO10" "Configuration - Security" @toc "CO_W" @{b}@{u}Configuration - SECURITY@{uu} (Encryption, anonymous mail, protocols)@{ub} @{fg shine}--------------------------PGP--------------------------@{fg text} @{u}PGP path@{uu} The famous (some people and authorities might even say notorious) programme PGP (Pretty Good Privacy) by Philip Zimmermann is used for encrypting, decrypting and digitally 'signing' messages. Please install PGP as described in PGP's manual and insert the full directory path of the PGP executable here. YAM recognizes automatically if you're using version 2.6 or 5.x. @{i}Example:@{ui} Work:Programs/PGP/bin/ @{u}Your PGP keys ID@{uu} If you want to sign messages with PGP YAM needs the shortcut of your secret PGP key. Click on the pop-up button and select your key. If you cannot find your PGP key it could have two reasons: either PGP is not installed correctly on your system or you've specified the wrong path for the PGP executable. @{i}Example:@{ui} 0x70804A7B [] @{u}Encrypt to self@{uu} Encrypting messages for a certain recipient has one disadvantage: you cannot read or edit the message any more after encryption. Activate this option to be able to read the message after encryption. YAM will enable you to do so by simply encrypting the mail using the recipient's key as well as your own. @{fg shine}--------------------Anonymous mail---------------------@{fg text} @{u}Re-Mailer@{uu} E-mail address of the re-mailing service you'd like to use. If sending e-mail anonymously by using a so called 're-mailer' this re-mailer will erase all information from the message header that could be used for identifying the original sender and then forward the message to the actual recipient. You can find addresses of re-mailing services by having a (www-) search engine examine the internet for 'remailer'. @{i}Example:@{ui} Remailer @{u}Header field@{uu} The address of the actual recipient of the message is transmitted to the re-mailing service by being contained in a header field or in the first line of the message. In the latter case simply create a blank line at the beginning of the re-mailer header line by inserting '\\n'. The variable '%s' will be replaced by the recipient's address. Please refer to the documentation of the re-mailing service for information on the exact format of the header line. @{i}Example:@{ui} Anon-to: %s @{fg shine}-----------------------Logfiles------------------------@{fg text} @{u}Logfile path@{uu} YAM will save the logfiles in the path specified here. The logfiles are formatted as follows: Date/time/[code]/description of the event. The code, which consists of a two-digit number, is handy when running a computer-supported analysis of the logfile data since it is not related to the selected language (whereas the description of the event is). [] @{u}Split logfile@{uu} Switch on this option if you want YAM to create a new logfile each month. To distinguish the different files that will be created YAM includes the date in the logfile name, @{i}e.g.@{ui} YAM-Jan98.log. If you'd like one big single logfile just leave this option deactivated. @{u}Mode@{uu} If you are not interested in having logfiles at all select 'none'. Select 'normal' to have the important events like receiving/sending mail recorded. In 'verbose' mode YAM will protocol every transferred e-mail in detail. [] @{u}Log all events@{uu} Deactivate this option if you're only interested in logging events to do with the mail transfer (sending/receiving). @endnode @node "CO11" "Configuration - Start/Quit" @toc "CO_W" @{b}@{u}Configuration - START/QUIT@{uu} (Actions to be executed at startup and exit)@{ub} @{fg shine}------------------On program startup-------------------@{fg text} [] @{u}Load all folders@{uu} If you have many voluminous archive folders you can increase YAM's starting speed by deactivating this option. Furthermore deactivating this option will save memory, because only the index files of the system folders will be loaded on program startup. The index files of the user-defined folders will then be loaded only when needed. [] @{u}Mark new mail as unread@{uu} Switch on this option to mark all messages with the status 'new' as 'unread' on startup. [] @{u}Delete old mail@{uu} In the case that you have defined a maximum age for specific folders YAM will delete all messages exceeding this age before actually quitting if this option is activated. [] @{u}Remove deleted mail@{uu} Switch this on to make YAM empty the 'Deleted' folder when closing down. [] @{u}Check birthdates@{uu} Switch on this option to make YAM search the address book on startup for persons whose birthday is today. This way you can send your congratulations at once, in case it's the birthday of one of your pals (or maybe even business partners). [] @{u}Send mail in outgoing queue@{uu} If this option is activated YAM will search the outgoing folder for messages to send on startup and ask you if you'd like to send them. Please note that this will work only if a TCP/IP stack has been loaded previously. You can temporarily stop YAM from doing so by starting YAM from a shell with the qualifier NOCHECK. [] @{u}Download new mail@{uu} If this option is activated (and there's already a TCP/IP stack running on your system) YAM will check the mail server for new messages. You can temporarily stop YAM from doing so by starting YAM from a shell with the qualifier NOCHECK. @{fg shine}-----------------On program termination----------------@{fg text} [] @{u}Send mail in outgoing queue@{uu} Activate this option to make YAM look for ready to send messages in the outgoing folder before actually ending the program. If it's activated YAM will ask you if you'd like to send those messages before quitting. (Of course it will do so only if there actually are any messages in the outgoing folder.) [] @{u}Delete old mail@{uu} In the case that you have defined a maximum age for specific folders YAM will delete all messages exceeding this age before actually quitting if this option is activated. [] @{u}Remove deleted mail@{uu} Switch this on to make YAM empty the 'Deleted' folder when closing down. @endnode @node "CO12" "Configuration - MIME" @toc "CO_W" @{b}@{u}Configuration - MIME@{uu} (MIME viewers for attachments)@{ub} @{fg shine}----------------------MIME viewers---------------------@{fg text} The program selected by default for displaying attachments is MultiView. Messages in @{"MIME-Format" link "MIME" 0} contain a field called 'ContentType' in which the type of the encoded file is specified. You can define a different program for processing every single type of file. That is important for users who do not want to use MultiView for processing images and sound files or for processing file types that are not yet supported by datatypes. Click on [New] to configure a displaying program or use [Delete] to delete an entry. @{u}Attachment type@{uu} This is the type of the actual entry and corresponds with the ContentType field contained in the message. You can select one from the pop-up list or use AmigaDOS wildcards, @{i}e.g.@{ui} 'image/#?' to use the programme for a whole class of file types. @{i}Example:@{ui} image/jpeg @{u}Extension@{uu} Filename extension for the file type. This extension allows YAM to assign the correct ContentType field for a file. @{i}Example:@{ui} jpg jpeg jfif @{u}Viewer@{uu} Choose a program you'd like to use for displaying the attachment. Do not forget to insert a "%s" into the command line which will be replaced by the filename when processing. The quotation marks in "%s" make it possible to use spaces in the filename. @{i}Example:@{ui} TOOLS:Gfx/ViewJPG "%s" @{u}Default viewer@{uu} This viewer will be used if the attachment doesn't match any of the user defined types (see above). @{i}Example:@{ui} SYS:Utilities/Multiview "%s" SCREEN [] @{u}Identify binary attachments@{uu} Some mail clients always use a ContentType field of 'application/octet-stream' for binary attachments. To still show such attachments with the correct program, YAM can search the viewer list based on the file name extenstion of the attached file (see Extension). @{fg shine}---------------------------Paths-----------------------@{fg text} @{u}Decode files to@{uu} This is the pre-selected directory to decode attachments into. @{i}Example:@{ui} Work:Data/In @{u}Attach files from@{uu} Whenever you want to attach a file to a new message YAM will look for it at thi position first. @{i}Example:@{ui} Work:Data/Out @endnode @node "CO13" "Configuration - Address book" @toc "CO_W" @{b}@{u}Configuration - ADDRESS BOOK@{uu} (Visible columns, personal data exchange) @{ub} @{u}Columns@{uu} Select the items you want to show in the address book. @{fg shine}------------------Personal data exchange---------------@{fg text} [] @{u}Add personal data@{uu} Check this option to create special message headers containing personal data like your postal address, phone number, homepage, date of birth or URL of your picture. If the recipient works with YAM too, (s)he will able to create an address book entry and fill it with your data. To get this working, add an entry in @{i}your@{ui} address book containing your data (YAM will find your entry based on the e-mail address). @{u}Save sender's address@{uu} YAM can automatically save the sender's address when you're reading a message, i.e. it creates a new entry in the address book. Choose one of these modes: @{b}never@{ub} Don't save addresses @{b}ask before@{ub} You'll be prompted every time if the address should be saved @{b}if info available; ask@{ub} You'll only be prompted if there's personal data of the sender available, otherwise the address won't be saved @{b}if info available@{ub} The address will be saved automatically if there's personal data of the sender available @{b}always@{ub} All new addresses will be saved automatically @{u}Save photos in@{uu} The pictures of the senders are stored here. @{i}Example:@{ui} YAM:Gallery @{u}Group for new entries@{uu} Alias of the group that will contain the new address book entries. The group will be created if it doesn't exist. @{i}Example:@{ui} NEW @{u}URL of your picture@{uu} If existing, enter the WWW address (URL) of a small photo of you here. The URL will be listed in the header of every outgoing message if 'Add personal information' is enabled. @{i}Example:@{ui} http://www.yam.ch/gallery/BECK_Marcel.gif @{u}HTTP Proxy server@{uu} If you're behind a firewall and only get into the Internet using a proxy server, then you have to enter the address of that proxy server. Otherwise it's not possible to download photos or get information about new versions of YAM. @{i}Example:@{ui} proxy.access.ch:8080 @endnode @node "CO14" "Configuration - ARexx" @toc "CO_W" @{b}@{u}Configuration - AREXX@{uu} (ARexx- und AmigaDOS-Scripts)@{ub} As well as the ARexx menu in the main window, which can hold up to ten scripts, ARexx scripts can also be started by specified events. Thus it is possible with two simple scripts to start up Miami in order to go online and fetch new mail and then close Miami again once the mail has been downloaded. @{u}Name@{uu} The title of the script as it appears in the ARexx menu, @{i}e.g.@{ui} Browser start. @{u}Script@{uu} File name of the ARexx script, with any parameters (in usual ARexx fashion but without a call to 'RX'). @{i}Example:@{ui} YAM:rexx/StartBrowser.rexx [] @{u}Open Console window@{uu} The script opens a window for input and output, while it is running. Switch this option off if it is not required. [] @{u}Wait for termination@{uu} Switch this option off if you want the script to run in the background, which means you don't want to wait for it to finish. @endnode @node "CO15" "Configuration - Miscellaneous" @toc "CO_W" @{b}@{u}Configuration - MISCELLANEOUS@{ub}@{uu} @{fg shine}-------------------------Paths-------------------------@{fg text} @{u}Directory for temp files@{uu} YAM requires this directory for saving some files needed while processing. If you are short on memory (2 MB or less) you better choose a path on your hard disk to avoid possible problems with large messages. @{i}Example:@{ui} RAM:t @{fg shine}-----------------Mailbox status AppIcon----------------@{fg text} @{u}Position@{uu} X Y Enter the desired position on your workbench for YAM's AppIcon here. In case there should already be another icon at this position the workbench will choose a 'safe' position for the AppIcon on its own (so you don't have to worry about 'deleting' another icon). @{i}Example:@{ui} X 550 Y 144 [] @{u}Closegadget iconifies program@{uu} Normally the closegagdet (or ESC-key) will terminate the program. Activate this option to iconify YAM instead. @{fg shine}-------------------Save/delete messages----------------@{fg text} [] @{u}Confirm deletion of [xx] or more messages@{uu} If this option is activated a security requester will appear before deleting a certain number of messages. This especially makes sense when a number of two or more is selected. [] @{u}Remove messages immediately@{uu} If this option is switched on messages won't be moved into the 'Deleted' folder on deletion but will be erased from hard disk immediately. Doing so saves a little time and memory but on the other hand you won't be able to reconstruct any message deleted by mistake. [] @{u}Save sent messages@{uu} Activate this option to make YAM save sent messages into the 'Sent' folder. You can select this as well specifically for each mail when processing it. @{fg shine}-------------------Message tracking--------------------@{fg text} Here you can define how YAM should react if a message's sender has requested a condition report (MDN) when writing the message by choosing 'Message tracking'. @{fg shine} Ignore@{fg text} - The request will be ignored completely and there won't be any report. @{fg shine} Autodeny@{fg text} - The sender will be informed that you don't wish to send a condition report for the message. @{fg shine} Accept@{fg text} - The sender will be informed about the message's condition as requested. @{fg shine} Ask user@{fg text} - You can decide in each case if you want to ignore, deny or accept the request. In addition YAM's reaction can be related to the event activating the condition report: @{fg shine} Display@{fg text} - The message will be read or answered @{fg shine} Process@{fg text} - The message will be bounced or forwarded without reading @{fg shine} Delete@{fg text} - The message will be deleted without asking @{fg shine} Filter@{fg text} - The message will be automatically processed or deleted by a filter [] @{u}Send at once@{uu} The condition report will be sent immediately if there's a TCP/IP-stack running. If not it will be saved to the 'Outgoing' folder. @{fg shine}------------------XPK/LhA settings---------------------@{fg text} @{u}Packer@{uu} Here you can choose the XPK library you wish to use for compressing folders by clicking on the pop-up button. Before doing so an XPK package must be installed on your computer system. This package is not contained in the YAM archive. You can obtain such a package from Aminet. You can select the packer's efficiency using the slider bar on the right-hand side of the pop-up button. The higher the value is the more effective and the slower is the compression. @{i}Example:@{ui} NUKE 100% @{u}Pack/protect@{uu} Click on the pop-up button to select the XPK library you wish to use for compression and password protection of folders. You can only select XPK libraries offering password protection. Specify the packer's efficiency with the slider bar on the right-hand side of the pop-up button. @{i}Example:@{ui} HUFF 50% @{u}Archiver@{uu} YAM is capable of crunching one or more files before attaching them to an e-mail. Suitable for that use are archive packers such as LHA, LZX or ZIP. Enter the full command line for your favourite packer. You can insert variables for the resulting archive and the source files (or a list containing the source files) by clicking on the pop-up button on the righthand side of the text field. @{i}Example:@{ui} LhA -a -m -i%l a %a @{i}Example:@{ui} BIN:LZX -a -m a %a %f @endnode @node "CO_H" "Configuration - Hidden Options" @toc "CO_W" @{b}@{u}Configuration - HIDDEN OPTIONS@{ub}@{uu} YAM recognises a couple of parameters which cannot be set through the configuration window. You have to load the file YAM:.config into an editor and alter the parameters in the [Advanced] section by hand. @{u}LetterPart@{uu} Usually the first part of a multipart letter contains tha actual message while the subsequent parts are the attachments. A few mail servers, like GeoCities, use the first part for their advertisments which then get quoted in a reply instead of the actual message. Wtih the option LetterPart you can correct this. @{i}Example:@{ui} LetterPart = 2 @{u}WriteIndexes@{uu} If the contents of a folder are altered, YAM must rebuild the index. This index is in the memory and is saved back to the hard disk on a normal exit. In the event that the computer has to be rebooted (because of a crash, perhaps), YAM has to rebuild the indices on startup. Therefore YAM will save alterations to the index file at intervals of 120 seconds. This time interval can be altered using the WriteIndexes option. @{i}Example:@{ui} WriteIndexes = 30 @{u}SupportSite@{uu} This is the address of the YAM homepage, which is used for access to the user picture gallery and the version check. @{i}Example:@{ui} SupportSite = http://www.yam.ch/ @{u}JumpToNewMsg@{uu} If this option is set to 'Y', YAM jumps to the first new or unread message whenever you select a folder. @{i}Example:@{ui} JumpToNewMsg = N @{u}PrinterCheck@{uu} YAM does some printer checking before printing a message. This test can be disabled because it's not fully compatible with some printer drivers. @{i}Example:@{ui} PrinterCheck = N @{u}HideGUIElements@{uu} This options can be used to hide some elements of the graphical user interface. The following values can be added: 4 for the toolbars, 2 for the cursor position display in the editor and 1 for the status bar. @{i}Example:@{ui} HideGUIElements = 3 @endnode @node "CO_M" "Configuration - Menus" @{b}@{u}Configuration - MENUS@{ub}@{uu} @{u}Project/Open@{uu} Loads a config file thus enabling you to use several different configuration setups. @{u}Project/Save as@{uu} Saves the actual configuration with another name. @{u}Edit/Reset To Defaults@{uu} Resets the parameters on the current sheet to their default values internally contained in YAM. @{u}Edit/Reset all settings@{uu} Resets all parameters to their default values internally contained in YAM. @{u}Edit/Last Saved@{uu} Replaces the present configuration with the one most recently saved. @{u}Edit/Restore@{uu} Discards any changes of the settings made since the last time they've been [Save]d or [Use]d. @{u}Extras/Scan for folders@{uu} Searches the mail directory for folders and adds them to the folder list. This allows to reactivate folders that got lost in the configuration, but still exist on your hard disk. This menu item can only be called from the @{"Folders" link "CO03" 0} sheet. @{u}Extras/Import MIME viewers & types@{uu} Imports attachment types, file name extenstions and MIME viewers. Supported file formats are mime.types, mailcap and MIME.prefs. This menu item can only be called from the @{"MIME" link "CO12" 0} sheet. @endnode @node "AB_W" "Address Book" @{b}@{u}ADDRESS BOOK@{ub}@{uu} @{"menu bar" link "AB_M" 0} ________________________________________________________________ | @{"toolbar" link "AB_B" 0} | |________________________________________________________________| ________________________________________________________________ | @{fg shine}Alias@{fg text} | @{fg shine}Name@{fg text} | @{fg shine}Description@{fg text} | @{fg shine}Address@{fg text} | |----------|--------------|-----------------|--------------------| |js | John Smith | mate | jsmith@isp.co.uk | | | | | | | | | | | | | | | | |__________|______________|_________________|____________________| By default the list displays four columns as above, but you can (of course) change the @{"List" link "CO09" 0} configuration, to include phone numbers for example. You can click and drag the column dividers to reposition them. Double click on an entry to see or edit the information in the @{"edit address" link "EA_W" 0} window. In addition to the fields mentioned, you can enter the postal address, PGP key, homepage URL, date of birth and a picture. An entry must contain at the least the real name and the e-mail address. The point of the @{b}Alias@{ub} is to save typing; you can put a short nickname, or initials, into the To field of an e-mail message and let YAM fill in the details. For this to work, the alias obviously has to be unique to the entry. In addition to personal entries, the address book can also contain @{b}Lists@{ub} of individual recipients which can be invoked with a single alias. Lists are used for circular e-mails and are marked with the list symbol (three little heads). Both individual entries and lists can be put into @{b}Groups@{ub}, which are like subdirectories, used to keep the address book clearly arranged. Group names are displayed in bold. You can open a group to display the names in it by clicking on the [+] and close it again by clicking on [-]. Use drag & drop to move an entry from one group into another. @endnode @node "AB_B" "Address book - Toolbar" @toc "AB_W" @{b}@{u}Address book - TOOLBAR@{ub}@{uu} [@{u}Save@{uu}] Saves the address book to your hard disk. [@{u}Find@{uu}] Searches the address book for a specific text string. All variables contained in the database will be searched with full support of @{"AmigaDOS patterns" link "DOSW" 0}. If the result of the search is positive the alias and the name of the found entry will be displayed. You can then search for other hits or edit the found entry. @{i}Example:@{ui} Anna#? (finds all Annas contained in the address book) [@{u}Person@{uu}] [@{u}List@{uu}] [@{u}Group@{uu}] All three buttons open the @{"Edit address" link "EA_W" 0} window to 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. [@{u}Edit@{uu}] This also opens the edit address window, to see or edit the information stored. Again, the layout depends on the type of entry. [@{u}Delete@{uu}] Deletes the selected entry from the address book. [@{u}Print@{uu}] Prints the selected entry. [@{u}Unfold@{uu}] Unfolds all groups (subdirectories) of the address book so all entries will be visible. [@{u}Fold@{uu}] Folds all groups (subdirectories) of the address book so only the entries on the highest hierarchical level will be visible. [@{u}To:@{uu}] Uses the selected entry as the primary recipient of a new e-mail. If the address book window has been opened from the main window, a new 'write' window will appear. [@{u}CC:@{uu}] Uses the selected entry as secondary recipient of a new e-mail. If the address book window has been opened from the main window, a new 'write' window will appear. [@{u}BCC:@{uu}] Uses the selected entry as recipient of a hidden copy of a new e-mail. If the address book window has been opened from the main window, a new 'write' window will appear. @endnode @node "AB_M" "Address book - Menus" @toc "AB_W" @{b}@{u}Address book - MENUS@{ub}@{uu} @{u}Address book/New@{uu} Starts a new address book; all existing entries of the address book presently resident in RAM will be deleted. CAUTION: Save your old address book with another name before selecting this option!! @{u}Address book/Open@{uu} Opens an existing address book from your hard disk. The address book presently resident in RAM will be replaced. @{u}Address book/Append@{uu} Loads another address book from your hard disk and appends its contents to the address book presently resident in RAM. @{u}Address book/Saves@{uu} Saves the address book to your hard disk. @{u}Address book/Save as@{uu} Saves the address book with a name of your choice so you can keep several different address book files. @{u}Address book/Find@{uu} Searches the address book for a certain character string. For more details see @{"BUTTONS" link "AB_B" 0}/Search. @{u}Address book/Print@{uu} Prints the whole address book. Select 'Short format' to print a single line for each entry. Select 'Long format' to print the entry with details, which needs several lines for each entry. @{u}Entry/New person@{uu} @{u}Entry/New distribution list@{uu} @{u}Entry/New group@{uu} Opens the @{"Edit address window" link "EA_W" 0} to add a new entry to the address book. The appearance of the window depends on the type of entry. @{u}Entry/Edit@{uu} The selected entry can be modified in the @{"Edit address window" link "EA_W" 0}. @{u}Entry/Duplicate@{uu} Duplicates the selected entry. The alias will be adjusted automatically. @{u}Entry/Delete@{uu} Deletes the selected entry from the address book. @{u}Entry/Print@{uu} Prints the selected entry. (Who would have guessed it? ;) ). @{u}Sort/by@{uu}... Sorts the address book by alias, last name, first name, description or e-mail address. Please note that 'First name' is related to the first word in the 'Full name' textfield while 'Last name' is related to the last word in this textfield. @endnode @node "EA_W" "Entering addresses" @toc "AB_W" @{b}@{u}Address book - ENTERING ADDRESSES@{ub}@{uu} In this window a single address book entry can be edited. According to the kind of entry (person, list or group) you will see a different set of editing fields. Click on [Okay] to accept the changes, click on [Cancel] to discard the changes. @{b}====================person====================@{ub} @{fg shine}--------------------Electronic mail--------------------@{fg text} @{u}Alias@{uu} (applies to person, list or group) An 'Alias' is a convenient short name that identifes the address book entry unambiguously. Its function is to save typing - you can put the alias into the to field of a message and YAM fills in the details when sending the message. If you leave this field blank, YAM will create an alias for the entry. @{i}Example:@{ui}JohnD @{u}Real Name@{uu} The person's first name and surname. @{i}Example:@{ui}John Doe @{u}Email address@{uu} The internet address to use to send e-mail to this person. @{i}Example:@{ui} jdoe@athome.uk @{u}PGP key ID@{uu} The hexadecimal code of this person's PGP public key. It is needed to send the recipient a PGP encrypted message. Click on the pop-up button to select the key from your public key folder (for that, PGP must be installed on your system and the key you're looking for must be in the keyring folder). @{i}Example:@{ui} 0x709B40C3 @{u}Home page@{uu} The URL for the person's homepage in the world wide web. YAM can connect to this address via your browser, provided that the appropriate script is specified in the @{"scripts" link "CO14" 0} configuration for 'when double clicking a URL'. All you have to do is to click on the button to the right of the textfield. @{i}Example:@{ui} http://come.to/mars @{fg shine}----------------------Snail mail-----------------------@{fg text} @{u}Street@{uu} Street and house number of the postal address. @{i}Example:@{ui} 43 High street @{u}City / ZIP@{uu} City and (ZIP) postcode (who would have guessed that...) @{i}Example:@{ui} Shrewsbury SY1 3PE @{u}State / Country@{uu} @{i}Example:@{ui}Shropshire, England @{u}Phone number(s)@{uu} One or more phone numbers (voice, FAX, cellular phone, whatever...) @{i}Example:@{ui} 08154711 @{fg shine}---------------------Miscellaneous---------------------@{fg text} @{u}Description@{uu} (applies to person, list or group) Any comment you'd like to enter to describe the current entry. @{i}Example:@{ui} My beloved one ;-) @{u}Date of birth@{uu} The person's date of birth. Enter it in the format DD-MMM-YYYY. @{i}Example:@{ui} 12-Dec-1967 @{fg shine}------------------------Portrait-----------------------@{fg text} @{u}Select@{uu} 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. If you want this picture will show up whenever you display a message written by this person. (See 'sender info' in the @{"Read" link "CO05" 0} configuration) @{u}Download@{uu} You can find a steadily growing number of portraits of other users of YAM on the YAM homepage. YAM 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 [download] button. YAM 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 (Name, e-mail address and home page) is made good and the picture downloaded and saved in the gallery. If you want to add your picture to the collection, please follow the instructions on YAM's home page at http://www.yam.ch/gallery.html. @{b}=====================list=====================@{ub} @{u}Alias@{uu} as described above. @{u}Return address@{uu} If you'd like to maintain a small mailing list using a YAM distribution list you will have to correct the reply-to addresses of the original messages. Otherwise the answer to an e-mail would be returned to the message's author and not to the mailing list. Enter the return address you'd like to use. @{i}Example:@{ui} discussion@provider.uk @{u}Mailing list name@{uu} When maintaining a mailing list by using a YAM distribution list enter the mailing list's name here. This name will appear in the 'To' header field to help the recipient sorting the mail correctly by using filters. @{i}Example:@{ui} discussion-ML @{u}Members@{uu} A list of all current members of the distribution list. You may enter aliases, names or complete e-mail addresses. Click on [New] to add a new list member, [Delete] to delete the highlighted entry or [Sort] to have all entries sorted alphabetically. @{b}====================group=====================@{ub} Only the @{i}Alias@{ui} and @{i}Description@{ui} fields apply in this case. @endnode @node "FI_W" "Finding messages" @{b}@{u}FINDING MESSAGES@{ub}@{uu} If you have many messages and folders, it is easy to lose track of them all. You know you have saved a message on a particular topic, but where? YAM's search function solves this problem. In the upper half of the window you define the query. On the left you can select one or more folders in which to search. On the right you define the @{"Search criterion" link "FI_K" 0}. In the lower half of the window you will get a list of messages which match the query. @{u}Functions of the buttons@{uu} [@{u}everywhere@{uu}] Includes all folders in your search. [@{u}Use filter settings@{uu}] Replaces the search criterion with a @{"Filter" link "CO04" 0}. [@{u}Make new filter@{uu}] Sets up a new @{"Filter" link "CO04" 0} based on the current search criterion. [@{u}Start search@{uu}] Begins the search. Matching messages are shown in the results list. The search can be stopped by clicking on [Abort]. [@{u}Select found messages@{uu}] Selects all the messages listed as a result of the search, highlighting them in the @{"message list" link "MA01" 0} of the main window. [@{u}Read messages@{uu}] Displays the contents of a selected message in the result list. Double-clicking on the name in the result list has the same effect. @endnode @node "FI_K" "Finding messages - Search criteria" @toc "FI_W" @{b}@{u}SEARCH CRITERIA@{ub}@{uu} @{u}Search in@{uu} Here you select what part of the message is to be searched with the search pattern. If you want to search in a header line you can either pick it out of the list or else choose 'Other field' and type in the name of the field in the text gadget on the right. 'Message body' causes the whole message to be searched, apart from the headers. Note that a full text search can take a long time. (YAM has to decode messages in MIME format before it can search them.) @{i}Example@{ui}: Other field X-Mailer @{u}Comparison@{uu} The instruction has two components, the comparison operator and the search pattern. YAM supports the following @{b}comparison operators@{ub}: @{fg shine} =@{fg text} the text which is compared must match the search pattern @{fg shine} <@{fg text} the text must be less than the search string @{fg shine} >@{fg text} the text must be greater than the search string @{fg shine} <>@{fg text} the text must be different from the search string @{fg shine} IN@{fg text} the text must match a pattern contained in the file which is specified in the text field to the right side of the comparison cycle gadget. Instead of a search pattern itself the name of a file is to be inserted here, containing one or several lines of search patterns. In this way it is possible to create a so-called 'Killfile' containing a list of e-mail addresses. The comparison operators < and > work using alphanumeric ordering, as used for names in a telephone directory, so James < Jim and 12 < 2. The @{b}search pattern@{ub} may contain Amiga-DOS @{"wildcards" link "DOSW" 0} such as ?, #?, (a|b) or [abc]. Please note that the search pattern [YAM]#? will filter all messages beginning with Y, A or M. For filtering mails out of a mailing list (for example a mailing list related to YAM) you need to use the search pattern ?YAM#? or have the filter compare the 'To' field with the address of the mailing list. @{i}Example:@{ui} = YAM 1.3.#? @{u}Address/Name@{uu} If you want to search a header field containing an e-mail address you can specify here whether the search pattern should be processed on the address (@{i}e.g.@{ui} jdoe@provider.uk) or the author's name (@{i}e.g.@{ui} 'John Doe'). [] @{u}Case sensitive@{uu} Activate this option if you want the search to distinguish between normal and capital letters. [] @{u}Substring search@{uu} If the search pattern consists of only a part of the header field which is to be searched through you must activate this option. YAM will then complete the search pattern with #? internally. @endnode @node "WR_W" "Write window" @{b}@{u}WRITING MESSAGES@{ub}@{uu} This window will appear when you choose to write a new message or answer or forward an existing message. You can open TWO write windows at a time. The write window consists of three sheets, laid out as shown: The Menu bar is the same for each sheet: @{"Text" link "WRM1" 0} @{"Edit" link "WRM2" 0} @{"Attachments" link "WRM3" 0} @{"Options" link "WR02" 0} _______________________ ___________________ ____________________ | @{"  Message  " link "WR00" 0} | | @{"Attachments" link "WR01" 0} | | @{"  Options  " link "WR02" 0} | | |_|____________________|_|____________________| | | | | | | | | | The big text edit field on the 'Message' | | sheet is the @{"internal editor" link "EDIT" 0} which you | | can use to enter your message. | | | | | | | | | |_____________________________________________________________________| _______________ _______________ _______________ _______________ |@{u} Send now @{uu}| |@{u} Send later @{uu}| |@{u} Hold @{uu}| |@{u} Cancel @{uu}| These four buttons appear at the bottom of each sheet: @{u}Send now@{uu} Prepares the message for sending, copies it to the outgoing folder and tries to send the mail at once. For this option to work correctly there must be a TCP/IP stack running already. @{u}Send later@{uu} Prepares the message for sending and copies it to the outgoing folder. Use this button when working off line. @{u}Hold@{uu} 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 (@{i}e.g.@{ui} if you'd like to make some additions to the e-mail at a later time). @{u}Cancel@{uu} Push this in case you've changed your mind. BEWARE: All entries made in this window will be lost. But don't worry too much, the security requester will pop up before YAM really discards any modifications you have made. (It won't show if you haven't made any modifications at all, though). @endnode @node "WR00" "Write window - message" @toc "WR_W" @{b}@{u}Write window - MESSAGE SHEET@{ub}@{uu} Above the large @{"text editor" link "EDIT" 0} field there are two header fields and a toolbar @{u}To@{uu} Insert the main recipient here, you wish to send the actual message to. You may 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 have to separate them by inserting commas. To insert an address book entry just click on the pop-up button to the right thereby opening the address book. Now double-click on the selected entry or simply drag it over to the text field holding the left mouse button. Then click on [To:]. If YAM cannot find a name or alias you've inserted manually into the text field in the address book the screen will flash, as soon as you press the RETURN key. You can change an alias to an e-mail address manually by clicking on the [<] button to the right. @{i}Example:@{ui} jdoe, boss@work.whyme.com @{u}Subject@{uu} What the mail is all about. When a mail is answered there will be a 'Re:' inserted in front of the original subject, when forwarded a '(fwd)' will be added to the subject. @{b}@{u}Toolbar@{ub}@{uu} @{u}[Editor]@{uu} equivalent to menu item @{"Text/Launch editor" link "WRM1" 0}. @{u}[Insert]@{uu} equivalent to menu item @{"Text/Insert as/plain" link "WRM1" 0}. @{u}[Cut]@{uu} equivalent to menu item @{"Edit/Cut" link "WRM2" 0}. @{u}[Copy]@{uu} equivalent to menu item @{"Edit/Copy" link "WRM2" 0}. @{u}[Paste]@{uu} equivalent to menu item @{"Edit/Paste" link "WRM2" 0}. @{u}[Undo]@{uu} equivalent to menu item @{"Edit/Undo" link "WRM2" 0}. @{u}[Bold]@{uu} equivalent to menu item @{"Edit/Textstyle/Bold" link "WRM2" 0}. @{u}[Italic]@{uu} equivalent to menu item @{"Edit/Textstyle/Italic" link "WRM2" 0}. @{u}[ULined]@{uu} equivalent to menu item @{"Edit/Textstyle/Underlined" link "WRM2" 0}. @{u}[Colored]@{uu} equivalent to menu item @{"Edit/Textstyle/Alternative color" link "WRM2" 0}. @endnode @node "WR01" "Write window - Attachments " @toc "WR_W" @{b}@{u}Write window - ATTACHMENTS SHEET@{ub}@{uu} You can add one or more files to your message. This way you can send binary files such as archives, pictures, etc. via e-mail. You can choose the method of encoding (MIME or UUencoded) and write a comment for each file. Files can be archived automatically to reduce the size of the message. The attachment list contains five columns: File name, Size (in bytes), Contents, Encryption and Description. You can re-order the files using Drag & Drop. @{b}@{u}Buttons and Gadgets@{ub}@{uu} @{u}Add file(s)@{uu} You can select on or more files which will be added as a new attachment to the list. YAM recognizes over 20 filetypes automatically and will fill in the field 'MIME type' accordingly. @{u}Pack & add@{uu} By adding files this way they will be archived (LHA, LZX or ZIP) before being attached to the message. Select the files you would like to be added to the archive, then enter an archive name. You can define the archiver in the configuration window under @{"Miscellaneous" link "CO15" 0}. @{u}Delete@{uu} Removes the selected entries from the list. @{u}Display@{uu} Displays the selected entry using one of the programs contained in the MIME-viewer list. The default program is MultiView. @{u}Encoding@{uu} For normal use you should encode your files using MIME (base64/qp). YAM uses quoted-printable for text files and base64 for binary files. If the recipient isn't able to decode messages in MIME format (because his e-mailer does not support this) you can also UUencode the files. Messages containing UUencoded files are still in MIME multipart/mixed format but can be stripped from the message using a UUdecoder such as UUxt. A message generated by YAM may contain UUencoded attachments as well as attachments in base64 format. @{u}MIME type@{uu} As long as YAM recognizes the filetype of the attachment the correct MIME type will be inserted automatically. Otherwise the default setting (application/octet-stream) will be used. Before defining a new MIME type please check if it's not already part of the pop-up list. @{i}Example:@{ui} image/gif @{u}Description@{uu} You may enter a comment on the actual attachment here. When more attachments are added the description - if there is one - will be copied. @{i}Example:@{ui} Picture from our summer holidays (GIF format) @endnode @node "WR02" "Write window - Options" @toc "WR_W" @{b}@{u}Write window - OPTIONS SHEET@{ub}@{uu} The @{b}OPTIONS MENU@{ub} items correspond to the buttons on this sheet. The layout of this sheet is: ___________________________________________________ Copies to|_______________________________________________|@{u}<@{uu}|@{u}^@{uu}| Hidden copies to|_______________________________________________|@{u}<@{uu}|@{u}^@{uu}| From|_______________________________________________|@{u}<@{uu}|@{u}^@{uu}| Reply to|_______________________________________________|@{u}<@{uu}|@{u}^@{uu}| Additional header|___________________________________________________| _____________ _____________ ____________ | | | | | | |Send options | | signature | | security | |_____________| |_____________| |____________| @{b}@{u}Header fields@{ub}@{uu} @{u}Copies to@{uu} The recipients listed here will receive a copy of the actual message. See also information about the 'To' header given for the @{"Message sheet" link "WR00" 0}. @{u}Hidden copies to@{uu} The recipients listed here will receive a copy of the actual message. Unlike the recipients listed in 'Copies to' they won't be listed in the message header. This is useful if you want to send someone a copy of a message without the other recipient(s) knowing. @{u}From@{uu} Pretty obvious, really! YAM will fill this in with your address, but you can change the way your real name appears (the string in double quotes). @{u}Reply to@{uu} This setting is valid only for the actual message and will be inserted instead of the normal reply-to address as specified in the program settings. Leave this blank unless it is different from the e-mail address in the From header. @{u}Additional header@{uu} If for any reason it should become necessary to add one or more special header lines to a message you can enter these here. Several lines must be separated by inserting '/n'. @{b}@{u}Send options@{ub}@{uu} @{u}Delete after sending@{uu} Activate this option if you want the message to be deleted right after transfer instead of being copied to the 'Sent' folder. @{u}Return receipt@{uu} By activating this option you ask the recipient's mail server to inform you of the successful mail transfer. Normally you'll only be notified if problems have occurred. Please note that not all mail servers support this function. The command to notify you is sent in the 'Return-Receipt-To' header field. @{u}Track message@{uu} Activate this option to ask the recipient's e-mail program to inform you about the condition of your message, stating if the message has been read by the recipient or if the recipient has deleted or forwarded it. Please note there are only few e-mail programs which support this function as well as the fact that the recipient is able to forbid the sending of status reports on e-mails. So not getting any information even with this option in force does not necessarily mean the message has not been read. The command to send a status report is contained in the 'Disposition-Notification-To' header field. At the time of writing the internet standard for Message Disposition Notifications (MDN) was still being formulated. @{u}Add personalinfo @{uu} Check this option to create special message headers containing personal data like your postal address, phone number, homepage, date of birth or URL of your picture. If the recipient works with YAM too, (s)he will able to create an address book entry and fill it with your data. To get this working, add an entry in @{i}your@{ui} address book containing your data (YAM will find your entry based on the e-mail address). If existing, enter the WWW address of a small photo of you in the "address book" section of the configuration. @{u}Importance@{uu} Specify here how important the message is for the recipient. Messages with a high grade of importance will be displayed with an exclamation mark in the status line and will be put into first place by automatic mail sorting. The importance will be stated in the 'Importance' header field. @{b}@{u}Signature@{ub}@{uu} Here you can replace the standard signature by one of the alternative signatures or switch it off completely. @{b}@{u}Security@{ub}@{uu} Select here which security measures you want to take for this message. @{b} none:@{ub} Normal mail transfer. @{b} sign:@{ub} The message will be signed with the recipient's PGP key and saved in multipart/signed format. The text of the message will be readable without PGP. @{b} encrypt:@{ub} The message will be encrypted using the recipient's PGP key and saved in multipart/signed format. @{b} sign and encrypt:@{ub} This is a combination of the two previous options allowing the recipient to check the sender's identity. @{b} send anonymously:@{ub} The mail will be sent using an ANON service so the sender will stay anonymous. Please note that encrypted or signed messages must not have binary files attached. You can find further information in the chapter @{"PGP" link "PGP" 0} and in @{"CONFIGURATION/Security" link "CO10" 0}. @endnode @node "WRM1" "Write window - Text menu" @toc "WR_W" @{b}@{u}Write window - TEXT MENU@{ub}@{uu} @{u}Text/New@{uu} Clears any text to start a new message. @{u}Text/Open@{uu}... Opens an existing file. @{u}Text/Insert as@{uu} » plain Inserts a text file at the current cursor position. @{u}Text/Insert as@{uu} » quoted Inserts a text file at the current cursor position, prefacing each line with the citation character (usually '>'). @{u}Text/Insert as@{uu} » ROT-13 encrypted Inserts a text file at the current cursor position and replaces each letter with the one 13 characters on, cycling back from Z to A (so A->M, B->N, M->A). This very simple code is used for example for indecent humour. @{u}Text/Launch editor@{uu} This lets you compose your message with your favourite editor (as installed in the @{"Write" link "CO06" 0} configuration). Note that a few functions such as text styles and the @{"Glossary" link "DI_W" 0} are only supported correctly in the internal editor. Whenever you save in the external editor, the text in the internal editor is updated. (This is due to the way the operating system interprets the FileSystem-Notification when you save the temporary file.) @endnode @node "WRM2" "Write window - Edit menu" @toc "WR_W" @{b}@{u}Write window - EDIT MENU@{ub}@{uu} @{u}Edit/Cut@{uu} Cuts the marked text and saves it to the Clipboard. @{u}Edit/Copy@{uu} Places a copy of the marked text on the Clipboard. @{u}Edit/Paste@{uu} Inserts the text on the Clipboard at the current cursor position. @{u}Edit/PasteAs@{uu} » quoted Inserts the text on the Clipboard at the current cursor position, prefacing each line with the citation mark. @{u}Edit/PasteAs@{uu} » ROT-13 encoded Inserts a text file at the current cursor position, applying ROT-13 encoding. (See also under @{"Text/Input as" link "WRM1" 0}). @{u}Edit/Undo@{uu} Undoes the last change made in the editor @{u}Edit/Redo@{uu} Restores the change just undone with 'Edit/Undo' @{u}Edit/Glossary@{uu} Opens the @{"Glossary" link "DI_W" 0} window. @{u}Edit/Textstyle@{uu} » Bold Toggles bold type on or off for a marked block or for text entered subsequently. In a transmitted message text in bold type is delineated by asterisks, thus @{b}bold@{ub} -> *bold* @{u}Edit/Textstyle@{uu} » Italic Toggles italic type on or off for a marked block or for text entered subsequently. In a transmitted message text in italics is delineated by slashes, thus @{i}italic@{ui} -> /italic/ @{u}Edit/Textstyle@{uu} » Underlined Toggles underlining on or off for a marked block or for text entered subsequently. In a transmitted message text in bold type is delineated by underline characters, thus @{u}underline@{uu} -> _underline_ @{u}Edit/Textstyle@{uu} » Alternative color Toggles coloured type on or off for a marked block or for text entered subsequently. The colour is defined in the @{"Read configuration" link "CO05" 0}. In a transmitted message the coloured text is delineated by hash signs, thus: @{fg fill}colour@{fg text} -> #colour# @{u}Edit/Separators@{uu} » thin @{i}or@{ui} thick Inserts a separator at the current cursor position. It does this by inserting an extra line containing either or . YAM and other (MUI-)Mail programs interpret this character sequence as a separator. @{u}Edit/Emoticons@{uu} » happy | indifferent | sad/angry | ironic Inserts a 'smiley' at the current cursor position. Smilies express your feelings about the topic and compensate for the loss of intonation when expressing yourself in writing rather than speech. (See also under @{"E-Mail Netiquette" link "NETI" 0}). @{u}Edit/Type and Spell@{uu} Switches automatic spell-checking on or off. The spell-check is a function of the Text-editor class and must be configured in @{"Settings/MUI" link "MAM5" 0}. It must use an external program like AlphaSpell. If you type in a word which is not in the dictionary, the screen flashes (and you will get an audible signal too if you have set this up in your Workbench Sound-Preferences). Hit the key to get a list of suggestions for the correct spelling. @endnode @node "WRM3" "Write window - Attachments menu" @toc "WR_W" @{b}@{u}Write window - ATTACHMENTS MENU@{ub}@{uu} @{u}Attachments/Add file@{uu} Equivalent to the button [Add file] in the @{"Attachments" link "WR01" 0} sheet. @{u}Attachments/Add clipboard@{uu} Adds the contents of the clipboard as an attachment to your message, so you can easily include documents from other applications. @{u}Attachments/Add PGP key@{uu} Use this to attach your @{"public PGP key" link "PGP" 0} to your message. The recipient can add this to his "keyring" and will then be able in future to send you PGP-encoded messages. @endnode @node "EDIT" "Editor features" @{b}@{u}THE INTERNAL EDITOR@{ub}@{uu} YAM uses the efficient MUI-Class @{fg shine}TextEditor.mcc@{fg text} 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}. Although 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 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/ @endnode @node "DI_W" "The Glossary" @{b}@{u}THE GLOSSARY@{ub}@{uu} YAM's Glossary acts as a place to collect blocks of text which you may use fairly frequently, such as templates for letters, greeting phrases or frequently asked questions. The text can be as long as desired and can extend over several lines. Using the menu item 'Edit/glossary' or the key combination you can go straight from the @{"internal editor" link "EDIT" 0} into the glossary. Each entry has a name (@{i}e.g.@{ui} "ys" for "Yours sincerely") which you can see in the left-hand part of the window. Click on the name and you can edit the entry in the right-hand side of the window. A double click on the name pastes the text block at the current cursor position and closes the window. @{b}@{u}Functions of the buttons@{ub}@{uu}: @{b}[New]@{ub} Starts a new entry in the glossary. @{b}[Add selection]@{ub} Creates a new entry in the glossary based on the marked text in the text editor. @{b}[Delete]@{ub} Deletes the selected entry in the glossary. @{b}[Paste]@{ub} Pastes the highlighted entry into the text editor at the current cursor position. @endnode @node "RE_W" "Read window" @{b}@{u}READING MESSAGES@{ub}@{uu} This window opens when you choose to read a message. If you have enabled multiple windows in the @{"Read configuration" link "CO05" 0}, then you can have up to four open simultaneously. The window is laid out as shown: Menu bar @{"Message" link "REM1" 0} @{"Navigation" link "REM2" 0} @{"PGP" link "REM3" 0} @{"Settings" link "REM4" 0} __________________________________________________ ________ | @{"Tool bar" link "RE_B" 0} | | @{"status" link "MA0S" 0} | |__________________________________________________| |________| _____________________________________________________________ | | | Message headers | |_____________________________________________________________| You can _____________________________________________________________ <-- | | click & | | drag the | | divider | Message body | | | | | |_____________________________________________________________| @{u}Message status@{uu} At the top right corner there is a small field in which small icons appear to display the @{"status" link "MA0S" 0} of the message (new, read etc.). @{u}Headers@{uu} The amount of information displayed in the list of @{"headers" link "HEAD" 0} for the selected message is set in the @{"configuration" link "CO05" 0} but can be changed (temporarily) with the @{"Settings" link "REM4" 0} menu. 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. @{u}Message body@{uu} The largest field displays the message body. Only text can be shown; for graphics or sounds you must use an @{"external program" link "CO05" 0}. Navigation within the message uses the same keyboard shortcuts as the @{"internal editor" link "EDIT" 0}. In addition you can hit the spacebar to go forwards one page and to go back to the previous page. To copy part of the 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 doubleclick on an e-mail address, a new 'write' window opens and the address is pasted into the 'To' header. A doubleclick on a URL, either http:// or ftp://, starts the macro defined in the @{"Scripts configuration" link "CO14" 0} with the URL as parameter. In this way you can without fuss copy WWW-addresses to your web browser. @endnode @node "RE_B" "Read window - Buttons" @toc "RE_W" @{b}@{u}Read window - TOOLBAR@{ub}@{uu} ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ | 1 | 2 | 3 | 4 | | 5 | 6 | 7 | | 8 | 9 | 10 | 11 | |____|____|____|____| |____|____|____| |____|____|____|____| @{fg shine}Button Shortcut key Equivalent to Menu item...@{fg text} 1. [Prev] <- @{"Navigation/next message" link "REM2" 0} 2. [Next] -> @{"Navigation/previous message" link "REM2" 0} 3. [PrevThr] E @{"Navigation/previous message in thread" link "REM2" 0} 4. [NextThr] N @{"Navigation/next message in thread" link "REM2" 0} 5. [Display] A @{"Message/Attachments/Display" link "REM1" 0} 6. [Save] S @{"Message/Save" link "REM1" 0} 7. [Print] P @{"Message/Print" link "REM1" 0} 8. [Delete] D @{"Message/Delete" link "REM1" 0} 9. [Move] V @{"Message/Move" link "REM1" 0} 10. [Reply] R @{"Message/Reply" link "REM1" 0} 11. [Forward] @{"Message/Forward" link "REM1" 0} @endnode @node "REM1" "Read window - Message Menu" @toc "RE_W" @{b}@{u}Read window - MESSAGE MENU@{ub}@{uu} @{u}Message/Edit@{uu} Sends the current message to the message editor. @{u}Message/Move@{uu} Moves the current message to a different folder. @{u}Message/Copy@{uu} Creates a copy of the current message in another folder. With the exception of the filename the copy is identical with the original. @{u}Message/Delete@{uu} Deletes the current message and loads the next one into the read window. Unless the option 'remove messages immediately' is enabled (@{"Miscellaneous" link "CO15" 0} configuration settings), the message is actually moved into the "Deleted" folder, from which it can be recovered if need be. The key works as a keyboard shortcut, while forces immediate (irreversible) deletion, regardless of the configuration settings. @{u}Message/Print@{uu} Sends the actual message, or a part of it, to the printer. A requester opens to let you choose whether to print the original message without decoding (raw format), or to print the decoded text as diplayed, or to print an attached text file. Note that you cannot print binary data such as graphics; for that you must use the print option of the appropriate (@{"MIME viewer" link "CO12" 0}). @{u}Message/Save@{uu} Saves the current message or a part of it to your hard disk, floppy, etc. Again a requester appears to let you choose whether to save the message in raw format, the decoded message (the same as it appears in the read window), or to save one of the attached files. @{u}Message/Attachments@{uu} » Display This displays the current message, or part of it, using the MIME viewer specified in the @{"MIME configuration" link "CO12" 0}. You can choose whether to display the message in raw format (to check for errors) or to view one of the attached files. If nothing happens, check the settings for MIME viewers in the configuration. @{u}Message/Attachments@{uu} » Save all Saves all the files attached to the current message to a directory you select. @{u}Message/Attachments@{uu} » Crop Deletes all the attached files for the current message in order to save disk space. Note - these files are not sent to the deleted folder, so be sure that you don't want to keep one! This function only applies to messages in @{"MIME format" link "MIME" 0}. A notice is added to the end of the message about the removed files. @{u}Message/New@{uu} Opens the @{"Write window" link "WR_W" 0} so you can compose a new message. @{u}Message/Reply@{uu} Use this to reply to the current message. Subject and recipient fields are filled in automatically and the original message is quoted. @{u}Message/Forward@{uu} 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 text for forwarding defined in the @{"Reply" link "CO07" 0} configuration is inserted at the start of the message. @{u}Message/Bounce@{uu} Use this to send the original unaltered message to another recipient. The only changes made are to enter a new To header while YAM adds a couple of Resent headers (based on the original To header). The text for forwarded messages (as defined in the configuration) is not used. M@{u}essage/Save address @{uu} The address of the sender (or the recipient, depending on the type of folder) of the current message is put into your @{"Address book." link "AB_W" 0} If the message has multiple recipients, you have the option of creating a distribution list. M@{u}essage/Change subject @{uu} This lets you change the subject of the current message, so you can amend uninformative subject headers subsequent to receiving the message. The original subject is saved in an X-Original-Subject header, to facilitate following a thread back. @endnode @node "REM2" "Read window - Navigation menu" @toc "RE_W" @{b}@{u}Read window - NAVIGATION MENU@{ub}@{uu} @{u}Navigation/next message@{uu} This displays the next message @{i}i.e.@{ui} the one below the current message in the main window. Shortcut: @{u}Navigation/previous message@{uu} This displays the previous message @{i}i.e.@{ui} the one above the current message in the main window. Shortcut: @{u}Navigation/next unread message@{uu} This displays the next unread message @{i}i.e.@{ui} below the current message in the main window. Shortcut: @{u}Navigation/previous unread message@{uu} This displays the previous unread message @{i}i.e.@{ui} above the current message in the main window. Shortcut: @{u}Navigation/next message in thread@{uu} This displays the message which replies to the current message. This allows you to follow a dialogue between yourself and another person, regardless of what other messages are present in the folders. But note that to find the reply in a different folder, YAM must load the index filesvfor all the folders, which can take a while. YAM compares the @{"message-ID" link "HEAD" 0} header of the current message with the In-Reply-To header of the other message. Should the answer not be found, the screen flashes briefly. @{u}Navigation/previous message in thread@{uu} Loads the message to which the current message is a reply (see item above!). @endnode @node "REM3" "Read window - PGP menu" @toc "RE_W" @{b}@{u}Read window - PGP MENU@{ub}@{uu} @{u}PGP/extract public key@{uu} If the sender of the current message has attached his @{"public PGP key" link "PGP" 0} you can transfer this to your "key ring". You can then use this key if the sender then sends you an encrypted message. @{u}PGP/check PGP signature@{uu} Verifies the signature of the current message. This works only with PGP signed messages and serves to ensure that the message has not been tampered with and is really from the named sender. @{u}PGP/save decrypted message@{uu} On the grounds of security a @{"PGP-encrypted" link "PGP" 0} message is saved to the hard disk as it stands. To open it you have to use the key each time. You can use this menu item to save the decrypted message to the hard disk, overwriting the PGP-encrypted version @endnode @node "REM4" "Read window - Settings menu" @toc "RE_W" @{b}@{u}Read window - SETTINGS MENU@{ub}@{uu} These choices only apply to the current session; on opening a new read window the @{"Read" link "CO05" 0} configuration settings are used. @{u}Settings/no headers@{uu}|@{u}short headers@{uu}|@{u}full headers@{uu} Use these to select how much of the information in the headers you want to see in the read window. This choice only applies to the current session; on opening a new read window the @{"Read" link "CO05" 0} configuration settings are used. @{u}Settings/no sender info@{uu}|@{u}data fields only@{uu}|@{u}data and image@{uu} This selects how much of the information saved in your @{"address book" link "AB_W" 0} about the sender is to be displayed. This choice only applies to the current session; on opening a new read window the @{"Read configuration" link "CO05" 0} settings are used. @{u}Settings/wrap headers@{uu} Choose whether to show a long header on one line or to break it across two or more. In the first case you will need to use the horizontal scrollbar in order to see all of the information. @{u}Settings/text styles@{uu} YAM uses the characters _ / * and # to indicate underlined, italic, bold and coloured text. For certain special documents (like Quelltext) this can make things difficult because some characters are suppressed. So you have the option of switching the rendering of text styles on or off. @endnode @node "TR_W" "Mail Transfers" @{b}@{u}MAIL TRANSFERS@{ub}@{uu} When fetching, sending, importing or exporting mail YAM opens a transfer window which allows you some control over the process. If pre-selection is enabled YAM displays a list of the messages on offer for importing or downloading. Messages which exceed the pre-set maximum size are highlighted with white letters. Two explanatory status symbols may show at the side of the message. A little trashcan means that the message will be deleted from the server. The floppy disk icon indicates that the message will be downloaded. There are therefore the following possibilities: @{fg shine}Trashcan Diskette Action@{fg text} yes yes The message will be downloaded and then deleted from the server yes no The message is deleted immediately! The preferred action for unsolicited commercial e-mail. no no The message remains on the server but is not downloaded. no yes The message is downloaded but not deleted. @{b}Meanings of the buttons@{ub}: @{u}All@{uu} Selects all messages in the list for a subsequent change of status. This button has no effect on the action to be taken. @{u}None@{uu} Clears the current selection. This button has no effect on the action to be taken @{u}Download@{uu} Sets the diskette icon for all selected messages, marking them for downloading. @{u}Skip@{uu} Clears the diskette icon for all selected messages, so they will not be downloaded. @{u}Delete@{uu} Sets the trashcan symbol for all selected messages, marking them for deletion from the server. @{u}Keep@{uu} Clears the trashcan symbol for all selected messages, so that they will stay on the server. @{u}Stop/proceed@{uu} So long as the pre-selection list is displayed, YAM loads details of the separate messages - the headers are called from the server. The [Stop] button halts this process. @{u}Start@{uu} The selection stage is ended and the mail transfer starts. @{u}Abort@{uu} The mail transfer is terminated immediately. In the panel '@{b}Status@{ub}' you can see how many kbytes and how many messages have been transferred so far, at what rate, and how long the transfer will take. The rate is measured in characters per second. Do not be disappointed if the transmission seems not to measure up to the speed of the modem. The transfer of a short message requires a relatively large time for negotiation between YAM and the server, which is not allowed for in the calculated rate. Try it yourself and send yourself a message with a large attachment (@{i}e.g.@{ui} 100kb). The @{b}[Abort]@{ub} button forces a premature end to the transfer. It only works if YAM has control of the transfer. If YAM freezes because the server is not doing anything, either wait for the time-out or else break the connection by means of the TCP/IP program. @endnode @node "US_W" "Users" @{b}@{u}USER ADMINISTRATION@{ub}@{uu} YAM will satisfy the needs of a large family, being able to handle up to 16 users, who can each have their own folders and configuration settings. On starting YAM you can say who you are and immediately get back to your own personal set-up. Thus programs like MultiYAM become redundant. Selecting the menu item Settings/Users brings you to the Users window. @{u}User name@{uu} This is the name of the user. It appears in the Welcome dialogue on starting up the program, so long as only a single user is defined. @{i}Example:@{ui} Bill Brown @{u}Password@{uu} If you fill in this field, then a password requester appears when you select this user on program startup. @{u}Mail directory@{uu} This is the home directory for all user-specific files, such as folders and configuration settings. This directory obviously must be different from that of any other user. @{i}Example:@{ui} YAM:bill [] @{u}Use global address book@{uu} Check this option if the user will not use a personal address book. The address book is then shared with the other users; the file is kept in the program base directory and not in the user's home directory. [] @{u}Use global glossary@{uu} Enable this option if the user will not maintain a separate glossary but rather share one with the other users. The file is kept in the program base directory and not in the users home directory. [] @{u}Supervisor privileges@{uu} Enable this option to allow the user to create or remove other users. [] @{u}Copy configuration from current user@{uu} If you are adding a new user, you can select this option and copy the current settings to the new user directory, so saving the new user some tedious work setting up a configuration from scratch. @{b}[Add user]@{ub} Adds the new user to the list @{b}[Delete user]@{ub} Deletes the selected user from the list. @endnode @node "OPTI" "Start-up options" @{b}@{u}STARTUP OPTIONS@{ub}@{uu} YAM supports some special startup options, which can be used from Shell and from the Workbench (Tooltypes). @{b}USER=user name@{ub} Selects the active YAM user. So you can skip the login procedure on startup in case you've created multiple users. @{b}PASSWORD=password@{ub} This is the password for the selected user (see above). It serves to avoid the password request on program startup. @{b}MAILDIR=path@{ub} Sets the root directory for the folders and configuration files. In YAM 1.3.x this option was used to implement multi-user support. YAM 2.0 sets the root directory for each user in the user configuration. @{b}PREFSFILE=filename@{ub} Configuration file what should be used. Default is /.config @{b}HIDE@{ub} Starts YAM in iconified mode. @{b}NOCHECK@{ub} Skips the feature 'Send/Get mail on startup' and 'Check birthdays' (this might be useful if you're starting YAM from a WWW browser). @{b}DEBUG@{ub} This option protocols the conversation between YAM and the mail server in the Shell window. It's a very valuable tool if the connection fails. @{b}MAILTO=address@{ub} Creates a new message for the specified recipient on startup. @{b}SUBJECT=subject@{ub} Sets the subject for the new message (see MAILTO). @{b}LETTER=text file@{ub} The text file contains the letter you want to send (see MAILTO). @{b}ATTACH=files@{ub} Attaches one or more files to the new message (see MAILTO). @{i}Examples:@{ui} YAM USER Tom PASSWORD secret HIDE YAM NOCHECK MAILTO mbeck@access.ch SUBJECT "Bug Report" ATTACH ram:debug.txt @endnode @node "REXX" "ARexx Interface" @{b}@{u}AREXX INTERFACE@{ub}@{uu} With the help of ARexx scripts you can add new functions to YAM or let it do things automatically. YAM offers a @{"set of commands" link "REXL" 0}, which can be called through the ARexx port "YAM". Explanations for the syntax templates of the @{"ARexx commands" link "REXL" 0}: /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 null or more elements Take care when passing arguments that contain spaces: sub = 'Hello World' 'WRITESUBJECT' sub @{u}doesn't work@{uu}! It must be written as: 'WRITESUBJECT "'sub'"' or 'WRITESUBJECT "Hello World"' Commands can return results in three different kinds. Let's look at these @{i}examples@{ui} which use the FOLDERINFO command: @{b}FOLDERINFO@{ub} -> RESULT = "0 Incoming incoming 10 2 4 23030" @{b}FOLDERINFO VAR fi@{ub} -> fi = "0 Incoming incoming 10 2 4 23030" @{b}FOLDERINFO STEM fi.@{ub} -> fi.number = 0 fi.name = "Incoming" fi.path = "incoming" fi.total = 10 fi.new = 2 fi.unread = 4 fi.size = 23030 Another example which returns a result of type /M: @{b}ADDRFIND STEM found. "Marcel Beck" SEARCHNAME@{ub} -> found.alias.count = 2 found.alias.0 = "Mars" found.alias.1 = "mbe" @{"List of all ARexx commands" link "REXL" 0} @endnode @node "REXL" "List of all ARexx commands" @toc "REXX" @{b}@{u}LIST OF ALL AREXX COMMANDS@{ub}@{uu} @{b}ADDRFIND@{ub} VAR/K,STEM/K,PATTERN/A,NAMEONLY/S,EMAILONLY/S => ALIAS/M Searches the address book for one or more entries. Use NAMEONLY or EMAILONLY to search only in the Realname or Address field. @{b}ADDRINFO@{ub} VAR/K,STEM/K,ALIAS/A => TYPE,NAME,EMAIL,PGP,HOMEPAGE, STREET,CITY,COUNTRY,PHONE,COMMENT,BIRTHDATE/N,IMAGE, MEMBERS/M Returns information about the address book entry ALIAS. TYPE is P (person), L (distribution list) or G (group). The date of birth is in format YYYYMMTT. IMAGE is the file path of the portrait picture, MEMBERS contains all members in a distribution list. The other results are self-explaining. @{b}ADDRRESOLVE@{ub} VAR/K,STEM/K,ALIAS/A => RECPT/M Converts an alias or name into the corresponding email address(es). @{b}APPBUSY@{ub} VAR/K,STEM/K,TEXT Switches YAM into "busy" state and displays the text TEXT in the status bar of the main window. During this state YAM doesn't accept inputs. RC is set to 1 if YAM is currently busy. @{b}APPNOBUSY@{ub} Terminates "busy" state. RC is set to 1 if YAM is still busy. @{b}FOLDERINFO@{ub} VAR/K,STEM/K => NUMBER/N,NAME,PATH,TOTAL/N,NEW/N,UNREAD/N, SIZE/N Returns information about the current folder. NUMBER is the internal number (0=incoming folder), PATH is the directory and SIZE is the total size in bytes. TOTAL, NEW and UNREAD is the number of the total, new and unread messages. @{b}HELP@{ub} FILE Prints a list of supported ARexx commands in the Shell window or saves it to a FILE. @{b}HIDE@{ub} Turns YAM into iconified state. @{b}INFO@{ub} VAR/K,STEM/K,ITEM => VALUE Returns information about the program. ITEM is one of TITLE, AUTHOR, COPYRIGHT, DESCRIPTION, VERSION, BASE and SCREEN (see @{"MUI.guide" link "MUI:Docs/english/MUI.guide/main" 0}). @{b}ISONLINE@{ub} Detects if YAM is currently getting or sending mail. In that case RC is set to 1. @{b}LISTSELECT@{ub} MODE/A Selects messages in the current folder. Valid values for MODE are: N (none), A (all), T (toggle). @{b}MAILBOUNCE@{ub} VAR/K,STEM/K => WINDOW/N Opens a new write window in order to bounce the selected message. WINDOW contains the number of the created window. @{b}MAILCHECK@{ub} VAR/K,STEM/K,POP/K/N,MANUAL/S => DOWNLOADED/N, ONSERVER/N,DUPSKIPPED/N,DELETED/N Downloads new mail. If you omit the POP parameter, all configured POP3 servers are checked. Specify MANUAL if you want user interaction (message pre-selection etc.). @{b}MAILCOPY@{ub} FOLDER/A Copies selected message(s) to another folder. FOLDER can be the number or name of the destination folder. @{b}MAILDELETE@{ub} ATONCE/S,FORCE/S Deletes selected message(s). ATONCE doesn't move the messages into the trash folder, FORCE suppresses the confirmation requester. @{b}MAILEDIT@{ub} VAR/K,STEM/K => WINDOW/N Opens active message for editing in a new write window. WINDOW contains the number of the created window. @{b}MAILEXPORT@{ub} FILENAME/A,ALL/S,APPEND/S Exports selected message(s) into a file. ALL exports the whole folder. @{b}MAILFILTER@{ub} VAR/K,STEM/K,ALL/S => CHECKED/N,BOUNCED/N, FORWARDED/N,REPLIED/N,EXECUTED/N,MOVED/N,DELETED/N Filters messages in current folder. Without the ALL switch, only new messages are filtered. @{b}MAILFORWARD@{ub} VAR/K,STEM/K => WINDOW/N Opens a new write window in order to forward the selected message. WINDOW contains the number of the created window. @{b}MAILIMPORT@{ub} FILENAME/A,WAIT/S Imports messages from the file FILENAME into the current folder. Specify WAIT if you want user interaction (message pre-selection). @{b}MAILINFO@{ub} VAR/K,STEM/K => INDEX/N,STATUS,FROM,TO,REPLYTO,SUBJECT, FILENAME,SIZE/N,DATE,FLAGS Returns information about the current message. INDEX is the position of the message in the list (0=first one), STATUS is N,O,U,R,F,S,W,H or E, FROM contains the sender, TO is the recipient, REPLYTO is the return address, SUBJECT and DATE are obvious and FILENAME contains the file path of the message. SIZE is the size of the message in bytes; FLAGS is a 8 byte string in "MARCS-00" format (M=multiple recipients, A=attachments, R=report, C=encrypted, S=signed; the last two digits are user-defined flags, see SETFLAG). @{b}MAILMOVE@{ub} FOLDER/A Moves selected message(s) to another folder. FOLDER can be the number or name of the destination folder. @{b}MAILREAD@{ub} VAR/K,STEM/K,WINDOW/N,QUIET/S => WINDOW/N Loads the active message in the read window or, if WINDOW is specified, activates an already opened read window. Use QUIET if the window should stay invisible. @{b}MAILREPLY@{ub} VAR/K,STEM/K => WINDOW/N Opens a new write window in order to reply the selected message. WINDOW contains the number of the created window. @{b}MAILSEND@{ub} ALL/S Sends selected or all messages in the outgoing folder. @{b}MAILSTATUS@{ub} STATUS Changes the status of the selected message(s). Valid values for STATUS are O (read), U (unread), H (on hold) and W (ready to send). @{b}MAILUPDATE@{ub} Updates the index of the current folder. @{b}MAILWRITE@{ub} VAR/K,STEM/K,WINDOW/N => WINDOW/N Opens a new write window or selects an already opened one (using WINDOW). @{b}NEWMAILFILE@{ub} VAR/K,STEM/K,FOLDER => FILENAME Returns a valid, but unused message file name for the FOLDER. @{b}QUIT@{ub} FORCE/S Terminates YAM. Use FORCE to skip safety requesters. @{b}READCLOSE@{ub} Closes the active read window. @{b}READINFO@{ub} VAR/K,STEM/K => PARTS/N,FILENAME/M,FILETYPE/M, FILESIZE/N/M,TEMPFILE/M Gets details about the attachments of a message in the active read window. @{b}READPRINT@{ub} PART/N Prints an attachment (or the visible message if PART is omitted) to the printer. @{b}READSAVE@{ub} PART/N,FILENAME/K,OVERWRITE/S Saves an attachment (or the visible message if PART is omitted) into a file. @{b}REQUEST@{ub} VAR/K,STEM/K,BODY/A,GADGETS/A => RESULT/N Opens a requester containg the text BODY and the buttons GADGET. The number of the selected button will be return as RESULT (0=right, 1=left, 2=second one from the left, etc.) You can define as many buttons as you want, e.g. "Yes|Maybe|No|Cancel". @{b}SCREENTOBACK@{ub} Puts the YAM screen behind all other screens. @{b}SCREENTOFRONT@{ub} Brings the YAM screen to the front. @{b}SETFLAG@{ub} VOL/K/N,PER/K/N Sets the PERmanent or VOLatile flag of a message. The value of a flag can be between 0 and 7. These flags aren't used internally, but they might be useful in complex Arexx scripts. The value of the permanent flag is saved in the file comment of the message, so it will be still present after a reset. @{b}SETFOLDER@{ub} FOLDER/A Changes the current FOLDER. @{b}SETMAIL@{ub} NUM/N/A Selects the current message in the current folder, NUM is 0 to n-1. @{b}SETMAILFILE@{ub} MAILFILE/A Selects the current message, MAILFILE is the filename of the message. @{b}SHOW@{ub} Changes back from iconified state into full view. @{b}WRITEATTACH@{ub} FILE/A,DESC,ENCMODE,CTYPE Attaches a file to a new message. FILE is the filename, DESC is the description, ENCMODE is either "uu" or "b64" and CTYPE is the content-type. @{b}WRITEBCC@{ub} ADDRESS/A/M,ADD/S Enters one or more addresses (or aliases) into the "Hidden copy to" field in the write window. Without ADD, existing addresses will be overwritten. @{b}WRITECC@{ub} ADDRESS/A/M,ADD/S Enters one or more addresses (or aliases) into the "Copy to" field in the write window. Without ADD, existing addresses will be overwritten. @{b}WRITEEDITOR@{ub} COMMAND/A Passes an ARexx command to the internal editor. Refer to the documentation of the TextEditor class. @{b}WRITEFROM@{ub} ADDRESS/A Enters an address or alias into the "From" field in the write window. @{b}WRITELETTER@{ub} FILE/A,NOSIG/S Loads FILE into the internal text editor. Specify NOSIG if you don't want to append the signature. @{b}WRITEOPTIONS@{ub} DELETE/S,RECEIPT/S,NOTIF/S,ADDINFO/S,IMPORTANCE/N,SIG/N, SECURITY/N Sets the options for the new message. DELETE discards the message after sending, RECEIPT asks for a return receipt, NOTIF enables message tracking, ADDINFO adds personal information, IMPORTANCE is 0-2 (0=high), SIG selects the signature (0-3, 0=none), SECURITY is 0-5 (0=normal). @{b}WRITEQUEUE@{ub} HOLD/S Puts the new message into the outgoing queue. Use HOLD to lock it. @{b}WRITEREPLYTO@{ub} ADDRESS/A Enters an address or alias into the "Reply to" field in the write window. @{b}WRITESEND@{ub} Sends the new message. @{b}WRITESUBJECT@{ub} SUBJECT/A Enters the subject in the write window. @{b}WRITETO@{ub} ADDRESS/A/M,ADD/S Enters one or more addresses (or aliases) into the "To" field in the write window. Without ADD, existing addresses will be overwritten. @endnode @node "TIPS" "Tips & Tricks" @{b}@{u}TIPS & TRICKS@{ub}@{uu} @{u}Snapshot window position and size@{uu} Start the MUI settings interface by selecting 'Settings/MUI'. 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 actual size and position of the window for future sessions. @endnode @node "TECH" "Technical" @{b}@{u}TECHNICAL@{ub}@{uu} @{b}@{u}File structure@{ub}@{uu} In the program directory for YAM (generally YAM:) the following files and directories will be found: @{b}YAM@{ub} The program itself @{b}YAM.info@{ub} The program icon @{b}YAM.guide@{ub} This documentation in AmigaGuide format @{b}Icons/*.info@{ub} Icons which show the satus of the incoming mailbox when the program is iconified: @{b}empty.info@{ub} the mailbox is empty @{b}old.info@{ub} the mailbox only holds "old" mail @{b}new.info@{ub} the mailbox has at least one new message @{b}check.info@{ub} YAM is checking for new mail @{b}Icons/status@{ub} status icons in IFF/ILBM format @{b}Icons/toolbar@{ub} button borders in IFF/ILBM format @{b}Rexx/@{ub} ARexx programs for YAM @{b}Gallery/@{ub} Pictures of people mentioned in the address book @{b}.config@{ub} the @{"configuration" link "CO_W" 0} file @{b}.addressbook@{ub} the @{"address book" link "AB_W" 0} @{b}.glossary@{ub} the @{"glossary" link "DI_W" 0} @{b}.users@{ub} a list of the @{"YAM-users" link "US_W" 0} @{b}.signature@{ub} your personal @{"signature" link "CO08" 0} @{b}.altsignature1@{ub} first alternative signature @{b}.altsignature2@{ub} second alternative signature @{b}YAM.log@{ub} protocol file (if @{"Use protocol" link "CO10" 0} has been set). @{b}incoming/@{ub} the incoming mailbox directory @{b}outgoing/@{ub} the outgoing mailbox directory @{b}sent/@{ub} the directory for sent mail @{b}deleted/@{ub} the directory for mail marked for deletion @{b}archiveX/@{ub} the @{"user-defined archive folders" link "CO03" 0} (X is a number) Each message is saved as a separate file of which the filename constructed by conjoining (with a dot) the number of days since 1.1.1978 and a running number for that day. The mail status is saved in an comments file. In each mailbox directory there is an index file called .index which contains the headers of every message in the directory. There is also a configuration file called .fconfig which holds the settings for that particular folder. @endnode @node "MAIL" "Basics - what is e-mail?" @{b}@{u}WHAT IS ELECTRONIC MAIL?@{ub}@{uu} E-mail was the first service to be implemented on the Internet and is still the most popular method of communication over the Internet. A substantial proportion of the people on the internet use only this service. It is predicted that in the next few years e-mail will replace the traditional forms of communication like letters and fax for many purposes. At the present time one can in a matter of minutes reach several million people world-wide by e-mail. Users of other networks, such as Compuserve and T-Online are connected to the internet through "gateways". Related topics: @{"Make up of a message header" link "HEAD" 0} @{"Mail protocols (POP3 and SMTP)" link "PROT" 0} @{"What is MIME?" link "MIME" 0} @{"Encrypting with PGP" link "PGP" 0} @{"Golden rules (Netiquette)" link "NETI" 0} @endnode @node "HEAD" "Make up of a message header" @{b}@{u}MAKE UP OF A MESSAGE HEADER@{ub}@{uu} Every e-mail starts with a header which is separated from the actual message body by a blank line. YAM constructs this header automatically following the settings specified in the Configuration. The header of an e-mail is divided into fields which each start on a new line and have the general form 'Fieldname: contents'. Fields which are too long for a single line can be split to run over several lines. The majority of the header lines can be omitted but are added to provide the recipient's mail program with additional information about the message or to give data needed to check for errors caused by transmission problems. A few of the important fields are explained by means of the following example. @{fg shine}Return-Path:@{b}@{fg text} @{ub} This field is added by the recipient's mailserver and contains the e-mail address of the sender to allow the recipient's computer to send a reply by e-mail @{fg shine}Received:@{b}@{fg text} from ina.zfn.uni-bremen.de by atlantica.access.ch (8.8.5/INA-1.05pri) id XAA29100; Tue, 23 Dec 1997 23:40:45 +0100 (MET) @{ub}@{fg shine}Received:@{b}@{fg text} from moritz37.zfn.uni-bremen.de by ina.zfn.uni-bremen.de (AIX 3.2/UCB 5.64/ZFNserver) id AA26355; Tue, 23 Dec 1997 23:40:13 +0100@{ub} Each computer which sends the message on the next stage of its journey, and also the recipient's own system, adds on a Received field to the header to say when the message arrived and where it came from. This allows one to reconstruct transmission problems which may have affected the message along its route. @{fg shine}From:@{b}@{fg text} Christian Just @{ub} E-mail address and real name of the sender. @{fg shine}Reply-To:@{b}@{fg text} just@zfn.uni-bremen.de@{ub} The address to which any reply to this message should be sent. This is used if the message is despatched from a computer which the sender cannot use to read mail, for whatever reason. Then he can use this field to say where a reply should be sent. In the absence of a Reply-To field, replies go the address given in the From field. @{fg shine}To:@{b}@{fg text} "Marcel Beck (Yet another Mailer-autor)" @{ub} The address of the recipient; additional names can be given, separated by commas. This field may contain simply the address in the form name@domain or else it may be prefaced by an additional comment, such as the sender's name. In this case the address must be enclosed in pointed brackets. @{fg shine}Date:@{fg text} @{b}Tue, 23 Dec 1997 23:28:30 +0200@{ub} Date and time of despatch of the message. The figure after the time represents the time zone, expressed as the difference from Greenwich Mean Time. In this, the first two digits show the hours and the next two the minutes. @{fg shine}Message-Id:@{fg text} @{b}@{ub} A unique identifier, created automatically on despatch. Using this it is possible unequivocally to cancel any particular message. @{fg shine}In-Reply-To:@{fg text} @{b}@{ub} A precise reference to the message being replied to, such as its message-ID @{fg shine}X-Mailer:@{fg text} @{b}YAM 2.0beta4 - Amiga Mailer by Marcel Beck - http://www.yam.ch@{ub} Name and Version of the sender's mail program. @{fg shine}Subject:@{fg text} @{b}Re: YAM2beta5@{ub} This field should state concisely the topic of the message. Giving a clear and informative Subject is a mark of good style ("Netiquette"). @{fg shine}Mime-Version:@{fg text} @{b}1.0@{ub} @{fg shine}Content-Transfer-Encoding:@{fg text} @{b}quoted-printable@{ub} @{fg shine}Content-Type:@{fg text} @{b}text/plain; charset=iso-8859-1@{ub} These fields indicate that the message is set out in MIME format. In this example, it contains plain text in the ISO-Latin-1 character set and characters which cannot be represented using 7 bits are coded as uoted-printable. @endnode @node "PGP" "Basics - Encrypting with PGP" @toc "MAIL" @{b}@{u}ENCRYPTING WITH PGP@{ub}@{uu} In order to ensure that the e-mail cannot be read by anyone other than the recipient, it is necessary to encrypt the transmission. Is this important? Sometimes very much so! It is not possible to say in advance what route electronic mail will take through the Net and along the way it is possible or someone to read your mail unauthorised, admittedly with more trouble than one would normally bother to take. In particular, encrypting e-mail is a wise precaution if you want to send passwords, credit card numbers or suchlike over the Net. Such encrypted data is then often transmitted more safely than if sent by normal letter post. A simple, effective and widely used tool for this sort of encryption is PGP, short for Pretty Good Privacy. It was developed by Phil Zimmerman and employs the public key method. Using this PGP program one can be sure that the message is the one actually written by the sender and that only the intended recipient can read it. So-called public keys offer the highest possible level of security. There are two kinds of key: - One is a private key, used on your computer and never revealed elsewhere. - The other sort is the public key. You can make as many copies of this as you like and send the copies to other users so that they can read the encrypted mail you send them. You need both types of key, public and private, because they are inherently connected together. You can distribute your public key as often as needed but it will only work when matched up with its exact counterpart. Hence both public and private keys are involved in locking and (generally) unlocking information. PGP keys are used in two distinct ways: 1. Another person can encrypt information using your public key and send the encrypted file to you, to decipher with your private key. 2. You can encrypt information with your private key and send it safely over the Net. Anyone in possession of your public key can read your communication. The recipient can be sure that the communication is genuinely from you (your digital signature proves its authenticity) and that it has not been altered. PGP is obtainable as freeware and the International PGP Home Page is easy to find on the Internet: 'http://www.ifi.uio.no/pgp/'. @endnode @node "PROT" "Basics - Mail Protocols" @toc "MAIL" @{b}@{u}MAIL PROTOCOLS@{ub}@{uu} YAM uses the Simple Mail Transfer Protocol (SMTP) in order to send your mail to the SMTP server, which also uses SMTP to transmit your mail across the whole world. Incoming mail arrives at your Post Office Protocol (POP) server, where it waits until YAM downloads it to your computer, using the POP3 (version 3) protocols. The messages which YAM sends and receives conform to the conventions set out in RFC 822 and RFC 1521 (MIME). @{b}Outgoing mail@{ub} If you want to send an e-mail message to anyone, YAM transfers the message by SMTP to your local SMTP server. This computer forwards the message to the recipient's computer, geneally also by SMTP. Why does YAM not deal directly with the recipient's server? Firstly, it would take quite a long time for your Amiga to get a connection to one particular computer and then transmit the message. Secondly, many computers are hard to find; it is much better to let the mail server look for the address, instaed of burdening your Amiga. Thirdly, quite frequently the recipient's server will not be available at the time you want to send the mail. The SMTP server solves these problems, holding back the message until the other computer is ready to receive it. @{b}Incoming mail@{ub} If someone sends you mail, the other computer transfers it using the SMTP protocol as far as your POP server. This stores the message in a sort of mailbox, where it remains until YAM collects it. When you look for new mail, YAM downloads the message to your Amiga using POP3. Why doesn't YAM use SMTP for incoming mail? SMTP works best if the if the intercommunicating computers both are on standby to receive messages. Unless you run YAM and your Amiga 24 hours a day and seven days a week, SMTP would not be particularly suitable for you. @endnode @node "MIME" "Basics - MIME" @toc "MAIL" @{b}@{u}WHAT IS MIME?@{ub}@{uu} MIME stands for Multipurpose Internet Mail Extensions. MIME serves two major purposes: it allows one mail application to tell another what sort of data is contained in a message and it also provides standardised rules by which mail applications can encode data, so that it can be sent through the Internet mail system. @{b}MIME Encoding@{ub} The Internet uses the SMTP protocol to move mail around. SMTP is limited to the US-ASCII character set. This is a problem for people who speak languages other than American English and so need accented characters or non-American letters, or for people who want to use special symbols like the bullet. Even more difficult is the transmission of binary files (as attached files). MIME provides a way around this restriction. It offers two encodings, "quoted- printable" and "base64". These encodings use US-ASCII character codes to represent any sort of data you like, including special characters or even non-text data. Quoted-printable is used for data that is mostly text, but has special characters for very long lines. Quoted-printable looks just like regular text, except when a special character is used. The special character is replaced with an = and two more characters that represent the (hexadecimal) character code of the special character. So, a bullet in quoted-printable looks like =95DA. No line in quoted-printable is allowed to be more than 76 characters long. If your mail has a line longer than 76 characters, the quoted-printable encoding will break your line in two, and put an = at the end of the first line, to signal to the mail reader at the other end that the two lines are really supposed to be one. Base64 encoding is another way to protect binary data from the SMTP mail system. However, Base64 makes no attempt to be legible, and is, most appropriate for non-text data. It is equivalent to the older UUencode but more reliable in use. @{b}Content type@{ub} The other important function of MIME is to allows mail programs to exchange information about what kind of data is in a message (or part of a message). The primary mechanism used for this is the Content-Type header. The major content types are: text readable text image pictures and graphics audio sound video animations message messages or parts of messages multipart several different kinds of data in a single message The subtype gives additional information about the type of data: text/plain plain text text/html text in HTML format image/gif image in GIF format etc. By using the Content type a mail program is able to select the correct utility to display the attached file. @endnode @node "DOSW" "AmigaDOS Patterns and wildcards" @{b}@{u}AMIGADOS PATTERN MATCHING@{ub}@{uu} The use of wildcards in patterns allows you to set up very powerful searches. The special wildcard characters are listed below. ? Matches any single character so Y?M matches YAM, YUM, Y@M etc. # Matches zero or more occurrences of the following item so Y#AM matches YM, YAM, YAAM, YAAAM etc. #? matches anything at all (including nothing!) so #?YAM#? matches any string containing "YAM" % matches an empty string. Not terribly useful by itself, but you could use it to find messages with blank Subject headers. () Round brackets are used to group characters and expressions and show how to evaluate the expression. Use them freely! Thus #(Re:)YAM matches YAM, Re:YAM, Re:Re:YAM ... [] Square brackets are used to indicate a list of alternatives so [YAM] matches any of the single letters Y, A or M but @{i}not@{ui} YAM - indicates a range, so [0-9] matches any single digit and #[0-9] matches any integral number. ~ means NOT, referring to the whole expression following, so ~Re: matches @{i}any@{ui} string that does not start with "Re:" | means OR, referring to the expressions either side. You @{i}have@{ui} to enclose the whole expression in round brackets: @{i}e.g.@{ui} (#?YAM#?|#?MUI#?) finds strings including either "YAM" or "MUI". WARNING! It's not as easy as it looks! For example, let's construct a filter that will find references to YAM or YAM2 but discard YAM1. Try this one: #?YAM(~1) What does this say to do? Reading a new string from the left, look for the sequence YAM. If you find it, look at the following part: is it equal to "1"? If not, you've got a match. The trouble is, "1.3.5" isn't equal to "1" (it's too long) so YAM1.3.5 is included when we don't want it. The solution is to make it clear that the string following "YAM" mustn't start with a "1". So try: #?YAM(~1#?) This gets rid of 1.3.5 alright, but there's still a problem. Sometimes people insert a space between YAM and the version number and sometimes not. So references to YAM 1 are still included. So we must say that any number of spaces may be present, like this: #?YAM# (~1#?) Another case - suppose we want to find all the strings that include YAM but do not start with "Re:". So we try: (~Re:)YAM#? This says to begin by comparing the start of the string to "Re:". If we get a match, that string is discarded. If not, we look in the rest of the string to find "YAM". So what happens if the string @{i}starts@{ui} with "YAM"? The first letter isn't R, so the NOT condition is satisfied. But we've done the Y now, so we don't find the string YAM! To sort this out, we have to explain that the string in front of "YAM" may be the null string (so that's what it's for!) Like this: (~Re:|%)YAM#? Question for computer buffs: what does ~((~#?YAM#?)|(~#?MUI#?)) mean? @endnode @node "NETI" "The basics - Email Netiquette" @toc "MAIL" @{u}EMAIL NETIQUETTE@{uu} Keep messages short and to the point Give the message a concise and meaningful Subject header, so that it can easily be found again. Put a signature at the end of the message. This should contain your name and e-mail address and should not be longer than five lines. Signatures often also give the postal address, telephone number, web-site and instructions about sending PGP messages. Only write in block capitals if you want to give particular emphasis to a point. *Stars* are also used for emphasis (YAM interprets this by using bold type). Block capitals are generally taken as equivalent to SHOUTING. Set up YAM to use a line length of less than 80 characters and don't use any control characters. Don't use non-ASCII characters unless you are sure that the recipient's software interprets them correctly. It is regarded as extremely impolite to forward a private message to a mailing list without the permission of the original sender. Abbreviations and TLA's (Three Letter Acronyms) can be useful provided they don't make the message unintelligible. The following are often used: IMHO (in my humble opinion) BTW (by the way) FYI (for your information) AFAIK (as far as I know) ASAP (as soon as possible) CU (see you) Use the ;-) smiley (winky?) to denote a touch of irony which could otherwise easily be misinterpreted. Be tolerant of other people's failings, @{i}e.g.@{ui} in spelling, grammar, expression or familiarity with e-mail. If you join a mailing list, read the messages for a while to get a feel for the general style, what questions are asked and what is not suitable. Study the FAQ's (lists of Frequently Asked Questions). It is annoying for the members of a group if the same questions are being asked repeatedly. If someone posts a message which is "off-topic", @{i}i.e.@{ui} does not belong in the mailing list, reply privately and not in the list. If you quote another message, then cut all the bits which are not relevant to your answer. No-one wants to read the same message three or four times, especially when all that is added is "Yes, me too". Resist the temptation to flame in the mailing list. ("Flame" = write abusively, generally when provoked by idiocy.) Remember that the list is public and meant for constructive discussion. Do as you would be done by! If you reply to a message in a mailing list, think whether to send it direct to the sender or to the list and check that the To address is correct. It can be very irritating when a letter addressed to a particular person appears on the list, unintentionally. @endnode @node "PLAN" "Future Plans" @{b}@{u}FUTURE PLANS@{ub}@{uu} A few functions which I may perhaps put into the next version of YAM: - Support for messages in HTML-Format - Inline-Display of attached files (graphics) - Support for the IMAP-4 Protocol - Hierarchical folders @endnode @node "INFO" "Further Information about YAM" @{b}@{u}FURTHER INFORMATION ABOUT YAM@{ub}@{uu} In order to provide all users with up-to-date information about YAM, I have set up a home page in the world wide web: @{fg shine}http://www.yam.ch@{fg text} If you want to discuss YAM-related issues with other users, you can join the YAM mailing list. Just send an e-mail to @{i}listserv@tu-clausthal.de@{ui} with the text 'subscribe yam' as the first line (subsequent lines are ignored). You can send me suggestions, questions, criticism, bug reports etc. at: mbeck@access.ch http://www.yam.ch/contact.html http://come.to/mars or failing that, by conventional mail at: Marcel Beck Hammerstraße 4 4414 Füllinsdorf Schweiz @endnode @node "CRED" "Credits" @{b}@{u}CREDITS@{ub}@{uu} At this point I would like to thank the following people who contributed substantially to the development of YAM: @{u}Beta-testers@{uu}: Phil Beazley, Benjamin Busche, Mario Cattaneo, Patrick Ernst, Giuseppe Ghibo, Christian Just, Laurent Kempe, Peter Kromarek, Markus Lamers, Jens Langner, Richard Marti, Marco Musso, Benny Kjær Nielsen, Marcin Orlowski, Allan Odgaard, Roman Patzner, Lars Pisanec, Georgia Pristo, Christoph Rickers, Markus Roth, Thmoas Schraitle, Ulf Seltier, Stefan Sommerfeld, Martin Sprenger, Peter Thiessen, Danny Thinnes, Walter Watzl, Piotr Wojciechowski, Michael Zaruba @{u}Translators@{uu}: Ulf Seltier, James Bridge (english YAM.guide) @{u}Icon Artists@{uu}: Roman Patzner (title graphic, button borders, status icons), Ash Thomas (a complete set of @{"NewIcons" link "NEWI" 0}) @{u}Programmers@{uu}: Stefan Stuntz (MUI), Allan Odgaard (TextEditor.mcc, BetterString.mcc), Benny Kjaer Nielsen (Toolbar.mcc), Marcin Orlowski (Flexcat), Gilles Masson (NList.mcc), Klaus Melchior (Listtree.mcc) @endnode @node HeddleyAutoIndex "Index" @remark Index auto-generated by Heddley Index of database YAM.guide Documents @{"Address Book" link "AB_W"} @{"Address book - Menus" link "AB_M"} @{"Address book - Toolbar" link "AB_B"} @{"AmigaDOS Patterns and wildcards" link "DOSW"} @{"ARexx Interface" link "REXX"} @{"Basics - Encrypting with PGP" link "PGP"} @{"Basics - Mail Protocols" link "PROT"} @{"Basics - MIME" link "MIME"} @{"Basics - what is e-mail?" link "MAIL"} @{"Configuration" link "CO_W"} @{"Configuration - Address book" link "CO13"} @{"Configuration - ARexx" link "CO14"} @{"Configuration - Filters" link "CO04"} @{"Configuration - First steps" link "CO00"} @{"Configuration - Folders" link "CO03"} @{"Configuration - Hidden Options" link "CO_H"} @{"Configuration - Lists" link "CO09"} @{"Configuration - Menus" link "CO_M"} @{"Configuration - MIME" link "CO12"} @{"Configuration - Miscellaneous" link "CO15"} @{"Configuration - New mail " link "CO02"} @{"Configuration - Read" link "CO05"} @{"Configuration - Replying" link "CO07"} @{"Configuration - Security" link "CO10"} @{"Configuration - Signature" link "CO08"} @{"Configuration - Start/Quit" link "CO11"} @{"Configuration - TCP/IP" link "CO01"} @{"Configuration - Write" link "CO06"} @{"Credits" link "CRED"} @{"Editor features" link "EDIT"} @{"Entering addresses" link "EA_W"} @{"Finding messages" link "FI_W"} @{"Finding messages - Search criteria" link "FI_K"} @{"Further Information about YAM" link "INFO"} @{"Future Plans" link "PLAN"} @{"Installation" link "INST"} @{"Introduction" link "INTR"} @{"Legal issues" link "COPY"} @{"List of all ARexx commands" link "REXL"} @{"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 - Scripts Menu" link "MAM5"} @{"Main window - Settings Menu" link "MAM4"} @{"Main window - toolbar" link "MA02"} @{"Make up of a message header" link "HEAD"} @{"MUI" link "MUI"} @{"NewIcons" link "NEWI"} @{"Quickstart" link "TUTO"} @{"Read window" link "RE_W"} @{"Read window - Buttons" link "RE_B"} @{"Read window - Message Menu" link "REM1"} @{"Read window - Navigation menu" link "REM2"} @{"Read window - PGP menu" link "REM3"} @{"Read window - Settings menu" link "REM4"} @{"Requirements" link "REQS"} @{"Start-up options" link "OPTI"} @{"Status Icons" link "MA0S"} @{"Technical" link "TECH"} @{"The basics - Email Netiquette" link "NETI"} @{"The Glossary" link "DI_W"} @{"Tips & Tricks" link "TIPS"} @{"Users" link "US_W"} @{"Write window" link "WR_W"} @{"Write window - Attachments " link "WR01"} @{"Write window - Attachments menu" link "WRM3"} @{"Write window - Edit menu" link "WRM2"} @{"Write window - message" link "WR00"} @{"Write window - Options" link "WR02"} @{"Write window - Text menu" link "WRM1"} @{"YAM - English documentation" link "Main"} Buttons @{"  Message  " link "WR00" 0} @{"  Options  " link "WR02" 0} @{" Address book   " link "CO13" 0} @{" Address book    " link "AB_W" 0} @{" ARexx          " link "CO14" 0} @{" ARexx Interface " link "REXX" 0} @{" Author          " link "INFO" 0} @{" Configuration   " link "CO_W" 0} @{" Copyright       " link "COPY" 0} @{" Editor          " link "EDIT" 0} @{" Filters        " link "CO04" 0} @{" First Steps    " link "CO00" 0} @{" Folders        " link "CO03" 0} @{" Headers         " link "HEAD" 0} @{" Hidden Options " link "CO_H" 0} @{" Installation    " link "INST" 0} @{" Introduction    " link "INTR" 0} @{" Lists          " link "CO09" 0} @{" Mail protocols  " link "PROT" 0} @{" Mail transfers  " link "TR_W" 0} @{" Main Window     " link "MA_W" 0} @{" MIME           " link "CO12" 0} @{" Miscellaneous  " link "CO15" 0} @{" Netiquette      " link "NETI" 0} @{" New functions   " link "Changes/MAIN" 0} @{" New Mail       " link "CO02" 0} @{" PGP             " link "PGP" 0} @{" Quickstart      " link "TUTO" 0} @{" Read           " link "CO05" 0} @{" Read            " link "RE_W" 0} @{" Reply          " link "CO07" 0} @{" Requirements    " link "REQS" 0} @{" Search          " link "FI_W" 0} @{" Security       " link "CO10" 0} @{" Signature      " link "CO08" 0} @{" Start/End      " link "CO11" 0} @{" Starting options" link "OPTI" 0} @{" TCP/IP         " link "CO01" 0} @{" Technical stuff " link "TECH" 0} @{" Thanks to       " link "CRED" 0} @{" The future      " link "PLAN" 0} @{" Tips & tricks   " link "TIPS" 0} @{" Users           " link "US_W" 0} @{" What is e-mail? " link "MAIL" 0} @{" What is MIME?   " link "MIME" 0} @{" Write          " link "CO06" 0} @{" Write           " link "WR_W" 0} @{"Address book" link "AB_W" 0} @{"Address book." link "AB_W" 0} @{"Amiga-DOS wildcards" link "DOSW" 0} @{"AmigaDOS pattern" link "DOSW" 0} @{"AmigaDOS patterns" link "DOSW" 0} @{"Arexx" link "REXX" 0} @{"ARexx script" link "CO12" 0} @{"ARexx commands" link "REXL" 0} @{"Attachments" link "WRM3" 0} @{"Attachments" link "WR01" 0} @{"BUTTONS" link "AB_B" 0} @{"configuration" link "TUTO" 0} @{"Configuration" link "CO03" 0} @{"configuration" link "CO05" 0} @{"configuration" link "CO_W" 0} @{"Configuration window" link "CO_W" 0} @{"CONFIGURATION/Security" link "CO10" 0} @{"Copyright Information" link "COPY" 0} @{"E-Mail Netiquette" link "NETI" 0} @{"Edit" link "WRM2" 0} @{"edit address" link "EA_W" 0} @{"Edit address window" link "EA_W" 0} @{"Edit/Copy" link "WRM2" 0} @{"Edit/Cut" link "WRM2" 0} @{"Edit/Paste" link "WRM2" 0} @{"Edit/Undo" link "WRM2" 0} @{"electronic mail" link "MAIL" 0} @{"Encrypting with PGP" link "PGP" 0} @{"external program" link "CO05" 0} @{"Filter" link "CO04" 0} @{"filters" link "CO04" 0} @{"First steps " link "CO00" 0} @{"Folder" link "MAM2" 0} @{"folder configuration" link "CO03" 0} @{"Folder list" link "MA00" 0} @{"Folder/Export" link "MAM2" 0} @{"Folder/Filter" link "MAM2" 0} @{"Folder/Find" link "MAM2" 0} @{"Folder/Get new mail" link "MAM2" 0} @{"Folder/Send queued mail" link "MAM2" 0} @{"Folders" link "CO03" 0} @{"glossary" link "DI_W" 0} @{"Golden rules (Netiquette)" link "NETI" 0} @{"headers" link "HEAD" 0} @{"installation" link "INST" 0} @{"internal editor" link "EDIT" 0} @{"List" link "CO09" 0} @{"List of all ARexx commands" link "REXL" 0} @{"Lists" link "CO09" 0} @{"macros" link "CO14" 0} @{"Mail protocols (POP3 and SMTP)" link "PROT" 0} @{"Make up of a message header" link "HEAD" 0} @{"Menu" link "CO_M" 0} @{"menu bar" link "AB_M" 0} @{"Message" link "MAM3" 0} @{"Message" link "REM1" 0} @{"Message list" link "MA01" 0} @{"Message sheet" link "WR00" 0} @{"message-ID" link "HEAD" 0} @{"Message/Attachments/Display" link "REM1" 0} @{"Message/Delete" link "MAM3" 0} @{"Message/Delete" link "REM1" 0} @{"Message/Edit" link "MAM3" 0} @{"Message/Forward" link "MAM3" 0} @{"Message/Forward" link "REM1" 0} @{"Message/Move" link "MAM3" 0} @{"Message/Move" link "REM1" 0} @{"Message/Print" link "REM1" 0} @{"Message/Read" link "MAM3" 0} @{"Message/Reply" link "MAM3" 0} @{"Message/Reply" link "REM1" 0} @{"Message/Save" link "REM1" 0} @{"Message/Save Address" link "MAM3" 0} @{"Message/Write" link "MAM3" 0} @{"MIME" link "MIME" 0} @{"MIME" link "CO12" 0} @{"MIME format" link "MIME" 0} @{"MIME viewer" link "CO05" 0} @{"MIME-Format" link "MIME" 0} @{"Miscellaneous" link "CO13" 0} @{"Miscellaneous" link "CO15" 0} @{"MUI" link "MUI" 0} @{"MUI 3.8" link "MUI" 0} @{"MUI-configuration" link "MAM4" 0} @{"MUI.guide" link "MUI:Docs/english/MUI.guide/main" 0} @{"Navigation" link "REM2" 0} @{"Navigation/next message" link "REM2" 0} @{"Navigation/next message in thread" link "REM2" 0} @{"Navigation/previous message" link "REM2" 0} @{"Navigation/previous message in thread" link "REM2" 0} @{"NewIcons" link "NEWI" 0} @{"Options" link "WR02" 0} @{"PGP" link "PGP" 0} @{"PGP" link "REM3" 0} @{"PGP-encrypted" link "PGP" 0} @{"POP3" link "PROT" 0} @{"POP3 server" link "CO02" 0} @{"preselection window" link "TR_W" 0} @{"Project" link "MAM1" 0} @{"public PGP key" link "PGP" 0} @{"READ" link "CO05" 0} @{"Read configuration" link "CO05" 0} @{"Read window" link "RE_W" 0} @{"Reply" link "CO07" 0} @{"Scripts" link "MAM5" 0} @{"scripts" link "CO12" 0} @{"Scripts configuration" link "CO12" 0} @{"search capabilities" link "FI_W" 0} @{"Search criterion" link "FI_K" 0} @{"Search window" link "FI_W" 0} @{"set of commands" link "REXL" 0} @{"Settings" link "MAM4" 0} @{"Settings" link "REM4" 0} @{"Settings/Address book" link "MAM4" 0} @{"Settings/Configuration" link "MAM4" 0} @{"Settings/MUI" link "MAM4" 0} @{"Settings/MUI" link "MAM5" 0} @{"signature" link "CO08" 0} @{"SMTP" link "PROT" 0} @{"status" link "MA0S" 0} @{"Text" link "WRM1" 0} @{"text editor" link "EDIT" 0} @{"Text/Input as" link "WRM1" 0} @{"Text/Insert as/plain" link "WRM1" 0} @{"Text/Launch editor" link "WRM1" 0} @{"timezone" link "CO00" 0} @{"Tool bar" link "RE_B" 0} @{"Toolbar" link "MA02" 0} @{"toolbar" link "AB_B" 0} @{"transfer window" link "TR_W" 0} @{"Use protocol" link "CO10" 0} @{"User window" link "US_W" 0} @{"user-defined archive folders" link "CO03" 0} @{"user-defined folders" link "CO03" 0} @{"Users" link "US_W" 0} @{"What is MIME?" link "MIME" 0} @{"wildcards" link "DOSW" 0} @{"Write" link "CO06" 0} @{"Write window" link "WR_W" 0} @{"YAM-users" link "US_W" 0} @endnode