From 6af58c620886854276732dd0b1c7841e6dadd62e Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Tue, 23 Mar 2010 11:08:28 -0400
Subject: [PATCH] Add notes about gobject-introspection

---
 INSTALL.in                       |  2 ++
 README.in                        |  5 +++++
 docs/reference/gtk/building.sgml | 20 ++++++++++++++++++--
 3 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/INSTALL.in b/INSTALL.in
index e28a0674a8..5181298014 100644
--- a/INSTALL.in
+++ b/INSTALL.in
@@ -7,6 +7,8 @@ GTK+ requires the following packages:
    location as GTK+. GTK+ @GTK_VERSION@ requires at least GLib 2.23.6,
    Pango 1.20, ATK 1.29.2 and cairo 1.6.0.
 
+ - gobject-introspection 0.6.7 or newer.
+
  - The TIFF, PNG, and JPEG image loading libraries. You most
    likely have these installed on your system already. If not
    these libraries are available from:
diff --git a/README.in b/README.in
index 316db6a095..f7108acbe7 100644
--- a/README.in
+++ b/README.in
@@ -41,6 +41,11 @@ Release notes for 2.20
   attribute of the <object>. Use gtk_buildable_get_name() instead of
   gtk_widget_get_name() to obtain the ID.
 
+* GTK+ now includes introspection data, as a consequence, it gained a
+  dependency on gobject-introspection. It is possible to build without
+  introspection by passing --disable-introspection to configure.
+
+
 Release notes for 2.18
 ======================
 
diff --git a/docs/reference/gtk/building.sgml b/docs/reference/gtk/building.sgml
index 1842d3708a..3d3da46a67 100644
--- a/docs/reference/gtk/building.sgml
+++ b/docs/reference/gtk/building.sgml
@@ -244,17 +244,24 @@ 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> 
@@ -368,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>
 
@@ -580,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>