source: xsoft/other/pidgin.xml@ 761b96b

10.0 10.1 11.0 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 761b96b was 761b96b, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Pidgin-2.10.9 and LXDM-0.5.0: fixes.

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

  • Property mode set to 100644
File size: 10.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 pidgin-download-http "&sourceforge-repo;/pidgin/pidgin-&pidgin-version;.tar.bz2">
8 <!ENTITY pidgin-download-ftp " ">
9 <!ENTITY pidgin-md5sum "10a4a69d077893f6dd3438cd8af94e81">
10 <!ENTITY pidgin-size "9.7 MB">
11 <!ENTITY pidgin-buildsize "238 MB (additional 2MB for the tests and
12 90 MB for API docs)">
13 <!ENTITY pidgin-time "1.7 SBU (additional 0.1 SBU for API docs)">
14]>
15
16<sect1 id="pidgin" xreflabel="Pidgin-&pidgin-version;">
17 <?dbhtml filename="pidgin.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Pidgin-&pidgin-version;</title>
25
26 <indexterm zone="pidgin">
27 <primary sortas="a-Pidgin">Pidgin</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Pidgin</title>
32
33 <para>
34 <application>Pidgin</application> is a Gtk+ 2 instant messaging client
35 that can connect with a wide range of networks including AIM, ICQ,
36 GroupWise, MSN, Jabber, IRC, Napster, Gadu-Gadu, SILC, Zephyr and Yahoo!
37 </para>
38
39 &lfs76_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&pidgin-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&pidgin-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &pidgin-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &pidgin-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &pidgin-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &pidgin-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Pidgin Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="gtk2"/>
80 </para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended">
84 <xref linkend="libgcrypt"/> and
85 <xref linkend="gnutls"/> or
86 <xref linkend="nss"/>
87 </para>
88
89 <para>
90 SSL support is required for the MSN Messenger, Yahoo!, Novel Groupwise and
91 Google Talk protocol plugins. <application>GnuTLS</application> is the
92 preferred method (the Mozilla NSS API is more likely to change and this
93 can cause problems).
94 </para>
95
96 <bridgehead renderas="sect4">Optional</bridgehead>
97 <para role="optional">
98 <xref linkend="avahi"/> (required for the Bonjour plugin),
99 <xref linkend="check"/> (only used during the test suite),
100 <xref linkend="cyrus-sasl"/>,
101 <xref linkend="dbus"/>,
102 <xref linkend="GConf"/>,
103 <xref linkend="libidn"/>,
104 <xref linkend="NetworkManager"/>,
105 <xref linkend="gstreamer"/> (required for audio support),
106 <xref linkend="sqlite"/> (required for the Contact Availability Prediction
107 plugin),
108 <xref linkend="startup-notification"/>,
109 <xref linkend="tcl"/>,
110 <xref linkend="tk"/>,
111 <ulink url="&gnome-download-http;/evolution-data-server/">
112 Evolution Data Server</ulink>,
113 <ulink url="http://www.freedesktop.org/wiki/Software/Farstream">
114 Farstream (Version 0.1)</ulink>
115 (required for video and voice support),
116 <ulink url="http://gtkspell.sourceforge.net/">Gtkspell</ulink>,
117 <ulink url="http://libgadu.net/">libgadu</ulink>,
118 <ulink url="http://meanwhile.sourceforge.net/">Meanwhile</ulink>
119 (required for Sametime protocol support),
120 <ulink url="http://silcnet.org/software/">SILC Client</ulink>,
121 <ulink url="http://silcnet.org/software/">SILC Toolkit</ulink>,
122 <ulink url="http://packages.debian.org/stable/source/zephyr">Zephyr</ulink>, and
123 <xref linkend="mitkrb"/> (required for Kerberos support in the Zephyr
124 module),
125 </para>
126
127 <para condition="html" role="usernotes">
128 User Notes: <ulink url="&blfs-wiki;/pidgin"/>
129 </para>
130 </sect2>
131
132 <sect2 role="installation">
133 <title>Installation of Pidgin</title>
134
135 <para>
136 Compile <application>Pidgin</application> by running the following
137 commands:
138 </para>
139
140<screen><userinput>./configure --prefix=/usr \
141 --sysconfdir=/etc \
142 --disable-avahi \
143 --disable-gtkspell \
144 --disable-gstreamer \
145 --disable-meanwhile \
146 --disable-idn \
147 --disable-nm \
148 --disable-vv \
149 --disable-tcl &amp;&amp;
150make</userinput></screen>
151
152 <para>
153 If you have <xref linkend="doxygen"/> installed
154 (<xref linkend="graphviz"/> can be used also) and you wish to create the
155 API documentation, issue: <command>make docs</command>
156 </para>
157
158 <para>
159 To test the results, issue: <command>make check</command>.
160 </para>
161
162 <para>
163 Now, as the <systemitem class="username">root</systemitem> user:
164 </para>
165
166<screen role="root"><userinput>make install &amp;&amp;
167mkdir -pv /usr/share/doc/pidgin-&pidgin-version; &amp;&amp;
168cp -v README doc/gtkrc-2.0 /usr/share/doc/pidgin-&pidgin-version;</userinput></screen>
169
170 <para>
171 If you created the API documentation, install it using the following
172 commands as the <systemitem class="username">root</systemitem> user:
173 </para>
174
175<screen role="root"><userinput>mkdir -pv /usr/share/doc/pidgin-&pidgin-version;/api &amp;&amp;
176cp -v doc/html/* /usr/share/doc/pidgin-&pidgin-version;/api</userinput></screen>
177
178 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
179 href="../../xincludes/update-icons-and-desktop.xml"/>
180
181 </sect2>
182
183 <sect2 role="commands">
184 <title>Command Explanations</title>
185
186 <para>
187 <option>--disable-avahi</option>: Remove this switch if you've
188 installed <xref linkend="avahi"/>.
189 </para>
190
191 <para>
192 <option>--disable-gtkspell</option>: Spellchecking. Remove this switch if
193 you've installed
194 <ulink url="http://gtkspell.sourceforge.net/">Gtkspell</ulink>.
195 </para>
196
197 <para>
198 <option>--disable-gstreamer</option>: Sounds. Remove this switch if you've
199 installed <xref linkend="gstreamer"/>.
200 </para>
201
202 <para>
203 <option>--disable-meanwhile</option>: Remove this switch if you've
204 installed <ulink url="http://meanwhile.sourceforge.net/">Meanwhile</ulink>.
205 </para>
206
207 <para>
208 <option>--disable-idn</option>: Remove this switch if you've installed
209 <xref linkend="libidn"/>.
210 </para>
211
212 <para>
213 <option>--disable-nm</option>: Remove this switch if you've installed
214 <xref linkend="NetworkManager"/>.
215 </para>
216
217 <para>
218 <option>--disable-vv</option>: Video and voice. Remove this switch if
219 you've installed
220 <ulink url="http://www.freedesktop.org/wiki/Software/Farstream">
221 Farstream (Version 0.1)</ulink>.
222 </para>
223
224 <para>
225 <option>--disable-tcl</option>: Remove this switch if you've installed
226 <xref linkend="tcl"/>.
227 </para>
228
229 <para>
230 <option>--enable-cyrus-sasl</option>: Use this switch if you've installed
231 <xref linkend="cyrus-sasl"/> and wish to build
232 <application>Pidgin</application> with SASL support.
233 </para>
234
235 <para>
236 <option>--disable-gnutls</option>: Use this switch if you've got both
237 <xref linkend="gnutls"/> and <xref linkend="nss"/> installed, but want
238 to use <xref linkend="nss"/> for the SSL support.
239 </para>
240
241 </sect2>
242
243 <sect2 role="configuration">
244 <title>Configuring Pidgin</title>
245
246 <sect3 id="pidgin-config">
247 <title>Config Files</title>
248 <para>
249 <filename>~/.purple/*</filename> and
250 <filename>~/.gtkrc-02</filename>
251 </para>
252
253 <indexterm zone="pidgin pidgin-config">
254 <primary sortas="e-AA.purple-*">~/.purple/*</primary>
255 </indexterm>
256
257 <indexterm zone="pidgin pidgin-config">
258 <primary sortas="e-AA.gtkrc-02">~/.gtkrc-02</primary>
259 </indexterm>
260 </sect3>
261
262 <sect3><title>Configuration Information</title>
263
264 <para>
265 Most configuration can be accomplished by using the various preference
266 settings inside the programs. Additionally, you can create a
267 <filename>~/.gtkrc-02</filename> file which can store gtk+-2 theme
268 settings that affect <application>Pidgin</application> and other Gtk+ 2
269 applications. Note that an example <filename>gtkrc-02</filename> file
270 was installed during the package installation and can be used as a
271 starting point or reference.
272 </para>
273
274 </sect3>
275
276 </sect2>
277
278 <sect2 role="content">
279 <title>Contents</title>
280
281 <segmentedlist>
282 <segtitle>Installed Programs</segtitle>
283 <segtitle>Installed Library</segtitle>
284 <segtitle>Installed Directories</segtitle>
285
286 <seglistitem>
287 <seg>
288 finch, pidgin, purple-client-example,
289 purple-remote, purple-send, purple-send-async, and
290 purple-url-handler
291 </seg>
292 <seg>
293 libgnt.so, libpurple.so, libpurple-client.so, and
294 plugins under /usr/lib/{finch,gnt,pidgin,purple-2}
295 </seg>
296 <seg>
297 /usr/include/finch,
298 /usr/include/gnt,
299 /usr/include/libpurple,
300 /usr/include/pidgin,
301 /usr/lib/finch,
302 /usr/lib/gnt,
303 /usr/lib/pidgin,
304 /usr/lib/purple-2,
305 /usr/share/doc/pidgin-&pidgin-version;,
306 /usr/share/pixmaps/pidgin,
307 /usr/share/purple, and
308 /usr/share/sounds/purple
309 </seg>
310 </seglistitem>
311 </segmentedlist>
312
313 <variablelist>
314 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
315 <?dbfo list-presentation="list"?>
316 <?dbhtml list-presentation="table"?>
317
318 <varlistentry id="pidgin-prog">
319 <term><command>pidgin</command></term>
320 <listitem>
321 <para>
322 is a <application>GTK+</application> 2 instant messaging client.
323 </para>
324 <indexterm zone="pidgin pidgin-prog">
325 <primary sortas="b-pidgin">pidgin</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 <varlistentry id="finch">
331 <term><command>finch</command></term>
332 <listitem>
333 <para>
334 is a text-based instant messaging client.
335 </para>
336 <indexterm zone="pidgin finch">
337 <primary sortas="b-finch">finch</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 </variablelist>
343
344 </sect2>
345
346</sect1>
Note: See TracBrowser for help on using the repository browser.