<p>Mail is Haiku's default viewer and editor of emails. It has nothing to do with the actual fetching and sending of mails, which is done by the mail_daemon and can be configured via the <ahref="../preferences/e-mail.html">E-mail</a> preferences.</p>
<p>This page is a general overview of the application Mail. For more information how email in Haiku works, refer to the <ahref="../workshop-email.html">Workshop on managing email</a>.</p>
<p>A menu and optional tool bar on top, with an area of the interesting attributes of a mail (to, from, subject, date) below that, and then the actual body of the mail. If the mail appears with strange characters or empty, try to change the <spanclass="menu">Decoding</span> from the pop-up menu.</p>
<p>If there are files attached to an email, they are listed at the end of the message. A right-click on one opens a context menu to <spanclass="menu">Save attachment...</span> or <spanclass="menu">Open attachment</span>. You can also drag & drop directly to the Desktop or another Tracker window.</p>
<p>Most of the menu and tool bar items are pretty self-explaining, so we'll concentrate just on the highlights.</p>
<p>When you close the window of a new mail, its status is normally switched from "New" to "Read". But you can set other statuses as well, by choosing from the <spanclass="menu">Close and...</span> submenu. There you'll also find the option <spanclass="menu">Set to...</span> to create your own custom statuses, which are saved under <spanclass="path">~/config/settings/Mail/status/</span>.</p>
<p>Here you'll find an item to open Mail's <spanclass="menu">Preferences...</span> (<ahref="#preferences">see below</a>) and a shortcut to manage your <spanclass="menu">Accounts...</span>, which will open the <ahref="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<tr><td><spanclass="menu">Show header</span></td><tdclass="onelinetop"><spanclass="key">ALT</span><spanclass="key">H</span></td><tdstyle="width:10px;"></td><td>Shows the complete header of a mail, in case you need to track down the path of your mail, for example.</td></tr>
<tr><tdclass="onelinetop"><spanclass="menu">Show raw message</span></td><td></td><td></td><td>Displays a mail in its raw state, i.e. with all its control characters and without Mail's coloring of quotes or URLs, for example..</td></tr>
<tr><td><spanclass="menu">Reply</span></td><td><spanclass="key">ALT</span><spanclass="key">R</span></td><tdstyle="width:10px;"></td><td>The standard reply to the server that has sent the mail to you. NOTE: In case of a mailing list post, this normally replies back to the mailing list, <i>not</i> just the person that wrote the post!</td></tr>
<tr><tdclass="onelinetop"><spanclass="menu">Reply to sender</span></td><td><spanclass="key">OPT</span><spanclass="key">ALT</span><spanclass="key">R</span></td><td></td><td>This on the other hand, sends directly and only to the person listed in the "From" attribute.</td></tr>
<tr><td><spanclass="menu">Reply to all</span></td><tdclass="onelinetop"><spanclass="key">SHIFT</span><spanclass="key">ALT</span><spanclass="key">R</span></td><td></td><td>Replies to the original sender plus all other (cc'ed) recipients of the original mail.</td></tr>
</table>
<divclass="box-info">If you mark a passage in the email before replying to it, only the marked text will be quoted in your answering mail. A nice way to cut down on excessive quoting, which is frowned upon by pretty much everybody...</div>
<p>The items to <spanclass="menu">Forward</span>, <spanclass="menu">Resend</span> and <spanclass="menu">Copy to new</span> are again pretty self-explaining.</p>
<p>When you've opened an email from a Tracker or query result window, <spanclass="menu">Previous message</span> and <spanclass="menu">Next message</span> will move to the previous/next email in the list.</p>
<p><spanclass="menu">Save address</span> collects all email addresses from the header and the actual email body in a submenu. Choosing an address will open the <ahref="people.html">People</a> application in order to complete and save the contact information.</p>
<p>This doesn't work yet, but is intended to hold queries that would show all mail related to the currently open mail, like all from the same sender or same subject/thread.</p>
<aid="creating"name="creating">Creating new messages</a></h2>
<p>A new email is created by invoking the <spanclass="menu">New mail message</span> menu or the corresponding icon from the tool bar of an open email. Or you just start the Mail application or choose <spanclass="menu">Create new message...</span> from the context menu of the mailbox icon in the Deskbar.</p>
<p>The window is pretty similar to the one when reading mails. The menu and tool bar items are slightly different and the text boxes have to be filled with the recipient's email address, subject and so on, of course.</p>
<p><spanclass="menu">Cc</span> is short for the anachronistic term "<i>carbon copy</i>" and results in copies of your mail being sent to the listed people. The difference to just listing a buch of addresses in the "To" field is, that you don't directly address the cc'ed people, thereby signaling that you probably don't expect an answer of them.<br/>
<spanclass="menu">Bcc</span> means "<i>blind carbon copy</i>" which does practically the same as "Cc", but hides the recipients from each other.</p>
<p>You can enter several recipients by separating their addresses with a comma.
<spanclass="menu">To</span>, <spanclass="menu">CC</span>, and <spanclass="menu">BCC</span> are pop-up menus. They contain all email addresses on your system found by a query for <ahref="people.html">People</a> files. Their "Group" attribute will sort them in corresponding submenus.</p>
<p>Again, we'll focus on the more interesting features in the menus.</p>
<p>With <spanclass="menu">Save as draft</span> you can store your work so far and come back to it later. To load it again, choose it from the <spanclass="menu">Open draft</span> submenu that will list the result of a query for all mails with the status "Draft".</p>
<p><spanclass="menu">Quote</span> and <spanclass="menu">Remove quote</span> or their respective shortcuts <spanclass="key">ALT</span><spanclass="key">←</span> / <spanclass="key">→</span> are used to add/remove a level of quoting by adjusting the number of ">" symbols in front of quoted lines. Just select some text in all the lines you want un/quoted and invoke the menu item.</p>
<p><spanclass="menu">Check spelling</span> currently only offers corrections of English texts by marking wrong or unknown words red and showing them in italic.
Right-clicking such a word opens a context menu offering suggestions to correct the word or to <spanclass="menu">Add</span> it to the accepted vocabulary.</p>
<p>Then, there are again the items to open Mail's <spanclass="menu">Preferences...</span> (<ahref="#preferences">see below</a>) and a shortcut to managing your <spanclass="menu">Accounts...</span>, which will open the <ahref="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<p>With <spanclass="menu">Add signature</span> you can add predefined texts to the end of your mail. From its submenu you can choose a specific or <spanclass="menu">Random</span> one.</p>
<p>You create new or edit existing signatures with <spanclass="menu">Edit signatures...</span>, which will open a window where you enter the text itself and the title of your new sig. There, in the <spanclass="menu">Signature</span> menu, you find items to <spanclass="menu">Open</span> a specific signature or <spanclass="menu">Save</span> or <spanclass="menu">Delete</span> the currently loaded one, Signatures should be saved in <spanclass="path">~/config/settings/Mail/signatures</span>.</p>
<p>Use <spanclass="menu">Add enclosure...</span> and <spanclass="menu">Remove enclosure</span> to add/remove files as attachments. You can also drag & drop files from a Tracker window. Be careful though to drop those in the header section (To/From/Subject area at the top) or they'll get pasted into the email body if they are text files.</p>
<p>File attachments are listed below the header section. You can remove a file by invoking a context menu or by selecting it and pressing <spanclass="key">DEL</span>.</p>
<p>This doesn't work yet, but is intended to hold queries that would show all mail related to the currently open mail, like all to the same recipient or same subject/thread.</p>
<tr><td><spanclass="menu">Button bar</span></td><tdstyle="width:10px;"></td><td>Options to show labels under the icons or hide the tool bar completely.</td></tr>
<tr><td><spanclass="menu">Font</span></td><td></td><td>Sets the type of font used for the email text.</td></tr>
<tr><td><spanclass="menu">Size</span></td><td></td><td>Sets the font size.</td></tr>
<tr><td><spanclass="menu">Colored quotes</span></td><td></td><td>Colors different levels of quotation.</td></tr>
<tr><tdclass="onelinetop"><spanclass="menu">Initial spell check mode</span></td><td></td><td>Turns the spell checker on/off on startup.</td></tr>
<tr><tdclass="onelinetop"><spanclass="menu">Automatically mark mail as read</span></td><td></td><td>If you close an email with the Status "New", you can have it automatically marked as "Read".</td></tr>
<tr><td><spanclass="menu">Default account</span></td><tdstyle="width:10px;"></td><td>If you have several email accounts, this specifies which to use by default when creating a new message.</td></tr>
<tr><td><spanclass="menu">Reply account</span></td><td></td><td>When you reply to a mail, you can either always <spanclass="menu">Use default account</span> set in the pop-up menu above, or use the <spanclass="menu">Account from mail</span>, which will send the mail from the same account that received the original message.</td></tr>
<tr><td><spanclass="menu">Reply preamble</span></td><td></td><td>This is inserted before the quoted text in your reply. You can use various variables from the pop-up menu next to the text field. Example: "<i>Hello %n!\n\nOn %d you wrote:\n</i>" produces this:
<pre>Hello Dr. Hawking!
On Mon, 18 Jan 1998 02:55:16 +0800 you wrote:
> so thanks again for the inspiration concerning the cosmological constant.
> ...and the rest of the quoted text following...</pre></td></tr>
<tr><td><spanclass="menu">Auto signature</span></td><td></td><td>Adds a signature automatically to the end of the mail.</td></tr>
<tr><td><spanclass="menu">Encoding</span></td><td></td><td>Sets the default encoding.</td></tr>
<tr><tdclass="onelinetop"><spanclass="menu">Warn unencodable</span></td><td></td><td>If your mail contains characters that can't be encoded with the currently set encoding method, you can turn on being warned about that. That gives you the opportunity to change the encoding before sending. Otherwise unencodable characters are replaced by rectangle symbols.</td></tr>
<tr><td><spanclass="menu">Text wrapping</span></td><td></td><td>Inserts line-breaks every 76 characters which makes mails easier to read.</td></tr>
<tr><td><spanclass="menu">Attach attributes</span></td><td></td><td>You can choose to send BFS' attributes of a file alongside the attachments. This is nice for other Haiku users, as they'll get a "complete" file (think artist, album, title attributes of MP3 files), but may cause confusion (or even suspicion) with others, who will wonder what the additional "BeOS Attributes" attachment might be...<br/>
Should you opt not to send attributes with your attachments, remember zip up your files before you send them or you'll strip away BFS attributes.</td></tr>
