source: gnome/platform/tracker3.xml@ 4e707ac

lazarus trunk
Last change on this file since 4e707ac was 4e707ac, checked in by Douglas R. Reno <renodr@…>, 6 weeks ago

Update to tracker and tracker-miners 3.7.2.
  • Property mode set to 100644
File size: 10.4 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 tracker3-download-http
8 "&gnome-download-http;/tracker/3.7/tracker-&tracker3-version;.tar.xz">
9 <!ENTITY tracker3-download-ftp " ">
10 <!ENTITY tracker3-md5sum "5f15dfe3b50e17b5baf62dc8aebb7be3">
11 <!ENTITY tracker3-size "1.7 MB">
12 <!ENTITY tracker3-buildsize "58 MB (with tests)">
13 <!ENTITY tracker3-time "0.4 SBU (with tests)">
14]>
15
16<sect1 id="tracker3" xreflabel="Tracker-&tracker3-version;">
17 <?dbhtml filename="tracker3.html"?>
18
19
20 <title>Tracker-&tracker3-version;</title>
21
22 <indexterm zone="tracker3">
23 <primary sortas="a-Tracker3">Tracker3</primary>
24 </indexterm>
25
26 <sect2 role="package">
27 <title>Introduction to Tracker</title>
28
29 <para>
30 <application>Tracker</application> is the file indexing and search
31 provider used in the <application>GNOME</application> desktop environment.
32 </para>
33
34 &lfs121_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&tracker3-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&tracker3-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &tracker3-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &tracker3-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &tracker3-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &tracker3-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70<!-- Not needed with 3.0.3, but keep around just in case
71 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>
75 Required patch:
76 <ulink url="&patch-root;/tracker-&tracker3-version;-upstream_fixes-1.patch"/>
77 </para>
78 </listitem>
79 </itemizedlist>
80-->
81
82 <bridgehead renderas="sect3">Tracker Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="json-glib"/>,
87 <xref linkend="libseccomp"/>, and
88 <xref linkend="vala"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 &gobject-introspection;,
94 <xref linkend="icu"/>,
95 <xref linkend="libsoup3"/>,
96 <xref linkend="pygobject3"/>,
97 <xref linkend="sqlite"/>, and
98 <xref linkend="tracker3-miners"/> (runtime)
99 </para>
100
101 <bridgehead renderas="sect4">Optional</bridgehead>
102 <para role="optional">
103 <xref linkend="asciidoc"/>,
104 <xref linkend="avahi"/>,
105<!-- It looks like not used even if docs=true,
106 the pre-built doc is shipped in tarball and will be installed
107 <xref linkend="gi-docgen"/>
108-->
109 <xref linkend="graphviz"/>,
110 <xref linkend="libsoup"/>,
111 <ulink url="https://github.com/scop/bash-completion/">bash-completion</ulink>, and
112 <ulink url="https://github.com/snowballstem/snowball/">libstemmer</ulink>
113 <!--<ulink url="https://pypi.python.org/pypi/tap.py/">tap.py</ulink>
114 (for tests)-->
115 </para>
116
117 </sect2>
118
119 <sect2 role="installation">
120 <title>Installation of Tracker</title>
121
122 <para>
123 Fix the location to install the documentation into:
124 </para>
125
126<screen><userinput>mv docs/reference/libtracker-sparql/doc/{Tracker-3.0,tracker-&tracker3-version;} &amp;&amp;
127sed '/docs_name/s/Tracker-3.0/tracker-&tracker3-version;/' \
128 -i docs/reference/libtracker-sparql/meson.build</userinput></screen>
129
130 <!-- https://gitlab.gnome.org/GNOME/tracker/-/merge_requests/665
131 <para>
132 Adapt for a behavior change of SQLite 3.45.3:
133 </para>
134
135 <screen><userinput>sed 's/ROWID/\\"rdfs:Resource\\".ID/' \
136 -i src/libtracker-sparql/core/tracker-fts.c</userinput></screen>
137 -->
138
139 <para>
140 Install <application>Tracker</application> by running the following
141 commands:
142 </para>
143
144<screen revision="systemd"><userinput>mkdir build &amp;&amp;
145cd build &amp;&amp;
146
147meson setup --prefix=/usr \
148 --buildtype=release \
149 -Dman=false \
150 .. &amp;&amp;
151ninja</userinput></screen>
152
153<screen revision="sysv"><userinput>mkdir build &amp;&amp;
154cd build &amp;&amp;
155
156meson setup --prefix=/usr \
157 --buildtype=release \
158 -Dman=false \
159 -Dsystemd_user_services=false \
160 .. &amp;&amp;
161ninja</userinput></screen>
162
163 <para>
164 Now, as the <systemitem class="username">root</systemitem> user:
165 </para>
166
167<screen role="root"><userinput>ninja install</userinput></screen>
168
169 <para>
170 To test the results, issue: <command>meson configure -Ddebug=true
171 &amp;&amp; ninja test</command>.
172 The test suite should be run from a graphical session. <!--One test,
173 <filename>tracker: fts / fts</filename>, is known to fail due to an
174 incompatibility with SQLite-3.42.-->
175 </para>
176
177 </sect2>
178
179
180 <sect2 role="commands">
181 <title>Command Explanations</title>
182
183 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
184 href="../../xincludes/meson-buildtype-release.xml"/>
185
186 <para>
187 <parameter>-Dman=false</parameter>: This switch prevents the build
188 process from generating man pages. Omit this switch if you have
189 <xref linkend="asciidoc" role="nodep"/> installed and wish to generate
190 and install the man pages.
191 </para>
192
193 <para revision="sysv">
194 <parameter>-Dsystemd_user_services=false</parameter>: This switch prevents
195 the build process from installing systemd user services since they are
196 useless on SysV systems.
197 </para>
198
199 <para>
200 <command>meson configure -Ddebug=true</command>: This command enables
201 some debug checks necessary for the test suite. We don't want to
202 enable them for the installed Tracker 3 libraries and programs, so
203 we run the test suite after installation.
204 </para>
205
206 </sect2>
207
208
209 <sect2 role="content">
210 <title>Contents</title>
211
212 <segmentedlist>
213 <segtitle>Installed Programs</segtitle>
214 <segtitle>Installed Library</segtitle>
215 <segtitle>Installed Directories</segtitle>
216
217 <seglistitem>
218 <seg>
219 tracker3,
220 tracker3-endpoint,
221 tracker3-export,
222 tracker3-help,
223 tracker3-import,
224 tracker3-sparql, and
225 tracker3-sql
226 </seg>
227 <seg>
228 libtracker-sparql-3.0.so
229 </seg>
230 <seg>
231 /usr/{include,lib}/tracker-3.0,
232 /usr/libexec/tracker3,
233 /usr/share/tracker3, and
234 /usr/share/doc/tracker-&tracker3-version; (optional)
235 </seg>
236 </seglistitem>
237 </segmentedlist>
238
239 <variablelist>
240 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
241 <?dbfo list-presentation="list"?>
242 <?dbhtml list-presentation="table"?>
243
244 <varlistentry id="tracker3-prog">
245 <term><command>tracker3</command></term>
246 <listitem>
247 <para>
248 is a control program for the indexer
249 </para>
250 <indexterm zone="tracker3 tracker3-prog">
251 <primary sortas="b-tracker3">tracker3</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="tracker3-endpoint">
257 <term><command>tracker3-endpoint</command></term>
258 <listitem>
259 <para>
260 creates a SPARQL endpoint
261 </para>
262 <indexterm zone="tracker3 tracker3-endpoint">
263 <primary sortas="b-tracker3-endpoint">tracker3-endpoint</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="tracker3-export">
269 <term><command>tracker3-export</command></term>
270 <listitem>
271 <para>
272 exports all data from a Tracker database
273 </para>
274 <indexterm zone="tracker3 tracker3-export">
275 <primary sortas="b-tracker3-export">tracker3-export</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="tracker3-help">
281 <term><command>tracker3-help</command></term>
282 <listitem>
283 <para>
284 shows manual pages related to Tracker
285 </para>
286 <indexterm zone="tracker3 tracker3-help">
287 <primary sortas="b-tracker3-help">tracker3-help</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="tracker3-import">
293 <term><command>tracker3-import</command></term>
294 <listitem>
295 <para>
296 imports data into a Tracker database
297 </para>
298 <indexterm zone="tracker3 tracker3-import">
299 <primary sortas="b-tracker3-import">tracker3-import</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="tracker3-sparql">
305 <term><command>tracker3-sparql</command></term>
306 <listitem>
307 <para>
308 uses SparQL to query a Tracker database
309 </para>
310 <indexterm zone="tracker3 tracker3-sparql">
311 <primary sortas="b-tracker3-sparql">tracker3-sparql</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="tracker3-sql">
317 <term><command>tracker3-sql</command></term>
318 <listitem>
319 <para>
320 uses SQL to query a Tracker database
321 </para>
322 <indexterm zone="tracker3 tracker3-sql">
323 <primary sortas="b-tracker3-sql">tracker3-sql</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="libtracker3-sparql">
329 <term><filename class="libraryfile">libtracker-sparql-3.0.so</filename></term>
330 <listitem>
331 <para>
332 contains resource management and database functions
333 </para>
334 <indexterm zone="tracker3 libtracker3-sparql">
335 <primary sortas="c-libtracker3-sparql">libtracker-sparql-3.0.so</primary>
336 </indexterm>
337 </listitem>
338 </varlistentry>
339
340 </variablelist>
341
342 </sect2>
343
344</sect1>
Note: See TracBrowser for help on using the repository browser.