Beyond Linux® From Scratch - Version 2012-01-16

Chapter 24. X Libraries

gtk+-2.24.8

Introduction to gtk+-2

The gtk+-2 package contains gtk+-2 libraries. These are useful for creating graphical user interfaces for applications.

This package is known to build and work properly using an LFS-7.0 platform.

Package Information

gtk+-2 Dependencies

Required

cairo-1.10.2 (compiled with libX11 support), gdk-pixbuf-2.24.0, the X Window System (specifically, libX11, libXext and libXrender), Pango-1.29.4 and atk-2.2.0

Recommended

hicolor-icon-theme-0.12

Optional

Cups-1.5.0, DocBook-utils-0.6.14, gobject-introspection-1.30.0 and GTK-Doc-1.18.

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/gtk+2

Installation of gtk+-2

Install gtk+-2 by running the following commands: 

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                                         &&

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                                              &&

sed -i -e 's#^\(      gtk_icon_view_\)l#\1queue_l#' gtk/gtkiconview.c &&

./configure --prefix=/usr --sysconfdir=/etc &&
make

To test the results, issue: make check. 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

Now, as the root user: 

make install                                                    &&
sed -i 's/#man_MANS/man_MANS/' docs/reference/gtk/Makefile      &&
make -C docs/reference/gtk install-man                          &&
        
install -v -m755 -d         /usr/share/doc/gtk+-2.24.8          &&
cp -v -R docs/faq/html      /usr/share/doc/gtk+-2.24.8/faq      &&
cp -v -R docs/tutorial/html /usr/share/doc/gtk+-2.24.8/tutorial &&
install -v -m644 docs/*.txt /usr/share/doc/gtk+-2.24.8
[Warning]

Warning

If you installed the package on to your system using a “DESTDIR” method two important files were not installed and must be copied and/or generated. Generate them using the following commands as the root user: 

gdk-pixbuf-query-loaders > /etc/gtk-2.0/gdk-pixbuf.loaders &&
gtk-query-immodules-2.0  > /etc/gtk-2.0/gtk.immodules

Command Explanations

sed -i '/db2html/i@HAVE_DOCBOOK...: If you have DocBook-utils-0.6.14 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.

sed -i...gtk/gtkiconview.c: This fixes a bug in gtk+-2.24.8 that makes some applications (eg, lxappearance) crash.

--sysconfdir=/etc: This switch installs the configuration files into /etc instead of /usr/etc.

sed -i 's/#man_MANS... and make -C docs...install-man these commands install the man pages for gtk-builder-convert, gtk-query-immodules-2.0 and gtk-update-icon-cache.

--enable-gtk-doc: This switch will rebuild the API documentation during the make 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.

Configuring gtk+-2

Config Files

~/.gtkrc-2.0 and /etc/gtk-2.0/gtkrc

Configuration Information

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 (eg GNOME Themes-2.30.2) or a Gtk icon theme (such as GNOME Icon Theme-2.30.3) you can set your prefences in ~/.gtkrc-2.0: 

cat > ~/.gtkrc-2.0 << "EOF"
include "/usr/share/themes/Glider/gtk-2.0/gtkrc"
gtk-icon-theme-name = "hicolor"
EOF

There are many more themes available at Gnome-Look.org and other places.

Once you've settled on themes you like, you can (as the root user) make them the default system wide: 

cat > /etc/gtk-2.0/gtkrc << "EOF"
include "/usr/share/themes/Clearlooks/gtk-2.0/gtkrc"
gtk-icon-theme-name = "elementary"
EOF

LXAppearance is a gtk+-2 application that can help you choose the themes you like.

Contents

Installed Programs: gtk-builder-convert, gtk-demo, gtk-query-immodules-2.0, and gtk-update-icon-cache
Installed Libraries: 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
Installed Directories: /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+-2.24.8, /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

Short Descriptions

gtk-builder-convert

converts glade files into XML files which can be loaded with GtkBuilder.

gtk-demo

demonstrates gtk+-2 functionality and provides code for the examples.

gtk-query-immodules-2.0

collects information about loadable input method modules for gtk+-2 and writes it to standard output.

gtk-update-icon-cache

creates mmap()able cache files for icon themes.

gtk+-2 Libraries

provide an API to implement graphical user interfaces.

Last updated on 2011-12-12 05:30:20 +0000