The <pre/> section is rendered as-is on the page. That is, if all the lines are prefixed with 4 spaces the rendered page will also have them. Problem is if we put a box around such <pre/> because the content might not fix into it. Signed-off-by: Michal Privoznik <mprivozn@xxxxxxxxxx> --- docs/internals/command.html.in | 172 ++++++++++++++++++++--------------------- 1 file changed, 86 insertions(+), 86 deletions(-) diff --git a/docs/internals/command.html.in b/docs/internals/command.html.in index 17d1360..c6131e3 100644 --- a/docs/internals/command.html.in +++ b/docs/internals/command.html.in @@ -83,7 +83,7 @@ </p> <pre> - virCommandPtr cmd = virCommandNew("/usr/bin/dnsmasq"); +virCommandPtr cmd = virCommandNew("/usr/bin/dnsmasq"); </pre> <p> @@ -100,7 +100,7 @@ </p> <pre> - virCommandAddArg(cmd, "-strict-order"); +virCommandAddArg(cmd, "-strict-order"); </pre> <p> @@ -109,7 +109,7 @@ </p> <pre> - virCommandAddArgPair(cmd, "--conf-file", "/etc/dnsmasq.conf"); +virCommandAddArgPair(cmd, "--conf-file", "/etc/dnsmasq.conf"); </pre> <p> @@ -118,7 +118,7 @@ </p> <pre> - virCommandAddArgFormat(cmd, "%d", count); +virCommandAddArgFormat(cmd, "%d", count); </pre> <p> @@ -127,11 +127,11 @@ </p> <pre> - const char *const args[] = { - "--strict-order", "--except-interface", "lo", NULL - }; - virCommandAddArgSet(cmd, args); - virCommandAddArgList(cmd, "--domain", "localdomain", NULL); +const char *const args[] = { + "--strict-order", "--except-interface", "lo", NULL +}; +virCommandAddArgSet(cmd, args); +virCommandAddArgList(cmd, "--domain", "localdomain", NULL); </pre> <p> @@ -140,14 +140,14 @@ </p> <pre> - const char *const args[] = { - "/usr/bin/dnsmasq", - "--strict-order", "--except-interface", - "lo", "--domain", "localdomain", NULL - }; - virCommandPtr cmd1 = virCommandNewArgs(cmd, args); - virCommandPtr cmd2 = virCommandNewArgList("/usr/bin/dnsmasq", - "--domain", "localdomain", NULL); +const char *const args[] = { + "/usr/bin/dnsmasq", + "--strict-order", "--except-interface", + "lo", "--domain", "localdomain", NULL +}; +virCommandPtr cmd1 = virCommandNewArgs(cmd, args); +virCommandPtr cmd2 = virCommandNewArgList("/usr/bin/dnsmasq", + "--domain", "localdomain", NULL); </pre> <h3><a name="env">Setting up the environment</a></h3> @@ -163,7 +163,7 @@ </p> <pre> - virCommandAddEnvPassCommon(cmd); +virCommandAddEnvPassCommon(cmd); </pre> <p> @@ -177,8 +177,8 @@ </p> <pre> - virCommandAddEnvPass(cmd, "DISPLAY"); - virCommandAddEnvPass(cmd, "XAUTHORITY"); +virCommandAddEnvPass(cmd, "DISPLAY"); +virCommandAddEnvPass(cmd, "XAUTHORITY"); </pre> <p> @@ -187,7 +187,7 @@ </p> <pre> - virCommandAddEnvPair(cmd, "TERM", "xterm"); +virCommandAddEnvPair(cmd, "TERM", "xterm"); </pre> <p> @@ -196,7 +196,7 @@ </p> <pre> - virCommandAddEnvString(cmd, "TERM=xterm"); +virCommandAddEnvString(cmd, "TERM=xterm"); </pre> <h3><a name="misc">Miscellaneous other options</a></h3> @@ -210,7 +210,7 @@ </p> <pre> - virCommandDaemonize(cmd); +virCommandDaemonize(cmd); </pre> <p> @@ -221,7 +221,7 @@ </p> <pre> - virCommandSetPidFile(cmd, "/var/run/dnsmasq.pid"); +virCommandSetPidFile(cmd, "/var/run/dnsmasq.pid"); </pre> <p> @@ -240,7 +240,7 @@ </p> <pre> - virCommandClearCaps(cmd); +virCommandClearCaps(cmd); </pre> <h3><a name="fds">Managing file handles</a></h3> @@ -256,13 +256,13 @@ </p> <pre> - int sharedfd = open("cmd.log", "w+"); - int childfd = open("conf.txt", "r"); - virCommandPassFD(cmd, sharedfd, 0); - virCommandPassFD(cmd, childfd, - VIR_COMMAND_PASS_FD_CLOSE_PARENT); - if (VIR_CLOSE(sharedfd) < 0) - goto cleanup; +int sharedfd = open("cmd.log", "w+"); +int childfd = open("conf.txt", "r"); +virCommandPassFD(cmd, sharedfd, 0); +virCommandPassFD(cmd, childfd, + VIR_COMMAND_PASS_FD_CLOSE_PARENT); +if (VIR_CLOSE(sharedfd) < 0) + goto cleanup; </pre> <p> @@ -282,7 +282,7 @@ </p> <pre> - virCommandSetInputFD(cmd, 7); +virCommandSetInputFD(cmd, 7); </pre> <p> @@ -291,10 +291,10 @@ </p> <pre> - int outfd = open("out.log", "w+"); - int errfd = open("err.log", "w+"); - virCommandSetOutputFD(cmd, &outfd); - virCommandSetErrorFD(cmd, &errfd); +int outfd = open("out.log", "w+"); +int errfd = open("err.log", "w+"); +virCommandSetOutputFD(cmd, &outfd); +virCommandSetErrorFD(cmd, &errfd); </pre> <p> @@ -304,10 +304,10 @@ </p> <pre> - int outfd = -1; - int errfd = -1 - virCommandSetOutputFD(cmd, &outfd); - virCommandSetErrorFD(cmd, &errfd); +int outfd = -1; +int errfd = -1 +virCommandSetOutputFD(cmd, &outfd); +virCommandSetErrorFD(cmd, &errfd); </pre> <p> @@ -326,7 +326,7 @@ </p> <pre> - virCommandNonblockingFDs(cmd); +virCommandNonblockingFDs(cmd); </pre> <h3><a name="buffers">Feeding & capturing strings to/from the child</a></h3> @@ -350,8 +350,8 @@ </p> <pre> - const char *input = "Hello World\n"; - virCommandSetInputBuffer(cmd, input); +const char *input = "Hello World\n"; +virCommandSetInputBuffer(cmd, input); </pre> <p> @@ -362,9 +362,9 @@ </p> <pre> - char *output = NULL, *errors = NULL; - virCommandSetOutputBuffer(cmd, &output); - virCommandSetErrorBuffer(cmd, &errors); +char *output = NULL, *errors = NULL; +virCommandSetOutputBuffer(cmd, &output); +virCommandSetErrorBuffer(cmd, &errors); </pre> <p> @@ -392,7 +392,7 @@ </p> <pre> - virCommandSetWorkingDirectory(cmd, LOCALSTATEDIR); +virCommandSetWorkingDirectory(cmd, LOCALSTATEDIR); </pre> <h3><a name="hooks">Any additional hooks</a></h3> @@ -406,7 +406,7 @@ </p> <pre> - virCommandSetPreExecHook(cmd, hook, opaque); +virCommandSetPreExecHook(cmd, hook, opaque); </pre> <h3><a name="logging">Logging commands</a></h3> @@ -418,20 +418,20 @@ </p> <pre> - int logfd = ...; - char *timestamp = virTimestamp(); - char *string = NULL; +int logfd = ...; +char *timestamp = virTimestamp(); +char *string = NULL; - dprintf(logfd, "%s: ", timestamp); - VIR_FREE(timestamp); - virCommandWriteArgLog(cmd, logfd); +dprintf(logfd, "%s: ", timestamp); +VIR_FREE(timestamp); +virCommandWriteArgLog(cmd, logfd); - string = virCommandToString(cmd); - if (string) - VIR_DEBUG("about to run %s", string); - VIR_FREE(string); - if (virCommandRun(cmd, NULL) < 0) - return -1; +string = virCommandToString(cmd); +if (string) + VIR_DEBUG("about to run %s", string); +VIR_FREE(string); +if (virCommandRun(cmd, NULL) < 0) + return -1; </pre> <h3><a name="sync">Running commands synchronously</a></h3> @@ -443,8 +443,8 @@ </p> <pre> - if (virCommandRun(cmd, NULL) < 0) - return -1; +if (virCommandRun(cmd, NULL) < 0) + return -1; </pre> <p> @@ -465,19 +465,19 @@ </p> <pre> - int status; - if (virCommandRun(cmd, &status) < 0) - return -1; - if (status == 1) { - ...do stuff... - } +int status; +if (virCommandRun(cmd, &status) < 0) + return -1; +if (status == 1) { + ...do stuff... +} - virCommandRawStatus(cmd2); - if (virCommandRun(cmd2, &status) < 0) - return -1; - if (WIFEXITED(status) && WEXITSTATUS(status) == 1) { - ...do stuff... - } +virCommandRawStatus(cmd2); +if (virCommandRun(cmd2, &status) < 0) + return -1; +if (WIFEXITED(status) && WEXITSTATUS(status) == 1) { + ...do stuff... +} </pre> <h3><a name="async">Running commands asynchronously</a></h3> @@ -490,19 +490,19 @@ </p> <pre> - pid_t pid; - if (virCommandRunAsync(cmd, &pid) < 0) - return -1; +pid_t pid; +if (virCommandRunAsync(cmd, &pid) < 0) + return -1; - ... do something while pid is running ... +... do something while pid is running ... - int status; - if (virCommandWait(cmd, &status) < 0) - return -1; +int status; +if (virCommandWait(cmd, &status) < 0) + return -1; - if (WEXITSTATUS(status)...) { - ..do stuff.. - } +if (WEXITSTATUS(status)...) { + ..do stuff.. +} </pre> <p> @@ -540,7 +540,7 @@ </p> <pre> - virCommandFree(cmd); +virCommandFree(cmd); </pre> <p> -- 2.8.4 -- libvir-list mailing list libvir-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/libvir-list