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

diff --git a/gio/gdbusintrospection.c b/gio/gdbusintrospection.c
index a97fa43..e24e5a7 100644 (file)
--- 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.