From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:38722) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbBR4-000641-O0 for qemu-devel@nongnu.org; Thu, 15 Dec 2011 08:33:26 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RbBQy-0004yp-8k for qemu-devel@nongnu.org; Thu, 15 Dec 2011 08:33:22 -0500 Received: from mail-gy0-f173.google.com ([209.85.160.173]:39678) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbBQy-0004ye-2y for qemu-devel@nongnu.org; Thu, 15 Dec 2011 08:33:16 -0500 Received: by ghbg19 with SMTP id g19so1776300ghb.4 for ; Thu, 15 Dec 2011 05:33:15 -0800 (PST) Message-ID: <4EE9F717.1040606@codemonkey.ws> Date: Thu, 15 Dec 2011 07:33:11 -0600 From: Anthony Liguori MIME-Version: 1.0 References: <1323879637-16901-1-git-send-email-aliguori@us.ibm.com> <1323879637-16901-4-git-send-email-aliguori@us.ibm.com> <4EE9BD4A.9040702@redhat.com> In-Reply-To: <4EE9BD4A.9040702@redhat.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [PATCH 3/4] memory: update documentation to be in gtk-doc format List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Avi Kivity Cc: qemu-devel@nongnu.org On 12/15/2011 03:26 AM, Avi Kivity wrote: > On 12/14/2011 06:20 PM, Anthony Liguori wrote: >> Signed-off-by: Anthony Liguori >> --- >> memory.h | 341 ++++++++++++++++++++++++++++++++++---------------------------- >> 1 files changed, 188 insertions(+), 153 deletions(-) >> >> diff --git a/memory.h b/memory.h >> index 3aa8404..4d76df3 100644 >> --- a/memory.h >> +++ b/memory.h >> @@ -16,6 +16,15 @@ >> >> #ifndef CONFIG_USER_ONLY >> >> +/** >> + * SECTION:memory >> + * @title:Memory API >> + * @short_description: interfaces for dispatching I/O to devices >> + * >> + * The memory API models the memory and I/O buses and controllers of a QEMU >> + * machine. >> + */ >> + > > Can we have a space after the colon, or is that disallowed by the format? Ugh, I hate reading perl code.. All of the docs and usage in gtk seem to not use a space for SECTION at least. I can try removing it and see what happens but I suspect it's better to be consistent with gtk here to avoid future breakages. Regards, Anthony Liguori