From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1NsCeb-0004Im-Kl
	for qemu-devel@nongnu.org; Thu, 18 Mar 2010 06:08:37 -0400
Received: from [199.232.76.173] (port=53766 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1NsCeZ-0004H9-PC
	for qemu-devel@nongnu.org; Thu, 18 Mar 2010 06:08:35 -0400
Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim
	4.60) (envelope-from <mst@redhat.com>) id 1NsCeY-0003y2-J8
	for qemu-devel@nongnu.org; Thu, 18 Mar 2010 06:08:35 -0400
Received: from mx1.redhat.com ([209.132.183.28]:48935)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <mst@redhat.com>) id 1NsCeY-0003xs-89
	for qemu-devel@nongnu.org; Thu, 18 Mar 2010 06:08:34 -0400
Received: from int-mx04.intmail.prod.int.phx2.redhat.com
	(int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.17])
	by mx1.redhat.com (8.13.8/8.13.8) with ESMTP id o2IA8Xib019384
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK)
	for <qemu-devel@nongnu.org>; Thu, 18 Mar 2010 06:08:33 -0400
Date: Thu, 18 Mar 2010 12:05:08 +0200
From: "Michael S. Tsirkin" <mst@redhat.com>
Message-ID: <20100318100508.GA24356@redhat.com>
References: <cover.1268765204.git.quintela@redhat.com>
	<20100318064015.GA16973@redhat.com> <m3iq8unksl.fsf@trasno.mitica>
	<20100318074239.GA23474@redhat.com> <m339zyni0w.fsf@trasno.mitica>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <m339zyni0w.fsf@trasno.mitica>
Subject: [Qemu-devel] Re: [PATCH 0/9] Virtio cleanups
List-Id: qemu-devel.nongnu.org
List-Unsubscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/qemu-devel>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: Juan Quintela <quintela@redhat.com>
Cc: qemu-devel@nongnu.org

On Thu, Mar 18, 2010 at 09:36:15AM +0100, Juan Quintela wrote:
> searching for how to use a qemu api because from only the
> prototypes it is not clear,

That's the issue right there: if prototype is not enough
we should add documentation.

> and just pick an example, and that one uses
> it in a non-conventional way.

copy paste coding always has this issue. Better avoid it
with APIs which don't force so much boilerplate code.

-- 
MST