source: gnome/platform/evolution-data-server.xml

trunk
Last change on this file was 43b45a17, checked in by Douglas R. Reno <renodr@…>, 10 days ago

Update to evolution-data-server-3.52.0
  • Property mode set to 100644
File size: 13.9 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY evolution-data-server-download-http
8 "&gnome-download-http;/evolution-data-server/&gnome-minor-52;/evolution-data-server-&evolution-data-server-version;.tar.xz">
9 <!ENTITY evolution-data-server-download-ftp " ">
10 <!ENTITY evolution-data-server-md5sum "8d6d370f54b5dbdd0d95adf98ca42b0c">
11 <!ENTITY evolution-data-server-size "4.8 MB">
12 <!ENTITY evolution-data-server-buildsize "181 MB (with tests)">
13 <!ENTITY evolution-data-server-time "0.7 SBU (using parallelism=4)">
14]>
15
16<sect1 id="evolution-data-server"
17xreflabel="evolution-data-server-&evolution-data-server-version;">
18 <?dbhtml filename="evolution-data-server.html"?>
19
20
21 <title>evolution-data-server-&evolution-data-server-version;</title>
22
23 <indexterm zone="evolution-data-server">
24 <primary sortas="a-evolution-data-server">evolution-data-server</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to Evolution Data Server</title>
29
30 <para>
31 The <application>Evolution Data Server</application> package provides
32 a unified backend for programs that work with contacts, tasks, and calendar
33 information. It was originally developed for
34 <application>Evolution</application> (hence the name), but is now used by
35 other packages as well.
36 </para>
37
38 &lfs121_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&evolution-data-server-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&evolution-data-server-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &evolution-data-server-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &evolution-data-server-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &evolution-data-server-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &evolution-data-server-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Evolution Data Server Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="libical"/>,
79 <xref linkend="libsecret"/>,
80 <xref linkend="nss"/>, and
81 <xref linkend="sqlite"/>
82 </para>
83
84 <bridgehead renderas="sect4">Recommended</bridgehead>
85 <para role="recommended">
86 <xref linkend="gnome-online-accounts"/>,
87 &gobject-introspection;,
88 <xref linkend="gtk3"/>,
89 <xref linkend="gtk4"/>,
90 <xref linkend="icu"/>,
91 <xref linkend="libcanberra"/>,
92 <xref linkend="libgweather"/>,
93 <xref linkend="vala"/>, and
94 <xref linkend="webkitgtk"/>
95 </para>
96
97 <bridgehead renderas="sect4"
98 revision="sysv">Recommended (Runtime)</bridgehead>
99 <para role="recommended" revision="sysv">
100 <xref linkend="blocaled" role="runtime"/>
101 </para>
102
103 <bridgehead renderas="sect4">Optional</bridgehead>
104 <para role="optional">
105 <xref linkend="gtk-doc"/>,
106 <xref linkend="mitkrb"/>,
107 a <xref linkend="server-mail"/> (that provides a <command>sendmail</command> command),
108 <xref linkend="openldap"/>,
109 &berkeley-db;, and
110 <ulink url="https://github.com/googlei18n/libphonenumber/">libphonenumber</ulink>
111 </para>
112
113 </sect2>
114
115 <sect2 role="installation">
116 <title>Installation of Evolution Data Server</title>
117
118<!-- Fixed in 3.50.2
119 <para>
120 First, fix a build failure when using libxml2-2.12.x:
121 </para>
122
123<screen><userinput remap="pre">sed -i '/xpathInternals.h/a #include &lt;libxml/globals.h&gt;' src/libedataserver/e-xml-utils.c</userinput></screen>
124-->
125
126 <para>
127 Install <application>Evolution Data Server</application> by running
128 the following commands:
129 </para>
130
131<screen revision="sysv"><userinput>mkdir build &amp;&amp;
132cd build &amp;&amp;
133
134cmake -DCMAKE_INSTALL_PREFIX=/usr \
135 -DSYSCONF_INSTALL_DIR=/etc \
136 -DENABLE_VALA_BINDINGS=ON \
137 -DENABLE_INSTALLED_TESTS=ON \
138 -DWITH_OPENLDAP=OFF \
139 -DWITH_KRB5=OFF \
140 -DENABLE_INTROSPECTION=ON \
141 -DENABLE_GTK_DOC=OFF \
142 -DWITH_LIBDB=OFF \
143 -DWITH_SYSTEMDUSERUNITDIR=no \
144 -Wno-dev -G Ninja .. &amp;&amp;
145ninja</userinput></screen>
146
147<screen revision="systemd"><userinput>mkdir build &amp;&amp;
148cd build &amp;&amp;
149
150cmake -DCMAKE_INSTALL_PREFIX=/usr \
151 -DSYSCONF_INSTALL_DIR=/etc \
152 -DENABLE_VALA_BINDINGS=ON \
153 -DENABLE_INSTALLED_TESTS=ON \
154 -DWITH_OPENLDAP=OFF \
155 -DWITH_KRB5=OFF \
156 -DENABLE_INTROSPECTION=ON \
157 -DENABLE_GTK_DOC=OFF \
158 -DWITH_LIBDB=OFF \
159 -Wno-dev -G Ninja .. &amp;&amp;
160ninja</userinput></screen>
161
162 <para>
163 Now, as the <systemitem class="username">root</systemitem> user:
164 </para>
165
166<screen role="root"><userinput>ninja install</userinput></screen>
167
168 <para>
169 To test the results, issue: <command>ninja test</command>.
170 </para>
171
172 <!-- The tests need to be run after the package is installed due to
173 compatibility issues that show up when upgrading from previous versions
174 of e-d-s. This is due to soup2/soup3 mixing. -->
175
176 </sect2>
177
178 <sect2 role="commands">
179 <title>Command Explanations</title>
180
181 <para>
182 <parameter>-DENABLE_VALA_BINDINGS=ON</parameter>: This switch
183 enables building the Vala bindings. Remove it if you don't
184 have <xref linkend="vala"/> installed.
185 </para>
186
187 <para>
188 <parameter>-DENABLE_GTK_DOC=OFF</parameter>: This switch
189 disables building the API documentation. It is broken for
190 this package due to the use of a long deprecated gtk-doc program
191 that is no longer available.
192 </para>
193
194 <para>
195 <parameter>-DWITH_LIBDB=OFF</parameter>: This switch allows building
196 this package without &berkeley-db;. <!--This package only uses
197 &berkeley-db; to import data from very outdated releases.-->
198 <xref linkend="sqlite"/> is used for normal operation.
199 </para>
200
201 <para>
202 <option>-DENABLE_OAUTH2_WEBKITGTK4=OFF</option>: Use this switch if
203 you did not build <xref linkend="webkitgtk" role="nodep"/> with GTK-4.
204 </para>
205
206 <para revision="sysv">
207 <parameter>-DWITH_SYSTEMDUSERUNITDIR=no</parameter>: This switch
208 disables installing the systemd units, which are not used for a Sysv
209 build.
210 </para>
211
212 <note>
213 <para>
214 To enable many of the optional dependencies, review the information
215 from <command>cmake -L CMakeLists.txt</command> for the necessary
216 parameters you must pass to the <command>cmake</command> command.
217 </para>
218 </note>
219
220 </sect2>
221
222 <sect2 role="content">
223 <title>Contents</title>
224
225 <segmentedlist>
226 <segtitle>Installed Programs</segtitle>
227 <segtitle>Installed Libraries</segtitle>
228 <segtitle>Installed Directories</segtitle>
229
230 <seglistitem>
231 <seg>
232 None
233 </seg>
234 <seg>
235 libcamel-1.2.so,
236 libebackend-1.2.so,
237 libebook-1.2.so,
238 libebook-contacts-1.2.so,
239 libecal-2.0.so,
240 libedata-book-1.2.so,
241 libedata-cal-2.0.so,
242 libedataserver-1.2.so,
243 libedataserverui-1.2.so,
244 libedataserverui4-1.0.so,
245 and libetestserverutils.so
246 </seg>
247 <seg>
248 /usr/include/evolution-data-server,
249 /usr/lib{,exec}/evolution-data-server,
250 /usr/share/evolution-data-server,
251 /usr/share/installed-tests/evolution-data-server, and
252 <!-- We explicitly disable gtk-doc generation, so comment these out
253 /usr/share/gtk-doc/html/{camel,libebackend,libebook},
254 /usr/share/gtk-doc/html/{libecal,libedata-book,libedata-cal},
255 /usr/share/gtk-doc/html/{libedataserver,libedataserverui} and
256 -->
257 /usr/share/pixmaps/evolution-data-server
258 </seg>
259 </seglistitem>
260 </segmentedlist>
261
262 <variablelist>
263 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
264 <?dbfo list-presentation="list"?>
265 <?dbhtml list-presentation="table"?>
266
267 <varlistentry id="libcamel-1">
268 <term><filename class="libraryfile">libcamel-1.2.so</filename></term>
269 <listitem>
270 <para>
271 is the <application>Evolution</application> MIME message
272 handling library
273 </para>
274 <indexterm zone="evolution-data-server libcamel-1">
275 <primary sortas="c-libcamel-1">libcamel-1.2.so</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="libebackend-1">
281 <term><filename class="libraryfile">libebackend-1.2.so</filename></term>
282 <listitem>
283 <para>
284 is the utility library for
285 <application>Evolution Data Server</application> Backends
286 </para>
287 <indexterm zone="evolution-data-server libebackend-1">
288 <primary sortas="c-libebackend-1">libebackend-1.2.so</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="libebook-1">
294 <term><filename class="libraryfile">libebook-1.2.so</filename></term>
295 <listitem>
296 <para>
297 is the client library for <application>Evolution</application>
298 address books
299 </para>
300 <indexterm zone="evolution-data-server libebook-1">
301 <primary sortas="c-libebook-1">libebook-1.2.so</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="libebook-contacts-1">
307 <term><filename class="libraryfile">libebook-contacts-1.2.so</filename></term>
308 <listitem>
309 <para>
310 is the client library for <application>Evolution</application>
311 contacts
312 </para>
313 <indexterm zone="evolution-data-server libebook-contacts-1">
314 <primary sortas="c-libebook-contacts-1">libebook-contacts-1.2.so</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="libecal-1">
320 <term><filename class="libraryfile">libecal-1.2.so</filename></term>
321 <listitem>
322 <para>
323 is the client library for <application>Evolution</application>
324 calendars
325 </para>
326 <indexterm zone="evolution-data-server libecal-1">
327 <primary sortas="c-libecal-1">libecal-1.2.so</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="libedata-book-1">
333 <term><filename class="libraryfile">libedata-book-1.2.so</filename></term>
334 <listitem>
335 <para>
336 is the backend library for <application>Evolution</application>
337 address books
338 </para>
339 <indexterm zone="evolution-data-server libedata-book-1">
340 <primary sortas="c-libedata-book-1">libedata-book-1.2.so</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 <varlistentry id="libedata-cal-1">
346 <term><filename class="libraryfile">libedata-cal-1.2.so</filename></term>
347 <listitem>
348 <para>
349 is the backend library for <application>Evolution</application>
350 calendars
351 </para>
352 <indexterm zone="evolution-data-server libedata-cal-1">
353 <primary sortas="c-libedata-cal-1">libedata-cal-1.2.so</primary>
354 </indexterm>
355 </listitem>
356 </varlistentry>
357
358 <varlistentry id="libedataserver-1">
359 <term><filename class="libraryfile">libedataserver-1.2.so</filename></term>
360 <listitem>
361 <para>
362 is the utility library for
363 <application>Evolution Data Server</application>
364 </para>
365 <indexterm zone="evolution-data-server libedataserver-1">
366 <primary sortas="c-libedataserver-1">libedataserver-1.2.so</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370
371 <varlistentry id="libedataserverui-3">
372 <term><filename class="libraryfile">libedataserverui-3.0.so</filename></term>
373 <listitem>
374 <para>
375 is the GUI utility library for
376 <application>Evolution Data Server</application>
377 </para>
378 <indexterm zone="evolution-data-server libedataserverui-3">
379 <primary sortas="c-libedataserverui-3">libedataserverui-3.0.so</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="libedataserverui4-1">
385 <term><filename class="libraryfile">libedataserverui4-1.0.so</filename></term>
386 <listitem>
387 <para>
388 is the GTK-4 based GUI utility library for
389 <application>Evolution Data Server</application>
390 </para>
391 <indexterm zone="evolution-data-server libedataserverui4-1">
392 <primary sortas="c-libedataserverui4-1">libedataserverui4-1.0.so</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="libetestserverutils-1">
398 <term><filename class="libraryfile">libetestserverutils.so</filename></term>
399 <listitem>
400 <para>
401 is the server test utility library for
402 <application>Evolution Data Server</application>
403 </para>
404 <indexterm zone="evolution-data-server libetestserverutils-1">
405 <primary sortas="c-libetestserverutils-1">libetestserverutils.so</primary>
406 </indexterm>
407 </listitem>
408 </varlistentry>
409
410
411 </variablelist>
412
413 </sect2>
414
415</sect1>
Note: See TracBrowser for help on using the repository browser.