Updated Pidgin to 2.10.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9082 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Andrew Benton 2011-12-07 22:28:56 +00:00
parent fdcbc8d2f6
commit dc1cfc4699
3 changed files with 116 additions and 123 deletions

View File

@ -795,7 +795,7 @@ $Date$
<!ENTITY thunderbird-version "8.0">
<!ENTITY pan-version "0.133">
<!ENTITY balsa-version "2.3.22">
<!ENTITY pidgin-version "2.1.0">
<!ENTITY pidgin-version "2.10.0">
<!ENTITY xchat-version "2.8.4">
<!-- Part XII -->

View File

@ -73,7 +73,10 @@
<para>[ken] - Updated to ImageMagick-6.7.3-10.</para>
</listitem>
<listitem>
<para>[abenton] - Updated to Bluefish to 2.2.0.</para>
<para>[abenton] - Updated Bluefish to 2.2.0.</para>
</listitem>
<listitem>
<para>[abenton] - Updated Pidgin to 2.10.0.</para>
</listitem>
</itemizedlist>
</listitem>

View File

@ -6,10 +6,10 @@
<!ENTITY pidgin-download-http "&sourceforge-repo;/pidgin/pidgin-&pidgin-version;.tar.bz2">
<!ENTITY pidgin-download-ftp " ">
<!ENTITY pidgin-md5sum "83f44bf9c076595967f7374c50250176">
<!ENTITY pidgin-size "7.7 MB">
<!ENTITY pidgin-buildsize "172 MB (additinoal 106 MB for API documentation)">
<!ENTITY pidgin-time "2.5 SBU">
<!ENTITY pidgin-md5sum "e1453c9093c4f32beec19abd14069a3f">
<!ENTITY pidgin-size "9.5 MB">
<!ENTITY pidgin-buildsize "244 MB (additinoal 106 MB for API documentation)">
<!ENTITY pidgin-time "1.9 SBU">
]>
<sect1 id="pidgin" xreflabel="Pidgin-&pidgin-version;">
@ -29,9 +29,12 @@
<sect2 role="package">
<title>Introduction to Pidgin</title>
<para><application>Pidgin</application> is an instant messaging client that
can connect with a wide range of networks including AIM, ICQ, GroupWise,
MSN, Jabber, IRC, Napster, Gadu-Gadu, SILC, Zephyr and Yahoo!.</para>
<para><application>Pidgin</application> is a Gtk+-2 instant messaging
client that can connect with a wide range of networks including AIM, ICQ,
GroupWise, MSN, Jabber, IRC, Napster, Gadu-Gadu, SILC, Zephyr and
Yahoo!.</para>
&lfs70_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
@ -58,66 +61,46 @@
<bridgehead renderas="sect3">Pidgin Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="glib2"/>,
<xref linkend="libxml2"/>, and
<xref linkend="perl-xml-parser"/></para>
<para role="required"><xref linkend="gtk2"/> and
<xref linkend="perl-xml-parser"/>. <application>Gtk+-2</application> is
required to build <application>Pidgin</application>, however, if you
configure <application>Pidgin</application> with the option
<option>--disable-gtkui</option>, it is possible to compile the command
line <command>finch</command> program without
<application>Gtk+-2</application> installed.</para>
<bridgehead renderas="sect4">Optional for SSL Support</bridgehead>
<para role="optional"><xref linkend="gnutls"/> or <xref linkend="nss"/></para>
<para role="optional"><xref linkend="gnutls"/> or
<xref linkend="nss"/></para>
<para>SSL support is required for MSN Messenger and Google Talk.
<application>GnuTLS</application> is the preferred method. Note that one of
<xref linkend="firefox"/>,
<xref linkend="thunderbird"/>,
<xref linkend="seamonkey"/>, or
<ulink url="http://www.mozilla.org/products/mozilla1.x/">Mozilla</ulink>
can be used instead of NSS.</para>
<bridgehead renderas="sect4">Optional GUI Tools</bridgehead>
<para role="optional"><xref linkend="gtk2"/>
(required to build the GUI interface),
<ulink url="http://gtkspell.sourceforge.net/">Gtkspell</ulink>
(for spell-check support and only used if <application>Gtk+</application> is installed),
<xref linkend="xscreensaver"/>
(to check for idleness and only used if <application>Gtk+</application> is installed),
<xref linkend="startup-notification"/>
(only used if <application>Gtk+</application> is installed), and
<xref linkend="x-window-system"/>
(used for session management support)</para>
<para>SSL support is required for the MSN Messenger and Google Talk
protocol plugins. <application>GnuTLS</application> is the preferred method
(the Mozilla nss API is more likely to change and this can cause
problems).</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="intltool"/>,
<xref linkend="GConf"/>,
<xref linkend="dbus-glib"/> (requires <xref linkend="python"/> also),
<para role="optional"><xref linkend="xscreensaver"/>,
<ulink url="http://gtkspell.sourceforge.net/">Gtkspell</ulink>,
<xref linkend="startup-notification"/>, <xref linkend="x-window-system"/>,
<xref linkend="intltool"/>, <xref linkend="GConf"/>,
<xref linkend="dbus-glib"/>, <xref linkend="libidn"/>,
<ulink url="http://silcnet.org/software/">SILC Client</ulink>,
<ulink url="http://silcnet.org/software/">SILC Toolkit</ulink>,
<ulink url="http://packages.debian.org/stable/source/zephyr">zephyr</ulink>,
<xref linkend="gstreamer"/>
(required for audio support),
<xref linkend="evolution-data-server"/>
(required for Evolution integration),
<xref linkend="sqlite"/>
(required for the Contact Availability Prediction plugin),
<xref linkend="cyrus-sasl"/>
(required for Jabber support),
<xref linkend="mitkrb"/>
(required for Kerberos support in the Zephyr module),
<xref linkend="avahi"/>,
(required for the Bonjour plugin),
<xref linkend="gstreamer"/> (required for audio support),
<xref linkend="evolution-data-server"/>,
<xref linkend="sqlite"/> (required for the Contact Availability Prediction
plugin), <xref linkend="cyrus-sasl"/>,
<xref linkend="mitkrb"/> (required for Kerberos support in the Zephyr
module), <xref linkend="avahi"/>, (required for the Bonjour plugin),
<ulink url="http://meanwhile.sourceforge.net/">Meanwhile</ulink>
(required for Sametime protocol support),
<ulink url="http://www.gnome.org/projects/NetworkManager/">NetworkManager</ulink>
(<ulink url="&gnome-download-http;/NetworkManager/">download</ulink> and
requires that <application>D-Bus</application> is installed),
<ulink url="http://sourceforge.net/projects/check">check</ulink>
(only used during the test suite), and
Gadu-Gadu external libraries (cannot find a URL)</para>
<bridgehead renderas="sect4">Optional for Programming Language Support</bridgehead>
<para role="optional"><ulink url="http://www.mono-project.com/Main_Page">Mono</ulink>
(experimental),
<xref linkend="tcl"/>, and
<xref linkend="tk"/></para>
(required for Sametime protocol support), <ulink
url="http://www.gnome.org/projects/NetworkManager/">NetworkManager</ulink>,
<ulink url="http://toxygen.net/libgadu/">libgadu</ulink>,
<ulink
url="http://www.freedesktop.org/software/farstream/releases/farsight2/">Farsight2</ulink>,
<ulink url="http://sourceforge.net/projects/check">check</ulink> (only
used during the test suite) and <xref linkend="tcl"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pidgin"/></para>
@ -130,52 +113,79 @@
<para>Compile <application>Pidgin</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr \
--with-gconf-schema-file-dir=&gnome-etc-dir;/gconf/schemas \
--disable-gtkui &amp;&amp;
<screen><userinput>LIBS=&quot;-lm -lX11&quot; ./configure --prefix=/usr --disable-screensaver --disable-idn \
--disable-meanwhile --disable-avahi --disable-nm --disable-tcl --disable-vv \
--with-gconf-schema-file-dir=&gnome-etc-dir;/gconf/schemas &amp;&amp;
make</userinput></screen>
<para> If you have <xref linkend="doxygen"/> installed
(<xref linkend="graphviz"/> can be used also) and you wish to create the
API documentation, issue: <command>make docs</command></para>
<para>To test the results, issue: <command>make check</command>. Note
that the end result of the suite indicates an error. This error is only
due to some locale translation issues and not the actual tests. The
actual result of the tests are displayed about half way through the
tests and should indicate that they passed.</para>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/pidgin-&pidgin-version; &amp;&amp;
install -v -m644 README* doc/*.txt doc/gtkrc-2.0 \
/usr/share/doc/pidgin-&pidgin-version;</userinput></screen>
mkdir /usr/share/doc/pidgin-&pidgin-version; &amp;&amp;
cp README doc/gtkrc-2.0 /usr/share/doc/pidgin-&pidgin-version;</userinput></screen>
<para>If you created the API documentation, install it using the following
commands as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/pidgin-&pidgin-version;/api &amp;&amp;
install -v -m644 doc/html/* \
/usr/share/doc/pidgin-&pidgin-version;/api</userinput></screen>
<screen role="root"><userinput>mkdir /usr/share/doc/pidgin-&pidgin-version;/api &amp;&amp;
cp doc/html/* /usr/share/doc/pidgin-&pidgin-version;/api</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--with-gconf-schema-file-dir=&gnome-etc-dir;/gconf/schemas</parameter>:
<para><parameter>LIBS=&quot;-lm -lX11&quot;</parameter>: This avoids
problems linking with <command>ld</command> from
<application>binutils-2.22</application>. This parameter is not needed with
earlier versions of <application>binutils</application>. If you
haven&apos;t installed <application>libX11</application> and are just
compiling <command>finch</command>, remove the &quot;-lX11&quot;
part.</para>
<para>
<option>--with-gconf-schema-file-dir=&gnome-etc-dir;/gconf/schemas</option>:
This parameter is used so that the <application>GConf</application> schema
files are installed into the existing database. If
<application>GConf</application> is not installed, the parameter does not
affect the build or installation of the package.</para>
<para><parameter>--disable-gtkui</parameter>: This parameter is used if
<application>GTK+</application> is not installed. The build will only
produce the <command>finch</command> program, which is a text-based
(<application>Ncurses</application>) only version. Remove this parameter
if you have <application>GTK+</application> installed to build the GUI
<command>pidgin</command> program.</para>
<para><option>--disable-screensaver</option>: Remove this option if
you&apos;ve installed <application>libXscrnsaver</application>.</para>
<para><option>--disable-idn</option>: Remove this option if you&apos;ve
installed <xref linkend="libidn"/>.</para>
<para><option>--disable-meanwhile</option>: Remove this option if
you&apos;ve installed
<ulink url="http://meanwhile.sourceforge.net/">Meanwhile</ulink>.</para>
<para><option>--disable-avahi</option>: Remove this option if you&apos;ve
installed <xref linkend="avahi"/>.</para>
<para><option>--disable-nm</option>: Remove this option if you&apos;ve
installed <ulink
url="http://www.gnome.org/projects/NetworkManager/">NetworkManager</ulink>.
</para>
<para><option>--disable-tcl</option>: Remove this option if you&apos;ve
installed <xref linkend="tcl"/>.</para>
<para><option>--disable-vv</option>: Disable video and voice. Remove this
option if you&apos;ve installed <ulink
url="http://www.freedesktop.org/software/farstream/releases/farsight2/">Farsight2</ulink>.</para>
<para><option>--disable-gtkui</option>: use this option if you&apos;ve not
installed <xref linkend="gtk2"/> and you just want the
<application>Ncurses</application> based <command>finch</command>
program.</para>
</sect2>
@ -200,11 +210,11 @@ install -v -m644 doc/html/* \
<para>Most configuration can be accomplished by using the various
preference settings inside the programs. Additionally, you can create
a <filename>~/.gtkrc-02</filename> file which can store settings that
affect the <application>Pidgin</application> application. Note that an
example <filename>gtkrc-02</filename> file was installed during the
package installation and can be used as a starting point or
reference.</para>
a <filename>~/.gtkrc-02</filename> file which can store gtk+-2 theme
settings that affect <application>Pidgin</application> and other gtk+-2
applications. Note that an example <filename>gtkrc-02</filename> file was
installed during the package installation and can be used as a starting
point or reference.</para>
</sect3>
@ -224,10 +234,11 @@ install -v -m644 doc/html/* \
<seg>libgnt.so, libpurple.so, and libpurple-client.so along with
numerous plugin and support modules located in various subdirectories
of /usr/lib.</seg>
<seg>/usr/include/{finch,gnt,libpurple,pidgin},
/usr/lib/{finch,gnt,pidgin,purple-2},
/usr/share/doc/pidgin-&pidgin-version;, /usr/share/pixmaps/pidgin, and
/usr/share/sounds/pidgin</seg>
<seg>/usr/include/finch, /usr/include/gnt, /usr/include/libpurple,
/usr/include/pidgin, /usr/lib/finch, /usr/lib/gnt, /usr/lib/pidgin,
/usr/lib/purple-2, /usr/share/doc/pidgin-&pidgin-version;,
/usr/share/pixmaps/pidgin, /usr/share/purple and
/usr/share/sounds/purple</seg>
</seglistitem>
</segmentedlist>
@ -236,6 +247,17 @@ install -v -m644 doc/html/* \
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="pidgin-prog">
<term><command>pidgin</command></term>
<listitem>
<para>is an instant messaging client based on the
<application>Gtk+-2</application> GUI toolkit.</para>
<indexterm zone="pidgin pidgin-prog">
<primary sortas="b-pidgin">pidgin</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="finch">
<term><command>finch</command></term>
<listitem>
@ -247,38 +269,6 @@ install -v -m644 doc/html/* \
</listitem>
</varlistentry>
<varlistentry id="pidgin-prog">
<term><command>pidgin</command></term>
<listitem>
<para>is an instant messaging client based on the
<application>Gtk+</application> GUI toolkit.</para>
<indexterm zone="pidgin pidgin-prog">
<primary sortas="b-pidgin">pidgin</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="purple-remote">
<term><command>purple-remote</command></term>
<listitem>
<para> is a command-line interface for controlling an already running
instance of <command>pidgin</command></para>
<indexterm zone="pidgin purple-remote">
<primary sortas="b-purple-remote">purple-remote</primary>
</indexterm>
</listitem>
</varlistentry>
<!-- <varlistentry id="libpidgin-remote">
<term><filename class='libraryfile'>libpidgin-remote.so</filename></term>
<listitem>
<para> contains functions that are used by pidgin-remote</para>
<indexterm zone="pidgin libpidgin-remote">
<primary sortas="c-libpidgin-remote">libpidgin-remote.so</primary>
</indexterm>
</listitem>
</varlistentry> -->
</variablelist>
</sect2>