From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:59955) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rav28-0007k0-2Z for qemu-devel@nongnu.org; Wed, 14 Dec 2011 15:02:36 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Rav27-0001ZQ-13 for qemu-devel@nongnu.org; Wed, 14 Dec 2011 15:02:32 -0500 Received: from cpe-70-123-132-139.austin.res.rr.com ([70.123.132.139]:43812 helo=localhost6.localdomain6) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Rav26-0001ZK-RT for qemu-devel@nongnu.org; Wed, 14 Dec 2011 15:02:30 -0500 From: Anthony Liguori Date: Wed, 14 Dec 2011 14:01:10 -0600 Message-Id: <1323892874-13234-1-git-send-email-aliguori@us.ibm.com> Subject: [Qemu-devel] [PATCH v2 0/4] GTK-DOC build integration (v2) List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org Cc: Peter Maydell , Anthony Liguori , Avi Kivity , Stefan Weil This series integrates GTK-DOC into our build process via a gtkdoc build target. This is to provide internal API documentation in a more accessible format. Once this gets merged into the tree, I'll add a nightly cron job on qemu.org so that there is always a copy of the latest internal API documentation on the website. I've posted the output of already on qemu.org at: http://wiki.qemu.org/docs-internal/ All it takes to add to this is to submit a patch converting a file to use gtk-doc syntax and then move the header into include/ For more information on gtk-doc, see: http://developer.gnome.org/gtk-doc-manual/unstable/ For v2, I'm relying on a fork of gtk-doc that removes the underscore requirements. I really hate to do this but I like it better than not having documentation. I'm poking in the gtk+ community to see if there's an upstream compromise possible. Anthony Liguori (4): memory: make memory API parsable by gtkdoc-scan (v2) docs: add build infrastructure for gtkdocs (v2) memory: update documentation to be in gtk-doc format memory: move header into include/ and add to QEMU docs Makefile | 6 +- Makefile.docs | 29 +++ Makefile.hw | 1 + Makefile.target | 1 + QEMU-docs.xml | 32 +++ include/memory.h | 566 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ memory.h | 522 ------------------------------------------------- 7 files changed, 634 insertions(+), 523 deletions(-) create mode 100644 Makefile.docs create mode 100644 QEMU-docs.xml create mode 100644 include/memory.h delete mode 100644 memory.h -- 1.7.4.1