source: gnome/platform/folks.xml@ 44621c7

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 44621c7 was 44621c7, checked in by Douglas R. Reno <renodr@…>, 22 months ago

Update to tracker-miners-2.3.2
Update to tracker-2.3.2
Update to dconf-editor-3.34.4
Update to evolution-data-server-3.34.4
folks: restore test suite instructions
Finish tagging the GNOME libraries.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22760 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
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 folks-download-http "&gnome-download-http;/folks/0.13/folks-&folks-version;.tar.xz">
8 <!ENTITY folks-download-ftp "&gnome-download-ftp;/folks/0.13/folks-&folks-version;.tar.xz">
9 <!ENTITY folks-md5sum "e9e8d37bbd2b6405c5d23269d9df2d49">
10 <!ENTITY folks-size "512 KB">
11 <!ENTITY folks-buildsize "42 MB (add 18 MB for tests)">
12 <!ENTITY folks-time "0.2 SBU (Using parallelism=4i, add 1.0 SBU for tests)">
13]>
14
15<sect1 id="folks" xreflabel="Folks-&folks-version;">
16 <?dbhtml filename="folks.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Folks-&folks-version;</title>
24
25 <indexterm zone="folks">
26 <primary sortas="a-Folks">Folks</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Folks</title>
31
32 <para>
33 <application>Folks</application> is a library that
34 aggregates people from multiple sources (e.g,
35 <application>Telepathy</application> connection managers and
36 <application>Evolution Data Server</application>,
37 Facebook, etc.) to create metacontacts.
38 </para>
39
40 &lfs91_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&folks-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&folks-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &folks-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &folks-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &folks-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &folks-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Folks Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="evolution-data-server"/>,
81 <xref linkend="gobject-introspection"/>,
82 <xref linkend="libgee"/>,
83 <xref linkend="python-dbusmock"/>, and
84 <xref linkend="telepathy-glib"/>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="bluez"/> and
90 <xref linkend="vala"/>
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="tracker"/> (Broken due to API changes in tracker),
96 <ulink url="&gnome-download-http;/libsocialweb/">libsocialweb</ulink>, and
97 <ulink url="https://packages.debian.org/jessie/zeitgeist">Zeitgeist</ulink>
98 </para>
99
100 <para condition="html" role="usernotes">User Notes:
101 <ulink url="&blfs-wiki;/folks"/>
102 </para>
103 </sect2>
104
105 <sect2 role="installation">
106 <title>Installation of Folks</title>
107
108 <para>
109 Install <application>Folks</application> by running the following
110 commands:
111 </para>
112
113<screen><userinput>mkdir build &amp;&amp;
114cd build &amp;&amp;
115
116meson --prefix=/usr --sysconfdir=/etc .. &amp;&amp;
117ninja</userinput></screen>
118
119 <para>
120 To test the results, issue <command>ninja test</command> from a local
121 X session started with <command>dbus-launch</command>.
122 </para>
123 <!--
124 As of version 0.13.1, I just get 'No tests defined. - Bruce
125 -->
126 <!-- with 0.13.2, I get the following results:
127 Ok: 44
128 Expected Fail: 0
129 Fail: 0
130 Unexpected Pass: 0
131 Skipped: 0
132 Timeout: 0
133 I believe it now has the test suite again. -->
134
135 <!-- In the future, we need to run the tests with Tracker's backend
136 enabled before we suggest enabling that backend. I tried this with 0.12.1
137 and had 103 test failures in Tracker's section of the test suite.
138 This is unacceptable and is why we have it disabled by default. -->
139 <!--<para>This package does not come with a test suite.</para>-->
140
141 <para>
142 Now, as the <systemitem class="username">root</systemitem> user:
143 </para>
144
145<screen role="root"><userinput>ninja install</userinput></screen>
146
147 </sect2>
148
149 <sect2 role="commands">
150 <title>Command Explanations</title>
151
152 <para>
153 <option>-Dtracker_backend=true</option>: This switch enables
154 building the <application>Tracker</application> backend.
155 Use it if you have <application>Tracker</application> installed. This
156 functionality is current broken, however, due to an upstream API change
157 in Tracker that hasn't been accounted for in this package.
158 </para>
159
160 <para>
161 <option>-Ddocs=true</option>: This switch enables
162 documentation generation.
163 </para>
164
165 </sect2>
166
167 <sect2 role="content">
168 <title>Contents</title>
169
170 <segmentedlist>
171 <segtitle>Installed Programs</segtitle>
172 <segtitle>Installed Libraries</segtitle>
173 <segtitle>Installed Directories</segtitle>
174
175 <seglistitem>
176 <seg>
177 folks-import and folks-inspect
178 </seg>
179 <seg>
180 libfolks-dummy.so, libfolks-eds.so, libfolks.so, and
181 libfolks-telepathy.so
182 </seg>
183 <seg>
184 /usr/include/folks and
185 /usr/lib/folks
186 </seg>
187 </seglistitem>
188 </segmentedlist>
189
190 <variablelist>
191 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
192 <?dbfo list-presentation="list"?>
193 <?dbhtml list-presentation="table"?>
194
195 <varlistentry id="folks-import">
196 <term><command>folks-import</command></term>
197 <listitem>
198 <para>
199 is used to import meta-contact information to libfolks.
200 </para>
201 <indexterm zone="folks folks-import">
202 <primary sortas="b-folks-import">folks-import</primary>
203 </indexterm>
204 </listitem>
205 </varlistentry>
206
207 <varlistentry id="folks-inspect">
208 <term><command>folks-inspect</command></term>
209 <listitem>
210 <para>
211 is used to inspect meta-contact information in libfolks.
212 </para>
213 <indexterm zone="folks folks-inspect">
214 <primary sortas="b-folks-inspect">folks-inspect</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="libfolks-eds">
220 <term><filename class="libraryfile">libfolks-eds.so</filename></term>
221 <listitem>
222 <para>
223 contains Evolution specific implementations of the libfolks classes.
224 </para>
225 <indexterm zone="folks libfolks-eds">
226 <primary sortas="c-libfolks-eds">libfolks-eds.so</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231<!--
232 <varlistentry id="libfolks-libsocialweb">
233 <term><filename class="libraryfile">libfolks-libsocialweb.so</filename></term>
234 <listitem>
235 <para>
236 contains libsocialweb specific implementations of the libfolks classes.
237 </para>
238 <indexterm zone="folks libfolks-libsocialweb">
239 <primary sortas="c-libfolks-libsocialweb">libfolks-libsocialweb.so</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243-->
244
245 <varlistentry id="libfolks">
246 <term><filename class="libraryfile">libfolks.so</filename></term>
247 <listitem>
248 <para>
249 contains the <application>Folks</application> API functions.
250 </para>
251 <indexterm zone="folks libfolks">
252 <primary sortas="c-libfolks">libfolks.so</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="libfolks-telepathy">
258 <term><filename class="libraryfile">libfolks-telepathy.so</filename></term>
259 <listitem>
260 <para>
261 contains Telepathy specific implementations of the libfolks classes.
262 </para>
263 <indexterm zone="folks libfolks-telepathy">
264 <primary sortas="c-libfolks-telepathy">libfolks-telepathy.so</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268<!--
269 <varlistentry id="libfolks-tracker">
270 <term><filename class="libraryfile">libfolks-tracker.so</filename></term>
271 <listitem>
272 <para>
273 contains Tracker specific implementations of the libfolks classes.
274 </para>
275 <indexterm zone="folks libfolks-tracker">
276 <primary sortas="c-libfolks-tracker">libfolks-tracker.so</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280-->
281
282 </variablelist>
283
284 </sect2>
285
286</sect1>
Note: See TracBrowser for help on using the repository browser.