1.9.100 released
[claws.git] / 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