Re: [Qemu-devel] [PATCH v6 10/25] replay: introduce breakpoint at the specified step

[Kashyap Chamarthy]

On Mon, Sep 24, 2018 at 08:44:07PM +0200, Markus Armbruster wrote:

[...]

> Remind me, why would rST be an improvement?

Relatively easy on the eye, more maintainable, active community around
the Sphinx tooling / extensions, not extremely arcane syntax (besides
some weird quirks), etc.

Take a look at its output (from a random page out of kernel
documentation):

    
https://www.kernel.org/doc/html/v4.11/driver-api/80211/mac80211-advanced.html

LWN did some analysis[1][2] on how the Linux kernel arrived at rST (with
Sphinx).

An example rendering of a document from the QEMU Git tree:

    
https://kashyapc.fedorapeople.org/QEMU-Docs/_build/html/docs/interop/live-block-operations.html

Not sure if that's improvement in your judgement, though. :-)

[...]

[1] https://lwn.net/Articles/692704/
[2] https://lwn.net/Articles/692705/

-- 
/kashyap