From 383add1ab2ee742b07eaf991ffbf88c6b25e1a55 Mon Sep 17 00:00:00 2001
From: Emmanuele Bassi <ebassi@openedhand.com>
Date: Mon, 18 Feb 2008 11:06:23 +0000
Subject: [PATCH] 2008-02-18  Emmanuele Bassi  <ebassi@openedhand.com>

	* clutter-docs.sgml: Add building instructions for OSX
---
 doc/reference/ChangeLog         |  4 ++++
 doc/reference/clutter-docs.sgml | 34 ++++++++++++++++++++++++++++++++-
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/doc/reference/ChangeLog b/doc/reference/ChangeLog
index 0e2e77989..44f2fcd64 100644
--- a/doc/reference/ChangeLog
+++ b/doc/reference/ChangeLog
@@ -1,3 +1,7 @@
+2008-02-18  Emmanuele Bassi  <ebassi@openedhand.com>
+
+	* clutter-docs.sgml: Add building instructions for OSX
+
 2008-02-18  Emmanuele Bassi  <ebassi@openedhand.com>
 
 	* clutter-animation.sgml: Fix warning
diff --git a/doc/reference/clutter-docs.sgml b/doc/reference/clutter-docs.sgml
index 095af186f..52ab5d1bb 100644
--- a/doc/reference/clutter-docs.sgml
+++ b/doc/reference/clutter-docs.sgml
@@ -266,7 +266,39 @@
 
       <section id='building-osx'>
           <title>OSX</title>
-            <para></para>
+          <para>The recommended way of building Clutter on OSX is to use
+            <ulink href="http://live.gnome.org/Jhbuild">Jhbuild</ulink>,
+            following the documentation for building the GTK+ stack as shown
+            <ulink href="http://developer.imendio.com/projects/gtk-macosx/build-instructions">here</ulink>.
+          </para>
+
+          <para>
+            Jhbuild depends on SVN, which can be installed on OSX by using
+            the <ulink href="http://www.macports.org/">MacPorts</ulink>
+            project.
+          </para>
+
+          <para>
+            XCode should also be installed, either from the OSX installation
+            disk or downloading it from the Apple website.
+          </para>
+
+          <para>
+            Due to Clutter's dependency on GDK-Pixbuf, GTK+ for OSX must
+            also be built. After building GTK+, extract the files from
+            Clutter's release tar archive or check out the project from
+            SVN. Clutter OSX backend is built by passing the
+            <literal>--with-flavour=osx</literal> command line argument
+            to the configure script.
+          </para>
+
+          <para>
+            GTK-Doc is not working on OSX, so API reference generation
+            should also be disabled when building Clutter, by using
+            the <literal>--disable-docs</literal> and
+            <literal>--disable-gtk-doc</literal> command line argument
+            to the configure script.
+          </para>
 
       </section>
    </section>