[gtk+] Add notes about gobject-introspection

[Matthias Clasen <matthiasc src gnome org>]

commit eb42c9e9cee8de4626da345113e1b40058d96354
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Mar 23 11:08:28 2010 -0400

    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 e28a067..5181298 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 316db6a..f7108ac 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 1842d37..3d3da46 100644
--- a/docs/reference/gtk/building.sgml
+++ b/docs/reference/gtk/building.sgml
@@ -244,18 +244,25 @@ 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 
@@ -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>