From c4dadf239315a9636f4f7b0562e16aa881d9d111 Mon Sep 17 00:00:00 2001
From: Claudio Bley <cbley@av-test.de>
Date: Thu, 9 Jan 2014 07:58:51 +0100
Subject: [PATCH] Clarify documentation on possible return values in case of
 errors

---
 src/libvirt.c | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/libvirt.c b/src/libvirt.c
index f287933be2..87a4d46fc4 100644
--- a/src/libvirt.c
+++ b/src/libvirt.c
@@ -14423,8 +14423,8 @@ virNodeDeviceGetName(virNodeDevicePtr dev)
  *
  * Accessor for the parent of the device
  *
- * Returns the name of the device's parent, or NULL if the
- * device has no parent.
+ * Returns the name of the device's parent, or NULL if an
+ * error occurred or when the device has no parent.
  */
 const char *
 virNodeDeviceGetParent(virNodeDevicePtr dev)
@@ -14454,7 +14454,8 @@ virNodeDeviceGetParent(virNodeDevicePtr dev)
  *
  * Accessor for the number of capabilities supported by the device.
  *
- * Returns the number of capabilities supported by the device.
+ * Returns the number of capabilities supported by the device or -1
+ * in case of error.
  */
 int
 virNodeDeviceNumOfCaps(virNodeDevicePtr dev)
@@ -14489,7 +14490,8 @@ error:
  *
  * Lists the names of the capabilities supported by the device.
  *
- * Returns the number of capability names listed in @names.
+ * Returns the number of capability names listed in @names or -1
+ * in case of error.
  */
 int
 virNodeDeviceListCaps(virNodeDevicePtr dev,
-- 
GitLab