Remove lfs-uefi.txt symlink
[linux_from_scratch_hints.git] / PREVIOUS_FORMAT / sylpheed.txt
blob0fe49c3c0e35eb85792a3e596f2b8e9268363c7a
1 TITLE:          Sylpheed
2 LFS-VERSION:    any
3 AUTHOR:         Vassili Dzuba <vassili.dzuba@wanadoo.fr>
4 SYNOPSIS:
5         How to install Sylpheed, a GTK+ -based mail/news program.
6 HINT VERSION:   1.0 (Aug 11, 2002)
8 HINT:
10 CONTENT
11 =======
12   1) INTRODUCTION
13   2) REQUIREMENTS
14   3) BUILDING THE REQUIRED LIBRARIES
15   4) GETTING Sylpheed
16   5) BUILDING Sylpheed
17   6) CONFIGURING Sylpheed
18   7) IMPORTING MESSAGES
20 INTRODUCTION
21 ============
23 From Sylpheed's README :
25 <quote>
26 Sylpheed is an e-mail client (and news reader) based on GTK+, running on
27 X Window System, and aiming for
29   * Quick response
30   * Graceful, and sophisticated interface
31   * Easy configuration, intuitive operation
32   * Abundant features
33 </quote>
35 The user interface is quite similar to the UI of Outlook Express and
36 other Windows e-mail client.
38 The messages are managed  in the MH format, so that Sylpheed is compatible
39 with other e-mail clients using this format; and fetchmail and/or procmail.
41 Sylpheed is released under the GPL.
43 REQUIREMENTS
44 ============
46 As Sylpheed is a X11 application (written using GTK+), it requires of 
47 course X11. One will assume that X11 has been installed according to the
48 BLFS book.
50 To build Sylpheed, you will need the following library
52 -  GTK+ 1.2.6 or higher (the current version is 1.2.10)
54 GTK+ itself requires some libraries (listed here with their current
55 version number) :
57 - libtiff 3.5.7
58 - libpng 1.2.3
59 - libjpeg 6b
60 - libungif 4.1.01b1
61 - glib 1.2.0
63 Optionally, you can use :
64 - libssl 0.9.6e for SSL support
65 - GPGME 0.2.3 or later for GnuPG support
67 The following libraries are recommanded :
69 - gdk-pixbuf 1.18.0
70 - imlib 1.9.14
72 The build process of most of these libraries is described in the BLFS book.
74 The build process of GnuPG is not described in the BLFS book but 
75 is rather straightforward
77    GnuPG can be obtained from http://www.gnupg.org.
79    tar xzvf gnupg-1.0.7.tar.gz /usr/src
80    cd /usr/src/gnupg-1.0.7
81    ./configure --prefix=/usr
82    make 
83    make install
84    gpg --gen-key
86 Note : the command  
87              gpg --gen-key
88        will create a new key pair for the current user, and store it into
89        the directory ~/.gnupg
90        It should therefore be executed for each user that will use gnupg.
92 The build process of GPGME is not described in the BLFS book but 
93 is rather straightforward
95    GPGME can be obtained from http://www.gnupg.org/gpgme.html
97    tar xzvf gpgme-0.3.8.tar.gz /usr/src
98    cd /usr/src/gpgme-0.3.8
99    ./configure --prefix=/usr
100    make 
101    make install
103 compface
104 --------
106   compface is an optional progam aimed at compressing/decompression
107   small (48x48) images to be put in mail headers, under the field name
108   X-Face.
109   i've never meet any e-mail with some X-face header, but if yuo want to
110   support it in sylpheed , you can get it from
111   http://freshmeat.net/projects/compface/
113   The compilation goes as follows:
114    
115      tar xzvf compface-1.4.tar.gz /usr/src
116      cd /usr/src/compface-1.4
117      ./configure --prefix=/usr
118      make
119      make install
121 libjconf
122 --------
124   By default, Sylpheed supports US-ASCII, ISO-8859-1, and EUC-JP.
125   For other character sets and/or encodings (UTF-8, KOI8-R, and GB2312)
126   you need to install libjconv, which is a wrapper for iconv()  
127   According to Sylphhed documentation, you can download it from :
129        http://www.kondara.org/libjconv/index.html
131   However, I have been unable to reach the site http://www.kondara.org/,
132   and i don't know if it exists any more.
134 ldap
135 ----
137   The support of LDAP is mentionned in the change log but not in the 
138   install file.
139   If you download openldap-2.1.3.tgz from http://www.openldap.org/
140   or one of its mirrors, and compile it, using the usual routine :
141      tar -xzvf openldap-2.1.3.tgz /usr/src
142      cd /usr/src/openldap-2.1.3
143      ./configure --prefix=/usr
144      make 
145      make install
146   and if you execute Sylpheed configuration with the option --enable-ldap
147   you'll make it happily tell you that it uses LDAP.
148   As i didn't test it; I cannot tell you more for the time being.
150 JPilot
151 ------
153   Sylpheed has support for JPilot, a Palm Pilot organizer that runs under
154   Linux. As i don't have a Palm Pilot, I cannot comment on that functionality.
155   If you are interested, see the site http://www.jpilot.org/ and add option
156   --enable-jpilot to Sylpheed's configure command.
159 GETTING Sylpheed
160 ================
162   Sylpheed home page is : http://sylpheed.good-day.net/
163   You can find there a .tar.gz and a .tar.bz2 archive.
164   The current version is 0.8.1
166   Note : there is also a "bleeding edge" advanced version named
167          Sylpheed-claws, available from http://sylpheed-claws.sourceforge.net/
168          Its version is called  0.8.1.claws
171 BUILDING Sylpheed
172 =================
174   The build process is as follows:
176     tar tzvf sylpheed-0.8.1 /usr/src
177     cd /usr/src/sylpheed-0.8.1
178     ./configure --prefix=/usr --enable-ssl --enable-gpgme  --enable-ldap
179     make
180     make install
183   Note : the option --enable-ssl is used to enable SSL support; you can omit
184          it if you don't have openssl, or do not wish SSL support
186          the option --enable-gpgme is used to enable GnuPG support; 
187          you can omit it if you don't have GnuPG, or do not wish SSL support
189          the option --enable-ldap is used to enable LDAP support; you can omit
190          it if you don't have LDAP or don't want to use it with Sylpheed.
192          the default installation directory for Sylpheed is /usr/local/bin
193          the option --prefix=/usr indicates that we want it to be installed
194          into /usr.
196          it is possible to enable IPv6 support by using the configure option
197          --enable-ipv6. As my LFS box does not support IPv6, I cannot comment
198          on this functionality.
200          it is possible to enable JPilot support by using the configure option
201          --enable-jpilot.
203   
204 CONFIGURING Sylpheed
205 ====================
207 If you want to have the interface of Sylpheed in a language different
208 from English, you must set an environment variable before launching 
209 Sylpheed. For instance, to have it in German :
210    export LANG=de_DE
211 or in French :
212    export LANG=fr_FR
214 When a user runs Sylpheed for the first time, the program creates
215 its private files under ~/.sylpheed; and asks the user for
216 the location of the mailbox, the default being ~/Mail.
218 When in Sylpheed, you will have to create one or several accounts,
219 through the menu item Configuration/ Create new account.
220 You will have to create one or several POP3 or IMAP account(s)
221 to access your e-mails, and one or several NNTP accounts to
222 access the news.
224 To have access to the documentation (which is in HTML), you might need to
225 configure the command to call your browser. You can reach it through
226 the menu Configuration / Common preferences, and then select the
227 tab "Other" in the dialog (you might have to scroll the tab list to the
228 right to see it).
229 The default is to call netscape, but you could for instance call mozilla
230 using the following command, assuming Mozilla is in your PATH:
232       mozilla -remote 'openURL(%s)'
234 IMPORTING MESSAGES
235 ==================
237 If you have some OutlookExpress mailbox that you want to import to Linux, 
238 you can get liboe from http://www.gpl.no/liboe/.
239 You can then download liboe-0.92.tar.gz, decompress it and
240 compile oe2mbx : 
241     make oe2mbx
243 The program oe2mbx will read your Outlook Express mailbox (.dbx)
244 and create a .mbx file that you will be able to import into Sylpheed
245 using the menu item File / Import mbox file...