On Fri, Apr 26, 2019 at 06:15:28PM -0400, John Snow wrote:
> This just about rewrites the entirety of the bitmaps.rst document to
> make it consistent with the 4.0 release. I have added new features seen
> in the 4.0 release, as well as tried to clarify some points that keep
> coming up when discussing this feature both in-house and upstream.
>
> Yes, it's a lot longer, mostly due to examples. I get a bit chatty.
> I could use a good editor to help reign in my chattiness.
>
> It does not yet cover pull backups or migration details, but I intend to
> keep extending this document to cover those cases.
>
> Please try compiling it with sphinx and look at the rendered output, I
> don't have hosting to share my copy at present.
FWIW, here's a public rendering (with the "Alabaster" Sphinx theme) with
your v3 applied:
https://kashyapc.fedorapeople.org/QEMU-Docs-v4.0.0-143-g1cb2ca0415/_build/html/docs/interop/bitmaps.html
Thanks for the overhaul. Afraid, I've been just too swamped to be able
to look at this in detail, much as I'd love to. I will slowly catch up.
- - -
(Note to self: send to the list the text-to-rST converted QEMU docs
sitting locally on a Git branch.)
[...]
> I think this new layout reads nicer in the HTML format than the old
> one did, at the expense of looking less readable in the source tree
> itself (though not completely unmanagable. We did decide to convert it
> from Markdown to ReST, after all, so I am going all-in on ReST.)
[...]
--
/kashyap
