doc: edit schema assert messages for clarity and grammar

Use DX names (acrn:title) instead of element names in messages.
Add missing message in rdt_support.xsd (all asserts need an annotation
with documentation for the error message that will be reported).

Tracked-On: #7685

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder
2022-06-03 13:02:14 -07:00
committed by acrnsi-robot
parent ecaecaf904
commit 54e275c8bb
8 changed files with 30 additions and 40 deletions

View File

@@ -10,14 +10,14 @@
every $vm_name in $vuart_connection/endpoint/vm_name/text() satisfies
count($vuart_connection/endpoint[./vm_name/text()=$vm_name]) = 1">
<xs:annotation acrn:severity="error" acrn:report-on="$vuart_connection/endpoint">
<xs:documentation>VM "{$vm_name}" can't connected to itself</xs:documentation>
<xs:documentation>The vUART configuration of VM "{$vm_name}" may not connect to itself.</xs:documentation>
</xs:annotation>
</xs:assert>
<xs:assert test="every $io_port in /acrn-config//endpoint/io_port satisfies
count(//endpoint[./vm_name=$io_port/ancestor::endpoint/vm_name and io_port=$io_port]) = 1">
<xs:annotation acrn:severity="error" acrn:report-on="$io_port">
<xs:documentation>VM "{$io_port/ancestor::endpoint/vm_name}" use duplicate "{$io_port}"</xs:documentation>
<xs:documentation>VM "{$io_port/ancestor::endpoint/vm_name}" may not duplicate use of port "{$io_port}."</xs:documentation>
</xs:annotation>
</xs:assert>
@@ -32,7 +32,7 @@
then count(//endpoint[./vm_name=$console_port/ancestor::vm/name and io_port='0x2E8']) &lt; 1
else true()">
<xs:annotation acrn:severity="error" acrn:report-on="$console_port">
<xs:documentation>VM "{$console_port/ancestor::vm/name}" use duplicate "{$console_port}"</xs:documentation>
<xs:documentation>VM "{$console_port/ancestor::vm/name}" may not duplicate use of console "{$console_port}."</xs:documentation>
</xs:annotation>
</xs:assert>