source: gnome/platform/folks.xml@ 503aae47

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 503aae47 was 503aae47, checked in by Xi Ruoyao <xry111@…>, 2 years ago

folks: python 2 is not necessary

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

  • Property mode set to 100644
File size: 8.5 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 "0038ec90db52ed7a82c93d98e227b078">
10 <!ENTITY folks-size "504 KB">
11 <!ENTITY folks-buildsize "28 MB">
12 <!ENTITY folks-time "0.1 SBU (Using parallelism=4)">
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 eventually <application>Evolution Data Server</application>,
37 Facebook, etc.) to create metacontacts.
38 </para>
39
40 &lfs90_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<!-- one file "tests/tools/manager-file.py" is still P2 but it's not invoked -->
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
120
121<!--
122 <para>
123 To test the results, issue <command>ninja test</command> from a local
124 X session started with <command>dbus-launch</command>.
125
126 As of version 0.13.1, I just get 'No tests defined. - Bruce
127 -->
128 <!-- In the future, we need to run the tests with Tracker's backend
129 enabled before we suggest enabling that backend. I tried this with 0.12.1
130 and had 103 test failures in Tracker's section of the test suite.
131 This is unacceptable and is why we have it disabled by default. -->
132 <para>This package does not come with a test suite.
133 </para>
134
135 <para>
136 Now, as the <systemitem class="username">root</systemitem> user:
137 </para>
138
139<screen role="root"><userinput>ninja install</userinput></screen>
140
141 </sect2>
142
143 <sect2 role="commands">
144 <title>Command Explanations</title>
145
146 <para>
147 <option>-Dtracker_backend=true</option>: This switch enables
148 building the <application>Tracker</application> backend.
149 Use it if you have <application>Tracker</application> installed. This
150 functionality is current broken, however, due to an upstream API change
151 in Tracker that hasn't been accounted for in this package.
152 </para>
153
154 <para>
155 <option>-Ddocs=true</option>: This switch enables
156 documentation generation.
157 </para>
158
159 </sect2>
160
161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Programs</segtitle>
166 <segtitle>Installed Libraries</segtitle>
167 <segtitle>Installed Directories</segtitle>
168
169 <seglistitem>
170 <seg>
171 folks-import and folks-inspect
172 </seg>
173 <seg>
174 libfolks-dummy.so, libfolks-eds.so, libfolks.so, and
175 libfolks-telepathy.so
176 </seg>
177 <seg>
178 /usr/include/folks and
179 /usr/lib/folks
180 </seg>
181 </seglistitem>
182 </segmentedlist>
183
184 <variablelist>
185 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
186 <?dbfo list-presentation="list"?>
187 <?dbhtml list-presentation="table"?>
188
189 <varlistentry id="folks-import">
190 <term><command>folks-import</command></term>
191 <listitem>
192 <para>
193 is used to import meta-contact information to libfolks.
194 </para>
195 <indexterm zone="folks folks-import">
196 <primary sortas="b-folks-import">folks-import</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="folks-inspect">
202 <term><command>folks-inspect</command></term>
203 <listitem>
204 <para>
205 is used to inspect meta-contact information in libfolks.
206 </para>
207 <indexterm zone="folks folks-inspect">
208 <primary sortas="b-folks-inspect">folks-inspect</primary>
209 </indexterm>
210 </listitem>
211 </varlistentry>
212
213 <varlistentry id="libfolks-eds">
214 <term><filename class="libraryfile">libfolks-eds.so</filename></term>
215 <listitem>
216 <para>
217 contains Evolution specific implementations of the libfolks classes.
218 </para>
219 <indexterm zone="folks libfolks-eds">
220 <primary sortas="c-libfolks-eds">libfolks-eds.so</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225<!--
226 <varlistentry id="libfolks-libsocialweb">
227 <term><filename class="libraryfile">libfolks-libsocialweb.so</filename></term>
228 <listitem>
229 <para>
230 contains libsocialweb specific implementations of the libfolks classes.
231 </para>
232 <indexterm zone="folks libfolks-libsocialweb">
233 <primary sortas="c-libfolks-libsocialweb">libfolks-libsocialweb.so</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237-->
238
239 <varlistentry id="libfolks">
240 <term><filename class="libraryfile">libfolks.so</filename></term>
241 <listitem>
242 <para>
243 contains the <application>Folks</application> API functions.
244 </para>
245 <indexterm zone="folks libfolks">
246 <primary sortas="c-libfolks">libfolks.so</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="libfolks-telepathy">
252 <term><filename class="libraryfile">libfolks-telepathy.so</filename></term>
253 <listitem>
254 <para>
255 contains Telepathy specific implementations of the libfolks classes.
256 </para>
257 <indexterm zone="folks libfolks-telepathy">
258 <primary sortas="c-libfolks-telepathy">libfolks-telepathy.so</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262<!--
263 <varlistentry id="libfolks-tracker">
264 <term><filename class="libraryfile">libfolks-tracker.so</filename></term>
265 <listitem>
266 <para>
267 contains Tracker specific implementations of the libfolks classes.
268 </para>
269 <indexterm zone="folks libfolks-tracker">
270 <primary sortas="c-libfolks-tracker">libfolks-tracker.so</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274-->
275
276 </variablelist>
277
278 </sect2>
279
280</sect1>
Note: See TracBrowser for help on using the repository browser.