source: x/lib/gtk+.xml@ af375104

<?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 GTK-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
  <!ENTITY GTK-download-ftp  "ftp://ftp.gtk.org/pub/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
  <!ENTITY GTK-md5sum        "4d5cb2fc7fb7830e4af9747a36bfce20">
  <!ENTITY GTK-size          "2.8 MB">
  <!ENTITY GTK-buildsize     "51.1 MB">
  <!ENTITY GTK-time          "1.01 SBU">
]>
<sect1 id="GTK" xreflabel="GTK+-&GTK-version;">
<sect1info>
  <othername>$LastChangedBy$</othername>
  <date>$Date$</date>
</sect1info>
<?dbhtml filename="gtk.html" ?>
<title>GTK+-&GTK-version;</title>

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

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

<para>The <application>GTK+</application> package contains
<application>GTK+</application> Libraries. This is useful for
creating graphical user interfaces for applications.</para>

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

<sect3>
  <title><application><acronym>GTK</acronym>+</application> dependencies</title>

<sect4>
  <title>Required</title>

<para><xref linkend="GLib"/>, 
      <xref linkend="libtiff"/>, 
      <xref linkend="libjpeg"/>, and 
      X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)
</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 &amp;&amp;
make</command></userinput></screen>

<para>This package does not come with a test suite.</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 installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>

<para><option>--with-xinput=xfree</option>: This configuration
flag is necessary to utilize alternative input devices.</para>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
  <segtitle>Installed Program</segtitle>
  <segtitle>Installed Libraries</segtitle>
  <segtitle>Installed Directories</segtitle>
 
  <seglistitem>
    <seg>gtk-config</seg>
    <seg>libgdk.[so,a] and libgtk.[so,a]</seg>
    <seg>/etc/gtk, /usr/include/gtk-1.2 and /usr/share/themes</seg>
  </seglistitem>
</segmentedlist>
 
<variablelist>
  <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  <?dbfo list-presentation="list"?>
  <?dbhtml list-presentation="table"?>

<varlistentry id="gtk-config">
  <term><command>gtk-config</command></term>
  <listitem>
    <para>is a tool used by <command>configure</command> scripts to determine 
    the compiler and linker flags that should be used to compile and link 
    programs that use 
    <application><acronym>GTK</acronym>+</application>.</para>
    <indexterm zone="GTK gtk-config">
      <primary sortas="b-gtk-config">gtk-config</primary>
    </indexterm>
  </listitem>
</varlistentry>

<varlistentry id="libgtk">
  <term><filename class='libraryfile'>libgtk.[so,a]</filename></term>
  <listitem>
    <para>(GIMP Tool Kit) is a library for creating graphical user interfaces 
    similar to the Motif <quote>look and feel</quote>.</para>
    <indexterm zone="GTK libgtk">
      <primary sortas="c-libgtk">libgtk.[so,a]</primary>
    </indexterm>
  </listitem>
</varlistentry>

<varlistentry id="libgdk">
  <term><filename class='libraryfile'>libgdk.[so,a]</filename></term>
  <listitem>
    <para>is designed as a wrapper library that lies on top of Xlib. It 
    performs many common and desired operations for a programmer instead of 
    the programmer having to explicitly ask for such functionality from Xlib 
    directly.</para>
    <indexterm zone="GTK libgdk">
      <primary sortas="c-libgdk">libgdk.[so,a]</primary>
    </indexterm>
  </listitem>
</varlistentry>

</variablelist>  
</sect2>
</sect1>