On Mon, Aug 03, 2020 at 20:08:27 +0200, Peter Krempa wrote:
For now just plain conversion to rst. Anchors which existed until now are preserved, but the table of contents now uses the docutils-generated ones.
Additionally <code> which was nested in a link (<a>) was removed as rst doesn't support nesting of inline markup.
The only anchor which wasn't restored is 'elementsDiskBackingStoreIndex' and it's only reference was removed.
Signed-off-by: Peter Krempa <pkrempa@redhat.com> ---
A rebased version of this patch. For now anchors and links are kept as-is as there wasn't a consensus on how to approach it.
This file is a magnet for conflicts so it's broken often and thus splitting it up will be made later once I will not get rippling conflicts.
The idea to split up into sections (if we decide to do so) can be done incrementally. As a first step the hacky HTML anchors will be removed and links will be fixed and then we can split up everyting, but that's for later.
For now I've updated the file manually from the last posting, but you can look how I did the automatic part at:
https://gitlab.com/pipo.sk/libvirt/-/commit/3d7e23948564502ff01160a73abd3973...
docs/formatdomain.html.in | 9860 ------------------------------------- docs/formatdomain.rst | 7453 ++++++++++++++++++++++++++++ docs/meson.build | 2 +- 3 files changed, 7454 insertions(+), 9861 deletions(-) delete mode 100644 docs/formatdomain.html.in create mode 100644 docs/formatdomain.rst
Forgot to commit the following hunk: diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index a9c4f46843..a39e0c4adf 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2572,8 +2572,7 @@ paravirtualized driver is specified via the ``disk`` element. specified storage volume is of 'file' or 'block' type). The ``source`` element may also have the ``index`` attribute with same - semantics the `index <#elementsDiskBackingStoreIndex>`__ attribute of - ``backingStore`` + semantics the ``index`` attribute of ``backingStore``. The ``source`` element may contain the following sub elements: