[telepathy-doc/master] Add example

[Davyd Madeley]

---
 docs/book/C/basics.xml                  |    8 +++++++-
 docs/examples/glib_get_roster/example.c |    2 ++
 2 files changed, 9 insertions(+), 1 deletions(-)

diff --git a/docs/book/C/basics.xml b/docs/book/C/basics.xml
index 5e8902b..06eee57 100644
--- a/docs/book/C/basics.xml
+++ b/docs/book/C/basics.xml
@@ -816,9 +816,15 @@
 	 <ulink url="&url_telepathy_glib_base;connection.html#tp-connection-call-when-ready"><methodname>tp_connection_call_when_ready</methodname></ulink>
 	 for a <classname>TpConnection</classname>, or
 	 <ulink url="&url_telepathy_glib_base;channel.html#tp-channel-call-when-ready"><methodname>tp_channel_call_when_ready</methodname></ulink>
-	 for a <classname>TpChannel</classname>.
+	 for a <classname>TpChannel</classname>. See
+         <xref linkend="ex.basics.language-bindings.telepathy-glib.ready"/>.
 	</para>
 
+        <example id="ex.basics.language-bindings.telepathy-glib.ready"
+                 file="glib_get_roster/example.c">
+         <title>Readiness Callback</title>
+        </example>
+
 	<tip>
 	 <title>TpConnection Readiness</title>
 	 <para>
diff --git a/docs/examples/glib_get_roster/example.c b/docs/examples/glib_get_roster/example.c
index c208610..88ef75a 100644
--- a/docs/examples/glib_get_roster/example.c
+++ b/docs/examples/glib_get_roster/example.c
@@ -211,12 +211,14 @@ main (int argc, char **argv)
 		g_error ("%s", error->message);
 	}
 
+	/* begin ex.basics.language-bindings.telepathy-glib.ready */
 	/* we want to request the gabble CM */
 	TpConnectionManager *cm = tp_connection_manager_new (bus_daemon,
 			"gabble", NULL, &error);
 	if (error) g_error ("%s", error->message);
 
 	tp_connection_manager_call_when_ready (cm, cm_ready, NULL, NULL, NULL);
+	/* end ex.basics.language-bindings.telepathy-glib.ready */
 
 	/* set up a signal handler */
 	struct sigaction sa = { 0 };
-- 
1.5.6.5