From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([2001:4830:134:3::10]:47935)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <armbru@redhat.com>) id 1bzo0W-0001PE-NB
	for qemu-devel@nongnu.org; Thu, 27 Oct 2016 12:58:25 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <armbru@redhat.com>) id 1bzo0T-0004Qe-MQ
	for qemu-devel@nongnu.org; Thu, 27 Oct 2016 12:58:24 -0400
Received: from mx1.redhat.com ([209.132.183.28]:36900)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <armbru@redhat.com>) id 1bzo0T-0004QA-GX
	for qemu-devel@nongnu.org; Thu, 27 Oct 2016 12:58:21 -0400
Received: from int-mx14.intmail.prod.int.phx2.redhat.com
	(int-mx14.intmail.prod.int.phx2.redhat.com [10.5.11.27])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by mx1.redhat.com (Postfix) with ESMTPS id 76104C0567B2
	for <qemu-devel@nongnu.org>; Thu, 27 Oct 2016 16:58:20 +0000 (UTC)
From: Markus Armbruster <armbru@redhat.com>
References: <20160925181836.18293-1-marcandre.lureau@redhat.com>
	<20160925181836.18293-10-marcandre.lureau@redhat.com>
Date: Thu, 27 Oct 2016 18:58:18 +0200
In-Reply-To: <20160925181836.18293-10-marcandre.lureau@redhat.com>
	(=?utf-8?Q?=22Marc-Andr=C3=A9?= Lureau"'s message of "Sun, 25 Sep 2016
	22:18:34 +0400")
Message-ID: <874m3xd905.fsf@dusky.pond.sub.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Subject: Re: [Qemu-devel] [PATCH v2 09/11] qga: fix
 guest-get-memory-block-info doc
List-Id: <qemu-devel.nongnu.org>
List-Unsubscribe: <https://lists.nongnu.org/mailman/options/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.nongnu.org/archive/html/qemu-devel/>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <https://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: =?utf-8?Q?Marc-Andr=C3=A9?= Lureau <marcandre.lureau@redhat.com>
Cc: qemu-devel@nongnu.org

Marc-Andr=C3=A9 Lureau <marcandre.lureau@redhat.com> writes:

> Signed-off-by: Marc-Andr=C3=A9 Lureau <marcandre.lureau@redhat.com>
> ---
>  qga/qapi-schema.json | 1 -
>  1 file changed, 1 deletion(-)
>
> diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json
> index 09c9728..7a35267 100644
> --- a/qga/qapi-schema.json
> +++ b/qga/qapi-schema.json
> @@ -954,7 +954,6 @@
>  #
>  # Get information relating to guest memory blocks.
>  #
> -# Returns: memory block size in bytes.
>  # Returns: @GuestMemoryBlockInfo
>  #
>  # Since 2.3

This is an instance of the general "doc comment doesn't match the actual
definition" doc bug pattern.

Does your doc generator (which I still haven't reviewed) check doc
comments against the definition?