From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:43533) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QKS9e-0008E3-UH for qemu-devel@nongnu.org; Thu, 12 May 2011 05:25:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QKS9d-0004Vf-V1 for qemu-devel@nongnu.org; Thu, 12 May 2011 05:25:58 -0400 Received: from mx1.redhat.com ([209.132.183.28]:14967) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QKS9d-0004VY-Kz for qemu-devel@nongnu.org; Thu, 12 May 2011 05:25:57 -0400 Message-ID: <4DCBA79B.5040608@redhat.com> Date: Thu, 12 May 2011 11:25:47 +0200 From: Gerd Hoffmann MIME-Version: 1.0 References: <1305023443-8722-1-git-send-email-kraxel@redhat.com> <201105101624.08253.bradh@frogmouth.net> In-Reply-To: <201105101624.08253.bradh@frogmouth.net> Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit Subject: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.) List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Brad Hards Cc: qemu-devel@nongnu.org Hi, > Some additional docs (based on 2/2 hints) might be a useful addition. Indeed. > Possible candidates: > - docs/qdev-device-use.txt > - qemu-doc.texi Hmm. qemu-doc.texi only documents the pre-qdev way to create devices. qdev-device-use.txt is a conversion guide. devices which can only be created via -device (or provide additional features via qdev attributes when created that way) are not documented anywhere now. Suggestions? Should we add a qdev section to qemu-doc.texi? Or better a separate qemu-devices.txt (or .texi)? What is the status of the qdev documentation patches btw.? Maybe we should just merge them, then start filling stuff and maybe also autogenerate documentation from that? cheers, Gerd