From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:60392) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbPwA-0006uw-6X for qemu-devel@nongnu.org; Fri, 16 Dec 2011 00:02:27 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RbPw9-0005S9-1T for qemu-devel@nongnu.org; Fri, 16 Dec 2011 00:02:26 -0500 Received: from cantor2.suse.de ([195.135.220.15]:52100 helo=mx2.suse.de) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RbPw8-0005S5-Rl for qemu-devel@nongnu.org; Fri, 16 Dec 2011 00:02:25 -0500 Message-ID: <4EEAD09B.9050206@suse.de> Date: Fri, 16 Dec 2011 06:01:15 +0100 From: =?ISO-8859-1?Q?Andreas_F=E4rber?= MIME-Version: 1.0 References: <1323879637-16901-1-git-send-email-aliguori@us.ibm.com> <1323879637-16901-3-git-send-email-aliguori@us.ibm.com> <4EE9BFD9.3040108@redhat.com> <4EE9F67B.3060302@codemonkey.ws> In-Reply-To: <4EE9F67B.3060302@codemonkey.ws> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Subject: Re: [Qemu-devel] [PATCH 2/4] docs: add build infrastructure for gtkdocs List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Anthony Liguori Cc: Avi Kivity , qemu-devel@nongnu.org Am 15.12.2011 14:30, schrieb Anthony Liguori: > On 12/15/2011 03:37 AM, Avi Kivity wrote: >> On 12/14/2011 06:20 PM, Anthony Liguori wrote: >>> By convention, documented headers now go in include/ >> >> Dislike. +1 > I've been planning on doing this for a while. I think it's a useful wa= y > to help improve internal modularity. It provides a consistent way to > indicate which headers represent "public" internal interfaces (like the > memory API) verses things that are really private headers specific to a > submodule (say block_int.h). So far you've always opposed the idea of a stable public API. If that's still not what you want, then there's no real distinction here and an include/ directory would give a wrong impression. If you just want a TODO list, then surely having a shell script print the *.h file names and copying them into the Wiki would be easier. Andreas --=20 SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 N=FCrnberg, Germany GF: Jeff Hawn, Jennifer Guild, Felix Imend=F6rffer; HRB 16746 AG N=FCrnbe= rg