Changes between Initial Version and Version 1 of Documentation/Windows/Writewindow


Ignore:
Timestamp:
Oct 10, 2013 8:33:50 PM (12 months ago)
Author:
AmigaPhil
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/Windows/Writewindow

    v1 v1  
     1[[TranslatedPages]] 
     2 
     3= Write window = 
     4 
     5This window will appear when you choose to write a new message or 
     6answer or forward an already existing message.  You can open TWO Write 
     7windows at a time.  The Write window consists of three sheets, laid out 
     8as shown below.  The menu bar is the same for each sheet. 
     9 
     10 
     11   Menu bar: [[Menus#FixWriteText| Text ]] [[Menus#FixWriteEdit| Edit ]] [[Menus#FixWriteAttachments| Attachments ]] [[Menus#FixWriteOptions| Options ]] 
     12 
     13  ||      [[#FixWriteMessage|  Message  ]]     ||  [[#FixWriteAttachments| Attachments ]]   ||    [[#FixWriteOptions|  Options  ]]     || 
     14  |||||| || 
     15  ||||||            The big text edit field on the 'Message'                 || 
     16  ||||||            sheet is the [[#FixEdit| internal editor ]] which you                 || 
     17  ||||||            can use to enter your message.                           || 
     18 
     19  `Send now`     `Send later`        `Hold`         `Cancel` 
     20 
     21These four buttons appear at the bottom of each sheet: 
     22 
     23 
     24'''Send now''' 
     25     Prepares the message for sending, moves it to the Outgoing folder 
     26     and tries to send the mail at once.  For this option to work 
     27     correctly, there must be a TCP/IP stack running and online. 
     28 
     29 
     30'''Send later''' 
     31     Prepares the message for sending and copies it to the Outgoing 
     32     folder.  Use this button when working offline. 
     33 
     34 
     35'''Hold''' 
     36     The message will be prepared as described in '''Send later''' and copied 
     37     to the Outgoing folder, but will be held back and NOT sent.  Use 
     38     this button for unfinished messages, e.g. if you'd like to make 
     39     some additions to the e-mail at a later time, and not risk them to 
     40     be sent out by mistake. 
     41 
     42 
     43'''Cancel''' 
     44     Use this button if you've changed your mind.  '''BEWARE:''' All input 
     45     made in this window will be lost.  But don't worry, a security 
     46     requester will popup before YAM really discards any modifications 
     47     you have made.  (It won't show up if you haven't made any 
     48     modifications in the message itself, though). 
     49 
     50[[=#FixWriteMessage]] 
     51== Write window – Message sheet == 
     52 
     53Above the large [[edit| text editor ]] area there are two header fields and a toolbar. 
     54 
     55 
     56'''To''' 
     57     Insert here the main recipient you wish to send the actual message 
     58     to.  You can use names or aliases from the address book or even 
     59     full e-mail addresses in case the recipient does not exist in the 
     60     address book.  If you wish to enter several recipients, you have to 
     61     separate them by inserting commas. 
     62 
     63     There are several ways of importing here any recipient which can 
     64     be found in your address book -- just select the method you feel 
     65     more comfortable with: 
     66 
     67       a. click on the pop-up button to the right, thereby opening the 
     68          address book.  Now you can either double click on any entry 
     69          you want, or [[drag| drag ]] it over to the text field holding the left 
     70          mouse button. 
     71 
     72       b. while the address book window is open, you can click the '''To:''' 
     73          button there to automatically add the current entry to the 
     74          '''To:''' field of your message.  To add several recipients, just 
     75          select them one by one and click the '''To:''' button in turn. 
     76 
     77       c. lastly, a newly introduced and more elegant method is to just 
     78          start typing the alias, first name or email address of your 
     79          recipient in the '''To:''' field.  This way you are quickly 
     80          presented with a dropdown list of the possible matches, taken 
     81          from your address book. 
     82 
     83          <Shift-Return> adds only the recipient address and drops the 
     84          real name, whilst pressing <Return> without selecting a recipient 
     85          will add the first match in the dropdown list.  Both techniques 
     86          can be combined. 
     87 
     88     If YAM cannot find a name or alias you've inserted manually into 
     89     the '''To:''' field, you will get an error report as soon as you try to 
     90     send [later] or hold your message.  Please double check your 
     91     spelling, or just use one of the selection methods outlined above. 
     92 
     93     Example: 
     94 
     95            jdoe, boss@work.whyme.com 
     96 
     97 
     98'''Subject''' 
     99     What the mail is all about.  When a mail is answered, there will be 
     100     a '''Re:''' inserted in front of the original subject, whereas when 
     101     forwarded a '''(fwd)''' will be added at the end. 
     102 
     103 
     104'''Toolbar''' 
     105 
     106    || 1 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Editor_S)]]|| 2 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Insert_S)]]|| 3 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Cut_S)]]|| 4 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Copy_S)]]|| 5 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Paste_S)]]|| 6 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Undo_S)]]|| 7 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Bold_S)]]|| 8 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Italic_S)]]|| 9 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Underline_S)]]|| 10 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Colored_S)]]|| 11 [[Image(http://yam.ch/export/HEAD/trunk/resources/themes/default/toolbar/tb_Find_S)]]|| 
     107 
     108    || 1 [Editor]   ||same as menu item [[wrm1| Text/Launch editor ]]|| 
     109    || 2 [Insert]   ||same as menu item [[wrm1| Text/Insert as/Plain ]]|| 
     110    || 3 [Cut]      ||same as menu item [[wrm2| Edit/Cut ]]|| 
     111    || 4 [Copy]     ||same as menu item [[wrm2| Edit/Copy ]]|| 
     112    || 5 [Paste]    ||same as menu item [[wrm2| Edit/Paste ]]|| 
     113    || 6 [Undo]     ||same as menu item [[wrm2| Edit/Undo ]]|| 
     114    || 7 [Bold]     ||same as menu item [[wrm2| Edit/Textstyle/Bold ]]|| 
     115    || 8 [Italic]   ||same as menu item [[wrm2| Edit/Textstyle/Italic ]]|| 
     116    || 9 [ULined]   ||same as menu item [[wrm2| Edit/Textstyle/Underlined ]]|| 
     117    || 10 [Colored]  ||same as menu item [[wrm2| Edit/Textstyle/Alternative color ]]|| 
     118    || 11 [Search]   ||allows you to search the text for a given string|| 
     119 
     120[[=#FixEdit]] 
     121=== Write window – Internal editor === 
     122 
     123YAM uses the efficient MUI class TextEditor.mcc for message 
     124handling.  Many aspects of the editor, such as keybindings, 
     125spellchecking or fonts can be changed in the '''TextEditor''' sheet of the 
     126[[mam4| MUI configuration ]].  Although you can modify the keybindings, here 
     127is a list of the important default settings in TextEditor 15.9: 
     128 
     129 
     130        <Control-Up>         go to the start of the text\\ 
     131        <Control-Down>       go to the end of the text\\ 
     132        <Control-Left>       go to the start of the line\\ 
     133        <Control-Right>      go to the end of the line\\ 
     134        <Alt-Up>             previous page\\ 
     135        <Alt-Down>           next page\\ 
     136        <Alt-Left>           previous word\\ 
     137        <Alt-Right>          next word\\ 
     138        <RAmiga-x>           cut\\ 
     139        <RAmiga-c>           copy\\ 
     140        <RAmiga-v>           paste\\ 
     141        <RAmiga-z>           undo\\ 
     142        <RAmiga-RShift-z>    redo\\ 
     143        <Command-Help>       suggest a word\\ 
     144        <Del>                delete the character\\ 
     145        <Shift-Backspace>    delete to start of line\\ 
     146        <Shift-Del>          delete to end of line\\ 
     147        <Alt-Backspace>      delete to start of word\\ 
     148        <Alt-Del>            delete to end of word\\ 
     149        <Alt-Tab>            quit editor\\ 
     150 
     151The TextEditor homepage can be found at http://sourceforge.net/projects/texteditor-mcc/ 
     152 
     153[[=#FixWriteAttachments]] 
     154== Write window – Attachment sheet == 
     155 
     156You can add one or more files to your message.  This way you can send 
     157binary files such as archives, pictures, etc. via e-mail.  You can choose 
     158the method of encoding (MIME or UUencoded) and write a comment for each 
     159file.  Files can be archived automatically to reduce the size of the 
     160resulting message. 
     161 
     162The attachment list contains five columns: filename, size (in bytes), 
     163contents, encoding and description.  You can re-order the files using 
     164Drag & Drop. 
     165 
     166 
     167=== Buttons and Gadgets === 
     168 
     169'''Add file(s)''' 
     170     You can select one or more files, which will be added as new 
     171     attachments to the list.  YAM recognizes over 20 filetypes 
     172     automatically and will fill in the '''MIME type''' field accordingly. 
     173 
     174 
     175'''Pack & add''' 
     176     By adding files this way, they will be archived with e.g. LhA, LZX 
     177     or ZIP before being actually attached to the message.  Select the 
     178     files you would like to add to the archive and then enter an 
     179     archive name.  You can define the archiver in the configuration 
     180     window, under [[co14| Miscellaneous ]]. 
     181 
     182 
     183'''Delete''' 
     184     Removes the selected entries from the list. 
     185 
     186 
     187'''Display''' 
     188     Displays the selected entry using one of the programs contained in 
     189     the MIME viewers list.  The program used by default is MultiView. 
     190 
     191 
     192'''Encoding''' 
     193     For normal use you should encode your files using MIME 
     194     (Base64/QP).  YAM uses ''quoted printable'' encoding for text files and 
     195     ''Base64'' for binary files.  If the recipient isn't able to decode 
     196     messages in MIME format (because his mailer does not support 
     197     this), you can also ''UUencode'' the files.  Messages containing 
     198     UUencoded files are still in MIME '''multipart/mixed format''', but 
     199     those attachments can be extracted from the message using a 
     200     UUdecoder such as '''UUxT'''.  A message generated by YAM may contain 
     201     UUencoded attachments as well as attachments in Base64 format. 
     202 
     203 
     204'''MIME type''' 
     205     As long as YAM recognizes the filetype of the attachment, the 
     206     correct MIME type will be inserted automatically, otherwise the 
     207     default setting ('''application/octet-stream''') will be used.  Before 
     208     defining a new MIME type, please check that is isn't already part 
     209     of the pop-up list. 
     210 
     211     Additional file types defined in the [[co11| MIME configuration ]] are 
     212     also used automatically. 
     213 
     214     Example:  image/gif 
     215 
     216 
     217'''Description''' 
     218     Here you can enter a comment about the actual attachment. 
     219 
     220     Example:  Picture from our summer holidays (GIF format) 
     221 
     222[[=#FixWriteOptions]] 
     223== Write window – Options sheet == 
     224 
     225The items in the '''Options''' menu correspond to the buttons on this sheet. 
     226 
     227The layout of this sheet is: 
     228{{{ 
     229                    _________________________________________________ 
     230          Copies to|_______________________________________________|^| 
     231   Hidden copies to|_______________________________________________|^| 
     232               From|_______________________________________________|^| 
     233           Reply to|_______________________________________________|^| 
     234  Additional header|_________________________________________________| 
     235}}} 
     236      `Send options`           ` Signature`            `Security` 
     237 
     238=== Header fields === 
     239 
     240'''Copies to''' 
     241     The recipients listed here will receive a copy of the message. 
     242     See also the explanation about the '''To:''' field given for the 
     243     [[wr00| Message sheet ]]. 
     244 
     245 
     246'''Hidden copies to''' 
     247     The recipients listed here will receive a copy of the message; 
     248     however, unlike the recipients listed in '''Copies to''', they won't 
     249     appear in the message headers.  This is useful if you want to 
     250     send someone a copy of a message without the other recipient(s) 
     251     knowing. 
     252 
     253 
     254'''From''' 
     255     Pretty obvious, really!  YAM will fill this in with your address, 
     256     but you might want to change the way your real name appears. 
     257 
     258 
     259'''Reply to''' 
     260     This setting is also valid only for the current message and will 
     261     be inserted instead of the usual "Reply-To:" address as specified 
     262     in the program settings.  Leave this blank unless it needs to be 
     263     different from the e-mail address in the "From:" header. 
     264 
     265 
     266'''Additional header''' 
     267     If for any reason it should become necessary to add one or more 
     268     special header lines to a message, you can enter these here. 
     269     Several lines must be separated by inserting '\n'.  YAM will 
     270     prepend the entered headers with '''X-YAM-Header-''' in the resulting 
     271     message. 
     272 
     273     Example:  Keywords: Amiga, YAM\nPassword: CuriosityKilledTheCat 
     274 
     275 
     276=== Send options === 
     277 
     278'''Delete after sending''' 
     279     Activate this option if you want the message to be deleted right 
     280     after being transmitted, instead of being copied to the 'Sent' 
     281     folder. 
     282 
     283 
     284'''Disposition Notification''' 
     285     Activate this option to request the recipient's e-mail program to 
     286     let you know about what the recipient did with your message, e.g. 
     287     if the message has been read by the recipient or if the recipient 
     288     has deleted or forwarded it.  Please note that there are only a 
     289     handful of e-mail programs which support this function, as well as 
     290     the fact that the recipient might forbid the sending of any status 
     291     report on e-mails.  Therefore, not getting any information even with 
     292     this option in use does not necessarily mean that the message has 
     293     not been read.  The command to send a status report is contained 
     294     in the '''Disposition-Notification-To:''' header field.  At the time of 
     295     writing this document, the Internet standard for Message Disposition 
     296     Notifications (MDN) was still being formulated. 
     297 
     298 
     299'''Add personal info''' 
     300     Check this option to create a special '''X-SenderInfo:''' header 
     301     containing personal data like your postal address, phone number, 
     302     homepage, date of birth or URL of your picture.  If the recipient 
     303     works with YAM too, (s)he will be able to create an address book 
     304     entry and fill it with your data.  To get this to work, add an 
     305     entry in your address book containing your data (YAM will find 
     306     your entry based on the email address).  If one exists, enter 
     307     the WWW address of a small photo of yourself in the "address book" 
     308     section of the configuration. 
     309 
     310 
     311'''Importance''' 
     312     Specify here how important the message is for the recipient. 
     313     Messages noted as important will usually be displayed with an 
     314     exclamation mark in the status line and put into first place by 
     315     automatic mail sorting.  The level of importance is stored in 
     316     the '''Importance:''' header. 
     317 
     318 
     319=== Signature === 
     320 
     321Here you can replace the standard signature by one of the alternative 
     322signatures, or switch it off completely for this message. 
     323 
     324 
     325=== Security === 
     326 
     327Select here which security measures you want to take for this message. 
     328 
     329    none: Normal mail transfer.\\ 
     330    sign: The message will be signed with your PGP public key and saved in multipart/signed format.  The text of the message will be readable without PGP.\\ 
     331    encrypt: The message will be encrypted using the recipient's PGP key and saved in multipart/encrypted format.\\ 
     332    sign and encrypt: This is a combination of the two previous options, allowing the recipient to check the sender's identity.\\ 
     333    send anonymously: The mail will be sent using an ANON service, so the sender will stay anonymous.\\ 
     334    default: The mail will use whatever security measures have been selected for this recipient in the address book, or "none" if this recipient cannot be found there.\\ 
     335 
     336Further information about PGP and security issues can be found in the 
     337[[pgp| PGP ]] and [[co09| Configuration/Security ]] chapters. 
     338 
     339== Write window – Glossary == 
     340 
     341YAM's Glossary acts as a place to collect blocks of text which you 
     342may use fairly frequently, such as templates for letters, greeting 
     343phrases or frequently asked questions.  The text can be as long as 
     344desired, extending over several lines.  Using the '''Edit/Glossary''' menu 
     345item or the <RAmiga-D> shortcut you can go straight from the 
     346[[#FixEdit| internal editor ]] into the glossary.  Each entry has a name (e.g. "ys" 
     347for "Yours sincerely") which you can see in the left-hand part of the 
     348window.  Click on the name and you can edit the entry in the right-hand 
     349side of the window.  A double click on the name pastes the text block at 
     350the current cursor position and then closes the window. 
     351 
     352 
     353=== Function of the buttons === 
     354 
     355'''New''' 
     356     Creates a new entry in the glossary. 
     357 
     358 
     359'''Add selection''' 
     360     Creates a new entry in the glossary using the block marked in the 
     361     text editor.  If no block is currently marked, YAM will try to 
     362     paste the contents of the clipboard. 
     363 
     364 
     365'''Delete''' 
     366     Deletes the selected entry from the glossary. 
     367 
     368 
     369'''Paste''' 
     370     Pastes the highlighted entry into the text editor, at the current 
     371     cursor position.