Add notes about gobject-introspection

[~andy/gtk] / docs / reference / gtk / building.sgml

diff --git a/docs/reference/gtk/building.sgml b/docs/reference/gtk/building.sgml
index dc7fcfe807213b3af941965604cfcbedf4fed371..3d3da46a6769b3dd17d4760499f51b617dff8612 100644 (file)
--- a/docs/reference/gtk/building.sgml
+++ b/docs/reference/gtk/building.sgml
@@ -1,3 +1,7 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
 <refentry id="gtk-building" revision="6 Sept 2001">
 <refmeta>
 <refentrytitle>Compiling the GTK+ libraries</refentrytitle>
@@ -240,17 +244,35 @@ How to compile GTK+ itself
        <para>
          The <ulink url="http://www.fontconfig.org">fontconfig</ulink>
          library provides Pango with a standard way of locating
-         fonts and matching them against font names. 
+         fonts and matching them against font names.
        </para>
       </listitem>
       <listitem>
        <para>
          <ulink url="http://www.cairographics.org">Cairo</ulink>
-          is a graphics library that supports vector graphics and image 
+          is a graphics library that supports vector graphics and image
           compositing. Both Pango and GTK+ use cairo for much of their
           drawing.
         </para>
       </listitem>
+      <listitem>
+       <para>
+         <ulink url="http://live.gnome.org/GObjectIntrospection">gobject-introspection</ulink>
+          is a framework for making introspection data available to
+          language bindings.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          The <ulink url="http://www.freedesktop.org/wiki/Software/shared-mime-info">shared-mime-info</ulink> 
+          package is not a hard dependency of GTK+, but it contains definitions 
+          for mime types that are used by GIO and, indirectly, by GTK+. 
+          gdk-pixbuf will use GIO for mime type detection if possible. For this 
+          to work, shared-mime-info needs to be installed and 
+          <envar>XDG_DATA_DIRS</envar> set accordingly at configure time. 
+          Otherwise, gdk-pixbuf falls back to its built-in mime type detection.
+        </para>
+      </listitem>
     </itemizedlist>
   </refsect1>
   <refsect1 id="building">
@@ -353,6 +375,9 @@ How to compile GTK+ itself
          <group>
            <arg>--with-gdktarget=[x11|win32|quartz|directfb]</arg>
          </group>
+          <group>
+           <arg>--disable-introspection</arg>
+          </group>
        </cmdsynopsis>
       </para>
 
@@ -565,7 +590,13 @@ How to compile GTK+ itself
           for the Linux framebuffer.
        </para>
       </formalpara>
+      <formalpara>
+        <title><systemitem>--disable-introspection</systemitem></title>
 
+        <para>
+          Build without introspection support.
+        </para>
+      </formalpara>
     </refsect1>
 
 </refentry>