From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: Before you start Message-Id: Welcome to Elmo's online tutorial. We hope that it will provide you with all information necessary to use Elmo with joy. If not - please let us know, so we can help you and others facing same problems. You can press 'r' at any time to send us a reply to the chapter you are reading. Each chapter of this tutorial is a separate message in tutorial box. We have made an assumption that you use default configuration, or no configuration at all, so some information may be not true for you if you have already customized Elmo. However there are some chapters of manual where you need some configuration to follow steps described there (e.g. fetching messages requires that you have setup at least one POP3 account). Sometimes there are some examples taken from .elmorc configuration file. These examples are indented, but remember that each command in .elmorc must start at the beginning of line. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1. Basic layout Message-Id: Topbar ------ There is a blue bar at the top of the screen that shows Elmo version, and few most basic key shortcuts in current mode. Right now it should tell you which keys to press if you'd like to close this window, reply to this message, and so on. If you quit this window by pressing 'q', you should see a window with list of messages in this box (chapters of this tutorial). Notice that available keys are different there. Command line ------------ Command line is a most bottom window on the screen. Right now it is black, and displays nothing. Elmo uses this window to get input from you. Status bar ---------- Status bar is a blue window right above the command line. It should display something like: (mail/3) --All-- Elmo Developers 1. Basic layout It means that the active window (mail) is assigned a number 3. You can focus any window by pressing alt key along with its number. Window description is followed by author and title of this message. If you quit this window it should look like: (folder/1) --All-- tutorial [msgs: 14 new: 12] From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1.1. Windows Message-Id: In-Reply-To: As you have already noticed, every window is assigned a number which is shown in the status bar. You can switch to any open window by pressing meta key along with a digit - number of desired window. You can also switch to the next window pressing . You have to be careful. Focusing window that overlaps the window currently being focused may have unexpected results. If you press '\M-2' now the box selection window should appear. Unfortunately it will corrupt the current view. You can get back to this window pressing '\M-3' or . You can have the screen redrawn at any time if you press '\C-l'. It is useful when some other program (e.g. Linux kernel) displays some data on the screen corrupting Elmo windows. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1.2. Mailreader Message-Id: In-Reply-To: Content-Type: multipart/mixed; boundary=alamakota --alamakota Content-Type: text/plain; charset=us-ascii Mailreader window is the one this message is displayed in. You can switch to the message header by pressing 'h'. Pressing 'h' second time will bring you back to this view. Headers are not mime-decoded in header view, and may seem unreadable, but some people find this feature useful. Press 'a' now. The window with list of all MIME parts of this message will appear. As you can see, this message consists of three parts - first two are marked "", and the third has a file name. Please select the second part of the message, and press enter. You will be taken to the continuation of the tutorial. --alamakota Content-Type: text/plain; charset=us-ascii As you can see, pressing enter makes Elmo load selected part of the message to this window. It is very handy, when you get a message with text attachments. You can try to do the same with last part of the message which is an image. Nothing happens because Elmo doesn't know which program do you use for viewing images. You can see the image though. Open attachments window, select "sflogo.png", and press 's'. The file name appears in a command line, because Elmo asks you for a location, where would you like to store this file. Default location is taken from the message. If you press enter, the file will be saved in current directory in file "sflogo.png". It doesn't mean you always have to save an attachment before viewing it. You can specify a program that will open an image for you. I use fbi for viewing images on text terminal, and here is what I have in my .elmorc file: handler image/* "fbi %f" Each time I press enter on an image Elmo runs fbi (which is an image viewer for framebuffer console) giving it a filename as an argument. --alamakota Content-Type: image/png Content-Disposition: attachment; filename="sflogo.png" Content-Transfer-Encoding: base64 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 SUVORK5CYIIyMTA4 --alamakota-- From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1.3. Command line Message-Id: In-Reply-To: In previous chapter, you were explained how to save an attachment to the file. You were prompted to enter a file name. There are few features of command line worth knowing. Command line in Elmo works the same way as in emacs, and key shortcuts are similar. If you don't like emacs - you can customize Elmo shortcuts even for command line. \C-g Abort reading. Usually aborts the action that led to activation of command line. Accept the string as it appears in command line. \C-a, Move cursor to the beginning of the string. \C-e, Move cursor to the end of the string. \C-b, Move cursor one character left. \C-f, Move cursor one character right. \M-b Move cursor left over the word. \M-f Move cursor right over the word. \C-d, Delete the character at point. Delete the character behind the cursor. \M-d Delete the word after the point. \M- Delete the word behind the cursor. \C-k Kill the text from point to the end of the line. Complete. Completing the text ------------------- Completing is as easy as in shell. If there is no ambiguity, Elmo will enter the completion or at least a longest possible prefix. If there are few possibilities of completing the text at the point, then Elmo won't enter anything. If you press again Elmo will show you all possibilities found right above the status bar. First item should be hilighted. You can select an item with , and arrows, and accept your selection with , or abort completion with \C-g. Elmo is able to complete file names, addresses from addressbook, and possible actions. First two are obvious. The third one will be explained later. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1.4. Folder Message-Id: In-Reply-To: Folder window is the one you are shown right after startup. It lists messages from the current mailbox. Besides some obvious information like author and subject, every line contains few columns of characters, that may be hard to understand at the very beginning. First column is used as an attachment indicator, and may contain: + - message has an attachment e - message is encrypted s - message is signed Second column may contain: N - message is new, O - message is old but you haven't read it yet, F - message has been flagged by you. Third column may contain: r - you have replied to this message f - you have forwarded this message Fourth column is a spam indicator, and will be explained later. You may be asking yourself, why would you like to flag a message? Let's first learn how to do it. To flag a message press space. To remove a flag press space again. You can flag all messages by pressing '+', unflag all messages by pressing '-', and reverse flag with '*'. You can also flag messages that are duplicates of other messages by pressing '='. What about flagged messages? There are many actions, that operate on more than one message. If you'd like to delete more than one message, you should first flag them, and then press key. If no message is flagged, then selected message is deleted (or moved to trash if you have one). Same rules apply when you kill messages with pressing 'K' (they are permanently removed, not moved to the trash), or move to other boxes pressing 'M'. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1.5. Searching, and sorting Message-Id: In-Reply-To: Sorting ------- When you start Elmo messages are sorted by date, and grouped in threads. You can change order by pressing these keys (pressing a key twice reverses the order): d - date A - author (from) s - subject Pressing t groups messages in threads without changing the order of parent messages. Searching --------- To find a message simply press \C-s (searching forward), or \C-r (searching backward), and start typing a pattern. The bar will be moving down/up to the next message which subject or author contains the typed string. Press \C-s (or \C-r respectively) to move to the next matching message without typing next letter of pattern. With Elmo you can also search for a pattern with mistakes. If you think, that a message may contain a subject, but are not sure exactly what is inside, you may specify how many mistakes you could make. Just press a digit before pressing \C-s. The digit indicates how many mistakes may the matching string contain. Search works not only in folder with messages, but also in mailreader window, and you may now experiment. Try to search for the word "search", and look how it behaves. You may fall into a trouble if \C-s enters a scroll-lock mode. This is common on text terminals (press \C-q to unlock). There are few ways to work around this problem (till I find an elegant solution). First is to disable "stop" action of the terminal driver. You only need to execute stty stop undef before running elmo. I have put this line to my .bashrc file. You may also define another key (like \C-t) for searching forward by adding something like this to your .elmorc: key \Ct folder folder_search_forward key \Ct abook abook_search_forward key \Ct mail mailreader_search_forward key \Ct search select_search_forward From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1.6. Box selection Message-Id: In-Reply-To: Box selection window displays list of boxes in your mailbox. There are two numbers in parentheses. First one shows the number of messages not read, and second the total number of messages in this box. Tutorial seems to have 0 messages. Elmo doesn't try to count messages in mbox files because it may be time-consuming. You can enable this feature by adding following line to your .elmorc file: set count_mbox yes To open the selected box press enter. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 1.7. Addressbook Message-Id: In-Reply-To: You can open addressbook from folder window pressing 'a'. Right now it is probably empty. You can add a new entry by pressing 'a'. You will be prompted for a name, and email address of the person you want to add. Another possibility of adding new person to your addressbook is to press 'b' in mailreader window. Please press 'b' now. You should see window with "Elmo Developers". You can add this entry to your addressbook simply pressing . Selecting addresses in addressbook works just like in folder window. The only difference is that you can't select duplicate entries. You can compose a new message to selected people by pressing 'm' (composing and sending mails is covered later in this tutorial). Same rules apply to removing entries, changing their flags and so on. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 2. Composing and sending mail Message-Id: Let's learn how to compose a new message. First you have to have at least one SMTP account already configured. If you don't know how to do it, you can use elmoconf.pl script that will do it for you. Right now it is impossible to use sendmail for passing messages, but we are working on it. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 2.1. New mail Message-Id: In-Reply-To: Composing new message is very simple. Press 'm' in folder window. Elmo asks you for recipients, and subject. Press \C-g if you changed your mind, and don't want to send a message. If you wish to supply more than one recipient - separate them with commas. Notice that you can complete an address if it is in your addressbook. After you supply a subject, an editor is opened. Write a message, but please leave an empty line between message header, and message body. It is very important. Close your editor when finished. You will be taken to a sender window. Sender window ------------- Message data is shown at the top. Below are parts of the message. First item is marked as . You can attach a file to the message simply pressing 'a', and supplying a file name. Use delete key to remove unwanted attachments. You can change any data displayed in the upper window. Use following keys: S - change smtp account used to send this message, note that your address is changed along with the server f - change from without altering smtp server r - change reply-to address t - change recipients of the message c - change carbon copy recipients b - change blind carbon copy recipients s - change subject T - change content-type of the selected attachment Press 'y' to send a message or 'q' to cancel. If you press 'y' the message won't be sent actually. It will be moved to a special mailbox 'sent'. If you press 'q' Elmo will ask you if you wish to store this message in 'drafts' folder. You will be able to get back to this message later. Press 'S' key in folder view to flush messages from outbox. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 2.2. Replying, and forwarding Message-Id: In-Reply-To: Press 'r' to reply to a selected message. The only difference between replying, and composing new message is that you don't supply recipients, and subject. Sometimes you want to send a reply not only to the author of the message, but also to other recipients of this message. Press 'R' to do this. Press 'f' to forward a selected message. You will only have to supply recipients. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 3. Fetching messages Message-Id: If you press 'F' key in folder window Elmo will try to connect with your pop3 server, and fetch list of messages. The list itself is very similar to folder view. You may use following keys in this mode: f - fetch a selected message d - delete a selected message r - reset state of the connection (undelete all messages marked for deletion) q - close the connection, and the window Elmo remembers which messages you have already fetched, and you won't be shown them again when you connect later. Messages are fetched to "inbox" folder unless you specify some rules for them. Rules are described in detail in doc/sample.elmorc file. Let's look at the example: rule elmo-users { If SUBJECT includes '[elmo-users]' move the message to elmo. } This rule, when copied to .elmorc, will instruct Elmo to deliver all messages with subject containing [elmo-users] to folder elmo. From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004 From: "Elmo Developers" Subject: 4. GnuPG Message-Id: Content-Type: multipart/signed; boundary=alamapsa --alamapsa Content-Type: text/plain; charset=us-ascii When describing folder view, we have written, that a message may be marked with 'e' (which means that it is encrypted), or with 's' (which means that it is digitally signed). Decrypting messages ------------------- You never have to decrypt an encrypted message. Each time you want to open a decrypted message you will be prompted for a password. If you supply a valid passphrase, the message will be shown. Elmo remembers your password, so you won't be prompted next time for it. You may force Elmo to forget your pass phrase. Just press ':', then type pgp_forget_passphrase, and press enter. Verifying digital signatures ---------------------------- This message has been signed with tutorial's private key. If you haven't imported it yet, then you should see an additional red header saying "PGP: No public key". You can find a public key in doc/tutorial.gpg file. Import it to your keyring (refer to gpg manual), and get back to this message. You should see a green header saying "PGP: ok" instead of a red one. If you cannot see a "PGP" header, then you have probably compiled Elmo without support for encryption. If you compile Elmo from source tarball, then you need headers of library gpgme (on Debian system these headers are in the package libgpgme11-dev). --alamapsa Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (GNU/Linux) iD8DBQBAUIVeu/t155ptteURAjTbAKCjxY3kNfuSzndVYC+mMDOuQ0aV4wCg0eNl fC2DcO1WmY+q+ZMB4sMUed0= =hmG/ -----END PGP SIGNATURE----- --alamapsa--