gtk+-2.24.10

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9666 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Andrew Benton 2012-03-10 16:51:39 +00:00
parent db33b3a056
commit b04a0494cb
3 changed files with 179 additions and 143 deletions

View File

@ -176,7 +176,6 @@ $Date$
<!ENTITY libxml2-version "2.7.8">
<!ENTITY libxslt-version "1.1.26">
<!ENTITY libgtkhtml-version "2.11.1">
<!ENTITY GLib-version "1.2.10">
<!ENTITY glib2-version "2.30.2">
<!ENTITY dbus-glib-version "0.98">
<!ENTITY glibmm-version "2.30.0">
@ -599,7 +598,6 @@ $Date$
<!-- Chapter 24 -->
<!ENTITY qt-version "3.3.8d">
<!ENTITY qt4-version "4.8.0">
<!ENTITY GTK-version "1.2.10">
<!ENTITY cairo-version "1.10.2">
<!ENTITY cairomm-version "1.9.2">
<!ENTITY pango-version "1.29.4">
@ -607,7 +605,7 @@ $Date$
<!ENTITY atk-version "2.2.0">
<!ENTITY atkmm-version "2.22.6">
<!ENTITY gdk-pixbuf-version "2.24.0">
<!ENTITY gtk2-version "2.24.8">
<!ENTITY gtk2-version "2.24.10">
<!ENTITY gtk2-libdir "2.0/2.10.0">
<!ENTITY gtk3-version "3.2.3">
<!ENTITY gtk-engines-version "2.20.1">

View File

@ -47,6 +47,9 @@
<listitem>
<para>[rthomsen] - upgrade to kdeadmin 4.8.1</para>
</listitem>
<listitem>
<para>[abenton] - Gtk+-2.24.10</para>
</listitem>
</itemizedlist>
</listitem>
@ -56,7 +59,7 @@
<listitem>
<para>[rthomsen] - upgrade to kdemultimedia 4.8.1</para>
</listitem>
<listitem>
<listitem>
<para>[rthomsen] - added taglib 1.7</para>
</listitem>
<listitem>

View File

@ -4,12 +4,14 @@
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gtk2-download-http "&gnome-download-http;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
<!ENTITY gtk2-download-ftp "&gnome-download-ftp;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
<!ENTITY gtk2-md5sum "5408d4a70ac132f7c439d7de40e83aff">
<!ENTITY gtk2-size "12.2 MB">
<!ENTITY gtk2-buildsize "337 MB">
<!ENTITY gtk2-time "2.7 SBU">
<!ENTITY gtk2-download-http
"&gnome-download-http;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
<!ENTITY gtk2-download-ftp
"&gnome-download-ftp;/gtk+/2.24/gtk+-&gtk2-version;.tar.xz">
<!ENTITY gtk2-md5sum "7fdcb407dd174010a695b555bf9b65e2">
<!ENTITY gtk2-size "12.6 MB">
<!ENTITY gtk2-buildsize "350 MB">
<!ENTITY gtk2-time "3.5 SBU">
]>
<sect1 id="gtk2" xreflabel="gtk+-&gtk2-version;">
@ -20,159 +22,171 @@
<date>$Date$</date>
</sect1info>
<title>gtk+-&gtk2-version;</title>
<title>Gtk+-&gtk2-version;</title>
<indexterm zone="gtk2">
<primary sortas="a-gtk2">gtk2</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to gtk+-2</title>
<title>Introduction to Gtk+-2</title>
<para>The <application>gtk+-2</application> package contains
<application>gtk+-2</application> libraries. These are useful
for creating graphical user interfaces for applications.</para>
<para>
The <application>Gtk+-2</application> package contains
<application>|Gtk+-2</application> libraries. These are useful for
creating graphical user interfaces for applications.
</para>
&lfs71_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gtk2-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&gtk2-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gtk2-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&gtk2-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &gtk2-md5sum;</para>
<para>
Download MD5 sum: &gtk2-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &gtk2-size;</para>
<para>
Download size: &gtk2-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gtk2-buildsize;</para>
<para>
Estimated disk space required: &gtk2-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &gtk2-time;</para>
<para>
Estimated build time: &gtk2-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">gtk+-2 Dependencies</bridgehead>
<bridgehead renderas="sect3">Gtk+-2 Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="cairo"/> (compiled with libX11
support), <xref linkend="gdk-pixbuf"/>, the
<xref linkend="x-window-system"/> (specifically, libX11, libXext and
libXrender), <xref linkend="pango"/> and <xref linkend="atk"/></para>
<para role="required">
<xref linkend="cairo"/> (compiled with libX11 support),
<xref linkend="gdk-pixbuf"/>,
the <xref linkend="x-window-system"/> (specifically, libX11, libXext and
libXrender),
<xref linkend="pango"/> and
<xref linkend="atk"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended"><xref linkend="hicolor-icon-theme"/></para>
<para role="recommended">
<xref linkend="hicolor-icon-theme"/>
</para>
<!-- hicolor-icon-theme is required for the test suite -->
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="cups"/>,
<xref linkend="docbook-utils"/>,
<!-- <ulink url="http://beagle-project.org/Main_Page">libbeagle</ulink>,
This beagle page appears to be just adverts -->
<!-- <ulink url="http://sourceforge.net/projects/openprinting/">papi</ulink>,
I think papi is just for solaris. It was a bugger to compile... -->
<!-- <ulink url="http://www.tracker-project.org/">Tracker</ulink>
This tracker page is a dead link -->
<xref linkend="gobject-introspection"/> and
<xref linkend="gtk-doc"/>.</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gtk+2"/></para>
<para role="optional">
<xref linkend="cups"/>,
<xref linkend="docbook-utils"/>,
<!-- <ulink url="http://beagle-project.org/Main_Page">libbeagle</ulink>,
This beagle page appears to be just adverts -->
<!-- <ulink url="http://sourceforge.net/projects/openprinting/">papi</ulink>,
I think papi is just for solaris. It was a bugger to compile... -->
<!-- <ulink url="http://www.tracker-project.org/">Tracker</ulink>
This tracker page is a dead link -->
<xref linkend="gobject-introspection"/> and
<xref linkend="gtk-doc"/>.
</para>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/gtk+2"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of gtk+-2</title>
<title>Installation of Gtk+-2</title>
<para>Install <application>gtk+-2</application> by running
the following commands:</para>
<para>
Install <application>Gtk+-2</application> by running the following
commands:
</para>
<screen><userinput>sed -i -e '/db2html/i@HAVE_DOCBOOK_TRUE@\t mkdir gtk-tut; ' \
-e '/gtk-tut html/i@HAVE_DOCBOOK_TRUE@\t mv *.html gtk-tut; ' \
docs/tutorial/Makefile.in &amp;&amp;
sed -i -e '/db2html/i@HAVE_DOCBOOK_TRUE@\t mkdir gtk-faq; ' \
-e '/gtk-faq html/i@HAVE_DOCBOOK_TRUE@\t mv *.html gtk-faq;' \
docs/faq/Makefile.in &amp;&amp;
sed -i -e 's#^\( gtk_icon_view_\)l#\1queue_l#' gtk/gtkiconview.c &amp;&amp;
./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
<screen><userinput>sed -i 's#l \(gtk-.*\).sgml#&amp; -o \1#' docs/{faq,tutorial}/Makefile.in &amp;&amp;
sed -i 's#.*@man_#man_#' docs/reference/gtk/Makefile.in &amp;&amp;
./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>. Note that
you must run the tests from a session with X Window Display capability
(i.e., not a text-based terminal/console) as the tests attempt to open an X
window, and the tests can take an excessively long time. Using an X Window,
the tests should take less than .3 SBUs</para>
<para>
To test the results, issue: <command>make check</command>. Note that you
must run the tests from a session with X Window Display capability (i.e.,
not a text-based terminal/console) as the tests attempt to open an X
window, and the tests can take an excessively long time. Using an X
Window, the tests should take less than 0.3 SBUs
</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;
sed -i 's/#man_MANS/man_MANS/' docs/reference/gtk/Makefile &amp;&amp;
make -C docs/reference/gtk install-man &amp;&amp;
install -v -m755 -d /usr/share/doc/gtk+-&gtk2-version; &amp;&amp;
<screen role="root"><userinput>make install &amp;&amp;
mkdir -pv /usr/share/doc/gtk+-&gtk2-version; &amp;&amp;
cp -v -R docs/faq/html /usr/share/doc/gtk+-&gtk2-version;/faq &amp;&amp;
cp -v -R docs/tutorial/html /usr/share/doc/gtk+-&gtk2-version;/tutorial &amp;&amp;
install -v -m644 docs/*.txt /usr/share/doc/gtk+-&gtk2-version;</userinput></screen>
<warning>
<para>If you installed the package on to your system using a
<quote>DESTDIR</quote> method two important files were not installed and
must be copied and/or generated. Generate them using the following
commands as the <systemitem class="username">root</systemitem>
user:</para>
<note>
<para>
If you installed the package on to your system using a
<quote>DESTDIR</quote> method two important files were not installed and
must be copied and/or generated. Generate them using the following
commands as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>gdk-pixbuf-query-loaders > /etc/gtk-2.0/gdk-pixbuf.loaders &amp;&amp;
gtk-query-immodules-2.0 > /etc/gtk-2.0/gtk.immodules</userinput></screen>
</warning>
</note>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i '/db2html/i@HAVE_DOCBOOK...</command>: If you have
<xref linkend="docbook-utils"/> installed (specifically, if configure finds
db2html) then it will try to use it to rebuild some of it's html
documentation and fail due to bugs in some of the Makefiles. These seds fix
the Makefiles.</para>
<para>
<command>sed -i 's#l \(gtk-.*\).sgml#&amp; -o \1#'
docs/{faq,tutorial}/Makefile.in</command>: If you have
<xref linkend="docbook-utils"/> installed (specifically, if configure
finds db2html) then it will try to use it to rebuild some of it's html
documentation and fail due to bugs in some of the Makefiles. This sed
fixes the Makefiles.
</para>
<para><command>sed -i...gtk/gtkiconview.c</command>: This fixes a bug in
gtk+-2.24.8 that makes some applications (eg, lxappearance) crash.</para>
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
<para><command>sed -i 's/#man_MANS...</command> and
<command>make -C docs...install-man</command> these commands install the
man pages for gtk-builder-convert, gtk-query-immodules-2.0 and
gtk-update-icon-cache.</para>
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the API documentation during the <command>make</command> command. Ensure
you really want to rebuild this documentation (and end up with what is
already shipped in the source tree) as it takes a very long time.</para>
<para>
<command>sed -i 's#.*@man_#man_#'
docs/reference/gtk/Makefile.in</command>: this sed fixes one of the
<filename>Makefile</filename>s so it installs the man pages for
gtk-builder-convert, gtk-query-immodules-2.0 and gtk-update-icon-cache.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
<sect2 role="configuration">
<title>Configuring gtk+-2</title>
<title>Configuring Gtk+-2</title>
<sect3 id="gtk2-config">
<title>Config Files</title>
<para><filename>~/.gtkrc-2.0</filename> and
<filename>/etc/gtk-2.0/gtkrc</filename></para>
<para>
<filename>~/.gtkrc-2.0</filename> and
<filename>/etc/gtk-2.0/gtkrc</filename>
</para>
<indexterm zone="gtk2 gtk2-config">
<primary sortas="e-AA.gtkrc-2.0">~/.gtkrc-2.0</primary>
@ -185,24 +199,33 @@ gtk-query-immodules-2.0 > /etc/gtk-2.0/gtk.immodules</userinput></screen>
<sect3><title>Configuration Information</title>
<para>Gtk themes change the way a gtk application looks. A Gtk icon theme
can be used to change the icons that appear on the application's
toolbar. If you have installed a Gtk theme or a Gtk icon theme (such as
<xref linkend="gnome-icon-theme"/>) you can set your prefences in
<filename>~/.gtkrc-2.0</filename>:</para>
<para>
Gtk themes change the way a gtk application looks. A Gtk icon theme can
be used to change the icons that appear on the application's toolbar.
If you have installed a Gtk theme (such as
<ulink
url="http://ftp.gnome.org/pub/gnome/sources/gnome-themes/2.32/">gnome-themes</ulink>
(requires <xref linkend="gtk-engines"/>)) or a Gtk icon theme (such as
<xref linkend="gnome-icon-theme"/>) you can set your preferences in
<filename>~/.gtkrc-2.0</filename>:
</para>
<screen><userinput>cat &gt; ~/.gtkrc-2.0 &lt;&lt; "EOF"
include "/usr/share/themes/<replaceable>Glider</replaceable>/gtk-2.0/gtkrc"
gtk-icon-theme-name = "<replaceable>hicolor</replaceable>"
EOF</userinput></screen>
<para>There are many more themes available at
<ulink url="http://gnome-look.org/">Gnome-Look.org</ulink> and other
places.</para>
<para>
There are many more themes available at
<ulink url="http://gnome-look.org/">Gnome-Look.org</ulink> and other
places.
</para>
<para>Once you've settled on themes you like, you can (as the
<systemitem class="username">root</systemitem> user) make them the
default system wide:</para>
<para>
Once you've settled on themes you like, you can (as the
<systemitem class="username">root</systemitem> user) make them the
default system wide:
</para>
<screen role="root"><userinput>cat &gt; /etc/gtk-2.0/gtkrc &lt;&lt; "EOF"
include "/usr/share/themes/<replaceable>Clearlooks</replaceable>/gtk-2.0/gtkrc"
@ -210,12 +233,11 @@ gtk-icon-theme-name = "<replaceable>elementary</replaceable>"
EOF</userinput></screen>
<para>
<ulink url="http://sourceforge.net/projects/lxde/files/LXAppearance/">
LXAppearance</ulink> is a gtk+-2 application that can help you choose the
themes you like.</para>
<ulink url="http://sourceforge.net/projects/lxde/files/LXAppearance/">
LXAppearance</ulink> is a <application>Gtk+-2</application> application
that can help you choose the themes you like.
</para>
</sect3>
</sect2>
<sect2 role="content">
@ -227,21 +249,27 @@ EOF</userinput></screen>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gtk-builder-convert, gtk-demo, gtk-query-immodules-2.0, and
gtk-update-icon-cache</seg>
<seg>libpixmap.so, im-am-et.so, im-cedilla.so, im-cyrillic-translit.so,
im-inuktitut.so, im-ipa.so, im-multipress.so, im-thai.so, im-ti-er.so,
im-ti-et.so, im-viqr.so, im-xim.so, libprintbackend-cups.so
libprintbackend-file.so, libprintbackend-lpr.so,
libferret.so, libgail.so, libgailutil.so, libgdk-x11-2.0.so and
libgtk-x11-2.0.so</seg>
<seg>/etc/gtk-2.0, /usr/include/gail-1.0,
/usr/include/gtk-2.0, /usr/include/gtk-unix-print-2.0},
/usr/lib/gtk-2.0, /usr/share/doc/gtk+-&gtk2-version;,
/usr/share/gtk-doc/html/gail-libgail-util,
/usr/share/gtk-doc/html/gdk-pixbuf, /usr/share/gtk-doc/html/gtk,
/usr/share/themes/Default, /usr/share/themes/Emacs and
/usr/share/themes/Raleigh</seg>
<seg>
gtk-builder-convert, gtk-demo, gtk-query-immodules-2.0 and
gtk-update-icon-cache
</seg>
<seg>
libpixmap.so, im-am-et.so, im-cedilla.so, im-cyrillic-translit.so,
im-inuktitut.so, im-ipa.so, im-multipress.so, im-thai.so, im-ti-er.so,
im-ti-et.so, im-viqr.so, im-xim.so, libprintbackend-cups.so
libprintbackend-file.so, libprintbackend-lpr.so,
libferret.so, libgail.so, libgailutil.so, libgdk-x11-2.0.so and
libgtk-x11-2.0.so
</seg>
<seg>
/etc/gtk-2.0, /usr/include/gail-1.0, /usr/include/gtk-2.0,
/usr/include/gtk-unix-print-2.0, /usr/lib/gtk-2.0,
/usr/share/doc/gtk+-&gtk2-version;,
/usr/share/gtk-doc/html/gail-libgail-util,
/usr/share/gtk-doc/html/gdk-pixbuf, /usr/share/gtk-doc/html/gtk,
/usr/share/themes/Default, /usr/share/themes/Emacs and
/usr/share/themes/Raleigh
</seg>
</seglistitem>
</segmentedlist>
@ -253,8 +281,10 @@ EOF</userinput></screen>
<varlistentry id="gtk-builder-convert">
<term><command>gtk-builder-convert</command></term>
<listitem>
<para>converts glade files into XML files which can be loaded with
GtkBuilder.</para>
<para>
converts glade files into XML files which can be loaded with
GtkBuilder.
</para>
<indexterm zone="gtk2 gtk-builder-convert">
<primary
sortas="b-gtk-builder-convert">gtk-builder-convert</primary>
@ -265,8 +295,10 @@ EOF</userinput></screen>
<varlistentry id="gtk-demo">
<term><command>gtk-demo</command></term>
<listitem>
<para>demonstrates <application>gtk+-2</application> functionality and
provides code for the examples.</para>
<para>
demonstrates <application>Gtk+-2</application> functionality and
provides code for the examples.
</para>
<indexterm zone="gtk2 gtk-demo">
<primary
sortas="b-gtk-demo">gtk-demo</primary>
@ -277,8 +309,10 @@ EOF</userinput></screen>
<varlistentry id="gtk-query-immodules-2.0">
<term><command>gtk-query-immodules-2.0</command></term>
<listitem>
<para>collects information about loadable input method modules for
<application>gtk+-2</application> and writes it to standard output.</para>
<para>
collects information about loadable input method modules for
<application>Gtk+-2</application> and writes it to standard output.
</para>
<indexterm zone="gtk2 gtk-query-immodules-2.0">
<primary
sortas="b-gtk-query-immodules-2.0">gtk-query-immodules-2.0</primary>
@ -289,7 +323,9 @@ EOF</userinput></screen>
<varlistentry id="gtk-update-icon-cache">
<term><command>gtk-update-icon-cache</command></term>
<listitem>
<para>creates mmap()able cache files for icon themes.</para>
<para>
creates mmap()able cache files for icon themes.
</para>
<indexterm zone="gtk2 gtk-update-icon-cache">
<primary sortas="b-gtk-update-icon-cache">gtk-update-icon-cache</primary>
</indexterm>
@ -297,17 +333,16 @@ EOF</userinput></screen>
</varlistentry>
<varlistentry id="gtk2libs">
<term>gtk+-2 Libraries</term>
<term>Gtk+-2 Libraries</term>
<listitem>
<para>provide an API to implement graphical user interfaces.</para>
<para>
provide an API to implement graphical user interfaces.
</para>
<indexterm zone="gtk2 gtk2libs">
<primary sortas="c-gtk2libs">gtk+-2 Libraries</primary>
<primary sortas="c-gtk2libs">Gtk+-2 Libraries</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>