[libvirt] [PATCH 12/35] monitor: Move documentation for qemuMonitorGetBalloonInfo

Document the top level function rather than both bottom level ones. It makes looking the docs up quicker. --- src/qemu/qemu_monitor.c | 4 ++++ src/qemu/qemu_monitor_json.c | 9 +++------ src/qemu/qemu_monitor_text.c | 9 +++------ 3 files changed, 10 insertions(+), 12 deletions(-) diff --git a/src/qemu/qemu_monitor.c b/src/qemu/qemu_monitor.c index f959b74..45414cf 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 e281140..2287398 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 f26bc78..ad36dd0 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; -- 2.4.1