source: general/genlib/glib2.xml@ 32ccdf34

<?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 glib2-download-http "&gnome-download-http;/glib/2.10/glib-&glib2-version;.tar.bz2">
  <!ENTITY glib2-download-ftp  "&gnome-download-ftp;/glib/2.10/glib-&glib2-version;.tar.bz2">
  <!ENTITY glib2-md5sum        "718961161ee1692c216a2d542196a04a">
  <!ENTITY glib2-size          "2.7 MB">
  <!ENTITY glib2-buildsize     "43.6 MB">
  <!ENTITY glib2-time          "0.5 SBU (additional 2.7 SBU to run the test suite)">
]>

<sect1 id="glib2" xreflabel="GLib-&glib2-version;">
  <?dbhtml filename="glib2.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
    <keywordset>
      <keyword role="package">glib-&glib2-version;.tar</keyword>
      <keyword role="ftpdir">glib</keyword>
    </keywordset>
  </sect1info>

  <title>GLib-&glib2-version;</title>

  <indexterm zone="glib2">
    <primary sortas="a-GLib2">GLib2</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to GLib</title>

    <para>The <application>GLib</application> package contains a low-level core
    library. This is useful for providing data structure handling for C,
    portability wrappers and interfaces for such runtime functionality as an
    event loop, threads, dynamic loading, and an object system.</para>

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

    <bridgehead renderas="sect3">GLib Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="pkgconfig"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="gtk-doc"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/glib2"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of GLib</title>

    <para>Install <application>GLib</application> by running the following
    commands:</para>

<screen><userinput>sed -i -e "/g_assert (test_count_threads () == limit);/d"  \
   tests/threadpool-test.c &amp;&amp;       
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

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

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><command>sed -i -e "/g_assert (test_count_threads () == limit);/d"
    tests/threadpool-test.c</command>: This command eliminates an unneeded
    assertion in the test suite.  The <command>make check</command> will 
    fail without this command.</para>
    
    <para><option>--enable-gtk-doc</option>: This switch will rebuild
    the API documentation during the <command>make</command> command.</para>

  </sect2>

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

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>glib-genmarshal, glib-gettextize, glib-mkenums, and
        gobject-query</seg>
        <seg>libglib-2.0.so, libgobject-2.0.so, libgmodule-2.0.so, and
        libgthread-2.0.so</seg>
        <seg>/usr/include/glib-2.0, /usr/lib/glib-2.0, /usr/share/glib-2.0,
        /usr/share/gtk-doc/html/glib, and /usr/share/gtk-doc/html/gobject</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="glib-genmarshal">
        <term><command>glib-genmarshal</command></term>
        <listitem>
          <para>is a C code marshaller generation utility for GLib
          closures.</para>
          <indexterm zone="glib2 glib-genmarshal">
            <primary sortas="b-glib-genmarshal">glib-genmarshal</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="glib-gettextize">
        <term><command>glib-gettextize</command></term>
        <listitem>
          <para>is a variant of the <application>gettext</application>
          internationalization utility.</para>
          <indexterm zone="glib2 glib-gettextize">
            <primary sortas="b-glib-gettextize">glib-gettextize</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="glib-mkenums">
        <term><command>glib-mkenums</command></term>
        <listitem>
          <para>is a C language enum description generation utility.</para>
          <indexterm zone="glib2 glib-mkenums">
            <primary sortas="b-glib-mkenums">glib-mkenums</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gobject-query">
        <term><command>gobject-query</command></term>
        <listitem>
          <para>is a small utility that draws a tree of types.</para>
          <indexterm zone="glib2 gobject-query">
            <primary sortas="b-gobject-query">gobject-query</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="GLib-libraries">
        <term>GLib libraries</term>
          <listitem>
          <para>contain a low-level core library for the
          <application>GIMP</application> Toolkit.</para>
          <indexterm zone="glib2 GLib-libraries">
            <primary sortas="c-GLib-libraries">Glib libraries</primary>
          </indexterm>
          </listitem>
        </varlistentry>

    </variablelist>

  </sect2>

</sect1>