From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004
From: "Elmo Developers" <elmo-devel@lists.sourceforge.net>
Subject: Before you start
Message-Id: <before>

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).


From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004
From: "Elmo Developers" <elmo-devel@lists.sourceforge.net>
Subject: 1. Basic layout
Message-Id: <chapter1>

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)   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 and its number.  Window
description is followed by author and title of this message.

If you quit this window it should look like:

 (folder/1)   tutorial [msgs:   10  new: 10]


From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004
From: "Elmo Developers" <elmo-devel@lists.sourceforge.net>
Subject: 1.1. Windows
Message-Id: <chapter1.1>
In-Reply-To: <chapter1>

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 with a digit - number of desired window.  You can
also switch to the next window pressing <tab>.

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-2' or <tab>.

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" <elmo-devel@lists.sourceforge.net>
Subject: 1.2. Mailreader
Message-Id: <chapter1.2>
In-Reply-To: <chapter1>
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 "<mail content>", 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.  Attachments window will be closed, and
you will see an error message saying that there is no handler defined
for image/png.  This is 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".

--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" <elmo-devel@lists.sourceforge.net>
Subject: 1.3. Command line
Message-Id: <chapter1.3>
In-Reply-To: <chapter1>

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.
<enter>        Accept the string as it appears in command line.
\C-a, <home>   Move cursor to the beginning of the string.
\C-e, <end>    Move cursor to the end of the string.
\C-b, <left>   Move cursor one character left.
\C-f, <right>  Move cursor one character right.
\M-b           Move cursor left over the word.
\M-f           Move cursor right over the word.
\C-d, <delete> Delete the character at point.
<backspace>    Delete the character behind the cursor.
\M-d           Delete the word after the point.
\M-<backspace> Delete the word behind the cursor.
\C-k           Kill the text from point to the end of the line.
<tab>          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 <tab> again elmo will show
you all possibilities found right above the status bar.  First item
should be hilighted.  You can select an item with <up>, and <down>
arrows, and accept your selection with <enter>, 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" <elmo-devel@lists.sourceforge.net>
Subject: 1.4. Folder
Message-Id: <chapter1.4>
In-Reply-To: <chapter1>

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 indicator whether the
message came with attachments - there is a plus sign in such a case.
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 <delete> 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" <elmo-devel@lists.sourceforge.net>
Subject: 1.5. Box selection
Message-Id: <chapter1.5>
In-Reply-To: <chapter1>

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.

To open the selected box press enter.


From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004
From: "Elmo Developers" <elmo-devel@lists.sourceforge.net>
Subject: 1.6. Addressbook
Message-Id: <chapter1.6>
In-Reply-To: <chapter1>

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 <enter>.

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" <elmo-devel@lists.sourceforge.net>
Subject: 2. Composing and sending mail
Message-Id: <chapter2>

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" <elmo-devel@lists.sourceforge.net>
Subject: 2.1. New mail
Message-Id: <chapter2.1>
In-Reply-To: <chapter2>

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 <mail content>.  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" <elmo-devel@lists.sourceforge.net>
Subject: 2.2. Replying, and forwarding
Message-Id: <chapter2.2>
In-Reply-To: <chapter2>

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" <elmo-devel@lists.sourceforge.net>
Subject: 3. Fetching messages
Message-Id: <chapter3>

Fetching messages is under heavy development.


From elmo-devel@lists.sourceforge.net Mon Jan 12 19:25:00 2004
From: "Elmo Developers" <elmo-devel@lists.sourceforge.net>
Subject: 4. Addressbook
Message-Id: <chapter4>

