[PATCH 03/17] docs: formatsnapshot: Convert to 'rst'

Ján Tomko jtomko at redhat.com
Mon Mar 7 17:56:22 UTC 2022


On a Monday in 2022, Peter Krempa wrote:
>Signed-off-by: Peter Krempa <pkrempa at redhat.com>
>---
> docs/formatsnapshot.html.in | 352 ------------------------------------
> docs/formatsnapshot.rst     | 297 ++++++++++++++++++++++++++++++
> docs/meson.build            |   2 +-
> 3 files changed, 298 insertions(+), 353 deletions(-)
> delete mode 100644 docs/formatsnapshot.html.in
> create mode 100644 docs/formatsnapshot.rst
>
>diff --git a/docs/formatsnapshot.html.in b/docs/formatsnapshot.html.in
>deleted file mode 100644
>index e481284aa8..0000000000
>--- a/docs/formatsnapshot.html.in
>+++ /dev/null
>@@ -1,352 +0,0 @@
>-            <dl>
>-              <dt><code>source</code></dt>
>-              <dd>If the snapshot mode is external (whether specified
>-              or inherited), then there is an optional sub-element
>-              <code>source</code>, with an attribute <code>file</code>
>-              giving the name of the new file.
>-              If <code>source</code> is not
>-              given and the disk is backed by a local image file (not
>-              a block device or remote storage), a file name is
>-              generated that consists of the existing file name
>-              with anything after the trailing dot replaced by the
>-              snapshot name.  Remember that with external
>-              snapshots, the original file name becomes the read-only
>-              snapshot, and the new file name contains the read-write
>-              delta of all disk changes since the snapshot.
>-              <p/>
>-              The <code>source</code> element also may contain the
>-              <code>seclabel</code> element (described in the
>-              <a href="formatdomain.html#seclabel">domain XML documentation</a>)
>-              which can be used to override the domain security labeling policy
>-              for <code>source</code>.
>-              </dd>
>-              <dt><code>driver</code></dt>
>-              <dd>An optional sub-element <code>driver</code>,
>-              with an attribute <code>type</code> giving the driver type (such
>-              as qcow2), of the new file created by the external
>-              snapshot of the new file.
>-
>-              Optionally <code>metadata_cache</code> sub-element can be used
>-              with same semantics as the identically named subelement of the
>-              domain definition disk's driver.
>-              </dd>
>-              <dt><code>seclabel</code></dt>
>-            </dl>
>-

Having just the 'seclabel' term here without a definition looks strange.

But your conversion is faithful.
Reviewed-by: Ján Tomko <jtomko at redhat.com>

Jano
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 488 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20220307/58a80f37/attachment.sig>


More information about the libvir-list mailing list