1 | Evolution is the integrated mail, calendar and address book |
---|
2 | distributed suite from Ximian, Inc. |
---|
3 | |
---|
4 | See http://www.ximian.com/apps/evolution.php3 for more information. |
---|
5 | |
---|
6 | Note that Evolution is still beta. This means it may delete all of |
---|
7 | your mail if you give it the chance. |
---|
8 | |
---|
9 | If you are using Evolution, you should subscribe to the Evolution |
---|
10 | mailing list. If you are interested in hacking on it, you should |
---|
11 | subscribe to the Evolution Hackers mailing list. Send mail to |
---|
12 | "evolution-request@ximian.com" or |
---|
13 | "evolution-hackers-request@ximian.com" with the word "subscribe" in |
---|
14 | the body of the message. If you are planning to work on any part of |
---|
15 | Evolution, please send mail to the mailing list first, to avoid |
---|
16 | duplicated effort (and to make sure that you aren't basing your work |
---|
17 | on interfaces that are expected to change). |
---|
18 | |
---|
19 | There are mailing list archives available at |
---|
20 | http://lists.ximian.com/archives/public/evolution/ and |
---|
21 | http://lists.ximian.com/archives/public/evolution-hackers/ |
---|
22 | |
---|
23 | There is also an #evolution IRC channel on irc.gnome.org. |
---|
24 | |
---|
25 | |
---|
26 | IF IT DOESN'T WORK |
---|
27 | ------------------ |
---|
28 | |
---|
29 | Did you read the "How to build" section below? |
---|
30 | |
---|
31 | If the configure script complains that you don't have a library that |
---|
32 | you know you have installed, it usually means either that you've |
---|
33 | installed things into multiple prefixes (see the bits on GNOME_PATH |
---|
34 | below) or (if you're on Linux) that you installed the "foo" package |
---|
35 | but forgot the "foo-devel" or "foo-dev" packages. |
---|
36 | |
---|
37 | |
---|
38 | HOW TO BUILD EVOLUTION |
---|
39 | ---------------------- |
---|
40 | |
---|
41 | *** READ THIS BEFORE YOU START BUILDING ANYTHING! *** |
---|
42 | |
---|
43 | Evolution depends on a large number of unreleased and rapidly-changing |
---|
44 | libraries. Some of these libraries in turn depend on other unreleased |
---|
45 | and rapidly-changing libraries. |
---|
46 | |
---|
47 | Building Evolution is HARD, and it's going to stay hard until all of |
---|
48 | the libraries it depends on stabilize, and there's nothing we can do |
---|
49 | to make it any easier until then. |
---|
50 | |
---|
51 | |
---|
52 | GENERAL PRINCIPLES |
---|
53 | ------------------ |
---|
54 | |
---|
55 | First you have to decide whether you want to install Evolution (and |
---|
56 | its dependencies) into the same prefix as the rest of your GNOME |
---|
57 | install, or into a new prefix. Installing everything into the same |
---|
58 | prefix as the rest of your GNOME install will make it much easier to |
---|
59 | build and run programs, and easier to switch between using packages |
---|
60 | and building it yourself, but it may also make it harder to uninstall |
---|
61 | later. |
---|
62 | |
---|
63 | If you want to install into the same prefix as the rest of GNOME, |
---|
64 | type: |
---|
65 | |
---|
66 | gnome-config --prefix |
---|
67 | gnome-config --sysconfdir |
---|
68 | |
---|
69 | and remember the answers, and pass them to "configure" or "autogen.sh" |
---|
70 | when building the other packages you need. For example: |
---|
71 | |
---|
72 | ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var/lib |
---|
73 | |
---|
74 | --localstatedir is needed to make the docs integrate with scrollkeeper |
---|
75 | and needs to point to the directory containing the scrollkeeper indices |
---|
76 | which are in: gnome-config --localstatedir |
---|
77 | |
---|
78 | If you build in another prefix instead, you will need to set the |
---|
79 | GNOME_PATH environment variable (and ACLOCAL_FLAGS as well if building |
---|
80 | from CVS) to include the prefix you install into. For example: |
---|
81 | |
---|
82 | export GNOME_PATH=/usr/local |
---|
83 | export ACLOCAL_FLAGS="-I /usr/local/share/aclocal" |
---|
84 | |
---|
85 | (Assuming your shell is bash, and you installed into /usr/local.) You |
---|
86 | need to set GNOME_PATH both during compiling AND when you run |
---|
87 | evolution. Remember also that if you're installing into an odd prefix |
---|
88 | such as /evolution, that you also need to make sure to put |
---|
89 | ${prefix}/bin in your PATH and ${prefix}/lib in your LD_LIBRARY_PATH. |
---|
90 | |
---|
91 | |
---|
92 | DEPENDENCIES |
---|
93 | ------------ |
---|
94 | |
---|
95 | The following required libraries are available in GNOME CVS, under the |
---|
96 | given names. Most (but not all) of them are also available as |
---|
97 | tarballs on ftp.gnome.org. The (*)ed packages are available in Ximian |
---|
98 | GNOME ( http://www.ximian.com/desktop/ ). Other packages may be |
---|
99 | available from the Ximian GNOME evolution preview mirror. |
---|
100 | |
---|
101 | If installing from packages, remember that you need both the runtime |
---|
102 | and -devel packages for each library. |
---|
103 | |
---|
104 | - xml-i18n-tools - latest from xml-i18n-tools-stable-1-x branch in |
---|
105 | GNOME CVS (0.8.2 is too old) |
---|
106 | |
---|
107 | - scrollkeeper - 0.1.4 or later (*) |
---|
108 | |
---|
109 | - gnome-xml - 1.8.10 or later in the 1.0 series, but not from the 2.0 |
---|
110 | series (If you get this from GNOME CVS, use the tag "LIB_XML_1_BRANCH".) |
---|
111 | (*) |
---|
112 | |
---|
113 | - gnome-print - 0.25 or later (*) |
---|
114 | |
---|
115 | - gdk-pixbuf - 0.9.0 or later (*) |
---|
116 | |
---|
117 | - ORBit - 0.5.8 or later (*) (If you get this from GNOME CVS, use the |
---|
118 | tag "orbit-stable-0-5".) |
---|
119 | |
---|
120 | - oaf - 0.6.2 or later (If you get this from GNOME CVS, use the tag |
---|
121 | "oaf-stable-0-6") |
---|
122 | |
---|
123 | *** If you are using oaf from CVS, you should use the flag |
---|
124 | *** "--disable-more-warnings" when configure, or it may fail to |
---|
125 | *** build. |
---|
126 | |
---|
127 | - gnome-vfs - 1.0.0 or later (If you get this from GNOME CVS, use |
---|
128 | the tag "gnome-vfs-1-0") |
---|
129 | |
---|
130 | *** If you are using gnome-vfs from CVS, you should use the flag |
---|
131 | *** "--disable-more-warnings" when configuring, or it may fail to |
---|
132 | *** build. |
---|
133 | |
---|
134 | - libglade - 0.14 or later |
---|
135 | |
---|
136 | - bonobo - 1.0.3 or later |
---|
137 | |
---|
138 | *** Note that bonobo must be installed with the same --prefix as |
---|
139 | *** either gnome-libs or evolution for the Makefiles to work |
---|
140 | *** properly. |
---|
141 | |
---|
142 | - gal (GNOME Application Library) - 0.18.1 or later |
---|
143 | |
---|
144 | - gtkhtml - later than 0.16.1 |
---|
145 | |
---|
146 | Other non-GNOME Dependencies: |
---|
147 | |
---|
148 | - Berkeley's libdb - 3.1.17 |
---|
149 | |
---|
150 | db3 is available from http://www.sleepycat.com. Make sure to get |
---|
151 | 3.1.17, it isn't the latest version. |
---|
152 | |
---|
153 | |
---|
154 | COMPILING BERKELEY DB |
---|
155 | --------------------- |
---|
156 | |
---|
157 | If you don't have 3.1.17 installed on your system or Evolution doesn't |
---|
158 | detect it for some reason, here is a way to get Evolution to link to |
---|
159 | it without messing up your system installation. |
---|
160 | |
---|
161 | * Get the Sleepycat tarball from: |
---|
162 | |
---|
163 | http://www.sleepycat.com/update/3.1.17/db-3.1.17.tar.gz |
---|
164 | |
---|
165 | * Install the content somewhere _other_ than the evolution source tree. |
---|
166 | e.g: NOT evolution/db-3.1.17 |
---|
167 | |
---|
168 | * Compile according to instructions, but installing into some custom |
---|
169 | prefix, for example: |
---|
170 | |
---|
171 | ../dist/configure --prefix=/home/user/berkeleydb-3.1.17 |
---|
172 | |
---|
173 | * Autogen Evolution specifying that it has to look for the DB |
---|
174 | library there, for example: |
---|
175 | |
---|
176 | ./autogen.sh --prefix=/opt/gnome |
---|
177 | --with-db3-includes=/home/user/berkeleydb-3.1.17/include |
---|
178 | --with-db3-libs=/home/user/berkeleydb-3.1.17/lib |
---|
179 | |
---|
180 | |
---|
181 | COMPILING PALM PILOT SUPPORT |
---|
182 | ---------------------------- |
---|
183 | |
---|
184 | If you want support for PalmPilot syncing (currently experimental so |
---|
185 | please back up your pilot) you will also need to do the following: |
---|
186 | |
---|
187 | 1) pilot-link 0.9.5 |
---|
188 | http://www.pilot-link.org |
---|
189 | |
---|
190 | 2) gnome-pilot 0.1.61 |
---|
191 | http://www.eskil.org/gnome-pilot/ |
---|
192 | |
---|
193 | 3) evolution |
---|
194 | In your evolution source directory do ./autogen.sh --prefix=<evo-prefix> |
---|
195 | --with-pisock=<pilot-link-prefix> --enable-pilot-conduits=yes |
---|
196 | make |
---|
197 | make install |
---|
198 | |
---|
199 | |
---|
200 | SSL SUPPORT |
---|
201 | ----------- |
---|
202 | |
---|
203 | If you want SSL support (and someday S/MIME), you will also need libnspr4 and |
---|
204 | libnss3 which can be found at http://www.mozilla.org. |
---|
205 | |
---|
206 | Once you have libnspr4 and libnss3 (and their respective includes) installed, |
---|
207 | in your evolution source directory do: |
---|
208 | ./autogen.sh --prefix=<evo-prefix> --with-nspr-includes=<nspr-includes-prefix> |
---|
209 | --with-nspr-libs=<nspr-libs-prefix> --with-nss-includes=<nss-includes-prefix> |
---|
210 | --with-nss-libs=<nss-libs-prefix> |
---|
211 | |
---|
212 | NEWSGROUP (NNTP) SUPPORT |
---|
213 | ------------------------ |
---|
214 | |
---|
215 | Experimental support for NNTP is enabled if you use the --enable-nntp |
---|
216 | configure option, but it's currently unmaintained and highly unstable |
---|
217 | and experimental. |
---|