manual/faq.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <appendix id="ap_faq">
   3 <title>The Sylpheed-Claws FAQ</title>
   4
   5   <section id="faq_general">
   6     <title>General information</title>
   7
   8     <section>
   9       <title>What is Sylpheed? What is Sylpheed-Claws?</title>
  10       <para>
  11          Sylpheed is an e-mail client (and news reader) based on GTK+, running on the X Window System, and aiming for:
  12       </para>
  13       <itemizedlist>
  14         <listitem>
  15           <para>
  16             Quick response
  17           </para>
  18         </listitem>
  19         <listitem>
  20           <para>
  21             Graceful, and sophisticated interface
  22           </para>
  23         </listitem>
  24         <listitem>
  25           <para>
  26             Easy configuration, intuitive operation
  27           </para>
  28         </listitem>
  29         <listitem>
  30           <para>
  31             Abundant features
  32           </para>
  33         </listitem>
  34       </itemizedlist>
  35       <para>
  36         Sylpheed-Claws is the extended version of Sylpheed.
  37       </para>
  38     </section>
  39
  40     <section>
  41       <title>What are the differences between Sylpheed and Sylpheed-Claws?</title>
  42       <para>
  43         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>.
  44       </para>
  45     </section>
  46
  47     <section>
  48       <title>Where can I get Sylpheed-Claws?</title>
  49       <para>
  50         See the <ulink url="http://sylpheed-claws.sourceforge.net/downloads.php">Downloads page</ulink>.
  51       </para>
  52     </section>
  53
  54     <section>
  55       <title>Who writes Sylpheed-Claws?</title>
  56       <para>
  57         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.
  58       </para>
  59     </section>
  60
  61     <section>
  62       <title>What does the name Sylpheed mean?</title>
  63       <para>
  64         It means 'light weight', like air. This comes from the name of the wind spirits, the Sylphs.
  65       </para>
  66     </section>
  67
  68     <section>
  69       <title>How does Sylpheed-Claws store mails?</title>
  70       <para>
  71         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>.
  72       </para>
  73     </section>
  74
  75     <section>
  76       <title>Does Sylpheed-Claws have mail filtering?</title>
  77       <para>
  78         Yes. You can find it in <quote>Configuration</quote> menu, <quote>Filtering...</quote> option.
  79       </para>
  80     </section>
  81
  82     <section>
  83       <title>Can Sylpheed-Claws handle IMAP mail?</title>
  84       <para>
  85         Yes.
  86       </para>
  87     </section>
  88
  89     <section>
  90       <title>Can Sylpheed-Claws handle local unix mailboxes?</title>
  91       <para>
  92         Yes.
  93       </para>
  94     </section>
  95
  96     <section>
  97       <title>Can Sylpheed-Claws handle IPv6?</title>
  98       <para>
  99         Yes, IPv6 is fully supported in Sylpheed-Claws.
 100       </para>
 101     </section>
 102
 103     <section>
 104       <title>How many POP3, News or IMAP accounts can I set up in Sylpheed-Claws?</title>
 105       <para>
 106         The number is not limited. The limit is reached when your computer stops responding.
 107       </para>
 108     </section>
 109
 110     <section>
 111       <title>Does Sylpheed-Claws support encryption like GPG?</title>
 112       <para>
 113         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.
 114       </para>
 115     </section>
 116
 117     <section>
 118       <title>How does Sylpheed-Claws check for MIME types?</title>
 119       <para>
 120         Sylpheed-Claws uses the Mutt type of mime checking.
 121       </para>
 122     </section>
 123
 124     <section>
 125       <title>Does Sylpheed-Claws allow me to write HTML styled messages?</title>
 126       <para>
 127         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).
 128       </para>
 129     </section>
 130
 131     <section>
 132       <title>Does Sylpheed-Claws have name completion in the address fields?</title>
 133       <para>
 134         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").
 135       </para>
 136     </section>
 137
 138     <section>
 139       <title>Fine, but when I hit the TAB key I get an error message.</title>
 140       <para>
 141         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.
 142       </para>
 143     </section>
 144
 145     <section>
 146       <title>Why is Sylpheed-Claws so fast?</title>
 147       <para>
 148         That's what it is designed for!
 149       </para>
 150     </section>
 151
 152     <section>
 153       <title>How can I send in patches, report bugs, talk about Sylpheed-Claws with others?</title>
 154       <para>
 155         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>.
 156       </para>
 157     </section>
 158
 159     <section>
 160       <title>Can I import a mbox into Sylpheed-Claws' MH mailfolders?</title>
 161       <para>
 162         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.
 163       </para>
 164     </section>
 165
 166     <section>
 167       <title>Can I use procmail to sort my mails with the MH mail handling?</title>
 168       <para>
 169         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:
 170       </para>
 171       <literallayout>
 172         <computeroutput>
 173 0:
 174
 175 * ^Subject:.*sylpheed
 176
 177 sylpheedmail/.
 178         </computeroutput>
 179       </literallayout>
 180       <para>
 181         Check <command>man procmail</command> for details.
 182       </para>
 183     </section>
 184
 185     <section>
 186       <title>When I upgrade Sylpheed-Claws, are there things I should be aware of?</title>
 187       <para>
 188         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.
 189       </para>
 190     </section>
 191
 192     <section>
 193       <title>How can I quickly update the views in Sylpheed-Claws?</title>
 194       <para>
 195         Just press <quote>Ctrl+Alt+U</quote> or select <quote>Update summary</quote> from the <quote>View</quote> menu.
 196       </para>
 197     </section>
 198
 199     <section>
 200       <title>Are there any plans to port Sylpheed-Claws to GTK2?</title>
 201       <para>
 202         Sylpheed-Claws already has a port to GTK2. The first release of this version was 1.9.6.
 203       </para>
 204       <para>
 205         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>.
 206       </para>
 207     </section>
 208
 209     <section>
 210       <title>Why does sylpheed allow me to open more than one instance at the same time for the same user on a network?</title>
 211       <para>
 212         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.
 213       </para>
 214     </section>
 215
 216   </section>
 217
 218   <section id="faq_instconf">
 219     <title>Installation and configuration</title>
 220
 221     <section>
 222       <title>What does it take to compile Sylpheed-Claws?</title>
 223       <para>
 224          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>
 225       <itemizedlist>
 226         <title>Optionally:</title>
 227         <listitem>
 228           <para>
 229             gdk-pixbuf (for built-in image view)
 230           </para>
 231         </listitem>
 232         <listitem>
 233           <para>
 234             libcompface (for X-Face)
 235           </para>
 236         </listitem>
 237         <listitem>
 238           <para>
 239             GPGME (for GnuPG)
 240           </para>
 241         </listitem>
 242         <listitem>
 243           <para>
 244             GNU/aspell
 245           </para>
 246         </listitem>
 247         <listitem>
 248           <para>
 249             OpenSSL
 250           </para>
 251         </listitem>
 252         <listitem>
 253           <para>
 254             LDAP
 255           </para>
 256         </listitem>
 257         <listitem>
 258           <para>
 259             iconv
 260           </para>
 261         </listitem>
 262         <listitem>
 263           <para>
 264             libEtPan! (for IMAP support)
 265           </para>
 266         </listitem>
 267         <listitem>
 268           <para>
 269             libpisock (for JPilot support in addressbook)
 270           </para>
 271         </listitem>
 272       </itemizedlist>
 273     </section>
 274
 275     <section>
 276       <title>How do I set up Sylpheed-Claws?</title>
 277       <para>
 278         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.
 279       </para>
 280       <para>
 281         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>.
 282       </para>
 283     </section>
 284
 285     <section>
 286       <title>Why did the creation of the mailbox fail?</title>
 287       <para>
 288         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.
 289       </para>
 290     </section>
 291
 292     <section>
 293       <title>How do I set up an account?</title>
 294       <para>
 295         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>.
 296       </para>
 297     </section>
 298
 299     <section>
 300       <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>
 301       <para>
 302 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.
 303       </para>
 304     </section>
 305
 306     <section>
 307       <title>Can I set up special addresses/ports for my mailserver/newsserver?</title>
 308       <para>
 309         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.
 310       </para>
 311     </section>
 312
 313     <section>
 314       <title>Does Sylpheed-Claws have options for threading messages?</title>
 315       <para>
 316         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.)
 317       </para>
 318     </section>
 319
 320     <section>
 321       <title>Can I create multiple levels of subfolders to store mail?</title>
 322       <para>
 323         Absolutely. This is not a problem. The only limitations are underlying filesystem capabilities.
 324       </para>
 325     </section>
 326
 327     <section>
 328       <title>Why isn't Sylpheed sending my mail out?</title>
 329       <para>
 330         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).
 331       </para>
 332     </section>
 333
 334     <section>
 335       <title></title>
 336       <para>
 337       </para>
 338     </section>
 339
 340     <section>
 341       <title></title>
 342       <para>
 343       </para>
 344     </section>
 345
 346     <section>
 347       <title></title>
 348       <para>
 349       </para>
 350     </section>
 351
 352     <section>
 353       <title></title>
 354       <para>
 355       </para>
 356     </section>
 357
 358     <section>
 359       <title></title>
 360       <para>
 361       </para>
 362     </section>
 363
 364     <section>
 365       <title></title>
 366       <para>
 367       </para>
 368     </section>
 369
 370     <section>
 371       <title></title>
 372       <para>
 373       </para>
 374     </section>
 375
 376     <section>
 377       <title></title>
 378       <para>
 379       </para>
 380     </section>
 381
 382     <section>
 383       <title></title>
 384       <para>
 385       </para>
 386     </section>
 387
 388     <section>
 389       <title></title>
 390       <para>
 391       </para>
 392     </section>
 393
 394     <section>
 395       <title></title>
 396       <para>
 397       </para>
 398     </section>
 399
 400     <section>
 401       <title></title>
 402       <para>
 403       </para>
 404     </section>
 405
 406     <section>
 407       <title></title>
 408       <para>
 409       </para>
 410     </section>
 411
 412     <section>
 413       <title></title>
 414       <para>
 415       </para>
 416     </section>
 417
 418     <section>
 419       <title></title>
 420       <para>
 421       </para>
 422     </section>
 423
 424   </section>
 425
 426   <section id="faq_interface">
 427     <title>Interface</title>
 428     <para>
 429     </para>
 430   </section>
 431
 432   <section id="faq_compose">
 433     <title>Composing mails or news</title>
 434     <para>
 435     </para>
 436   </section>
 437
 438   <section id="faq_filtering">
 439     <title>Filtering and processing of messages</title>
 440     <para>
 441     </para>
 442   </section>
 443
 444   <section id="faq_actions">
 445     <title>Actions</title>
 446     <para>
 447     </para>
 448   </section>
 449
 450   <section id="faq_plugins">
 451     <title>Plugins</title>
 452     <para>
 453     </para>
 454   </section>
 455
 456 </appendix>
 457