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

[Peter Krempa]

On Mon, Mar 07, 2022 at 18:56:22 +0100, Ján Tomko wrote:
> 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 @@

[...]

> > -              <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.

Well, my conversion is to a large extent automated so the content itself
in terms of actual text will not be impacted. In few cases I need to fix
nesting of some definition lists and add anchors which are used, so the
content is unlikely to diverge.

I'll post a follow up to address this.