Changes between Version 43 and Version 44 of Documentation/Configuration


Ignore:
Timestamp:
May 1, 2014 6:23:27 PM (6 months ago)
Author:
AmigaPhil
Comment:

Updated configuration settings to YAM2.9

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/Configuration

    v43 v44  
    11[[TranslatedPages(outdated=Several settings have changed - update needed)]] 
    2 [[TOC(depth=1)]] 
     2[[TOC(depth=3, Documentation/Configuration)]] 
    33 
    44= Configuration = 
     
    99This sheet contains some essential information needed for YAM to work. 
    1010 
    11 === Minimal configuration === 
     11'''''Minimal configuration''''' 
     12 
    1213`Full Name` 
    1314  Your real name and surname.  Please take care that this field is filled in correctly.  DO NOT use quotation marks in your name. 
     
    3637 
    3738[[=#FixTimezone]] 
    38 === Time zone === 
     39'''''System settings''''' 
     40 
     41`Charset` 
     42 
    3943`Timezone` 
    4044  The time and date displayed by YAM in the message list is always converted to your local time.  This guarantees correct sorting of messages from all over the world sent out from different time zones.  The time zone is part of the message's date and specifies the difference between local time and Greenwich Mean Time (GMT). 
     
    4448  Normally YAM will get the time zone from your Locale settings, thus this selector will be ghosted. 
    4549 
    46 `Add adjustment for daylight saving time` 
    47   This option is to be activated during daylight saving time. By doing so, one hour will be added to the time zone value. YAM automatically changes to/from daylight saving time if the operating system support DST switching (e.g. AmigaOS4) or if a AutoDST tool like SetDST, FACTS or SummertimeGuard is installed. This is indicated by ghosting this checkbox. 
    48  
    49   Example: John Doe 
    50  
     50----- 
    5151== TCP/IP == 
    5252Here you can enter the information needed to actually send email, as well as define additional POP3 accounts. 
    53  
    54 === Send mail (SMTP) === 
    55 Apart from the primary SMTP server already defined in the First steps section, you can set up an unlimited number of SMTP servers here; the names appear in the list on the left and clicking on a name brings up the relevant details 
    56 on the right. Note that these accounts 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 delete accounts. 
    57  
    58 `Server` 
    59   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. 
    60  
    61   Example: mail.example.com 
    62  
    63 `Port` 
    64   The port number of the SMTP service. The standard port is 25 for plain SMTP. In case of using SSL/TLS connections this port may also be 576 or 456. 
    65  
    66   Example: 25 
    67  
    68 `SMTP server allows 8bit` 
    69   Originally only the US-ASCII character set was allowed for use in e-mail, which meant that users were forced to use vowels (e.g., they had to use 'ae' instead of 'ä').  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 while 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 this option on and save a few bits when transferring e-mails. 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. 
    70  
    71   Example: Yes 
    72  
    73 `Use SMTP AUTH` 
    74   Enable this if you want to use SMTP Authentication, whereby YAM will request your mail server to use an extra authentication layer as documented in RFC 2554. You will need to fill in another couple of UserID/Password fields in this case. If your SMTP server does not support SMTP AUTH, you will receive an error message when trying to send email. Ask your ISP if in doubt.  
    75  
    76   Example: No 
    77  
    78 `Username` 
    79   When using SMTP AUTH you can insert the user name for the SMTP authentification here. In most cases this will be identical to the username in your e-mail address.  However, there are exceptions, so check the instructions from your ISP (YAM then constructs the full account name in the form <Username>@<server>). 
    80  
    81   Example: jdoe 
    82  
    83 `Password` 
    84   The password which has to be sent to the mail server at login time. You can leave this field empty for security reasons -- if you do, the password will be asked to you whenever you send new mails. Also, remember the password is case sensitive. 
    85  
    86   Example: nguz56 
    87  
    88 `Use SMTP TLSv1/SSLv3` 
    89   Enable this if your SMTP server supports TLSv1/SSLv3 secure connections. If enabled, YAM will connect via the AmiSSL library with the SMTP server and encrypts every transfer. 
    90  
    91   Example: No 
    9253 
    9354[[=#FixPOP3]] 
     
    9657on the right. Note that these accounts 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 delete accounts. 
    9758 
     59`Active` 
     60  Switch this option on to have the selected POP3 account checked for new mail whenever you use the Get new mail button in the toolbar, or the equivalent item in the "Folder" menu.  If you don't want this email account to be checked automatically, switch this option off and use the menu item Folder/Check single account from the main window instead. 
     61 
     62  Example: Yes 
     63 
     64`Description` 
     65 
    9866`Server` 
    9967  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 POP3 protocol. 
     
    10674  Example: 110 
    10775 
    108 `Username` 
    109   The user name for authentication against the specified POP server.. In most cases this will be identical to the username in your e-mail address.  However, there are exceptions, so check the instructions from your ISP (YAM then constructs the full account name in the form <Username>@<server>). 
    110  
    111   Example: jdoe 
    112  
    113 `Password` 
    114   The password which has to be sent to the mail server at login time. You can leave this field empty for security reasons -- if you do, the password will be asked to you whenever you send new mails. Also, remember the password is case sensitive. 
    115  
    116   Example: nguz56 
    117  
    118 `Active` 
    119   Switch this option on to have the selected POP3 account checked for new mail whenever you use the Get new mail button in the toolbar, or the equivalent item in the "Folder" menu.  If you don't want this email account to be checked automatically, switch this option off and use the menu item Folder/Check single account from the main window instead. 
    120  
    121   Example: Yes 
    122  
    123 `Use POP3 TLSv1/SSLv3` 
     76'''''Security and Authentification''''' 
     77 
     78`Connection Security` 
    12479  Activate this option to use SSL based encryption under the TLS protocol as described in RFC 2595.  This adds extra security to prevent the typical eavesdropping and hijacking attacks which POP is commonly subject to, and will use port 995 instead of the usual 110. 
    12580  The with STLS option will force the use of the POP3 STARTTLS  extension, adding another layer of security to the communication, using again port 110. 
    12681  If your POP3 server doesn't support any of this, you will receive an error message when checking for new mail.  Also, AmiSSL is required. 
    12782 
    128   Example: Yes 
    129  
    130 `Login using APOP` 
     83`Authentification` 
    13184  Normally the Username and the password are transmitted as plain text when connecting to a POP3 server.  Under certain circumstances, this could be a security risk, and for this reason modern POP3 servers support the APOP authentication, which transmits the username and password 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. Also note, that if your POP3 server supports TLS/SSL this should be preferred as it also transmits the email content encrypted rather than in plain text. 
    13285 
    133   Example: No 
    134  
    135 `Delete mail on server` 
    136   If this option is activated, new mail will be deleted after downloading it from the mail server.  The messages will be deleted only after they have been successfully saved to your computer. If the POP3 account is used by several people, or if you'd like to access your account again later from another computer, this option can be deactivated. 
    137  
    138   Example Yes 
    139  
    140 [[=#FixNewmail]] 
    141 == New mail == 
    142 Controlling the way mail is downloaded. 
    143  
    144 === Download === 
     86`User name` 
     87  The user name for authentication against the specified POP server.. In most cases this will be identical to the username in your e-mail address.  However, there are exceptions, so check the instructions from your ISP (YAM then constructs the full account name in the form <Username>@<server>). 
     88 
     89  Example: jdoe 
     90 
     91`Password` 
     92  The password which has to be sent to the mail server at login time. You can leave this field empty for security reasons -- if you do, the password will be asked to you whenever you send new mails. Also, remember the password is case sensitive. 
     93 
     94  Example: nguz56 
     95 
     96'''''Message handling''''' 
     97 
    14598`Pre-selection` 
    14699  After establishing a link with the POP3 server, a  preselection window 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. 
     
    153106  Example: always 
    154107 
    155 `Size limit` 
     108`Check for new mail on startup` 
     109 
     110`Check for new mail every...` 
     111  Here you can specify a time interval after which YAM will automatically recheck your mail server for new mail.  To deactivate this option, simply select zero. 
     112 
     113  Example: 15 minutes 
     114 
     115`Download messages larger than...` 
    156116  If pre-selection is activated, messages which exceed the size given here will be highlighted.  This way you can avoid downloading messages with huge attachments.  The size is given in kilobytes. If you don't want to use any limit, just insert '0'. 
    157117 
     
    160120  Example: 100 
    161121 
    162 `Transfer window` 
    163   Here you can decide if you want to see the  transfer window  while receiving or sending mail.  With //automatic// it only opens if you manually initialize the transfer, staying closed while YAM automatically checks for new mail. 
    164  
    165   Example: never 
    166  
    167 `Avoid duplicates` 
    168   If you choose not to have YAM delete the mail on the server after downloading, 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 the Avoid duplicates option on -- as long as this option is activated, YAM will keep track of all your downloaded messages in the .uidl file and use 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 turned off. 
    169  
    170   Example: Yes 
    171  
    172 `Update message status` 
    173   If this option is activated, new messages in the 'Incoming' folder will be marked as 'unread' before downloading new mail.  This way you can instantly recognize the new mail that was downloaded the last time you've fetched mail. 
    174  
    175   Example: Yes 
    176  
    177 === Automatic operation === 
    178 `Check for new mail every [xx] minutes` 
    179   Here you can specify a time interval after which YAM will automatically recheck your mail server for new mail.  To deactivate this option, simply select zero. 
    180  
    181   Example: 15 minutes 
    182  
    183 `Download large messages` 
    184   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. 
    185  
    186   Example: No 
    187  
    188 === Notification === 
     122`Delete mail on server` 
     123  If this option is activated, new mail will be deleted after downloading it from the mail server.  The messages will be deleted only after they have been successfully saved to your computer. If the POP3 account is used by several people, or if you'd like to access your account again later from another computer, this option can be deactivated. 
     124 
     125  Example Yes 
     126 
     127`Apply remote filter` 
     128 
     129'''''Default folders''''' 
     130 
     131`'Incoming' folder` 
     132 
     133[[=#FixNewmail]] 
     134'''''Notification for new mails''''' 
     135 
    189136`Requester` 
    190137  Once YAM has downloaded new mail, it will display a requester showing the number of new and deleted messages. 
     
    192139  Example: Yes 
    193140 
     141`AmigaOS4.1 notification system` 
     142 
    194143`Sound` 
    195144  Once YAM has downloaded new mail, it will play a sound file.  The datatypes library is used for playing, so the sound file can be of any format (like AIFF or WAVE), as long as you have installed the appropriate datatypes.  Click the small arrow (PLAY symbol) to test the sound. 
     
    202151  Example: RX PROGDIR:rexx/Newmail.YAM 
    203152 
     153=== Send mail (SMTP) === 
     154Apart from the primary SMTP server already defined in the First steps section, you can set up an unlimited number of SMTP servers here; the names appear in the list on the left and clicking on a name brings up the relevant details 
     155on the right. Note that these accounts 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 delete accounts. 
     156 
     157`Active` 
     158 
     159`Description` 
     160 
     161`Server` 
     162  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. 
     163 
     164  Example: mail.example.com 
     165 
     166`Port` 
     167  The port number of the SMTP service. The standard port is 25 for plain SMTP. In case of using SSL/TLS connections this port may also be 576 or 456. 
     168 
     169  Example: 25 
     170 
     171'''''Security and Authentification''''' 
     172 
     173`Connection Security` 
     174  Enable this if your SMTP server supports TLSv1/SSLv3 secure connections. If enabled, YAM will connect via the AmiSSL library with the SMTP server and encrypts every transfer. 
     175 
     176  Example: No 
     177 
     178`Authentification` 
     179  Enable this if you want to use SMTP Authentication, whereby YAM will request your mail server to use an extra authentication layer as documented in RFC 2554. You will need to fill in another couple of UserID/Password fields in this case. If your SMTP server does not support SMTP AUTH, you will receive an error message when trying to send email. Ask your ISP if in doubt.  
     180 
     181  Example: No 
     182 
     183`Username` 
     184  When using SMTP AUTH you can insert the user name for the SMTP authentification here. In most cases this will be identical to the username in your e-mail address.  However, there are exceptions, so check the instructions from your ISP (YAM then constructs the full account name in the form <Username>@<server>). 
     185 
     186  Example: jdoe 
     187 
     188`Password` 
     189  The password which has to be sent to the mail server at login time. You can leave this field empty for security reasons -- if you do, the password will be asked to you whenever you send new mails. Also, remember the password is case sensitive. 
     190 
     191  Example: nguz56 
     192 
     193'''''Options''''' 
     194 
     195`SMTP server allows 8bit` 
     196  Originally only the US-ASCII character set was allowed for use in e-mail, which meant that users were forced to use vowels (e.g., they had to use 'ae' instead of 'ä').  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 while 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 this option on and save a few bits when transferring e-mails. 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. 
     197 
     198  Example: Yes 
     199 
     200'''''Default folders''''' 
     201 
     202`'Sent' folder` 
     203 
     204----- 
     205== Identities == 
     206Manage pultiple identities for composing mails. 
     207 
     208=== General Settings === 
     209 
     210'''''General Settings''''' 
     211 
     212`Active` 
     213 
     214`Description` 
     215 
     216`Real name` 
     217 
     218`E-mail address` 
     219 
     220`Organization` 
     221 
     222  If you want the name of your organization, school, club or whatever to appear in a header of your message, insert it here. 
     223 
     224  Example:  Doe Donut Production Ltd. 
     225 
     226`Mail server (SMTP)` 
     227 
     228`Signature` 
     229 
     230=== Compose Mail === 
     231 
     232'''''Compose mail settings''''' 
     233 
     234`Cc: address` 
     235 
     236`Bcc: address` 
     237 
     238`Reply-To: address` 
     239 
     240  Normally this field should remain empty. The default Reply-To address is your e-mail address.  If you want to use a different address, then (AND ONLY THEN!!) you should insert that address here.  Alternatively, you can use the pop-up button to open the address book window, and then drag an entry from there into this field. 
     241 
     242  Example: jdoe@example.com 
     243 
     244`Extra headers` 
     245 
     246  If for some reason you need to add one or more special extra lines to the headers of your mail, you can insert these header lines here. If you would like to insert several lines, separate them by inserting '\n'. 
     247 
     248  PLEASE DON'T use this feature unless you have enough knowledge of the structure of Internet email. 
     249 
     250  Example: 'Content-Language: uk\nKeywords: Pattern, YAM, Internet' 
     251 
     252`URL to own photo` 
     253 
     254'''''Options''''' 
     255 
     256`After transfer store mails in 'Sent' folder` 
     257 
     258`Use alternative 'Sent' folder:` 
     259 
     260`Quote message when answering` 
     261 
     262`Put my answer...` 
     263 
     264`Put my signature...` 
     265 
     266`Use signature when replying` 
     267 
     268`Use signature when forwarding` 
     269 
     270`Add personnal information` 
     271 
     272`Request a return receipt` 
     273 
     274=== PGP-Security === 
     275 
     276'''''PGP-Security Settings''''' 
     277 
     278`Use PGP for this identity` 
     279 
     280`PGP key ID...` 
     281 
     282`PGP key URL...` 
     283 
     284'''''options''''' 
     285 
     286`Sign unencrypted mails per default` 
     287 
     288`Sign encrypted mails per default` 
     289 
     290`Encrypt all mails per default` 
     291 
     292`Add own key when encrypting mails` 
     293 
     294----- 
    204295[[=#FixFilters]] 
    205296== Filters == 
     
    219310You can define theoretically an unlimited number of 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. Filters are executed in top-to-bottom order, therefore you should place filters that delete or move messages at the bottom of the list. 
    220311 
    221 === Options === 
     312=== General === 
    222313`Name` 
    223314  The filter's name is merely for recognition and not of any other use. 
     
    237328 
    238329[[=#FixComparison]] 
    239 === Comparison === 
     330=== Conditions === 
    240331`Search in` 
    241332  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 headers- 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). 
     
    276367  //exclusive or// either one or the other of the two criteria must apply, but not both 
    277368 
     369`Use AmigaDOS patterns` 
     370 
    278371=== Action === 
    279372 
    280 `Bounce` 
     373`Redirect` 
    281374  Activate this option to have mail matching the search criteria bounced to another recipient -- for instance, you might use this to automatically resend certain email to your mailbox at work. 
    282375 
     
    308401  If you activate this option, YAM will move any email matching the search pattern to another folder. You can select the folder with the pop-up button. 
    309402 
     403`Set status to 'Marked'` 
     404 
     405`Set status to 'Unmarked'` 
     406 
     407`Set status to 'Read'` 
     408 
     409`Set status to 'Unread'` 
     410 
     411`Set status to 'Spam'` 
     412 
     413`Set status to 'Not spam'` 
    310414 
    311415`Delete` 
    312416  If this option is activated, all messages matching the search pattern will be deleted. (You probably guessed that... ;) ) 
    313417 
    314  
    315418`Don't download` 
    316419  If this option is activated, any message matching the search pattern will not be downloaded from the mail server. You can use a remote filter together with this option if several people share the same POP3 account. 
    317420 
     421`Terminate filter process` 
     422 
     423----- 
    318424[[=#FixSpam]] 
    319425== Spam == 
    320426Setup of the spam filter. 
    321427 
    322 `Activate spam filter` 
     428'''''Spam filter''''' 
     429 
     430`Spam filter enabled` 
    323431  Activates the spam filter, believe it or not :) 
     432 
     433`"Spam" classified mail...` 
     434 
     435`"Not spam" classified mails...` 
    324436 
    325437`Reset Spam training data` 
    326438  Resets the Spam training data. Should only be necessary in rare circumstances. 
    327439 
     440`Optimize training data` 
     441 
     442'''''Spam recognition''''' 
     443 
    328444`Check new mail for spam content` 
    329445  Automatically checks new mail for spam content. 
    330446 
    331 `Addressbook whitelisted` 
     447`Address book is white list` 
    332448  If a mail has an From: address that exist in your addressbook, it will never be considered as spam. 
    333449 
     
    344460  Applies all your defined filters to mail that is moved back to the 'Incoming' folder. 
    345461 
     462`Trust header lines of this external filter:` 
     463 
     464----- 
    346465[[=#FixRead]] 
    347466== Read == 
    348 Layout options 
    349  
    350 === Message header layout === 
    351 `Header` 
     467Settings related to e-mail reading. 
     468 
     469'''''Header layout''''' 
     470 
     471`Headers` 
    352472  If 'full' is selected, all the headers will be displayed. Select 'none' if you don't want to see any 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. The FROM, TO, DATE and SUBJECT fields are displayed by default. The header layout can also be changed (temporarily) in the Read window itself. 
    353473 
     
    360480  Choose whether to show long headers on one line or to break them on two or more. In the first case, you will need to use the horizontal scrollbar in order to see all the information. 
    361481 
    362 === Message body layout === 
    363 `Separate sig.` 
     482'''''Message body layout''''' 
     483 
     484`Sig. separator` 
    364485  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 kind 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 signature at all. 
    365486 
     
    370491  Select here the color used for the several levels of quoting. 
    371492 
     493`URL color` 
     494 
     495'''''Font settings''''' 
     496 
    372497`Use fixed font` 
    373498  It often makes more sense to use a non-proportional font to read messages, since the layout of any tables will be distorted when 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'. 
    374499 
    375 `Display all texts` 
    376   If this option is activated and the message contains attachments, not only the actual body of the message will be displayed, but also those attachments themselves, as long as they are of the 'text' type. 
    377  
    378 `Text styles` 
     500`Show text colors` 
     501 
     502`Show text styles` 
    379503  YAM uses the characters '_', '/', '*' and '#' to indicate underlined, italic, bold and colored text.  For certain special documents, as it is the case with source code, 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. 
    380504 
    381 === Other options === 
     505'''''Return receipts''''' 
     506 
     507`Never send a return receipt` 
     508 
     509`Allow return receipt for some messages...` 
     510 
     511'''''Other options''''' 
     512 
    382513`Multiple windows` 
    383514  With this option selected, each message which you choose to read will open its own Read window. 
    384515 
     516`Search for mails of same thread in all folders` 
     517 
     518`Delay marking of displayed mail as read for...` 
     519 
     520`Convert HTML e-mails to plain text` 
     521 
     522`Map foreign chars to ASCII` 
     523 
     524`Auto-detect cyrillic charsets` 
     525 
     526`Display all texts` 
     527 
     528`Show alternative parts` 
     529 
     530----- 
    385531[[=#FixWrite]] 
    386532== Write == 
    387 Headers, stock phrases and editor settings 
    388  
    389 === Message Header === 
    390 `Reply to` 
    391   Normally this field should remain empty. The default Reply-To address is your e-mail address.  If you want to use a different address, then (AND ONLY THEN!!) you should insert that address here.  Alternatively, you can use the pop-up button to open the address book window, and then drag an entry from there into this field. 
    392  
    393   Example: jdoe@example.com 
    394  
    395 `Organization` 
    396   If you want the name of your organization, school, club or whatever to appear in a header of your message, insert it here. 
    397  
    398   Example:  Doe Donut Production Ltd. 
    399  
    400 `Extra headers` 
    401   If for some reason you need to add one or more special extra lines to the headers of your mail, you can insert these header lines here. If you would like to insert several lines, separate them by inserting '\n'. 
    402  
    403   PLEASE DON'T use this feature unless you have enough knowledge of the structure of Internet email. 
    404  
    405   Example: 'Content-Language: uk\nKeywords: Pattern, YAM, Internet' 
    406  
    407 === Message Body === 
     533Settings related to e-mail composing. 
     534 
     535'''''Message Body''''' 
     536 
    408537`Welcome phrase` 
    409538  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'. 
     
    416545  Example: 'Kind regards\n\nJohn Doe' 
    417546 
     547`Default charset` 
     548 
     549'''''Editor''''' 
     550 
     551`Word wrap` 
     552  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 decide whether YAM will insert line breaks as you type or if this should be postponed until you send the message.  In the first case, the internal editor will insert line break codes while you're typing the message.  This way you avoid unwanted surprises when the text is formatted later on saving the message, but on the other hand, any subsequent insertion or deletion of text might be a little less comfortable. 
     553 
     554  Example: 76 
     555 
     556`Email cache` 
     557  YAM can cache on disk a certain number of the most recent recipients used when writing a new email, if those recipients aren't already in your address book. This may improve the performance of the automatic name completer, especially if your address book is rather brief and you often find yourself having to type your recipient's name and address. 
     558 
     559  If the hit ratio of the email cache is very low in your everyday use, you might want to turn it off completely by selecting zero mails. 
     560 
     561`Autosave interval` 
     562 
     563'''''Font settings''''' 
     564 
     565`Use fixed font` 
     566 
     567`Show text colors` 
     568 
     569`Show text styles` 
     570 
     571'''''Other options''''' 
     572 
    418573`Warn when there's an empty subject line` 
    419574  Activate this option to let YAM warn you any time you try to send an email with an empty subject line.  This may be the case when sending email to mailing list managers and other automated services, but it is generally considered as bad taste to use an empty subject line when posting to a mailing list.  If you seldom use empty subject lines or you use to forget to fill in this field, you might want to use this option. 
    420575 
    421 === Editor === 
    422 `Word wrap` 
    423   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 decide whether YAM will insert line breaks as you type or if this should be postponed until you send the message.  In the first case, the internal editor will insert line break codes while you're typing the message.  This way you avoid unwanted surprises when the text is formatted later on saving the message, but on the other hand, any subsequent insertion or deletion of text might be a little less comfortable. 
    424  
    425   Example: 76 
    426  
    427 `External editor` 
    428   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 its name here.  Remember to insert the full path for the editor, and maybe an appropriate command line option. 
    429  
    430   Examples: 'C:Ed' 
    431  
    432 `Launch immediately` 
     576`Launch external editor immediately` 
    433577  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. 
    434578 
    435 `Email cache` 
    436   YAM can cache on disk a certain number of the most recent recipients used when writing a new email, if those recipients aren't already in your address book. This may improve the performance of the automatic name completer, especially if your address book is rather brief and you often find yourself having to type your recipient's name and address. 
    437  
    438   If the hit ratio of the email cache is very low in your everyday use, you might want to turn it off completely by selecting zero mails. 
    439  
     579`Check for missing attachments` 
     580 
     581----- 
    440582[[=#FixReplyForward]] 
    441583== Reply/Forward == 
    442 Options for quoting messages 
    443  
    444 === Forwarding === 
    445 `Initial phrase` 
    446   This text will be added at the beginning of the original text of any message you forward.  Click 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 with their respective values, taken from the forwarded message. 
    447  
    448   Example: '*** Forwarded message, originally by %n on %d: ***\n' 
    449  
    450 `Terminating phrase` 
    451   This text will be inserted at the end of any forwarded message, but before the greetings phrase.  Click the pop-up button to select a variable from the list (for subject, date, sender, etc.). 
    452  
    453   Example:  '*** End of forwarded message ***\n' 
    454  
    455 === Replying === 
     584Settings related to e-mail replying and forwarding. 
     585 
     586'''''Replying''''' 
     587 
    456588`Default reply phrase` 
    457589  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 the pop-up button to select a variable from the list (for subject, date, sender, etc.). 
     
    460592            [Intro]   'On %d, you wrote:\n' 
    461593            [Close]   'Kind regards' 
    462  
    463594 
    464595`Alternative reply phrase` 
     
    481612            [Close]   'Kind regards' 
    482613 
    483 `Quote message using` 
    484   The character(s) specified in the editing field plus a space will be put in front of each line of the original message.  Click the pop-up button to select a variable for the sender's initials. 
    485  
    486   Example: '%i>' 
    487  
    488 `Quote external using` 
    489   The character(s) specified in the editing field plus a space will be put in front of each line quoted from an external source, not necessarily related to e-mail.  This is used when inserting or pasting text using the "alternate quoted" method. 
    490  
    491   Example: '|'  
     614`Verify recipient address` 
     615  If this option is enabled, YAM will check if the sender and the return address are the same -- if the "From:" and the "Reply-To:" headers of the message are different, you will be asked to select whom to reply to.  This way it is fairly easy to reply privately to a message from a mailing list. 
    492616 
    493617`Quote empty lines` 
    494618  Usually, the quotation character is inserted at the beginning of empty lines contained in the quoted message.  If for some reason you don't like this, just deactivate this option. 
    495619 
    496 `Verify recipient address` 
    497   If this option is enabled, YAM will check if the sender and the return address are the same -- if the "From:" and the "Reply-To:" headers of the message are different, you will be asked to select whom to reply to.  This way it is fairly easy to reply privately to a message from a mailing list. 
    498  
    499620`Strip signature` 
    500621  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, that is, two dashes AND a space. 
    501622 
     623'''''Forwarding''''' 
     624 
     625`Forward messages...` 
     626 
     627`Initial phrase` 
     628  This text will be added at the beginning of the original text of any message you forward.  Click 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 with their respective values, taken from the forwarded message. 
     629 
     630  Example: '*** Forwarded message, originally by %n on %d: ***\n' 
     631 
     632`Terminating phrase` 
     633  This text will be inserted at the end of any forwarded message, but before the greetings phrase.  Click the pop-up button to select a variable from the list (for subject, date, sender, etc.). 
     634 
     635  Example:  '*** End of forwarded message ***\n' 
     636 
     637----- 
    502638[=#FixSign] 
    503639== Signature == 
    504640You can define and use one standard and upto two alternative signatures within YAM (e.g. one signature for private email 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 below. 
    505641 
    506 `Use signature` 
     642'''''Signature''''' 
     643 
     644`Active` 
    507645  If this option is activated, a signature will be inserted at the end of each message you write. 
    508646 
     647`Signature text` 
    509648 
    510649`Edit in external editor` 
     
    517656  Click this button to insert the variable '%e' at the current cursor position in the editor.  YAM will replace this variable with the contents of the 'SIGNATURE' environment variable while creating a new message.  This way it is possible to have random values automatically inserted into the signature, like the date, the actual temperature, the time, your weight or whatever... 
    518657 
     658`Append a file as signature instead` 
     659 
     660'''''Taglines''''' 
     661 
    519662`Tagline file` 
    520663  The tagline database contains taglines, 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. 
     
    528671 
    529672[=#FixLists] 
    530 == Lists == 
    531 Columns, sizes, time unit, context menus 
    532  
    533 === Field settings === 
    534 `Folder list, Message list` 
    535   Select the items you want to see in these lists. 
    536  
    537   As of YAM 2.4, you can also have a context menu for both the folder and message lists. 
    538  
    539 === General settings === 
    540 `Use fixed font` 
    541   It often makes more sense to use a non-proportional font since the display might become distorted 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'. 
    542  
    543 `Time in Swatch Beats` 
    544   Enable this option to display the time in Swatch Beats instead of the hours:minutes format.  This revolutionary unit of time, invented by Swatch, a Swiss watch manufacturer, divides the day in 1000 beats and abolishes the different time zones.  The meridian is Biel, a town located in Switzerland. 
    545  
    546 `Size format` 
    547   This setting allows you to select the exact format of the sizes given in the message and folder lists, as well as the preselection window. 
    548  
    549 === Status bar === 
    550 `Position` 
    551   Allows you to select the position of the status bar, or even disable it completely. 
    552  
    553   Example: Top 
    554  
    555 `Label` 
    556   The contents of the status bar.  Use the pop-up button at the right to select a variable for new, unread, etc. messages. 
    557  
    558   Example: '- Total: %t New: %n Unread: %u' 
    559  
     673 
     674----- 
    560675[[=#FixSecurity]] 
    561676== Security == 
    562 Encrypting mails with PGP 
    563  
    564 === PGP === 
     677Configure security related settings. 
     678 
     679'''''PGP (Pretty Good Privacy)''''' 
     680 
    565681`PGP's directory` 
    566682  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. 
     
    568684  Example: 'Work:Programs/PGP/bin/'  
    569685 
    570 `Your PGP key ID` 
    571   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 YAM cannot find your PGP key, then either PGP is not installed correctly on your system, or you've specified the wrong path for the PGP executable. 
    572  
    573   Example: 0x70804A7B 
    574  
    575 `Encrypt to self` 
    576   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. 
     686`Remember passphrase for...` 
    577687 
    578688[[=#FixLogfiles]] 
    579 === Log files === 
    580 `Log file path` 
     689'''''Log files''''' 
     690 
     691`Mode` 
     692 
     693  If you are not interested in having log files at all, select 'none'.  Select 'normal' to have only the important events like receiving/sending mail recorded.  In 'verbose' mode, YAM will log every transferred e-mail in detail. 
     694 
     695`Path` 
     696 
    581697  YAM will save the log files to the path specified here. The format of log files is explained in the  Reference  chapter. 
    582698 
    583699`Split log file` 
     700 
    584701  Switch this option on if you want YAM to create a new log file each month.  To distinguish the different files that will be created, YAM includes the date in the log file name, e.g. YAM-Jan98.log. If you'd like one big single log file, just leave this option deactivated. 
    585702 
    586 `Mode` 
    587   If you are not interested in having log files at all, select 'none'.  Select 'normal' to have only the important events like receiving/sending mail recorded.  In 'verbose' mode, YAM will log every transferred e-mail in detail. 
    588  
    589703`Log all events` 
     704 
    590705  Deactivate this option if you're only interested in logging events having to do with the mail transfer (sending/receiving). 
    591706 
     707----- 
    592708[[=#FixStartQuit]] 
    593709== Start/Quit == 
    594710Options for actions at start up and termination 
    595711 
    596 === On program startup === 
     712'''''On program startup''''' 
     713 
    597714`Load all folders` 
    598715  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 startup -- the index files of the user-defined folders will be loaded only when they are needed. 
     
    613730  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 NOCHECK switch. 
    614731 
    615 `Download new mail` 
    616   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 on startup.  You can temporarily stop YAM from doing so by starting YAM from a shell with the NOCHECK switch. 
    617  
    618 === On program termination === 
     732'''''On program termination''''' 
     733 
    619734`Send mail in outgoing queue` 
    620735  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 are actually any messages in the Outgoing folder.) 
     
    626741  Switch this on to make YAM empty the 'Deleted' folder when closing down. 
    627742 
     743`Save user interface layout` 
     744 
     745----- 
    628746[[=#FixMime]] 
    629747== MIME == 
     
    635753In addition, new file types defined here are also taken into account when composing a new message.  For instance, if a new attachment type "application/pgs" is defined for filenames ending in ".pgs", YAM will automatically use this MIME type when attaching files that bear this extension. 
    636754 
    637 `Attachment type` 
     755'''''Options''''' 
     756 
     757`MIME type` 
    638758  This is the type of the actual entry, and corresponds to the Content-Type field contained in the message.  You can select one from the pop-up list or use AmigaDOS wildcards, e.g. 'image/#?' to use the programme for a whole class of file types. 
    639759 
    640760  Example: 'image/jpeg' 
    641761 
    642 `Extension` 
     762`File xtensions` 
    643763  Filename extension for the file type.  This extension allows YAM to assign the correct "Content-Type:" field for a file. 
    644764 
    645765  Example: 'jpg jpeg jfif' 
     766 
     767`Description` 
    646768 
    647769`Viewer` 
     
    650772  Example: 'TOOLS:Gfx/ViewJPG "%s"' 
    651773 
     774`Display charset` 
     775 
     776'''''Default''''' 
     777 
    652778`Default viewer` 
    653779  This viewer will be used if the attachment doesn't match any of the user defined types (see above). 
     
    655781  Example: 'SYS:Utilities/MultiView "%s" SCREEN' 
    656782 
    657 `Identify binary attachments` 
    658   Some mail clients always use application/octet-stream as the "Content-Type:" field for binary attachments.  To still show such attachments with the correct program, YAM can search the viewer list based on the file name extension of the attached file (see Extension above). 
    659  
    660 === Paths === 
    661  
    662 `Decode files to` 
    663   This is the pre-selected directory to decode attachments into. 
    664  
    665   Example: Work:Data/In 
    666  
    667  
    668 `Attach files from` 
    669   Whenever you want to attach a file to a new message, YAM will look for it at this position first. 
    670  
    671   Example: Work:Data/Out 
    672  
     783`Display charset` 
     784 
     785----- 
    673786[[=#FixAddressbook]] 
    674787== Address book == 
    675 Visible columns, personal data exchange 
    676  
    677 === Colums === 
     788Configure address book related options. 
     789 
     790'''''Colums''''' 
    678791Select the items you want to see in the address book. 
    679792 
    680 === Personal data exchange === 
    681 `Add personal info` 
    682   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 to your address book containing your data (YAM will find your entry based on the e-mail address). 
     793'''''Personal data exchange''''' 
    683794 
    684795`Save sender's address` 
     
    701812  Example:  PROGDIR:Gallery 
    702813 
    703 `URL of your picture` 
    704   If one exists, enter here the WWW address (URL) of a small photo of yourself.  The URL will be listed along with the headers of every outgoing message if 'Add personal info' is enabled. 
    705  
    706   Example: 'http://yam.ch/gallery/BECK_Marcel.gif' 
    707  
    708814`HTTP Proxy server` 
    709815  If you're behind a firewall and only get into the Internet using a proxy server, then you have to enter here the address of that proxy server, otherwise it won't be possible to download photos or get information about new versions of YAM. 
     
    711817  Example: proxy.example.com:8080 
    712818 
     819----- 
    713820[[=#FixScripts]] 
    714821== Scripts == 
     
    729836  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 before YAM can go ahead with other tasks. 
    730837 
     838----- 
    731839[[=#FixMisc]] 
    732840== Miscellaneous == 
    733841Paths, AppIcon, save/delete, tracking & packing 
    734842 
    735 === Paths === 
    736 `Directory for temp files` 
     843'''''Paths''''' 
     844 
     845`For temporary files` 
    737846  YAM needs this directory to save some files needed while processing e.g. messages with MIME attachments.  If you are short on memory (2 MB or less), you better choose a path on your hard disk to avoid possible problems with very large messages. 
    738847 
    739848  Example: 'T:' 
    740849 
    741 === Mailbox status AppIcon === 
     850`Decode files to` 
     851 
     852`Attach files from` 
     853 
     854`Download path` 
     855 
     856'''''External editor settings''''' 
     857 
     858`External editor` 
     859 
     860`Display charset` 
     861 
     862'''''Mailbox status''''' 
     863 
     864`AppIcon on Workbench` 
     865 
     866`Label` 
     867  The label for the AppIcon which will be displayed while YAM is running can be specified here.  Click the pop-up button to select a variable for new, unread, etc. messages. 
    742868 
    743869`Position X/Y` 
     
    746872  Example: 'X:550  Y:144' 
    747873 
    748 `Label` 
    749   The label for the AppIcon which will be displayed while YAM is running can be specified here.  Click the pop-up button to select a variable for new, unread, etc. messages. 
     874`Enable 'docky' icon` 
    750875 
    751876`Close gadget iconifies program` 
    752877  Following the MUI default behavior, the close gadget (or the <Esc> key) will terminate the program.  Activate this option to let them iconify YAM instead. 
    753878 
    754 === Save/delete messages === 
     879'''''Save/delete messages''''' 
    755880 
    756881`Confirm deletion of [xx] or more messages` 
     
    760885  If this option is switched on, messages won't be moved to the 'Deleted' folder on deletion -- instead, they will be erased immediately from the hard disk.  This saves some time and memory, but on the other hand you won't be able to retrieve any message deleted by mistake. 
    761886 
    762 `Save sent messages` 
    763   Activate this option to make YAM save sent messages into the 'Sent' folder.  You can select this as well specifically for any single mail, by using the relevant option in the  Write  window. 
    764  
    765 === Message tracking === 
    766  
    767 Here you can define how YAM should react if a message's sender has requested a disposition notification (MDN) while writing his/her message. 
    768  
    769  //Ignore//   - The request will be ignored completely and there won't be any report. 
    770  //Autodeny// - The sender will be informed that you don't wish to send a disposition notification for the message. 
    771  //Accept//   - The sender will be informed as requested about the message's disposition. 
    772  //Ask user// - You can decide in each case if you want to ignore, deny or accept the request. 
    773  
    774   Additionally, YAM's reaction can be related to the event activating the disposition notification: 
    775  
    776  //Display//  - The message was read or answered 
    777  //Process//  - The message was bounced or forwarded without reading 
    778  //Delete//   - The message was deleted without reading 
    779  //Filter//   - The message was automatically processed or deleted by a filter 
    780  
    781 `Send at once` 
    782   The condition report will be sent immediately if there's a TCP/IP stack running, otherwise it will be saved to the 'Outgoing' folder. 
    783  
    784 === XPK/LhA settings === 
     887'''''XPK/LhA settings''''' 
    785888 
    786889`Packer` 
     
    799902  Example: 'LhA -a -m -i%l a %a' 
    800903 
     904'''''Connections''''' 
     905 
     906`Transfer window` 
     907 
     908----- 
    801909[[=#FixLook] 
    802910== Look & Feel == 
    803911Here YAM will display a list with available themes and a small preview of what it will look like. 
    804912 
     913=== Theme === 
     914 
    805915`Activate` 
    806916  Activates the selected theme, which requires you to save the configuration and restart YAM, in order to see the new icons. 
    807917 
    808 `Status bar` 
     918=== Main window === 
     919 
     920'''''Column settings''''' 
     921 
     922  ''Folder list'' 
     923 
     924  `Folder name` 
     925 
     926  `Total` 
     927 
     928  `Unread` 
     929 
     930  `New` 
     931 
     932  `Size` 
     933 
     934  `Context menu` 
     935 
     936  ''Message list'' 
     937 
     938  `Status` 
     939 
     940  `Sender/recipient` 
     941 
     942  `Return address` 
     943 
     944  `Subject` 
     945 
     946  `Message date` 
     947 
     948  `Size` 
     949 
     950  `Filename` 
     951 
     952  `Date Sent/Received` 
     953 
     954  `Mail account` 
     955 
     956  `Context menu` 
     957 
     958'''''Status bar''''' 
     959 
     960`Position` 
    809961  Will show a status bar at either - top, middle, bottom or don't show any at all. 
    810962 
     
    812964  Here you can select what the status bar should show. There are a number of different options to select from. 
    813965 
     966'''''Quick search bar''''' 
     967 
     968`Position` 
     969 
     970'''''General settings''''' 
     971 
    814972`Size format` 
    815973  Here you can select how YAM will display sizes for mails and mail drawers. 
    816974 
    817 `Embedded read pane in main window` 
     975`Show embedded read pane in main window` 
    818976  Shows an embedded read pane in the main window, which allows you to read mails directly in the main window instead of double-clicking a mail to open it in a separate read window. 
    819977 
    820 `Show quick search in main window` 
    821   Shows a quick search field in the main window, for quick searches :) 
    822  
     978`Use fixed font` 
     979 
     980`Show time in Swatch Beats` 
     981 
     982`Relative date output` 
     983 
     984`Address book lookup in message list` 
     985 
     986`Double click on folder opens folder settings` 
     987 
     988----- 
    823989== Updates == 
    824990Update settings 
    825991 
     992'''''Update check''''' 
     993 
    826994`Check for updates` 
    827995  Allows you to select the interval at which YAM will check for updates to itself and other third party software, which YAM needs. A button next to it, allows you to do manual checks for updates at will. 
     
    829997  Below you can also see when exactly the last check was done. 
    830998 
     999----- 
     1000----- 
    8311001= Hidden Configuration = 
    8321002