docs: fix layout of code snippets

Similar to commit 52dbeac, we should indent code snippets in
other places to ensure they appear correctly in html.  See
http://libvirt.org/html/libvirt-libvirt.html#virNodeGetCPUStats
for an example improved by this patch.  Also fix some missing
semicolons in the examples.

* src/libvirt.c: Indent code samples in comments.

Signed-off-by: Eric Blake <eblake@redhat.com>
This commit is contained in:
Eric Blake 2013-12-28 11:10:06 -07:00
parent 9d30e078be
commit eb70ceba8a

View File

@ -7629,8 +7629,8 @@ error:
* *
* Here is a sample code snippet: * Here is a sample code snippet:
* *
* if ((virNodeGetCPUStats(conn, cpuNum, NULL, &nparams, 0) == 0) && * if (virNodeGetCPUStats(conn, cpuNum, NULL, &nparams, 0) == 0 &&
* (nparams != 0)) { * nparams != 0) {
* if ((params = malloc(sizeof(virNodeCPUStats) * nparams)) == NULL) * if ((params = malloc(sizeof(virNodeCPUStats) * nparams)) == NULL)
* goto error; * goto error;
* memset(params, 0, sizeof(virNodeCPUStats) * nparams); * memset(params, 0, sizeof(virNodeCPUStats) * nparams);
@ -7722,8 +7722,8 @@ error:
* *
* Here is the sample code snippet: * Here is the sample code snippet:
* *
* if ((virNodeGetMemoryStats(conn, cellNum, NULL, &nparams, 0) == 0) && * if (virNodeGetMemoryStats(conn, cellNum, NULL, &nparams, 0) == 0 &&
* (nparams != 0)) { * nparams != 0) {
* if ((params = malloc(sizeof(virNodeMemoryStats) * nparams)) == NULL) * if ((params = malloc(sizeof(virNodeMemoryStats) * nparams)) == NULL)
* goto error; * goto error;
* memset(params, cellNum, 0, sizeof(virNodeMemoryStats) * nparams); * memset(params, cellNum, 0, sizeof(virNodeMemoryStats) * nparams);
@ -9381,23 +9381,20 @@ error:
* on each array element, then calling free() on @domains. * on each array element, then calling free() on @domains.
* *
* Example of usage: * Example of usage:
*
* virDomainPtr *domains; * virDomainPtr *domains;
* size_t i; * size_t i;
* int ret; * int ret;
* unsigned int flags = VIR_CONNECT_LIST_DOMAINS_RUNNING | * unsigned int flags = VIR_CONNECT_LIST_DOMAINS_RUNNING |
* VIR_CONNECT_LIST_DOMAINS_PERSISTENT; * VIR_CONNECT_LIST_DOMAINS_PERSISTENT;
*
* ret = virConnectListAllDomains(conn, &domains, flags); * ret = virConnectListAllDomains(conn, &domains, flags);
* if (ret < 0) * if (ret < 0)
* error(); * error();
*
* for (i = 0; i < ret; i++) { * for (i = 0; i < ret; i++) {
* do_something_with_domain(domains[i]); * do_something_with_domain(domains[i]);
*
* //here or in a separate loop if needed * //here or in a separate loop if needed
* virDomainFree(domains[i]); * virDomainFree(domains[i]);
* } * }
*
* free(domains); * free(domains);
*/ */
int int
@ -17023,7 +17020,7 @@ virStreamRef(virStreamPtr stream)
* API looks like * API looks like
* *
* virStreamPtr st = virStreamNew(conn, 0); * virStreamPtr st = virStreamNew(conn, 0);
* int fd = open("demo.iso", O_RDONLY) * int fd = open("demo.iso", O_RDONLY);
* *
* virConnectUploadFile(conn, "demo.iso", st); * virConnectUploadFile(conn, "demo.iso", st);
* *
@ -17040,7 +17037,7 @@ virStreamRef(virStreamPtr stream)
* } * }
* int offset = 0; * int offset = 0;
* while (offset < got) { * while (offset < got) {
* int sent = virStreamSend(st, buf+offset, got-offset) * int sent = virStreamSend(st, buf+offset, got-offset);
* if (sent < 0) { * if (sent < 0) {
* virStreamAbort(st); * virStreamAbort(st);
* goto done; * goto done;
@ -17117,7 +17114,7 @@ error:
* API looks like * API looks like
* *
* virStreamPtr st = virStreamNew(conn, 0); * virStreamPtr st = virStreamNew(conn, 0);
* int fd = open("demo.iso", O_WRONLY, 0600) * int fd = open("demo.iso", O_WRONLY, 0600);
* *
* virConnectDownloadFile(conn, "demo.iso", st); * virConnectDownloadFile(conn, "demo.iso", st);
* *
@ -17132,7 +17129,7 @@ error:
* } * }
* int offset = 0; * int offset = 0;
* while (offset < got) { * while (offset < got) {
* int sent = write(fd, buf+offset, got-offset) * int sent = write(fd, buf + offset, got - offset);
* if (sent < 0) { * if (sent < 0) {
* virStreamAbort(st); * virStreamAbort(st);
* goto done; * goto done;
@ -17216,7 +17213,7 @@ error:
* } * }
* *
* virStreamPtr st = virStreamNew(conn, 0); * virStreamPtr st = virStreamNew(conn, 0);
* int fd = open("demo.iso", O_RDONLY) * int fd = open("demo.iso", O_RDONLY);
* *
* virConnectUploadFile(conn, st); * virConnectUploadFile(conn, st);
* if (virStreamSendAll(st, mysource, &fd) < 0) { * if (virStreamSendAll(st, mysource, &fd) < 0) {
@ -17313,7 +17310,7 @@ cleanup:
* } * }
* *
* virStreamPtr st = virStreamNew(conn, 0); * virStreamPtr st = virStreamNew(conn, 0);
* int fd = open("demo.iso", O_WRONLY) * int fd = open("demo.iso", O_WRONLY);
* *
* virConnectUploadFile(conn, st); * virConnectUploadFile(conn, st);
* if (virStreamRecvAll(st, mysink, &fd) < 0) { * if (virStreamRecvAll(st, mysink, &fd) < 0) {