From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56746) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X0CUH-0006BJ-Vx for qemu-devel@nongnu.org; Thu, 26 Jun 2014 12:25:30 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X0CUC-0003Hh-RZ for qemu-devel@nongnu.org; Thu, 26 Jun 2014 12:25:25 -0400 Received: from mx1.redhat.com ([209.132.183.28]:25996) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X0CUC-0003Ha-KR for qemu-devel@nongnu.org; Thu, 26 Jun 2014 12:25:20 -0400 Message-ID: <53AC496C.6040802@redhat.com> Date: Thu, 26 Jun 2014 10:25:16 -0600 From: Eric Blake MIME-Version: 1.0 References: <4b996aea34144d33f2227835dc3d064818ffb7be.1403688576.git.mprivozn@redhat.com> <53AAD523.3000604@redhat.com> <20140625155048.252833c1@redhat.com> <53AB2D71.7050704@redhat.com> <20140626084611.20f771a2@redhat.com> <53AC19C3.10502@redhat.com> <53AC1C13.40308@redhat.com> <53AC1C99.8070106@redhat.com> <20140626091738.4ee3a0b4@redhat.com> <53AC1F4D.6090702@redhat.com> In-Reply-To: <53AC1F4D.6090702@redhat.com> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="BUtDlNi7I2sPjT9irdjIW292XE9geHSaj" Subject: Re: [Qemu-devel] [PATCH] Makefile: Install qmp-events.txt List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Paolo Bonzini , Luiz Capitulino Cc: Michal Privoznik , famz@redhat.com, qemu-devel@nongnu.org, Wenchao Xia This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --BUtDlNi7I2sPjT9irdjIW292XE9geHSaj Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On 06/26/2014 07:25 AM, Paolo Bonzini wrote: > 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 tha= t >> we wanted to move away from duplicated information. So reverting is a >> step back. >=20 > We sure want to move away from duplicated information. However, at thi= s > point we are actively _dropping_ information compared to qmp-events.txt= > (the examples). >=20 > 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. Actually, there is a second new event on queue right now: https://lists.gnu.org/archive/html/qemu-devel/2014-06/msg06561.html >=20 > Of course, the obvious steps to do things "right" are: >=20 > - automatically generate HTML/DocBook/Texinfo documentation from .json >=20 > - install the automatically-generated documentation >=20 > - move examples from qmp-events.txt and qmp-commands.hx to the .json >=20 > - when qmp-events.txt and qmp-commands.hx are entirely duplicate, kill = them >=20 > But this requires manpower, of course. Sadly, manpower is more frequently devoted to code than to documentation improvements. >=20 > Paolo >=20 > (*) 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 So depending on Laszlo's series, we may be adding 2 events in 2.1. --=20 Eric Blake eblake redhat com +1-919-301-3266 Libvirt virtualization library http://libvirt.org --BUtDlNi7I2sPjT9irdjIW292XE9geHSaj Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 Comment: Public key at http://people.redhat.com/eblake/eblake.gpg Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBCAAGBQJTrElsAAoJEKeha0olJ0NqllwIAK2N3aw/PxXgQMeqtHcld6VK XL+sRvt7HEUjsdUYPE3ZYz5QabOsbWJ64Nn4JVyqpDU1k1hcuaJxctMp5vqzvMnt nwmzufjjYlIZ+MsEXLfFBDmlLxCckh/uouAj8kgFBdtwke9pBPn1edWSTtm/SECk lmIVKfsBdPidpXwYGLh3GOE4yFURdinnrxa6BdgxvhMYOO+UI8D/JErk0Iriz41H vIGdrpm8jkzrREAaMDv3ganXM3PYbJSDI+hOL/5p5LNzISAFpLfPvxecuwgI2Szk AkyZcoeAuKv1p3plDUfHBJAspJcwoE6mC9moURptwrv/tcnOJOpxs3Pi2Jg+0p0= =VwTG -----END PGP SIGNATURE----- --BUtDlNi7I2sPjT9irdjIW292XE9geHSaj--