|
From: | Avi Kivity |
Subject: | Re: [Qemu-devel] [PATCH 01/23] Hierarchical memory region API |
Date: | Tue, 26 Jul 2011 12:35:41 +0300 |
User-agent: | Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.18) Gecko/20110621 Fedora/3.1.11-1.fc15 Thunderbird/3.1.11 |
On 07/25/2011 09:41 PM, Anthony Liguori wrote:
+/* Initialize a memory region + * + * The region typically acts as a container for other memory regions. + */I'm also writing a fair bit of documentation right now. We should use a common format and declare that the doc format in CODING_STYLE.I think the two choices are gtk-doc (which I have been using):
<snip>
I think gtk-doc is more concise and easier to write. But Doxygen clearly has better tooling.
Updated to use gtk-doc. Ugh, a large API.
Otherwise, Reviewed-by: Anthony Liguori <address@hidden> but not tested yet.I assume that all of the FIXMEs don't actually introduce regressions, right?
Not intentionally. -- error compiling committee.c: too many arguments to function
[Prev in Thread] | Current Thread | [Next in Thread] |