From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:36474) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RcFQd-0000Ez-QL for qemu-devel@nongnu.org; Sun, 18 Dec 2011 07:01:20 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RcFQb-0006GP-VZ for qemu-devel@nongnu.org; Sun, 18 Dec 2011 07:01:19 -0500 Received: from v220110690675601.yourvserver.net ([78.47.199.172]:41963) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RcFQb-0006GD-Pi for qemu-devel@nongnu.org; Sun, 18 Dec 2011 07:01:17 -0500 Message-ID: <4EEDD5DA.7020401@weilnetz.de> Date: Sun, 18 Dec 2011 13:00:26 +0100 From: Stefan Weil MIME-Version: 1.0 References: <1323892874-13234-1-git-send-email-aliguori@us.ibm.com> <4EE91045.9070109@codemonkey.ws> <4EE98433.9080205@suse.de> <4EE9BEA4.5020004@weilnetz.de> <4EE9CA37.6040903@redhat.com> In-Reply-To: <4EE9CA37.6040903@redhat.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: quoted-printable Subject: Re: [Qemu-devel] [PATCH v2 0/4] GTK-DOC build integration (v2) List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Kevin Wolf Cc: Avi Kivity , Anthony Liguori , qemu-devel@nongnu.org, =?ISO-8859-1?Q?Andreas_F=E4rber?= Am 15.12.2011 11:21, schrieb Kevin Wolf: > Am 15.12.2011 10:32, schrieb Stefan Weil: >> Am 15.12.2011 06:22, schrieb Andreas F=E4rber: >>> 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 signal= s >>> and properties of GTK+ widgets and GObject classes which other tools = may >>> not have." >>> http://www.gtk.org/gtk-doc/ >>> >>> Don't know if Doxygen has less restrictions though. >>> >>> Andreas >> With doxygen, the documentation looks like this: >> http://qemu.weilnetz.de/doxygen/ >> >> I only modified the first lines of memory.h to get >> the global C functions, but of course more changes >> are needed if we choose doxygen as our standard. > You seem to have included Anthony's patches (specifically the one to > split out nested structs). Is Doxygen really as broken as gtk-doc seems > to be or can we do without it? > > Kevin Yes, the previous results were based on QEMU with Anthony's latest gtkdoc patches. Here is the result from unpatched QEMU code: http://qemu.weilnetz.de/doxygen2/ or http://qemu.weilnetz.de/doxygen2/memory_8h.html I had to remove most graphics because they needed more than 1 GB disk space and filled all available space on my server. Regards, Stefan