From aa69441cba3d9552049a4169e6529a71420c7272 Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Tue, 22 Nov 2011 10:30:07 -0700 Subject: [PATCH] docs: fix grammar of capabilities * docs/formatcaps.html.in: Avoid run-on sentence, wrap lines. --- docs/formatcaps.html.in | 45 ++++++++++++++++++++++++----------------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/docs/formatcaps.html.in b/docs/formatcaps.html.in index ce6f9a644a..423bc480ec 100644 --- a/docs/formatcaps.html.in +++ b/docs/formatcaps.html.in @@ -64,25 +64,32 @@ BIOS you will see

</guest> ... </capabilities> -

The first block (in red) indicates the host hardware capabilities, currently -it is limited to the CPU properties and the power management features of -the host platform, but other information may be available, it shows the CPU architecture, -topology, model name, and additional features which are not included in the model but the -CPU provides them. Features of the chip are shown within the feature block (the block is -similar to what you will find in a Xen fully virtualized domain description). Further, -the power management features supported by the host are shown, such as Suspend-to-RAM (S3) -and Suspend-to-Disk (S4). In case the query for power management features succeeded but the -host does not support any such feature, then an empty <power_management/> -tag will be shown. Otherwise, if the query itself failed, no such tag will -be displayed (i.e., there will not be any power_management block or empty tag in the XML).

-

The second block (in blue) indicates the paravirtualization support of the -Xen support, you will see the os_type of xen to indicate a paravirtual -kernel, then architecture information and potential features.

-

The third block (in green) gives similar information but when running a -32 bit OS fully virtualized with Xen using the hvm support.

-

This section is likely to be updated and augmented in the future, see the -discussion which led to the capabilities format in the mailing-list -archives.

+

The first block (in red) indicates the host hardware + capabilities, such as CPU properties and the power + management features of the host platform. CPU models are + shown as additional features relative to the closest base + model, within a feature block (the block is similar to what + you will find in a Xen fully virtualized domain + description). Further, the power management features + supported by the host are shown, such as Suspend-to-RAM (S3) + and Suspend-to-Disk (S4). In case the query for power + management features succeeded but the host does not support + any such feature, then an empty <power_management/> + tag will be shown. Otherwise, if the query itself failed, no + such tag will be displayed (i.e., there will not be any + power_management block or empty tag in the XML).

+

The second block (in blue) indicates the paravirtualization + support of the Xen support, you will see the os_type of xen + to indicate a paravirtual kernel, then architecture + information and potential features.

+

The third block (in green) gives similar information but + when running a 32 bit OS fully virtualized with Xen using + the hvm support.

+

This section is likely to be updated and augmented in the + future, + see the + discussion which led to the capabilities format in the + mailing-list archives.

-- GitLab