source: general/genlib/telepathy-glib.xml@ b80b399

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b80b399 was b80b399, checked in by Ken Moffat <ken@…>, 10 months ago

telepathy-glib:

This needs -i in autoreconf, so require gtk-doc.
Also fix one test where /usr/bin/python is hard-coded.

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

  • Property mode set to 100644
File size: 6.7 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 telepathy-glib-download-http
8 "https://telepathy.freedesktop.org/releases/telepathy-glib/telepathy-glib-&telepathy-glib-version;.tar.gz">
9 <!ENTITY telepathy-glib-download-ftp " ">
10 <!ENTITY telepathy-glib-md5sum "cbeb0a24acc26e7f095be281c324da69">
11 <!ENTITY telepathy-glib-size "3.8 MB">
12 <!ENTITY telepathy-glib-buildsize "222 MB">
13 <!ENTITY telepathy-glib-time "1.2 SBU">
14]>
15
16<sect1 id="telepathy-glib" xreflabel="telepathy-glib-&telepathy-glib-version;">
17 <?dbhtml filename="telepathy-glib.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>telepathy-glib-&telepathy-glib-version;</title>
25
26 <indexterm zone="telepathy-glib">
27 <primary sortas="a-telepathy-glib">telepathy-glib</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Telepathy GLib</title>
32
33 <para>
34 The <application>Telepathy GLib</application> contains a library used by
35 <application>GLib</application> based <application>Telepathy</application>
36 components. Telepathy is a <application>D-Bus</application> framework for
37 unifying real time communication, including instant messaging, voice calls
38 and video calls. It abstracts differences between protocols to provide a
39 unified interface for applications.
40 </para>
41
42 &lfs10_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&telepathy-glib-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&telepathy-glib-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &telepathy-glib-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &telepathy-glib-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &telepathy-glib-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &telepathy-glib-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>
82 Required patch:
83 <ulink url="&patch-root;/telepathy-glib-&telepathy-glib-version;-consolidated_fixes-1.patch"/>
84 </para>
85 </listitem>
86 </itemizedlist>
87
88 <bridgehead renderas="sect3">Telepathy GLib Dependencies</bridgehead>
89
90 <bridgehead renderas="sect4">Required</bridgehead>
91 <para role="required">
92 <xref linkend="dbus-glib"/>,
93 <xref linkend="gtk-doc"/> (required for autoreconf) and
94 <xref linkend="libxslt"/>
95 </para>
96
97
98 <bridgehead renderas="sect4">Recommended</bridgehead>
99 <para role="recommended">
100 <xref linkend="gobject-introspection"/>, and
101 <xref linkend="vala"/>
102 </para>
103
104<!--<bridgehead renderas="sect4">Optional</bridgehead>
105 <para role="optional">
106 <xref linkend="gtk-doc"/>
107 </para>-->
108
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url="&blfs-wiki;/telepathy-glib"/>
111 </para>
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of Telepathy Glib</title>
116
117 <para>
118 First, apply a patch to fix several bugs discovered after
119 release:
120 </para>
121
122<screen><userinput remap="pre">patch -Np1 -i ../telepathy-glib-&telepathy-glib-version;-consolidated_fixes-1.patch</userinput></screen>
123
124 <para>
125 If you intend to run the tests, one of them defaults to invoking
126 <filename>/usr/bin/python</filename> and fails if it is absent, causing
127 the second batch of tests to not run - unlike the other tests which can be
128 overridden from the environment. Fix it with the following command:
129 </para>
130
131<screen><userinput>sed -i 's%/usr/bin/python%&amp;3%' tests/all-errors-documented.py</userinput></screen>
132
133 <para>
134 Install <application>Telepathy GLib</application> by running the
135 following commands:
136 </para>
137
138<screen><userinput>autoreconf -fiv &amp;&amp;
139
140PYTHON=/usr/bin/python3 ./configure --prefix=/usr \
141 --enable-vala-bindings \
142 --disable-static &amp;&amp;
143make</userinput></screen>
144
145 <para>
146 To test the results, issue: <command>make check</command>.
147 <!--Four tests are known to fail: <emphasis>test-account</emphasis>,
148 <emphasis>test-cm</emphasis>, <emphasis>test-contact-lists</emphasis>, and
149 <emphasis>test-contact-list-client</emphasis>.-->
150 </para>
151
152 <para>
153 Now, as the <systemitem class="username">root</systemitem> user:
154 </para>
155
156<screen role="root"><userinput>make install</userinput></screen>
157
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <para>
164 <parameter>--enable-vala-bindings</parameter>: This switch
165 enables building of the Vala bindings. Remove if you don't
166 have <xref linkend="vala"/> installed.
167 </para>
168
169 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
170 href="../../xincludes/static-libraries.xml"/>
171
172 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
173 href="../../xincludes/gtk-doc-rebuild.xml"/>
174
175 </sect2>
176
177 <sect2 role="content">
178 <title>Contents</title>
179
180 <segmentedlist>
181 <segtitle>Installed Programs</segtitle>
182 <segtitle>Installed Libraries</segtitle>
183 <segtitle>Installed Directories</segtitle>
184
185 <seglistitem>
186 <seg>
187 None
188 </seg>
189 <seg>
190 libtelepathy-glib.so
191 </seg>
192 <seg>
193 /usr/include/telepathy-1.0 and
194 /usr/share/gtk-doc/html/telepathy-glib
195 </seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="libtelepathy-glib">
205 <term><filename class="libraryfile">libtelepathy-glib.so</filename></term>
206 <listitem>
207 <para>
208 contains the <application>Telepathy GLib</application> API functions.
209 </para>
210 <indexterm zone="telepathy-glib libtelepathy-glib">
211 <primary sortas="c-libtelepathy-glib">libtelepathy-glib.so</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 </variablelist>
217
218 </sect2>
219
220</sect1>
Note: See TracBrowser for help on using the repository browser.