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

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY gtk2-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v2.6/gtk+-&gtk2-version;.tar.bz2">
  <!ENTITY gtk2-download-ftp  "ftp://ftp.gtk.org/pub/gtk/v2.6/gtk+-&gtk2-version;.tar.bz2">
  <!ENTITY gtk2-md5sum        "4749fce7b082b784a71a076aa586dc25">
  <!ENTITY gtk2-size          "11.2 MB">
  <!ENTITY gtk2-buildsize     "202 MB">
  <!ENTITY gtk2-time          "2.87 SBU">
]>

<sect1 id="gtk2" xreflabel="GTK+-&gtk2-version;">
<sect1info>
  <othername>$LastChangedBy$</othername>
  <date>$Date$</date>
</sect1info>

<?dbhtml filename="gtk2.html" ?>
<title>GTK+-&gtk2-version;</title>

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

<sect2>
<title>Introduction to 
       <application><acronym>GTK</acronym>+</application></title>

<para>The <application><acronym>GTK</acronym>+</application> package contains
<application><acronym>GTK</acronym>+</application> Libraries. These are useful 
for creating graphical user interfaces for applications.</para>

<sect3><title>Package information</title>
<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>
</sect3>

<sect3>
  <title><application><acronym>GTK</acronym>+</application> dependencies</title>
 <sect4>
   <title>Required</title>
   <para>
     X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>),
     <xref linkend="pango"/>, and
     <xref linkend="atk"/>
   </para>
  </sect4>

  <sect4>
    <title>Optional</title>
    <para>
      <xref linkend="libtiff"/>,
      <xref linkend="libjpeg"/>,
      <xref linkend="gtk-doc"/>, and
      <xref linkend="docbook-utils"/>
    </para>
  </sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application><acronym>GTK</acronym>+</application></title>

<para>Install <application><acronym>GTK</acronym>+</application> by running 
the following commands:</para>

<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
    --without-libtiff --without-libjpeg &amp;&amp;
make</command></userinput></screen>

<para>To test the results, issue: <command>make check</command>.</para>

<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<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><parameter>--without-libtiff</parameter>: Omit this switch if you have
<application>libtiff</application> installed.</para>

<para><parameter>--without-libjpeg</parameter>: Omit this switch if you have
<application>libjpeg</application> installed.</para>

<para><option>--enable-gtk-doc</option>: This switch will rebuild
the <acronym>API</acronym> documentation during the
<command>make</command> command.</para>
</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
  <segtitle>Installed Programs</segtitle>
  <segtitle>Installed Libraries</segtitle>
  <segtitle>Installed Directories</segtitle>
 
  <seglistitem>
    <seg>gdk-pixbuf-csource, gdk-pixbuf-query-loaders, gtk-demo, 
         gtk-query-immodules-2.0, gtk-update-icon-cache</seg>
    <seg>libgdk_pixbuf-2.0.so, libgdk-x11-2.0.so, libgtk-x11-2.0.so, 
         libgdk_pixbuf_xlib-2.0.so and numerous engine, module and
         loader plugins</seg>
    <seg>/etc/gtk-2.0, /usr/include/gtk-2.0, /usr/lib/gtk-2.0, 
         /usr/share/gtk-2.0, /usr/share/gtk-doc/html/[gdk,gdk-pixbuf,gtk], 
         /usr/share/themes/Default/gtk* and 
         /usr/share/themes/Emacs/gtk-2.0-key</seg>
  </seglistitem>
</segmentedlist>
 
<variablelist>
  <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  <?dbfo list-presentation="list"?>

<varlistentry id="gdk-pixbuf-csource">
  <term><command>gdk-pixbuf-csource</command></term>
  <listitem>
    <para>generates C code containing images, useful for compiling images 
          directly into programs.</para>
    <indexterm zone="gtk2 gdk-pixbuf-csource">
      <primary sortas="b-gdk-pixbuf-csource">gdk-pixbuf-csource</primary>
    </indexterm>
  </listitem>
</varlistentry>

<varlistentry id="gdk-pixbuf-query-loaders">
  <term><command>gdk-pixbuf-query-loaders</command></term>
  <listitem>
    <para>collects information about loadable modules for gdk-pixbuf and 
          writes it to standard output.</para>
    <indexterm zone="gtk2 gdk-pixbuf-query-loaders">
      <primary sortas="b-gdk-pixbuf-query-loaders">gdk-pixbuf-query-loaders</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><acronym>GTK</acronym>+</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+ Libraries</term>
  <listitem>
    <para>provide an API to implement graphical user interfaces.</para>
    <indexterm zone="gtk2 GTK2libs">
      <primary sortas="c-GTK2libs">GTK+ Libraries</primary>
    </indexterm>
  </listitem>
</varlistentry>

</variablelist> 
</sect2>

</sect1>