[glib/glib-2-56: 9/17] gdbusmessage: Clarify error returns for g_dbus_message_new_from_blob()

[Philip Withnall <pwithnall src gnome org>]

commit c387ab9c9d7a29d30842187ea2ccc8093b155fb7
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 40e7dce0c..78b842547 100644
--- a/gio/gdbusmessage.c
+++ b/gio/gdbusmessage.c
@@ -2004,6 +2004,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().
  *