aboutsummaryrefslogtreecommitdiffstats
path: root/doc/doxygen
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2013-04-04 11:28:58 +1000
committerKristian Høgsberg <krh@bitplanet.net>2013-04-04 16:57:18 -0400
commitb1d7131c36a853ff688377fc077a0999cfc3a1b9 (patch)
tree84401e0eb931808f6f81f1165807748aa8e59b0b /doc/doxygen
parentdoc: Capitalize all Wayland occurrences (diff)
downloadwayland-b1d7131c36a853ff688377fc077a0999cfc3a1b9.tar
wayland-b1d7131c36a853ff688377fc077a0999cfc3a1b9.tar.gz
wayland-b1d7131c36a853ff688377fc077a0999cfc3a1b9.tar.bz2
wayland-b1d7131c36a853ff688377fc077a0999cfc3a1b9.tar.lz
wayland-b1d7131c36a853ff688377fc077a0999cfc3a1b9.tar.xz
wayland-b1d7131c36a853ff688377fc077a0999cfc3a1b9.tar.zst
wayland-b1d7131c36a853ff688377fc077a0999cfc3a1b9.zip
doc: generate server documentation from XML too
Same as WaylandClientAPI.xml we now also generate WaylandServerAPI.xml for publication. Most of this hunk is just adding a client/ or server/ into the xml path to keep the two separate. The change in wayland.doxygen now causes a standard doxygen call to not generate anything - what is generated is specified through the options passed by make. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Diffstat (limited to 'doc/doxygen')
-rw-r--r--doc/doxygen/Makefile.am19
-rw-r--r--doc/doxygen/wayland.doxygen.in5
2 files changed, 17 insertions, 7 deletions
diff --git a/doc/doxygen/Makefile.am b/doc/doxygen/Makefile.am
index 40dcecb..e41c790 100644
--- a/doc/doxygen/Makefile.am
+++ b/doc/doxygen/Makefile.am
@@ -1,5 +1,5 @@
-noinst_DATA = xml/index.xml
+noinst_DATA = xml/client/index.xml xml/server/index.xml
dist_noinst_DATA = wayland.doxygen.in
scanned_src_files_client = \
@@ -61,12 +61,23 @@ server_MANPAGES = \
man3_MANS= $(client_MANPAGES) $(server_MANPAGES)
-xml/index.xml: $(scanned_src_files_client) wayland.doxygen
- doxygen wayland.doxygen
+xml/client/index.xml: $(scanned_src_files_client) wayland.doxygen
+ $(AM_V_GEN)$(MKDIR_P) xml/client
+ (cat wayland.doxygen; \
+ echo "GENERATE_XML=YES"; \
+ echo "XML_OUTPUT=xml/client"; \
+ echo "INPUT= $(scanned_src_files_client)"; \
+ ) | doxygen -
+xml/server/index.xml: $(scanned_src_files_server) wayland.doxygen
+ $(AM_V_GEN)$(MKDIR_P) xml/server
+ (cat wayland.doxygen; \
+ echo "GENERATE_XML=YES"; \
+ echo "XML_OUTPUT=xml/server"; \
+ echo "INPUT= $(scanned_src_files_server)"; \
+ ) | doxygen -
doxygen.man: $(scanned_src_files_client) $(scanned_src_files_server)
(cat wayland.doxygen; \
- echo "GENERATE_XML=NO"; \
echo "GENERATE_MAN=YES"; \
echo "MAN_OUTPUT=man"; \
echo "JAVADOC_AUTOBRIEF=NO"; \
diff --git a/doc/doxygen/wayland.doxygen.in b/doc/doxygen/wayland.doxygen.in
index e700e3d..7a2ac62 100644
--- a/doc/doxygen/wayland.doxygen.in
+++ b/doc/doxygen/wayland.doxygen.in
@@ -642,8 +642,7 @@ WARN_LOGFILE =
# directories like "/usr/src/myproject". Separate the files or directories
# with spaces.
-INPUT = @top_srcdir@/src/wayland-client.c \
- @top_srcdir@/src/wayland-client.h
+INPUT =
# This tag can be used to specify the character encoding of the source files
# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@@ -1364,7 +1363,7 @@ MAN_LINKS = YES
# generate an XML file that captures the structure of
# the code including all documentation.
-GENERATE_XML = YES
+GENERATE_XML = NO
# The XML_OUTPUT tag is used to specify where the XML pages will be put.
# If a relative path is entered the value of OUTPUT_DIRECTORY will be