openkylin
/
libvirt
mirror of https://gitee.com/openkylin/libvirt.git
9
0
Fork 0
Code Issues Projects Releases Wiki Activity
libvirt/docs/testapi.html.in

36 lines
1.8 KiB
HTML
Raw Normal View History

Fix multiple formatting problems in HTML docs The rule generating the HTML docs passing the --html flag to xsltproc. This makes it use the legacy HTML parser, which either ignores or tries to fix all sorts of broken XML tags. There's no reason why we should be writing broken XML in the first place, so removing --html and adding the XHTML doctype to all files forces us to create good XML. This adds the XHTML doc type and fixes many, many XML tag problems it exposes. Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2013-05-03 22:25:37 +08:00
<?xml version="1.0" encoding="UTF-8"?>
docs: switch to using HTML5 doctype declaration The HTML5 doctype is simply <!DOCTYPE html> no DTD is present because HTML5 is no longer defined as an extension of SGML. XSL has no way to natively output a doctype without a public or system identifier, so we have to use an <xsl:text> hack instead. See also https://dev.w3.org/html5/html-author/#doctype-declaration Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-07-27 01:01:25 +08:00
<!DOCTYPE html>
Fix multiple formatting problems in HTML docs The rule generating the HTML docs passing the --html flag to xsltproc. This makes it use the legacy HTML parser, which either ignores or tries to fix all sorts of broken XML tags. There's no reason why we should be writing broken XML in the first place, so removing --html and adding the XHTML doctype to all files forces us to create good XML. This adds the XHTML doc type and fixes many, many XML tag problems it exposes. Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2013-05-03 22:25:37 +08:00
<html xmlns="http://www.w3.org/1999/xhtml">
Add documentation about test suites Create a new top level entry, add a new page listing the 3 test suites, and then one page for the TCK and one page for libvirt-test-API
2011-05-11 19:18:38 +08:00
<body>
<h1>libvirt-test-API: Python based test suite </h1>
<p>Libvirt-test-API is a powerful test tool designed to complement
existing libvirt test tools such as libvirt-TCK and the internal
test suite. It aims at functional regression testing, trying to
exercise nearly all the API by the way of the Python bindings.</p>
<p>The test API currently covers:</p>
<ul>
<li>domain: all classical lifetime operations, installation of
various guests OSes, snapshots</li>
<li>interfaces: define, create, destroy, undefine, NPIV</li>
<li>virtual networks: define, create, destroy, undefine</li>
<li>storage: regression tests for most storage types and configurations
dir, disk, netfs, iSCSI, multipath</li>
</ul>
<p>Some of the tests need dedicated local resources whose definitions
are stored in a configuration file. The tests are defined using
Python modules defining the code for the test, this is called
a <tt>test case</tt>, and test <tt>configuration files</tt> using one
or more test case to define a given test scenario.</p>
<p>For more details you can look at:</p>
<ul>
Use https:// links for most sites This adds a rule to require https links for the libvirt, qemu and kvm websites. Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2017-10-13 23:30:41 +08:00
<li> A <a href="https://libvirt.org/sources/libvirt-test-API/Libvirt-test-API.pdf">documentation PDF</a>
Add documentation about test suites Create a new top level entry, add a new page listing the 3 test suites, and then one page for the TCK and one page for libvirt-test-API
2011-05-11 19:18:38 +08:00
file describing the test suite and how to write test cases
Fix multiple formatting problems in HTML docs The rule generating the HTML docs passing the --html flag to xsltproc. This makes it use the legacy HTML parser, which either ignores or tries to fix all sorts of broken XML tags. There's no reason why we should be writing broken XML in the first place, so removing --html and adding the XHTML doctype to all files forces us to create good XML. This adds the XHTML doc type and fixes many, many XML tag problems it exposes. Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2013-05-03 22:25:37 +08:00
and test scenarios.</li>
Add documentation about test suites Create a new top level entry, add a new page listing the 3 test suites, and then one page for the TCK and one page for libvirt-test-API
2011-05-11 19:18:38 +08:00
</ul>
<p> Libvirt-test-API is maintained using
docs: point to GitLab as the primary git hosting We still point to git repositories hosted on libvirt.org in various places. Replace the links to their gitlab.com equivalents. Note that GitLab is trying to be smart here and https://gitlab.com/libvirt/libvirt redirects to https://gitlab.com/libvirt/libvirt.git when doing a 'git clone' and vice-versa when visiting from the browser, so I only kept the .git suffix in places that explicitly mentioned 'git clone'. Signed-off-by: Ján Tomko <jtomko@redhat.com> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
2020-06-03 18:42:34 +08:00
<a href="https://gitlab.com/libvirt/libvirt-test-API">a GIT
Add documentation about test suites Create a new top level entry, add a new page listing the 3 test suites, and then one page for the TCK and one page for libvirt-test-API
2011-05-11 19:18:38 +08:00
repository</a>, and comment, patches and reviews are carried
on the <a href="contact.html">libvir-list</a> development list.</p>
</body>
</html>