manual/starting.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <section id="ch_starting">
   3 <title>Getting started with Claws Mail</title>
   4
   5   <section id="start_wizard">
   6     <title>The initial wizard</title>
   7     <para>
   8         The first time that you start Claws Mail, you will be asked a few
   9         questions in order to set up an account. These questions are easy to
  10         answer and grouped in several short pages.
  11     </para><para>
  12         First you will be asked to fill in your name, (<emphasis>usually
  13         guessed from the operating system</emphasis>), your email address, and
  14         the name of your organisation, (<emphasis>optional</emphasis>).
  15     </para><para>
  16         The following page will allow you to enter details of how to retrieve
  17         your mail. The format of the page will be determined by the
  18         <quote>Server type</quote>:
  19     </para>
  20     <blockquote>
  21       <variablelist>
  22         <varlistentry>
  23           <term>POP3</term>
  24           <listitem>
  25             <para>
  26         If you choose POP3, you will need to enter the server address,
  27         username, and password. The password is optional, if you don't provide
  28         it here then you will be prompted for it each time it is needed.
  29             </para>
  30           </listitem>
  31         </varlistentry>
  32         <varlistentry>
  33           <term>IMAP</term>
  34           <listitem>
  35             <para>
  36         If you choose IMAP, you will need to enter the server address,
  37         username, password, and IMAP server directory. The password is
  38         optional, if you don't provide it here then you will be prompted for it
  39         each time it is needed. The IMAP server directory is also optional,
  40         often it is not needed and can be left empty.
  41             </para>
  42           </listitem>
  43         </varlistentry>
  44         <varlistentry>
  45           <term>Local mbox file</term>
  46           <listitem>
  47             <para>
  48         If you choose Local mbox file, you will need to enter the location of
  49         your local mailbox spool file. This location depends on your Operating
  50         System, but values like <filename>/var/mail/username</filename> or
  51         <filename>/var/spool/mail/username</filename> are common, where
  52         <literal>username</literal> is your system login.
  53             </para>
  54           </listitem>
  55         </varlistentry>
  56       </variablelist>
  57     </blockquote>
  58     <para>
  59         <title>Automatic configuration</title>
  60                 When you click the 'Auto-configure' button, Claws Mail will attempt to
  61                 configure your account's servers based on your email address and the type
  62                 of account you have chosen.
  63     </para>
  64     <para>
  65         On the next page you will enter the address of your SMTP server,
  66         (<emphasis>sometimes referred to as
  67         <quote>Outgoing server</quote></emphasis>). You will also be asked
  68         whether to authenticate when sending mail; this is often not the case
  69         if you're using an ISP to connect to Internet, and often the case if
  70         you are configuring a professional account.
  71     </para><para>
  72         If you chose either POP3 or Local mbox file, the next page  will ask
  73         you where you want to save your mail on disk. The default,
  74         <quote>Mail</quote>, is usually ok and will save your mails in a
  75         directory called <filename>Mail</filename> in your home directory.
  76     </para><para>
  77         If Claws Mail is built with support for OpenSSL, you will next see
  78         the <quote>Security</quote> page, here you will be able to choose to
  79         use SSL encryption to send and receive your emails. Most ISPs do not
  80         enable this, but many companies do; if you're unsure about it, you can
  81         leave them unselected.
  82     </para><para>
  83         You can now click on the Save button, and start enjoying Claws Mail.
  84     </para>
  85   </section>
  86
  87   <section id="start_getting">
  88     <title>Getting mail</title>
  89     <para>
  90         Retrieving your email can be done from the toolbar button named
  91         <quote>Get mail</quote> or from the <quote>Receive</quote> submenu of
  92         the <quote>Message</quote> menu.
  93     </para><para>
  94         If you want Claws Mail to check your mail automatically at regular
  95         intervals, you can ask it to do so from the
  96         <quote>Mail handling: Receiving</quote> preference page which you'll
  97         find in the <quote>Configuration/Preferences...</quote> menu. Just
  98         click the
  99         <quote>Automatically check new mail every [...] minute(s)</quote>
 100         checkbox, and set the interval to your liking.
 101     </para>
 102   </section>
 103
 104   <section id="start_reading">
 105     <title>Reading your mail</title>
 106     <para>
 107         Once you have retrieved your emails, the Inbox folder will contain
 108         them. The total number of emails in a folder is shown at the right of
 109         the folder's name, along with the number of unread and new emails in
 110         it. To see them, click on the folder row in the folder list, and the
 111         list of emails in that folder will be displayed in the Message List
 112         pane. You can then select an email using the mouse, or by using the Up
 113         and Down keys to navigate through the list, and the Space bar to
 114         display and scroll emails. You can use other keys to navigate through
 115         emails, like P and N (previous and next).
 116     </para>
 117   </section>
 118
 119   <section id="start_writing">
 120     <title>Writing your first mail</title>
 121     <para>
 122         When clicking on the <quote>Compose</quote> button of the toolbar, a
 123         composition window will open. This window contains different fields
 124         which you should be able to recognise easily: if you have multiple
 125         accounts, the From field can be used to select which account you want
 126         to use for this email; the To field is for recipient of the email. When
 127         you fill it in, a second To field will appear, so that you can send the
 128         email to multiple recipients. You can also change the To field to a Cc
 129         field or other types of fields, by using its dropdown menu, or by
 130         typing in the field that you require. After that, you will be able to
 131         set the subject of your email, then type its body.
 132     </para><para>
 133         A little note about an email's subject: Claws Mail will ask you for
 134         confirmation if you attempt to send an email with an empty subject.
 135         This is because it can be annoying for the recipient to receive emails
 136         without a subject, as it doesn't help in handling email.
 137     </para>
 138   </section>
 139
 140   <section id="start_sending">
 141     <title>Sending your first mail</title>
 142     <para>
 143         When you have finished writing your first email, you can either click
 144         the <quote>Send</quote> button to send your email immediately, or use
 145         the <quote>Send later</quote> button to queue the message for later
 146         sending. When using <quote>Send</quote>, the composition window will
 147         close itself when the mail has been sent; it will stay open if there is
 148         an error. When using <quote>Send later</quote>, the composition window
 149         will immediately close, and your email will be stored in your Queue
 150         folder. It will then be sent when you click the <quote>Send</quote>
 151         button in the main window's toolbar.
 152     </para><para>
 153         The emails that you send are saved in the Sent folder of your mailbox,
 154         so that you can recall what you wrote to whom, or use an already sent
 155         email as a template to write another.
 156     </para>
 157   </section>
 158 </section>
 159