Updated with regard to Sylpheed 3.0.1.

5 files changed, 128 insertions, 38 deletions

diff --git a/faq/en/ChangeLog b/faq/en/ChangeLog
index a366d1a..02fd148 100644
--- a/faq/en/ChangeLog
+++ b/faq/en/ChangeLog
@@ -1,3 +1,10 @@
+2010-03-22  Petr Kovar  <pknbe@volny.cz>
+
+	* faq.xml: Updated with regard to Sylpheed 3.0.1.
+	* faq_001.xml: Ditto.
+	* faq_002.xml: Ditto.
+	* faq_003.xml: Ditto.
+
 2009-10-02  Petr Kovar  <pknbe@volny.cz>
 
 	* NEWS: Add the file & prepare for the FAQ_EN_2_0 release.
diff --git a/faq/en/faq.xml b/faq/en/faq.xml
index 47bdc88..141bbeb 100644
--- a/faq/en/faq.xml
+++ b/faq/en/faq.xml
@@ -12,7 +12,7 @@
       <para>This document contains answers to various questions, which are frequently asked by Sylpheed users. It consists of three sections providing general information, information on Sylpheed installation and configuration, and on Sylpheed interface.</para>
     </abstract>
     <copyright>
-      <year>2009</year>
+      <year>2010</year>
       <holder>The Sylpheed Documentation Project.</holder>
     </copyright>
     <legalnotice>
@@ -64,8 +64,8 @@
           <email>pknbe at volny.cz</email>
         </address>
       </affiliation -->    </author>
-    <revhistory>
-<!-- ******************************************************************************** -->      <revision>
+    <revhistory><!-- ******************************************************************************** -->
+      <revision>
         <revnumber>1.9</revnumber>
         <date>2005/07/08</date>
         <authorinitials>OD</authorinitials>
@@ -77,6 +77,12 @@
         <authorinitials>PK</authorinitials>
         <revremark>Finished porting to DocBook XML, updated many questions across the document to conform with Sylpheed 2.7.1.</revremark>
       </revision>
-<!-- ******************************************************************************** -->    </revhistory>
+      <revision>
+        <revnumber>2.1</revnumber>
+        <date>2010/03/22</date>
+        <authorinitials>PK</authorinitials>
+        <revremark>Updated with regard to Sylpheed 3.0.1.</revremark>
+      </revision>
+    <!-- ******************************************************************************** --></revhistory>
   </bookinfo>
 &__faq__001;&__faq__002;&__faq__003;&__license;</book>
diff --git a/faq/en/faq_001.xml b/faq/en/faq_001.xml
index f5d86fe..29e808c 100644
--- a/faq/en/faq_001.xml
+++ b/faq/en/faq_001.xml
@@ -1,18 +1,7 @@
 <?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-faq-1">
   <title>Sylpheed FAQ - General Information</title>
-  <qandaset id="faq-general">
-<?dbhtml cellspacing="13px" ?><!--   
-   <qandaentry>
-    <question id="">
-      <para>
-      </para>
-    </question>
-    <answer>
-      <para>
-      </para>
-    </answer>
-  </qandaentry>
--->    <qandaentry>
+  <qandaset id="faq-general"><?dbhtml cellspacing="13px" ?>
+    <qandaentry>
       <question id="faq-languages">
         <para>
         Are there FAQ&apos;s in other languages?
@@ -72,7 +61,7 @@
             <para>Abundant features</para>
           </listitem>
         </itemizedlist>
-        <para>As the Sylpheed README file reads: The appearance and interface are similar to some popular e-mail clients for
+        <para>As the Sylpheed <filename>README</filename> file reads: The appearance and interface are similar to some popular e-mail clients for
 Windows, such as Outlook Express or Becky!. Many commands are accessible with
 the keyboard like the Emacs-based mailers such as Mew and Wanderlust.
 So you will be able to migrate to Sylpheed without much discomfort, even if
@@ -367,7 +356,7 @@ reporting bugs.</para>
         <para>You need to copy the <filename>sylpheed-2.0</filename> directory with your user profile, and your entire local mail archive. </para>
         <para>Under UNIX, the user profile is stored in <filename>$HOME/.sylpheed-2.0</filename> by default, and your local mail archive is by default located in <filename>$HOME/Mail</filename>. </para>
         <para>While under Windows 2000/XP, the user profile is stored in <filename>C:\Documents and Settings\<replaceable>(user name)</replaceable>\Application Data\Sylpheed</filename> by default, and your local mail archive is by default located in <filename>C:\Documents and Settings\<replaceable>(user name)</replaceable>\Application Data\Sylpheed\Mailboxes\Mail</filename>. </para>
-        <para>Under Windows Vista, the directory paths are <filename>C:\Users\<replaceable>(user name)</replaceable>\AppData\Sylpheed</filename>, and <filename>C:\Users\<replaceable>(user name)</replaceable>\AppData\Sylpheed\Mailboxes\Mail</filename>, respectively.</para>
+        <para>Under Windows Vista/Seven, the directory paths are <filename>C:\Users\<replaceable>(user name)</replaceable>\AppData\Roaming\Sylpheed</filename>, and <filename>C:\Users\<replaceable>(user name)</replaceable>\AppData\Roaming\Sylpheed\Mailboxes\Mail</filename>, respectively.</para>
       </answer>
     </qandaentry>
     <qandaentry>
@@ -508,6 +497,18 @@ sylpheedmail/.
       </answer>
     </qandaentry>
     <qandaentry>
+      <question>
+        <para>Are there any plug-ins extending standard Sylpheed functionality?</para>
+      </question>
+      <answer>
+        <para>Not yet, but they are planned, since Sylpheed 3.0, released in early 2010, and later supports a plug-in interface. In the future, some of the Sylpheed features  will be re-implemented as plug-ins, and, moreover, various other plug-ins will be released.</para>
+        <para>There is a page on the Sylpheed website dedicated to the <ulink url="http://sylpheed.sraoss.jp/en/plugin.html">plug-in interface</ulink>. Additionally,  the <filename>PLUGIN.txt</filename> file distributed directly with Sylpheed can provide you with some basic information on the topic.</para>
+        <note>
+          <para>If you are a developer interested in creating plug-ins for Sylpheed, see the <ulink url="http://sylpheed.sraoss.jp/wiki/index.php?PluginSpec">plug-in specification</ulink> on the Sylpheed wiki.</para>
+        </note>
+      </answer>
+    </qandaentry>
+    <qandaentry>
       <question id="faq-faq-sylpheed">
         <para>Where can I find the latest Sylpheed FAQ and manual?
       </para>
@@ -560,4 +561,4 @@ Frank    Weng          fweng at users.sourceforge.net</programlisting>
       </answer>
     </qandaentry>
   </qandaset>
-</chapter>
\ No newline at end of file
+</chapter>
diff --git a/faq/en/faq_002.xml b/faq/en/faq_002.xml
index 3e4ddc9..217ccc8 100644
--- a/faq/en/faq_002.xml
+++ b/faq/en/faq_002.xml
@@ -1,10 +1,9 @@
 <?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-faq-2">
   <title>Sylpheed FAQ - Installation and Configuration</title>
-  <qandaset id="faq-installation">
-<?dbhtml cellspacing="13px" ?>    <qandaentry>
+  <qandaset id="faq-installation"><?dbhtml cellspacing="13px" ?>
+    <qandaentry>
       <question>
-        <para>What does it take to compile Sylpheed?
-</para>
+        <para>What does it take to compile Sylpheed?</para>
       </question>
       <answer>
         <para>Any POSIX compliant UNIX or similar OS, e.g. Linux,
@@ -32,6 +31,9 @@ Sylpheed.</para>
             <para>GtkSpell for a spell checking feature</para>
           </listitem>
           <listitem>
+            <para>cURL for allowing Sylpheed to check for updates</para>
+          </listitem>
+          <listitem>
             <para>JPilot</para>
           </listitem>
           <listitem>
@@ -65,6 +67,7 @@ name.</para>
           <para>When Sylpheed is executed for the first time, it automatically creates the configuration files under <filename>$HOME/.sylpheed-2.0/</filename> (or <filename>%APPDATA%\Sylpheed\</filename> under Windows), and asks you the location of mailbox. As stated above, the default is <filename>$HOME/Mail</filename>, or <filename>%APPDATA%\Sylpheed\Mailboxes\Mail</filename> under Windows. If some files, which are non-MH format, already exist on the directory, you will have to specify another location.
 </para>
         </note>
+        <para>Furthermore, you need to <link linkend="faq-account-setup">create at least one account</link> to be able to receive or send messages.</para>
       </answer>
     </qandaentry>
     <qandaentry>
@@ -82,14 +85,23 @@ directory or use another name for the Sylpheed mail directory.
       </answer>
     </qandaentry>
     <qandaentry>
-      <question>
+      <question id="faq-account-setup">
         <para>How do I set up an account?
 </para>
       </question>
       <answer>
         <para>After loading Sylpheed for the first time, you can
-add an email account by clicking the <guimenu>Configuration</guimenu> menu. Select the option <guimenuitem>Create new account</guimenuitem> and fill in the appropriate fields.
-</para>
+add an email account by clicking the <guimenu>Configuration</guimenu> menu. Select the option <guimenuitem>Create new account</guimenuitem> and let the configuration assistant help you with the initial setup.
+In a few easy steps, the assistant allows you to conveniently configure your  POP3, IMAP4, or Gmail account.</para>
+        <tip>
+          <para>If you want later to change your account configuration, just select  <menuchoice>
+              <guimenuitem>Configuration</guimenuitem>
+              <guimenuitem>Preferences for current account...</guimenuitem>
+            </menuchoice>, or <menuchoice>
+              <guimenuitem>Configuration</guimenuitem>
+              <guimenuitem>Edit accounts...</guimenuitem>
+            </menuchoice></para>
+        </tip>
       </answer>
     </qandaentry>
     <qandaentry>
@@ -108,9 +120,10 @@ your computer stops responding.
         <para>Can I set up an account for sending mail only?</para>
       </question>
       <answer>
-        <para>Yes, set up a new account using <menuchoice>
+        <para>Yes, add a new account using <menuchoice>
             <guimenuitem>Configuration</guimenuitem>
-            <guimenuitem>Create new Account...</guimenuitem>
+            <guimenuitem>Edit accounts...</guimenuitem>
+            <guibutton>Add</guibutton>
           </menuchoice>  and set the Protocol to None (local).</para>
       </answer>
     </qandaentry>
@@ -283,6 +296,53 @@ When that completes successfully, there is a <guimenuitem>Privacy</guimenuitem>
     </qandaentry>
     <qandaentry>
       <question>
+        <para>How Sylpheed checks for new mail?</para>
+      </question>
+      <answer>
+        <para>New mail can be retrieved either manually or automatically.</para>
+        <para>To check for new mail the manual way, you can:</para>
+        <orderedlist>
+          <listitem>
+            <para>Either press the <guibutton>Get </guibutton>button on the toolbar to incorporate new mail  for the current account only, or use the <guibutton>Get all</guibutton> button to incorporate new mail for all configured accounts.</para>
+          </listitem>
+          <listitem>
+            <para>Or choose <menuchoice>
+                <guimenu>File</guimenu>
+                <guimenuitem>Mailbox</guimenuitem>
+                <guimenuitem>Check for new messages</guimenuitem>
+              </menuchoice>, or <guimenuitem>Check for new messages in all mailboxes</guimenuitem>.</para>
+          </listitem>
+          <listitem>
+            <para>Or select <menuchoice>
+                <guimenu>Message</guimenu>
+                <guimenuitem>Receive</guimenuitem>
+                <guimenuitem>Get from current account</guimenuitem>
+              </menuchoice>, or <guimenuitem>Get from all accounts</guimenuitem>.</para>
+          </listitem>
+        </orderedlist>
+        <tip>
+          <para>If you have a POP3 account and  don&apos;t want to retrieve all the new messages stored on  remote server to your computer, you can manage your account remotely (e.g. open or delete individual messages) by choosing <menuchoice>
+              <guimenu>Message</guimenu>
+              <guimenuitem>Receive</guimenuitem>
+              <guimenuitem>Remote mailbox...</guimenuitem>
+            </menuchoice></para>
+        </tip>
+        <para>If you prefer autochecking for new mail instead, first of all, make sure that you have checked <menuchoice>
+            <guimenu>Configuration</guimenu>
+            <guimenuitem>Common preferences...</guimenuitem>
+            <guimenuitem>Receive</guimenuitem>
+            <guilabel>Autocheck new mail every <replaceable>10</replaceable> minute(s)</guilabel>
+          </menuchoice>. Optionally, you can adjust the interval value (in minutes) as well.</para>
+        <para>Also check your settings under <menuchoice>
+            <guimenu>Configuration</guimenu>
+            <guimenuitem>Edit accounts...</guimenuitem>
+          </menuchoice> You will find this
+at the top:  <guilabel>Check the boxes on the &apos;G&apos; column to enable message retrieval by &apos;Get all&apos;</guilabel>. The setting applies on both manual  and automatic
+mail checks.</para>
+      </answer>
+    </qandaentry>
+    <qandaentry>
+      <question>
         <para>How can I make Sylpheed notify me when new mail arrives?
 </para>
       </question>
@@ -544,8 +604,8 @@ location (<filename>%APPDATA%\Sylpheed</filename>) by default:</para>
 <filename>C:\Documents and Settings\<replaceable>(user name)</replaceable>\Application Data\Sylpheed</filename></para>
             </listitem>
             <listitem>
-              <para>Windows Vista:
-<filename>C:\Users\<replaceable>(user name)</replaceable>\AppData\Sylpheed</filename></para>
+              <para>Windows Vista/Seven:
+<filename>C:\Users\<replaceable>(user name)</replaceable>\AppData\Roaming\Sylpheed</filename></para>
             </listitem>
           </itemizedlist></para>
         <para>If you want to change the location of the configuration files, you can
@@ -582,4 +642,4 @@ path from the folder in which <filename>sylpheed.exe</filename> is located, or a
       </answer>
     </qandaentry>
   </qandaset>
-</chapter>
\ No newline at end of file
+</chapter>
diff --git a/faq/en/faq_003.xml b/faq/en/faq_003.xml
index f5d4fb3..f9fd82d 100644
--- a/faq/en/faq_003.xml
+++ b/faq/en/faq_003.xml
@@ -1,10 +1,9 @@
 <?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-faq-3">
   <title>Sylpheed FAQ - Interface</title>
-  <qandaset id="faq-interface">
-<?dbhtml cellspacing="13px" ?>    <qandaentry>
+  <qandaset id="faq-interface"><?dbhtml cellspacing="13px" ?>
+    <qandaentry>
       <question>
-        <para>How do I make Sylpheed display my language?
-</para>
+        <para>How do I make Sylpheed display my language?</para>
       </question>
       <answer>
         <para>You have to set some environment variables, such as
@@ -43,6 +42,23 @@
     </qandaentry>
     <qandaentry>
       <question>
+        <para>How do I disable or enable the alternating row colors in the message list?</para>
+      </question>
+      <answer>
+        <para>Under  UNIX, you can directly edit the appropriate hidden setting stored in the <filename>$HOME/.sylpheed-2.0/sylpheedrc</filename> configuration file by changing the setting value to 0, or 1, respectively (default is on, i.e. 1): </para>
+        <programlisting>enable_rules_hint=0</programlisting>
+        <tip>
+          <para>There are various other hidden settings that can be adjusted in your <filename>sylpheedrc</filename> configuration file, see the <filename>README</filename> file for details.</para>
+        </tip>
+        <para>The above does not work under Windows, however, so you have to edit the <filename>C:\Program Files\Sylpheed\share\themes\MS-Windows\gtk-2.0\gtkrc</filename> file and set the following setting to 1, or 0, respectively (default is off under Windows, i.e. 0):</para>
+        <programlisting>GtkTreeView::allow-rules = 1</programlisting>
+        <note>
+          <para>Since the hidden setting  described above is not stored within your user profile under Windows, it may be overwritten when installing a new version of Sylpheed. To avoid this at least partially, keep a backup copy of the <filename>gtkrc</filename> file somewhere safe.</para>
+        </note>
+      </answer>
+    </qandaentry>
+    <qandaentry>
+      <question>
         <para>Can I use a different editor to write my mails?
 </para>
       </question>
@@ -102,7 +118,7 @@ widget_class &quot;*&quot; style &quot;default&quot;
 </para>
       </question>
       <answer>
-        <para>Unlike Sylpheed 1.x,  Sylpheed 2.x doesn&apos;t allow direct modification of the menu shortcuts by default. Nevertheless, you can use the following methods to configure them:</para>
+        <para>Unlike Sylpheed 1.x,  Sylpheed 2.x and 3.x doesn&apos;t allow direct modification of the menu shortcuts by default. Nevertheless, you can use the following methods to configure them:</para>
         <orderedlist>
           <listitem>
             <para><emphasis>Using GNOME 2.8 or later:</emphasis> run gconf-editor from <menuchoice>
@@ -283,4 +299,4 @@ parameter. Example: <command>gedit &apos;%s&apos;</command>
       </answer>
     </qandaentry>
   </qandaset>
-</chapter>
\ No newline at end of file
+</chapter>