From 6f23c33831f69ef111d22491586d1dfdd8ca3693 Mon Sep 17 00:00:00 2001
From: Rui Matos <tiagomatos@gmail.com>
Date: Tue, 10 Jul 2012 11:37:56 +0200
Subject: [PATCH] GDBusNodeInfo: the XML string must contain exactly one node
 element

Make the documentation clear about this.

https://bugzilla.gnome.org/show_bug.cgi?id=679671
---
 gio/gdbusintrospection.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gio/gdbusintrospection.c b/gio/gdbusintrospection.c
index a97fa43c1..e24e5a7e9 100644
--- a/gio/gdbusintrospection.c
+++ b/gio/gdbusintrospection.c
@@ -1755,6 +1755,9 @@ parser_error (GMarkupParseContext *context,
  *
  * Parses @xml_data and returns a #GDBusNodeInfo representing the data.
  *
+ * The introspection XML must contain exactly one top-level
+ * <tag class="starttag">node</tag> element.
+ *
  * Note that this routine is using a
  * <link linkend="glib-Simple-XML-Subset-Parser.description">GMarkup</link>-based
  * parser that only accepts a subset of valid XML documents.