Python 2 EOL: migrate eud2gc.py to Python 3
[claws.git] / manual / faq.xml
index dd98d7b..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>
-
+    <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>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 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>
+    <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_interface">
-    <title>Interface</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_compose">
-    <title>Composing mails or news</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_filtering">
-    <title>Filtering and processing of messages</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_actions">
-    <title>Actions</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>
-
-  <section id="faq_plugins">
-    <title>Plugins</title>
     <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>
-
+    </section>
 </appendix>
-