source: xsoft/other/pidgin.xml@ 9ed46c0

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 9ed46c0 was 9ed46c0, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

tags

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

  • Property mode set to 100644
File size: 10.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 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 <ulink url="&gnome-download-http;/evolution-data-server/">
103 Evolution Data Server</ulink>,
104 <ulink url="http://www.freedesktop.org/wiki/Software/Farstream">
105 Farstream (Version 0.1)</ulink>
106 (required for video and voice support),
107 <xref linkend="GConf"/>,
108 <xref linkend="gstreamer"/> (required for audio support),
109 <ulink url="http://gtkspell.sourceforge.net/">Gtkspell</ulink>,
110 <xref linkend="libidn"/>,
111 <ulink url="http://libgadu.net/">libgadu</ulink>,
112 <ulink url="http://meanwhile.sourceforge.net/">Meanwhile</ulink>
113 (required for Sametime protocol support),
114 <xref linkend="mitkrb"/> (required for Kerberos support in the Zephyr
115 module),
116 <xref linkend="NetworkManager"/>,
117 <ulink url="http://silcnet.org/software/">SILC Client</ulink>,
118 <ulink url="http://silcnet.org/software/">SILC Toolkit</ulink>,
119 <xref linkend="startup-notification"/>,
120 <xref linkend="sqlite"/> (required for the Contact Availability Prediction
121 plugin),
122 <xref linkend="tcl"/>, and
123 <ulink url="http://packages.debian.org/stable/source/zephyr">Zephyr</ulink>
124 </para>
125
126 <para condition="html" role="usernotes">
127 User Notes: <ulink url="&blfs-wiki;/pidgin"/>
128 </para>
129 </sect2>
130
131 <sect2 role="installation">
132 <title>Installation of Pidgin</title>
133
134 <para>
135 Compile <application>Pidgin</application> by running the following
136 commands:
137 </para>
138
139<screen><userinput>./configure --prefix=/usr \
140 --sysconfdir=/etc \
141 --disable-avahi \
142 --disable-gtkspell \
143 --disable-gstreamer \
144 --disable-meanwhile \
145 --disable-idn \
146 --disable-nm \
147 --disable-vv \
148 --disable-tcl &amp;&amp;
149make</userinput></screen>
150
151 <para>
152 If you have <xref linkend="doxygen"/> installed
153 (<xref linkend="graphviz"/> can be used also) and you wish to create the
154 API documentation, issue: <command>make docs</command>
155 </para>
156
157 <para>
158 To test the results, issue: <command>make check</command>.
159 </para>
160
161 <para>
162 Now, as the <systemitem class="username">root</systemitem> user:
163 </para>
164
165<screen role="root"><userinput>make install &amp;&amp;
166mkdir -pv /usr/share/doc/pidgin-&pidgin-version; &amp;&amp;
167cp -v README doc/gtkrc-2.0 /usr/share/doc/pidgin-&pidgin-version;</userinput></screen>
168
169 <para>
170 If you created the API documentation, install it using the following
171 commands as the <systemitem class="username">root</systemitem> user:
172 </para>
173
174<screen role="root"><userinput>mkdir -pv /usr/share/doc/pidgin-&pidgin-version;/api &amp;&amp;
175cp -v doc/html/* /usr/share/doc/pidgin-&pidgin-version;/api</userinput></screen>
176
177 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
178 href="../../xincludes/update-icons-and-desktop.xml"/>
179
180 </sect2>
181
182 <sect2 role="commands">
183 <title>Command Explanations</title>
184
185 <para>
186 <option>--disable-avahi</option>: Remove this switch if you've
187 installed <xref linkend="avahi"/>.
188 </para>
189
190 <para>
191 <option>--disable-gtkspell</option>: Spellchecking. Remove this switch if
192 you've installed
193 <ulink url="http://gtkspell.sourceforge.net/">Gtkspell</ulink>.
194 </para>
195
196 <para>
197 <option>--disable-gstreamer</option>: Sounds. Remove this switch if you've
198 installed <xref linkend="gstreamer"/>.
199 </para>
200
201 <para>
202 <option>--disable-meanwhile</option>: Remove this switch if you've
203 installed <ulink url="http://meanwhile.sourceforge.net/">Meanwhile</ulink>.
204 </para>
205
206 <para>
207 <option>--disable-idn</option>: Remove this switch if you've installed
208 <xref linkend="libidn"/>.
209 </para>
210
211 <para>
212 <option>--disable-nm</option>: Remove this switch if you've installed
213 <xref linkend="NetworkManager"/>.
214 </para>
215
216 <para>
217 <option>--disable-vv</option>: Video and voice. Remove this switch if
218 you've installed
219 <ulink url="http://www.freedesktop.org/wiki/Software/Farstream">
220 Farstream (Version 0.1)</ulink>.
221 </para>
222
223 <para>
224 <option>--disable-tcl</option>: Remove this switch if you've installed
225 <xref linkend="tcl"/>.
226 </para>
227
228 <para>
229 <option>--enable-cyrus-sasl</option>: Use this switch if you've installed
230 <xref linkend="cyrus-sasl"/> and wish to build
231 <application>Pidgin</application> with SASL support.
232 </para>
233
234 <para>
235 <option>--disable-gnutls</option>: Use this switch if you've got both
236 <xref linkend="gnutls"/> and <xref linkend="nss"/> installed, but want
237 to use <xref linkend="nss"/> for the SSL support.
238 </para>
239
240 </sect2>
241
242 <sect2 role="configuration">
243 <title>Configuring Pidgin</title>
244
245 <sect3 id="pidgin-config">
246 <title>Config Files</title>
247 <para>
248 <filename>~/.purple/*</filename> and
249 <filename>~/.gtkrc-02</filename>
250 </para>
251
252 <indexterm zone="pidgin pidgin-config">
253 <primary sortas="e-AA.purple-*">~/.purple/*</primary>
254 </indexterm>
255
256 <indexterm zone="pidgin pidgin-config">
257 <primary sortas="e-AA.gtkrc-02">~/.gtkrc-02</primary>
258 </indexterm>
259 </sect3>
260
261 <sect3><title>Configuration Information</title>
262
263 <para>
264 Most configuration can be accomplished by using the various preference
265 settings inside the programs. Additionally, you can create a
266 <filename>~/.gtkrc-02</filename> file which can store gtk+-2 theme
267 settings that affect <application>Pidgin</application> and other Gtk+ 2
268 applications. Note that an example <filename>gtkrc-02</filename> file
269 was installed during the package installation and can be used as a
270 starting point or reference.
271 </para>
272
273 </sect3>
274
275 </sect2>
276
277 <sect2 role="content">
278 <title>Contents</title>
279
280 <segmentedlist>
281 <segtitle>Installed Programs</segtitle>
282 <segtitle>Installed Library</segtitle>
283 <segtitle>Installed Directories</segtitle>
284
285 <seglistitem>
286 <seg>
287 finch, pidgin, purple-client-example,
288 purple-remote, purple-send, purple-send-async, and
289 purple-url-handler
290 </seg>
291 <seg>
292 libgnt.so, libpurple.so, libpurple-client.so, and
293 plugins under /usr/lib/{finch,gnt,pidgin,purple-2}
294 </seg>
295 <seg>
296 /usr/include/finch,
297 /usr/include/gnt,
298 /usr/include/libpurple,
299 /usr/include/pidgin,
300 /usr/lib/finch,
301 /usr/lib/gnt,
302 /usr/lib/pidgin,
303 /usr/lib/purple-2,
304 /usr/share/doc/pidgin-&pidgin-version;,
305 /usr/share/pixmaps/pidgin,
306 /usr/share/purple, and
307 /usr/share/sounds/purple
308 </seg>
309 </seglistitem>
310 </segmentedlist>
311
312 <variablelist>
313 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
314 <?dbfo list-presentation="list"?>
315 <?dbhtml list-presentation="table"?>
316
317 <varlistentry id="pidgin-prog">
318 <term><command>pidgin</command></term>
319 <listitem>
320 <para>
321 is a <application>GTK+</application> 2 instant messaging client.
322 </para>
323 <indexterm zone="pidgin pidgin-prog">
324 <primary sortas="b-pidgin">pidgin</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328
329 <varlistentry id="finch">
330 <term><command>finch</command></term>
331 <listitem>
332 <para>
333 is a text-based instant messaging client.
334 </para>
335 <indexterm zone="pidgin finch">
336 <primary sortas="b-finch">finch</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 </variablelist>
342
343 </sect2>
344
345</sect1>
Note: See TracBrowser for help on using the repository browser.