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