[glib/glib-2-58: 8/21] gdbusmessage: Clarify error returns for g_dbus_message_new_from_blob()

[Philip Withnall <pwithnall src gnome org>]

commit 90a1df4949f20069638f202b5714e50c6c4b03d6
Author: Philip Withnall <withnall endlessm com>
Date:   Tue Sep 18 14:48:43 2018 +0100

    gdbusmessage: Clarify error returns for g_dbus_message_new_from_blob()
    
    Signed-off-by: Philip Withnall <withnall endlessm com>

 gio/gdbusmessage.c | 3 +++
 1 file changed, 3 insertions(+)
---
diff --git a/gio/gdbusmessage.c b/gio/gdbusmessage.c
index 22fcb2025..97888ec57 100644
--- a/gio/gdbusmessage.c
+++ b/gio/gdbusmessage.c
@@ -2006,6 +2006,9 @@ g_dbus_message_bytes_needed (guchar  *blob,
  * order that the message was in can be retrieved using
  * g_dbus_message_get_byte_order().
  *
+ * If the @blob cannot be parsed, contains invalid fields, or contains invalid
+ * headers, %G_IO_ERROR_INVALID_ARGUMENT will be returned.
+ *
  * Returns: A new #GDBusMessage or %NULL if @error is set. Free with
  * g_object_unref().
  *