From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([140.186.70.92]:41842)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1RbBJX-0001Zm-B8
	for qemu-devel@nongnu.org; Thu, 15 Dec 2011 08:25:39 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1RbBJW-0003hJ-Bf
	for qemu-devel@nongnu.org; Thu, 15 Dec 2011 08:25:35 -0500
Received: from mail-iy0-f173.google.com ([209.85.210.173]:39808)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1RbBJW-0003hD-8c
	for qemu-devel@nongnu.org; Thu, 15 Dec 2011 08:25:34 -0500
Received: by iagj37 with SMTP id j37so3204448iag.4
	for <qemu-devel@nongnu.org>; Thu, 15 Dec 2011 05:25:33 -0800 (PST)
Message-ID: <4EE9F548.2080704@codemonkey.ws>
Date: Thu, 15 Dec 2011 07:25:28 -0600
From: Anthony Liguori <anthony@codemonkey.ws>
MIME-Version: 1.0
References: <1323892874-13234-1-git-send-email-aliguori@us.ibm.com>	<1323892874-13234-2-git-send-email-aliguori@us.ibm.com>
	<4EE9BDAE.6060200@redhat.com>
In-Reply-To: <4EE9BDAE.6060200@redhat.com>
Content-Type: text/plain; charset=ISO-8859-15; format=flowed
Content-Transfer-Encoding: 7bit
Subject: Re: [Qemu-devel] [PATCH v2 1/4] memory: make memory API parsable by
 gtkdoc-scan (v2)
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: Kevin Wolf <kwolf@redhat.com>
Cc: Peter Maydell <peter.maydell@linaro.org>, Avi Kivity <avi@redhat.com>, qemu-devel@nongnu.org, Stefan Weil <sw@weilnetz.de>

On 12/15/2011 03:28 AM, Kevin Wolf wrote:
> Am 14.12.2011 21:01, schrieb Anthony Liguori:
>> gtkdoc-scan cannot handle nested structs so remove those from the memory API.
>>
>> Signed-off-by: Anthony Liguori<aliguori@us.ibm.com>
>
> Surely the right thing to do then is fixing gtkdoc-scan?

It's not quite that simple.  gtkdoc uses a documentation format of:

  Thing

  Longer description of thing

   - sub-bullets about things parameters and/or members
   - another sub-bullet about things parameters and/or members.

So it's expecting to deal with only one level of nesting.  You would have to 
make significant changes to deal with multiple levels of nesting.

That said, I think using an anonymous named structure for grouping is a bit 
dubious to begin with.

Regards,

Anthony Liguori

>
> Kevin
>