From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:40548) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rb8Ar-0001xW-9n for qemu-devel@nongnu.org; Thu, 15 Dec 2011 05:04:30 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Rb8Am-00018z-8z for qemu-devel@nongnu.org; Thu, 15 Dec 2011 05:04:25 -0500 Received: from mx1.redhat.com ([209.132.183.28]:17161) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rb8Am-00018o-2G for qemu-devel@nongnu.org; Thu, 15 Dec 2011 05:04:20 -0500 Date: Thu, 15 Dec 2011 10:04:12 +0000 From: "Daniel P. Berrange" Message-ID: <20111215100412.GB2375@redhat.com> References: <1323892874-13234-1-git-send-email-aliguori@us.ibm.com> <4EE91045.9070109@codemonkey.ws> <4EE98433.9080205@suse.de> <4EE9BEA4.5020004@weilnetz.de> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <4EE9BEA4.5020004@weilnetz.de> Content-Transfer-Encoding: quoted-printable Subject: Re: [Qemu-devel] [PATCH v2 0/4] GTK-DOC build integration (v2) Reply-To: "Daniel P. Berrange" List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Stefan Weil Cc: qemu-devel@nongnu.org, Peter Maydell , =?utf-8?Q?Marc-Andr=C3=A9?= Lureau , Andreas =?utf-8?Q?F=C3=A4rber?= , Avi Kivity On Thu, Dec 15, 2011 at 10:32:20AM +0100, Stefan Weil wrote: > Am 15.12.2011 06:22, schrieb Andreas F=C3=A4rber: > >Their website has the following: > > > >"GTK-Doc wasn't originally intended to be a general-purpose > >documentation tool, so it can be a bit awkward to setup and use. For a > >more polished general-purpose documentation tool you may want to look = at > >Doxygen. However GTK-Doc has some special code to document the signals > >and properties of GTK+ widgets and GObject classes which other tools m= ay > >not have." > >http://www.gtk.org/gtk-doc/ > > > >Don't know if Doxygen has less restrictions though. > > > >Andreas >=20 > With doxygen, the documentation looks like this: > http://qemu.weilnetz.de/doxygen/ I don't know about others, but I find Doxygen output really unpleasant to read & navigate. I really despair whenever I find an API I need to learn that uses Doxygen. The output of GTK-DOC by comparison is so much more pleasant to consume. Regards, Daniel --=20 |: http://berrange.com -o- http://www.flickr.com/photos/dberrange= / :| |: http://libvirt.org -o- http://virt-manager.or= g :| |: http://autobuild.org -o- http://search.cpan.org/~danberr= / :| |: http://entangle-photo.org -o- http://live.gnome.org/gtk-vn= c :|