[PATCH 10/29] docs: Convert 'drvtest' page to rST

Mon Mar 28 12:10:25 UTC 2022

The first sentence was moved up a paragraph to stop treating the first
sub-heading as a page subtitle.

Signed-off-by: Peter Krempa <pkrempa at redhat.com>
---
 docs/drvtest.html.in | 27 ---------------------------
 docs/drvtest.rst     | 21 +++++++++++++++++++++
 docs/meson.build     |  2 +-
 3 files changed, 22 insertions(+), 28 deletions(-)
 delete mode 100644 docs/drvtest.html.in
 create mode 100644 docs/drvtest.rst

diff --git a/docs/drvtest.html.in b/docs/drvtest.html.in
deleted file mode 100644
index 6884184e6f..0000000000
--- a/docs/drvtest.html.in
+++ /dev/null
@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <body>
-    <h1>Test "mock" driver</h1>
-
-    <h2>Connections to Test driver</h2>
-
-    <p>
-    The libvirt Test driver is a per-process fake hypervisor driver,
-    with a driver name of 'test'. The driver maintains all its state
-    in memory. It can start with a pre-configured default config, or
-    be given a path to an alternate config. Some example connection URIs
-    for the libvirt driver are:
-    </p>
-
-<pre>
-test:///default                     (local access, default config)
-test:///path/to/driver/config.xml   (local access, custom config)
-test+unix:///default                (local access, default config, via daemon)
-test://example.com/default          (remote access, TLS/x509)
-test+tcp://example.com/default      (remote access, SASl/Kerberos)
-test+ssh://root@example.com/default (remote access, SSH tunnelled)
-</pre>
-
-  </body>
-</html>
diff --git a/docs/drvtest.rst b/docs/drvtest.rst
new file mode 100644
index 0000000000..99578a47ba
--- /dev/null
+++ b/docs/drvtest.rst
@@ -0,0 +1,21 @@
+==================
+Test "mock" driver
+==================
+
+The libvirt ``test`` driver is a per-process fake hypervisor driver.
+
+Connections to Test driver
+--------------------------
+
+The driver maintains all its state in memory. It can start with
+a pre-configured default config, or be given a path to an alternate config. Some
+example connection URIs for the libvirt driver are:
+
+::
+
+   test:///default                     (local access, default config)
+   test:///path/to/driver/config.xml   (local access, custom config)
+   test+unix:///default                (local access, default config, via daemon)
+   test://example.com/default          (remote access, TLS/x509)
+   test+tcp://example.com/default      (remote access, SASl/Kerberos)
+   test+ssh://root@example.com/default (remote access, SSH tunnelled)
diff --git a/docs/meson.build b/docs/meson.build
index 8499b3d595..5995b2ec91 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -22,7 +22,6 @@ docs_html_in_files = [
   'csharp',
   'dbus',
   'docs',
-  'drvtest',
   'drvvbox',
   'drvvirtuozzo',
   'drvvmware',
@@ -81,6 +80,7 @@ docs_rst_files = [
   'drvopenvz',
   'drvqemu',
   'drvsecret',
+  'drvtest',
   'errors',
   'formatbackup',
   'formatcheckpoint',
-- 
2.35.1

