From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:44135) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VsYzG-0004lR-KO for qemu-devel@nongnu.org; Mon, 16 Dec 2013 09:17:41 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VsYz9-00043L-Ao for qemu-devel@nongnu.org; Mon, 16 Dec 2013 09:17:34 -0500 Received: from cantor2.suse.de ([195.135.220.15]:40913 helo=mx2.suse.de) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VsYz9-00043A-4e for qemu-devel@nongnu.org; Mon, 16 Dec 2013 09:17:27 -0500 Message-ID: <52AF0B73.3090403@suse.de> Date: Mon, 16 Dec 2013 15:17:23 +0100 From: =?ISO-8859-1?Q?Andreas_F=E4rber?= MIME-Version: 1.0 References: <20131214002607.ffe2f4cc49f976b515ac4c0e@gmail.com> <20131215151709.be54fbe34245cae757ba0279@gmail.com> In-Reply-To: <20131215151709.be54fbe34245cae757ba0279@gmail.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Subject: Re: [Qemu-devel] a QOM Coding Conventions question List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Antony Pavlov Cc: Peter Maydell , Peter Crosthwaite , QEMU Developers Am 15.12.2013 12:17, schrieb Antony Pavlov: > Can we use more detailed comments? E.g. >=20 > typedef struct { > /*< QOM service fields >*/ > MyParentClass parent_class; > /*< class private fields >*/ >=20 > [any fields you need] > } FooClass; Since those comments wouldn't be supported by gtk-doc, the short answer is we can't. The longer answer, as explained in the other reply, is that it's a question of who contributes and more importantly maintains long-term the tools to process these and all the /** ... */ comments. Regards, 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