|
From: | Paolo Bonzini |
Subject: | Re: [Qemu-devel] [PATCH] Makefile: Install qmp-events.txt |
Date: | Thu, 26 Jun 2014 15:25:33 +0200 |
User-agent: | Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.6.0 |
Il 26/06/2014 15:17, Luiz Capitulino ha scritto:
> We're really close to hard freeze and by extension the release. Do > _not_ strive for perfection. Get something that is mostly okay and is > an obvious patch. We'll then have 3 weeks to do documentation patches.The hard freeze argument is a strong one, but my understanding was that we wanted to move away from duplicated information. So reverting is a step back.
We sure want to move away from duplicated information. However, at this point we are actively _dropping_ information compared to qmp-events.txt (the examples).
Considering that QEMU releases rarely add more than 1 event(*), the amount of duplicated work caused by qmp-events.txt is trivial for the foreseeable future.
Of course, the obvious steps to do things "right" are: - automatically generate HTML/DocBook/Texinfo documentation from .json - install the automatically-generated documentation - move examples from qmp-events.txt and qmp-commands.hx to the .json - when qmp-events.txt and qmp-commands.hx are entirely duplicate, kill them But this requires manpower, of course. Paolo (*) Version Events introduced 0.12.0 5 0.13.0 5 0.14.0 3 0.15.0 0 1.0 0 1.1 2 1.2 2 1.3 1 1.4 0 1.5 1 1.6 1 1.7 0 2.0 1 2.1 1
[Prev in Thread] | Current Thread | [Next in Thread] |