From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([140.186.70.92]:49714)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1QKXv6-0005Ck-DV
	for qemu-devel@nongnu.org; Thu, 12 May 2011 11:35:24 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1QKXv2-0001yj-Jo
	for qemu-devel@nongnu.org; Thu, 12 May 2011 11:35:20 -0400
Received: from mail-yw0-f45.google.com ([209.85.213.45]:43462)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1QKXv2-0001yZ-HM
	for qemu-devel@nongnu.org; Thu, 12 May 2011 11:35:16 -0400
Received: by ywl41 with SMTP id 41so664481ywl.4
	for <qemu-devel@nongnu.org>; Thu, 12 May 2011 08:35:15 -0700 (PDT)
Message-ID: <4DCBFE2F.7040202@codemonkey.ws>
Date: Thu, 12 May 2011 10:35:11 -0500
From: Anthony Liguori <anthony@codemonkey.ws>
MIME-Version: 1.0
References: <1305023443-8722-1-git-send-email-kraxel@redhat.com>	<201105101624.08253.bradh@frogmouth.net>	<4DCBA79B.5040608@redhat.com>	<m3d3jo2n1u.fsf@blackfin.pond.sub.org>
	<4DCBFBFF.7000203@redhat.com>
In-Reply-To: <4DCBFBFF.7000203@redhat.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Subject: Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2]
 usb-linux: physical port handling.)
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: Gerd Hoffmann <kraxel@redhat.com>
Cc: amit.shah@redhat.com, Markus Armbruster <armbru@redhat.com>, Brad Hards <bradh@frogmouth.net>, qemu-devel@nongnu.org

On 05/12/2011 10:25 AM, Gerd Hoffmann wrote:
> Hi,
>
>>> What is the status of the qdev documentation patches btw.?
>>
>> http://lists.gnu.org/archive/html/qemu-devel/2011-02/msg02169.html
>
> What is the problem with the empty strings btw?
>
> The only way around I can see is having _DOC and _NODOC versions for all
> the property macros, but I'd prefer to not have _NODOC macros in the
> tree ...

Inline documentation is bad.  Our documentation should be centralized. 
  That's the only way to keep it consistent and thorough.

There's no way to easily extract the inline docs in a complete way since 
some devices are built conditionally.

Regards,

Anthony Liguori

>
> cheers,
> Gerd
>
>