2005-09-08 [paul] 1.9.14cvs7
[claws.git] / doc / manual / en / sylpheed-4.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <html>
3 <head>
4   <meta name="GENERATOR" content="LinuxDoc-Tools 0.9.21">
5   <title>Sylpheed-Claws User's Manual: Installation.</title>
6   <link href="sylpheed-5.html" rel="next">
7   <link href="sylpheed-3.html" rel="previous">
8   <link href="sylpheed.html#toc4" rel="contents">
9 </head>
10 <body>
11 <a href="sylpheed-5.html">Next</a>
12 <a href="sylpheed-3.html">Previous</a>
13 <a href="sylpheed.html#toc4">Contents</a>
14 <hr>
15 <h2><a name="s4">4.</a> <a href="sylpheed.html#toc4">Installation.</a></h2>
16 <h2><a name="ss4.1">4.1</a> <a href="sylpheed.html#toc4.1">Required
17 environment</a>
18 </h2>
19 <p>To succesfully compile Sylpheed, you need at least:
20 </p>
21 <ul>
22   <li>Any POSIX compliant UNIX or similar OS eg. Linux, FreeBSD, Solaris</li>
23   <li>
24     <a href="http://www.gtk.org/">GTK+</a> 2.4.x or later</li>
25   <li>A recent ANSI C compiler (
26     <a href="http://gcc.gnu.org/">gcc</a> 2.95 should also work).</li>
27 </ul>
28 Optionally you need:
29 <a name="option_libraries"></a>
30 <ul>
31   <li><a href="ftp://ftp.cs.indiana.edu/pub/faces/compface/">libcompface</a>
32 (for X-Face)</li>
33   <li><a href="http://www.gnupg.org/gpgme.html">GPGME</a>
34 and
35     <a href="http://www.gnupg.org/">GNUPG</a>
36 (for encryption and signature)</li>
37   <li>
38     <a href="http://www.openssl.org/">OpenSSL</a>
39 (for SSL support)</li>
40   <li>
41     <a href="http://www.openldap.org/">OpenLDAP</a>
42 (for LDAP connection)</li>
43   <li>IPv6 support can be turned on (if your system supports it)</li>
44   <li>
45     <a href="http://www.jpilot.org/">Jpilot</a>
46 (for Palm addressbook use)</li>
47   <li><a href="http://libetpan.sourceforge.net">Libetpan</a> (for IMAP4
48 support)</li>
49   <li>libgnomeprint(ui) (for extended printing support)</li>
50   <li><a href=http://aspell.sourceforge.net/>Aspell</a> (for spell checker support)</li>
51   <li><a href=http://spamassassin.org/>SpamAssassin</a> (for SpamAssassin plugin support)</li>
52   <li><a href=http://clamav.sourceforge.net/>Clam AntiVirus</a> (for Clam AntiVirus plugin support)</li>
53   <li><a href=http://www.dillo.org/>Dillo</a> (for Dillo HTML viewer plugin support)</li>
54   <li><a href=http://helm.cs.unibo.it/mml-widget/>GtkMathView</a> (for MathML viewer plugin support)</li>
55 </ul>
56 <p></p>
57 <h2><a name="ss4.2">4.2</a> <a href="sylpheed.html#toc4.2">Nuts and
58 bolts of installation</a>
59 </h2>
60 <p>
61 </p>
62 <ul>
63   <li>Download the latest version of the Sylpheed-Claws package from
64     <a href="http://sourceforge.net/project/showfiles.php?group_id=25528&package_id=147457">SourceForge</a></li>
65   <li>Untar the sourcefiles to a new directory</li>
66   <li>tar -zxf sylpheed-claws-x.x.x.tar.gz (for tar.gz)</li>
67   <li>tar -jxf sylpheed-claws-x.x.x.tar.bz2 (for tar.bz2) </li>
68   <li>cd to the new sylpheed-claws-x.x.x directory </li>
69   <li>Run ./configure to check your environment and create the
70 installation make files </li>
71   <li>Run the 'make' program which will compile the sources. Do not
72 proceed with this step if there are fatal errors in the previous step.
73 Fatal errors indicate that things are missing in order to compile
74 Sylpheed-Claws properly. </li>
75 </ul>
76 <p></p>
77 <p>If the make process has completed, run "make install" (as root), to
78 install the program and the supportfiles.</p>
79 <h3><a name="compile_sylpheed"></a> Compiling Sylpheed-Claws with
80 options</h3>
81 <p>You can choose to compile Sylpheed-Claws with some optional features
82 enabled.
83 Use <i>./configure --help</i> to list configuration syntax and options.</p>
84 <p>The following optional features can be enabled:</p>
85 <p>
86 </p>
87 <ul>
88   <li><i>Jpilot</i>: to use you PDA addressbook with Sylpheed-Claws. You will
89 need the <i>Jpilot</i> library (and <i>pilot-link</i>, too).
90 Enable this option with the <i>--enable-jpilot</i> configure switch.</li>
91   <li><i>GnuPG</i>: Sylpheed-Claws can encrypt and sign your messages (also
92 decrypt
93 and verify the signatures of the incoming messages) using GnuPG.
94 GnuPG follows the OpenPGP standard and is compatible with PGP.
95 To enable this feature, you need to install GnuPG and GPGME (interface
96 library to GnuPG). This is automatically enabled if possible.</li>
97   <li><i>LDAP</i>: Sylpheed-Claws can connect to a LDAP server in order to
98 query mail addresses. To enable this feature you will need the
99 OpenLDAP library.
100 Enable this option with the <i>--enable-ldap</i> configure switch.</li>
101   <li><i>X-Face</i>: you can create a small picture (of your face, or
102 of anything else) that will be sent in the header of your mails.
103 This option is enabled if the compface library is found and
104 can be disabled using the <i>--disable-compface</i> configure switch.</li>
105   <li><span style="font-style: italic;">SSL</span>: OpenSSL support
106 will be automatically built if openssl is available with its
107 development files.</li>
108   <li><span style="font-style: italic;">libetpan</span>: libetpan is
109 required to build IMAP4 support. As this is important, if libetpan
110 isn't present, configure will fail. You can force a build with no IMAP4
111 support by using <span style="font-style: italic;">--disable-libetpan</span>.</li>
112 </ul>
113 <p></p>
114 <p>All these features require additional libraries and tools that may
115 not be part
116 of your distribution. You can find them at the addresses listed at the
117 beginning
118 of this chapter, <a href="#option_libraries">here</a>.</p>
119 <h2><a name="ss4.3">4.3</a> <a href="sylpheed.html#toc4.3">Installation
120 on Linux using RPM</a>
121 </h2>
122 <p>As root, run the "rpm -Uvh " command on the RPM file you downloaded.
123 As soon as this process is complete you can run Sylpheed-Claws as user.
124 </p>
125 <h2><a name="ss4.4">4.4</a> <a href="sylpheed.html#toc4.4">Installation
126 on Debian Linux</a>
127 </h2>
128 <p>With an internet connection :</p>
129 <p>apt-get install sylpheed-claws (to install it with a internet
130 connection)</p>
131 <p>Without internet connection, fetch the debian package for example on
132 <a href="http://packages.debian.org/unstable/mail/sylpheed-claws-gtk2.html">http://packages.debian.org/unstable/mail/sylpheed-claws-gtk2.html</a></p>
133 <p>dpkg -i sylpheed-claws-gtk2_x.x.x-1i386.deb</p>
134 <p>dpkg --install sylpheed-claws-gtk2_x.x.x-1i386.deb</p>
135 <h2><a name="ss4.5">4.5</a> <a href="sylpheed.html#toc4.5">Installation
136 on FreeBSD</a>
137 </h2>
138 <p>using the /stand/sysinstall tool (it is a menu-based interface) :</p>
139 <p>run "/stand/sysinstall" as root</p>
140 <p>in the main menu choose "Configure" -&gt; "Packages" -&gt; "mail",
141 then "sylpheed-claws" then, back to the "Packages" list, choose
142 "Install"</p>
143 <p>Using the ports</p>
144 <p>Get the Sylpheed-Claws port on :</p>
145 <p>
146 <a
147  href="ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-current/mail/">ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-current/mail/</a></p>
148 <p>then, as root: pkg-add sylpheed-claws-x.x.x.tgz</p>
149 <p>using the ports with compiling:</p>
150 <p>first, update your port, fetch it on <a
151  href="http://www.freebsd.org/ports/mail.html">http://www.freebsd.org/ports/mail.html</a></p>
152 <p>cd /usr/ports/mail/sylpheed-claws</p>
153 <p>make</p>
154 <p>If it succeeds, type "make install"</p>
155 <p>In case it fails, fetch the required package if necessary
156 (on the same page), put the package file in /usr/ports/distfiles/
157 then :
158 </p>
159 <ul>
160   <li>cd /usr/ports/mail/sylpheed-claws</li>
161   <li>make</li>
162   <li>make install</li>
163 </ul>
164 <p></p>
165 <p>Need a more up-to-date version ?</p>
166 <p>Just use the Unix standard method (see "Nuts and bolts of
167 installation")</p>
168 <hr>
169 <a href="sylpheed-5.html">Next</a>
170 <a href="sylpheed-3.html">Previous</a>
171 <a href="sylpheed.html#toc4">Contents</a>
172 </body>
173 </html>