By convention, documented headers now go in include/ Signed-off-by: Anthony Liguori <aligu...@us.ibm.com> --- Makefile | 6 +++++- Makefile.docs | 15 +++++++++++++++ QEMU-docs.xml | 31 +++++++++++++++++++++++++++++++ 3 files changed, 51 insertions(+), 1 deletions(-) create mode 100644 Makefile.docs create mode 100644 QEMU-docs.xml
diff --git a/Makefile b/Makefile index 2c03055..d7974af 100644 --- a/Makefile +++ b/Makefile @@ -92,6 +92,8 @@ ifneq ($(wildcard config-host.mak),) include $(SRC_PATH)/Makefile.objs endif +include $(SRC_PATH)/Makefile.docs + $(common-obj-y): $(GENERATED_HEADERS) subdir-libcacard: $(oslib-obj-y) $(trace-obj-y) qemu-timer-common.o @@ -113,6 +115,8 @@ QEMU_CFLAGS+=$(CURL_CFLAGS) QEMU_CFLAGS+=$(GLIB_CFLAGS) +QEMU_CFLAGS+=$(SRC_PATH)/include + ui/cocoa.o: ui/cocoa.m ui/sdl.o audio/sdlaudio.o ui/sdl_zoom.o baum.o: QEMU_CFLAGS += $(SDL_CFLAGS) @@ -220,7 +224,7 @@ qemu-ga$(EXESUF): qemu-ga.o $(qga-obj-y) $(qapi-obj-y) $(tools-obj-y) $(qobject- QEMULIBS=libhw32 libhw64 libuser libdis libdis-user -clean: +clean: gtkdoc-clean # avoid old build problems by removing potentially incorrect old files rm -f config.mak op-i386.h opc-i386.h gen-op-i386.h op-arm.h opc-arm.h gen-op-arm.h rm -f qemu-options.def diff --git a/Makefile.docs b/Makefile.docs new file mode 100644 index 0000000..bea0833 --- /dev/null +++ b/Makefile.docs @@ -0,0 +1,15 @@ +DOC_SRC=$(wildcard $(SRC_PATH)/include/*.h) + +gtkdoc: html/index.html + +html/index.html: $(DOC_SRC) + gtkdoc-scan --module=QEMU --source-dir=$(SRC_PATH)/include && \ + cp $(SRC_PATH)/QEMU-docs.xml . && \ + gtkdoc-mkdb --module=QEMU --output-format=xml --source-dir=$(SRC_PATH)/include && \ + mkdir -p html && \ + (cd html && gtkdoc-mkhtml QEMU ../QEMU-docs.xml && cd ..) && \ + gtkdoc-fixxref --module=QEMU --module-dir=html + +gtkdoc-clean: + $(RM) -r html xml + $(RM) $(SCAN_GEN) sgml.stamp *.bak html.stamp diff --git a/QEMU-docs.xml b/QEMU-docs.xml new file mode 100644 index 0000000..ddc827a --- /dev/null +++ b/QEMU-docs.xml @@ -0,0 +1,31 @@ +<?xml version="1.0"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" +[ + <!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'"> +]> +<book id="index"> + <bookinfo> + <title>QEMU Reference Manual</title> + <releaseinfo> + for QEMU 1.0. + The latest version of this documentation can be found on-line at + <ulink role="online-location" url="http://wiki.qemu.org/docs-internal/">http://wiki.qemu.org/docs-internal/</ulink>. + </releaseinfo> + </bookinfo> + + <chapter> + <title>Core Device APIs</title> + + </chapter> + <index id="api-index-full"> + <title>API Index</title> + <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include> + </index> + <index id="deprecated-api-index" role="deprecated"> + <title>Index of deprecated API</title> + <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include> + </index> + + <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include> +</book> -- 1.7.4.1