Python 2 EOL: migrate eud2gc.py to Python 3
[claws.git] / manual / faq.xml
index 6dd8950..516b053 100644 (file)
 <?xml version="1.0" encoding="utf-8"?>
 <appendix id="ap_faq">
-<title>The Sylpheed-Claws FAQ</title>
-
-  <section id="faq_general">
-    <title>General information</title>
-
+<title>The Claws Mail FAQ</title>
     <section>
-      <title>What is Sylpheed? What is Sylpheed-Claws?</title>
-      <para>
-         Sylpheed is an e-mail client (and news reader) based on GTK+, running on the X Window System, and aiming for:
-      </para>
-      <itemizedlist>
-        <listitem>
-         <para>
-           Quick response
-         </para>
-       </listitem>
-        <listitem>
-         <para>
-           Graceful, and sophisticated interface
-         </para>
-       </listitem>
-        <listitem>
-         <para>
-           Easy configuration, intuitive operation
-         </para>
-       </listitem>
-        <listitem>
-         <para>
-           Abundant features
-         </para>
-       </listitem>
-      </itemizedlist>
-      <para>
-        Sylpheed-Claws is the extended version of Sylpheed.
-      </para>
-    </section>
-
-    <section>
-      <title>What are the differences between Sylpheed and Sylpheed-Claws?</title>
-      <para>
-        For a list of features, and differences between Sylpheed and Sylpheed-Claws, see <ulink url="http://sylpheed-claws.sourceforge.net/features.php">the online features page</ulink>.
-      </para>
-    </section>
-
-    <section>
-      <title>Where can I get Sylpheed-Claws?</title>
-      <para>
-        See the <ulink url="http://sylpheed-claws.sourceforge.net/downloads.php">Downloads page</ulink>.
-      </para>
-    </section>
-
-    <section>
-      <title>Who writes Sylpheed-Claws?</title>
-      <para>
-        Sylpheed-Claws is developed by the Sylpheed-Claws Team. Sylpheed-Claws is also regularly syncronised with the original version of Sylpheed written by Hiroyuki Yamamoto.
-      </para>
-    </section>
-
-    <section>
-      <title>What does the name Sylpheed mean?</title>
-      <para>
-        It means 'light weight', like air. This comes from the name of the wind spirits, the Sylphs.
-      </para>
-    </section>
-
-    <section>
-      <title>How does Sylpheed-Claws store mails?</title>
-      <para>
-        Mails are stored in the MH mailfile format as used by MH and EMH. Maildir and mbox formats are supported via two plugins available on the <ulink url="http://sylpheed-claws.sourceforge.net/plugins.php">Plugins page</ulink>.
-      </para>
-    </section>
-
-    <section>
-      <title>Does Sylpheed-Claws have mail filtering?</title>
-      <para>
-        Yes. You can find it in <quote>Configuration</quote> menu, <quote>Filtering...</quote> option.
-      </para>
-    </section>
-
-    <section>
-      <title>Can Sylpheed-Claws handle IMAP mail?</title>
-      <para>
-        Yes.
-      </para>
-    </section>
-
-    <section>
-      <title>Can Sylpheed-Claws handle local unix mailboxes?</title>
-      <para>
-        Yes.
-      </para>
-    </section>
-
-    <section>
-      <title>Can Sylpheed-Claws handle IPv6?</title>
-      <para>
-        Yes, IPv6 is fully supported in Sylpheed-Claws.
-      </para>
-    </section>
-
-    <section>
-      <title>How many POP3, News or IMAP accounts can I set up in Sylpheed-Claws?</title>
-      <para>
-        The number is not limited. The limit is reached when your computer stops responding.
-      </para>
-    </section>
-
-    <section>
-      <title>Does Sylpheed-Claws support encryption like GPG?</title>
-      <para>
-        Yes. GPG is implemented and works fine. For activating it in Sylpheed-Claws, see Installation And Configuration section in this FAQ or the appropiate chapter in this manual.
-      </para>
-    </section>
-
-    <section>
-      <title>How does Sylpheed-Claws check for MIME types?</title>
-      <para>
-        Sylpheed-Claws uses the Mutt type of mime checking.
-      </para>
-    </section>
-
-    <section>
-      <title>Does Sylpheed-Claws allow me to write HTML styled messages?</title>
-      <para>
-        No. A discussion has gone around over this topic, and the outcome was that HTML mail is not wanted. If you really need to send HTML, you can of course attach a webpage to an e-mail. Several patches have been made to facilitate better HTML handling in Sylpheed. You can find these patches at the Sylpheed Patch Page (see further down in the document).
-      </para>
-    </section>
-
-    <section>
-      <title>Does Sylpheed-Claws have name completion in the address fields?</title>
-      <para>
-        Yes. When you search for a name that starts with "don", type "don" (without the quotes) and press the TAB key. This will show you the correct name (when only one "don" exists in your addressbook. Otherwise a dropdown list appears, which allows you to select the name you want. E.g. Donald Duck, Don Johnson. But also e-mail addresses starting with "don" will appear in the list (like "don.giovanni@maffia.org").
-      </para>
-    </section>
-
-    <section>
-      <title>Fine, but when I hit the TAB key I get an error message.</title>
-      <para>
-        When you want to use name completion, make sure that there are names in your address book. If there are no names, even Sylpheed-Claws has a hard time completing something.
-      </para>
-    </section>
-
-    <section>
-      <title>Why is Sylpheed-Claws so fast?</title>
-      <para>
-        That's what it is designed for!
-      </para>
-    </section>
-
-    <section>
-      <title>How can I send in patches, report bugs, talk about Sylpheed-Claws with others?</title>
-      <para>
-        To talk to others, you should join the Sylpheed-Claws users' mailing list at <ulink url="http http://sylpheed-claws.sourceforge.net/MLs.php">SourceForge</ulink>.
-      </para>
-    </section>
-
-    <section>
-      <title>Can I import a mbox into Sylpheed-Claws' MH mailfolders?</title>
-      <para>
-        Yes, just create or select the folder you want your mails in, and select <quote>Import mbox file...</quote> in the <quote>File</quote> menu.
-      </para>
-    </section>
-
-    <section>
-      <title>Can I use procmail to sort my mails with the MH mail handling?</title>
-      <para>
-        Yes. Just make sure that you add <quote>/.</quote> to the end of a rule so procmail knows you are filtering into an MH mail folder. Example:
-      </para>
-      <literallayout>
-        <computeroutput>
-0:
-
-* ^Subject:.*sylpheed
-
-sylpheedmail/.
-        </computeroutput>
-      </literallayout>
-      <para>
-        Check <command>man procmail</command> for details.
-      </para>
-    </section>
-
-    <section>
-      <title>When I upgrade Sylpheed-Claws, are there things I should be aware of?</title>
-      <para>
-        Yes. Anything you should be aware of is included in the Release Notes. Click the version number <ulink url="http http://sourceforge.net/project/showfiles.php?group_id=25528&amp;package_id=17401">on this page</ulink> to see them.
-      </para>
-    </section>
-
-    <section>
-      <title>How can I quickly update the views in Sylpheed-Claws?</title>
-      <para>
-        Just press <quote>Ctrl+Alt+U</quote> or select <quote>Update summary</quote> from the <quote>View</quote> menu.
-      </para>
-    </section>
-
-    <section>
-      <title>Are there any plans to port Sylpheed-Claws to GTK2?</title>
-      <para>
-        Sylpheed-Claws already has a port to GTK2. The first release of this version was 1.9.6.
-      </para>
-      <para>
-        If you want to test the GTK2 CVS versions, you have to checkout the corresponding branch: <command>cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sylpheed-claws co -r gtk2 sylpheed-claws</command>.
-      </para>
-    </section>
-
-    <section>
-      <title>Why does sylpheed allow me to open more than one instance at the same time for the same user on a network?</title>
-      <para>
-        Sylpheed-Claws opens a Unix-domain socket using a name built from your TMPDIR path plus your UID. This socket is used to arbitrate multiple instances on a given machine. In Linux, at least, named Unix-domain sockets are known only locally, to the creating machine. Pointing your TMPDIR environment variable to /home/yours/tmp doesn't have the desired effect, as the socket definition would need to be propagated across the LAN and isn't.
-      </para>
-    </section>
-
-  </section>
-
-  <section id="faq_instconf">
-    <title>Installation and configuration</title>
-
-    <section>
-      <title>What does it take to compile Sylpheed-Claws?</title>
-      <para>
-         Any <acronym>POSIX</acronym> compliant UNIX or similar Operating System (eg. Linux, FreeBSD, Solaris), GTK+ 2.4 or later, a recent ANSI C compiler (gcc 2.7.2.3 should also work) otherwise <command>./configure</command> will fail.        </para>
-      <itemizedlist>
-        <title>Optionally:</title>
-       <listitem>
-         <para>
-           gdk-pixbuf (for built-in image view)
-         </para>
-        </listitem>
-       <listitem>
-         <para>
-           libcompface (for X-Face)
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           GPGME (for GnuPG)
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-            GNU/aspell
-         </para>
-        </listitem>
-       <listitem>
-         <para>
-            OpenSSL
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-            LDAP
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           iconv
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           libEtPan! (for IMAP support)
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           libpisock (for JPilot support in addressbook)
-         </para>
-       </listitem>
-      </itemizedlist>
-    </section>
-    
-    <section>
-      <title>How do I set up Sylpheed-Claws?</title>
-      <para>
-        When you run Sylpheed-Claws for the first time, it will ask you where you want to store your mailboxes. The default is <filename class="directory">~/Mail</filename>. You can change this to anything you like as long as it is a valid directory name.
-      </para>
-      <para>
-        Please note: When Sylpheed-Claws is executed for the first time, it automatically creates the configuration files in the directory specified by the <command>./configure</command> option <command>--with-config-dir=XXX</command> (default is <filename class="directory">$HOME/.sylpheed-claws/</filename>), and asks you the location of mailbox. The default is <filename class="directory">$HOME/Mail</filename>.
-      </para>
-    </section>
-    
-    <section>
-      <title>Why did the creation of the mailbox fail?</title>
-      <para>
-        Sylpheed-Claws reports such an error if it can't create the default mailboxes (inbox, outbox, etc ...). This can be because <filename class="directory">~/Mail</filename> already contains files with the same names. This occurs when switching from Kmail to Sylpheed-Claws, in this case backup and remove the existing Mail directory or use another name for the Sylpheed-Claws mail directory.
-      </para>
-    </section>
-    
-    <section>
-      <title>How do I set up an account?</title>
-      <para>
-        After loading Sylpheed-Claws for the first time, you will be prompted to add an e-mail account. Simply fill in the appropriate fields, (name, email address, server details, etc). You can add more accounts by using the menu item <quote>/Configuration/Create new account</quote>.
-      </para>
-    </section>
-    
-    <section>
-      <title>Why does Sylpheed not delete my mails when I press <quote>delete</quote>? I set a filter, and Sylpheed does not filter? I moved a mail to a different mailbox and it did not move?</title>
-      <para>
-If you want immediate execution be sure to set the configuration option <quote>Execute immediately when moving or deleting messages</quote> available in the <quote>/Configuration/Preferences</quote> menu option, <quote>Common Interface</quote> tab.
-      </para>
-    </section>
-    
-    <section>
-      <title>Can I set up special addresses/ports for my mailserver/newsserver?</title>
-      <para>
-        Yes, you can. In the <quote>Account preferences</quote> menu option, on the <quote>Advanced</quote> tab you can specify the port addresses that you want to use.
-      </para>
-    </section>
-    
-    <section>
-      <title>Does Sylpheed-Claws have options for threading messages?</title>
-      <para>
-        Yes. You can switch it on and off in the <quote>View</quote> menu, just select <quote>Thread view</quote> or press <quote>Ctrl+T</quote>. (This only affects the currently selected folder; i.e. it is a folder property.)
-      </para>
-    </section>
-    
-    <section>
-      <title>Can I create multiple levels of subfolders to store mail?</title>
-      <para>
-        Absolutely. This is not a problem. The only limitations are underlying filesystem capabilities.
-      </para>
-    </section>
-    
-    <section>
-      <title>Why isn't Sylpheed sending my mail out?</title>
-      <para>
-        You need to create at least one account in order to send. (This is a wonderful gotcha on LAN installs with only a local mailbox feed).
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-    <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
+    <title>What are the differences between Claws Mail and Sylpheed?</title>
+    <para>
+       Claws Mail is a fork of Sylpheed, therefore you will find that 
+       it has all the features that Sylpheed has and a lot more besides. 
+       It also includes some modified dialogues to enhance usability. 
+       Further information can be found at 
+       <ulink url="http://www.claws-mail.org/features.php">
+       http://www.claws-mail.org/features.php</ulink>.
+    </para></section>
+    <section>
+    <title>Does Claws Mail allow me to write HTML styled messages?</title>
+    <para>
+       No. A discussion has gone on around this topic, and the outcome was that
+       HTML mail is not wanted. If you really need to send HTML, you can of
+       course attach a webpage to an email.
+    </para></section>
     <section>
-      <title></title>
-      <para>
-      </para>
-    </section>
-    
-  </section>
-
-  <section id="faq_interface">
-    <title>Interface</title>
+    <title>How can I submit patches, report bugs, and talk about Claws Mail
+       with others?</title>
     <para>
+       Patches should be submitted via our Bugzilla, 
+       <ulink url='http://www.thewildbeast.co.uk/claws-mail/bugzilla/'>
+       http://www.thewildbeast.co.uk/claws-mail/bugzilla/</ulink>, 
+       but please follow the patch guidelines at 
+       <ulink url="http://www.claws-mail.org/devel.php">
+       http://www.claws-mail.org/devel.php</ulink>.
     </para>
-  </section>
-
-  <section id="faq_compose">
-    <title>Composing mails or news</title>
     <para>
+        Bug reports should be submitted at our Bugzilla, 
+        <ulink url="http://www.thewildbeast.co.uk/claws-mail/bugzilla/">
+       http://www.thewildbeast.co.uk/claws-mail/bugzilla/</ulink>.
     </para>
-  </section>
-
-  <section id="faq_filtering">
-    <title>Filtering and processing of messages</title>
     <para>
+       To talk to others, you should join the Claws Mail users' mailing
+       list. Details can be found at 
+       <ulink url="http://www.claws-mail.org/MLs.php">
+       http://www.claws-mail.org/MLs.php</ulink>.
     </para>
-  </section>
-
-  <section id="faq_actions">
-    <title>Actions</title>
+    </section>
+    <section>
+    <title>Does Claws Mail have an anti-spam feature?</title>
     <para>
+       Yes. It has a SpamAssassin and a Bogofilter plugin. You can find 
+       details of it on the
+       <link linkend="ch_plugins">Extending Claws Mail</link> chapter.
     </para>
-  </section>
-
-  <section id="faq_plugins">
-    <title>Plugins</title>
     <para>
+       You can also use other spam filters via the <quote>Filtering</quote> and
+       <quote>Actions</quote> features. Instructions on how to use other antispam
+       filters with Claws Mail can be found as a Bogofilter-based example
+       on the <ulink url="http://bogofilter.sourceforge.net/faq.shtml#with-sc">
+       Bogofilter FAQ</ulink>.
+    </para></section>
+    <section>
+    <title>Does Claws Mail support Return Receipts?</title>
+    <para>
+       Yes.
+       To request a Return Receipt use <quote>Options/Request Return 
+       Receipt</quote> in the Compose window. When you receive a message that
+       requests a Return Receipt a notification area is shown just above the
+       message view. You can either use the <quote>Send receipt</quote> button,
+       or ignore the request - no receipts are sent automatically.
     </para>
-  </section>
-
+    <para>
+       If you do not ever want to send Return Receipts then you can use the
+       option <quote>Never send Return Receipts</quote> in the
+       <quote>Configuration/Preferences/Mail Handling/Sending</quote> page.
+    </para></section>
+    <section>
+    <title>How can I make Claws Mail notify me when new mail
+    arrives?</title>
+    <para>
+       Go to <quote>Configuration/Preferences</quote>, in the <quote>Mail
+       Handling/Receiving</quote> section, use the settings for <quote>Run
+       command</quote> in the <quote>After receiving new mail</quote>
+       frame. Alternatively, use the Trayicon plugin.
+    </para></section>
+    <section>
+    <title>Why are special characters (e.g. umlauts) not displayed
+    correctly?</title>
+    <para>
+       In most cases, this is caused by emails with broken encodings. You can
+       try to force it using the <quote>View/Character Encoding</quote>
+       submenu.
+    </para></section>
+    <section>
+    <title>Can I quote just a section of the original message when
+    replying?</title>
+    <para>
+       Yes, select the section of the message that you want to quote and use
+       <quote>Reply</quote>.
+    </para></section>
+    <section>
+    <title>Where can I find the answers to more FAQs about
+    Claws Mail?</title>
+    <para>
+       An enlarged, user-contributed FAQ can be found on the Claws Mail
+       website, <ulink url="http://www.claws-mail.org/faq/">
+       http://www.claws-mail.org/faq/</ulink>
+    </para>
+    </section>
 </appendix>
-