source: x/lib/gtk+2.xml@ e443c44e

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!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">
]>

<sect1 id="gtk2" xreflabel="gtk+-&gtk2-version;">
  <?dbhtml filename="gtk2.html" ?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>gtk+-&gtk2-version;</title>

  <indexterm zone="gtk2">
    <primary sortas="a-gtk2">gtk2</primary>
  </indexterm>

  <sect2 role="package">
    <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>

    &lfs70_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&gtk2-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&gtk2-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &gtk2-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &gtk2-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &gtk2-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &gtk2-time;</para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <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>

  </sect2>

  <sect2 role="installation">
    <title>Installation of gtk+-2</title>

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

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

  </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...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>

  </sect2>

  <sect2 role="configuration">
    <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>

      <indexterm zone="gtk2 gtk2-config">
        <primary sortas="e-AA.gtkrc-2.0">~/.gtkrc-2.0</primary>
      </indexterm>

      <indexterm zone="gtk2 gtk2-config">
        <primary sortas="e-etc-path-gtkrc">/etc/gtk-2.0/gtkrc</primary>
      </indexterm>
    </sect3>

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

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

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <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>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <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>
          <indexterm zone="gtk2 gtk-builder-convert">
            <primary
            sortas="b-gtk-builder-convert">gtk-builder-convert</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <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>
          <indexterm zone="gtk2 gtk-demo">
            <primary
            sortas="b-gtk-demo">gtk-demo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <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>
          <indexterm zone="gtk2 gtk-query-immodules-2.0">
            <primary
            sortas="b-gtk-query-immodules-2.0">gtk-query-immodules-2.0</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <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>
          <indexterm zone="gtk2 gtk-update-icon-cache">
            <primary sortas="b-gtk-update-icon-cache">gtk-update-icon-cache</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gtk2libs">
        <term>gtk+-2 Libraries</term>
        <listitem>
          <para>provide an API to implement graphical user interfaces.</para>
          <indexterm zone="gtk2 gtk2libs">
            <primary sortas="c-gtk2libs">gtk+-2 Libraries</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>