From: Peter Krempa <pkrempa@redhat.com>
Date: Wed, 27 May 2015 11:42:32 +0000 (+0200)
Subject: monitor: Move documentation for qemuMonitorGetBalloonInfo
X-Git-Tag: v1.2.17-rc1~294
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=efe8b44a84c83afa277539e6a982fd4f1891c098;p=thirdparty%2Flibvirt.git

monitor: Move documentation for qemuMonitorGetBalloonInfo

Document the top level function rather than both bottom level ones. It
makes looking the docs up quicker.
---

diff --git a/src/qemu/qemu_monitor.c b/src/qemu/qemu_monitor.c
index f959b74218..45414cfee7 100644
--- a/src/qemu/qemu_monitor.c
+++ b/src/qemu/qemu_monitor.c
@@ -1688,6 +1688,10 @@ qemuMonitorGetVirtType(qemuMonitorPtr mon,
 }
 
 
+/**
+ * Returns: 0 if balloon not supported, +1 if balloon query worked
+ * or -1 on failure
+ */
 int
 qemuMonitorGetBalloonInfo(qemuMonitorPtr mon,
                           unsigned long long *currmem)
diff --git a/src/qemu/qemu_monitor_json.c b/src/qemu/qemu_monitor_json.c
index e2811405c6..2287398586 100644
--- a/src/qemu/qemu_monitor_json.c
+++ b/src/qemu/qemu_monitor_json.c
@@ -1365,12 +1365,9 @@ qemuMonitorJSONUpdateVideoMemorySize(qemuMonitorPtr mon,
 }
 
 
-/*
- * Returns: 0 if balloon not supported, +1 if balloon query worked
- * or -1 on failure
- */
-int qemuMonitorJSONGetBalloonInfo(qemuMonitorPtr mon,
-                                  unsigned long long *currmem)
+int
+qemuMonitorJSONGetBalloonInfo(qemuMonitorPtr mon,
+                              unsigned long long *currmem)
 {
     int ret;
     virJSONValuePtr cmd = qemuMonitorJSONMakeCommand("query-balloon",
diff --git a/src/qemu/qemu_monitor_text.c b/src/qemu/qemu_monitor_text.c
index f26bc7892d..ad36dd0933 100644
--- a/src/qemu/qemu_monitor_text.c
+++ b/src/qemu/qemu_monitor_text.c
@@ -663,12 +663,9 @@ static int qemuMonitorParseBalloonInfo(char *text,
 /* The reply from QEMU contains 'ballon: actual=421' where value is in MB */
 #define BALLOON_PREFIX "balloon: "
 
-/*
- * Returns: 0 if balloon not supported, +1 if balloon query worked
- * or -1 on failure
- */
-int qemuMonitorTextGetBalloonInfo(qemuMonitorPtr mon,
-                                  unsigned long long *currmem)
+int
+qemuMonitorTextGetBalloonInfo(qemuMonitorPtr mon,
+                              unsigned long long *currmem)
 {
     char *reply = NULL;
     int ret = -1;