3 # automake normally assumes that man pages are generated files;
4 # these ones aren't, so we need the dist_ prefix to say that they're
5 # their own source code
7 dbus-cleanup-sockets.1 \
13 # on the other hand, this one is generated
17 MAN_IN_FILES = dbus-daemon.1.in
20 dbus-cleanup-sockets.1.html \
38 dbus-specification.xml \
47 doxygen_to_devhelp.xsl \
53 # we distribute these in the tarball so users don't necessarily need xmlto
54 dist_html_DATA = $(XMLTO_OUTPUT)
58 dbus-specification.html \
62 if DBUS_XML_DOCS_ENABLED
63 dbus-specification.html: dbus-specification.xml
64 $(XMLTO) html-nochunks $<
66 dbus-test-plan.html: dbus-test-plan.xml
67 $(XMLTO) html-nochunks $<
69 dbus-tutorial.html: dbus-tutorial.xml
70 $(XMLTO) html-nochunks $<
72 dbus-faq.html: dbus-faq.xml
73 $(XMLTO) html-nochunks $<
76 if DBUS_DOXYGEN_DOCS_ENABLED
77 all-local:: doxygen.stamp
79 doxygen.stamp: $(wildcard $(top_srcdir)/dbus/*.[ch])
80 $(AM_V_GEN)cd $(top_builddir) && doxygen Doxyfile
84 html_DATA += dbus.devhelp
86 dbus.devhelp: $(srcdir)/doxygen_to_devhelp.xsl doxygen.stamp
87 $(XSLTPROC) -o $@ $< api/xml/index.xml
90 # this assumes CREATE_SUBDIRS isn't set to YES in Doxyfile
91 # (which it isn't currently)
92 install-data-local:: doxygen.stamp
93 $(MKDIR_P) $(DESTDIR)$(apidir)
94 $(INSTALL_DATA) api/html/* $(DESTDIR)$(apidir)
97 rm -f $(DESTDIR)$(apidir)/*.html
98 rm -f $(DESTDIR)$(apidir)/*.png
99 rm -f $(DESTDIR)$(apidir)/*.css
100 rmdir --ignore-fail-on-non-empty $(DESTDIR)$(apidir) || \
101 rmdir $(DESTDIR)$(apidir)
104 if DBUS_HAVE_MAN2HTML
105 all-local:: $(MAN_HTML_FILES)
108 $(AM_V_GEN)( $(MAN2HTML) $< > $@.tmp && mv $@.tmp $@ )
111 if DBUS_CAN_UPLOAD_DOCS
113 $(top_srcdir)/README \
114 $(top_srcdir)/HACKING \
115 $(top_srcdir)/AUTHORS \
117 $(top_srcdir)/COPYING \
118 $(top_srcdir)/ChangeLog
120 dbus-docs: $(STATIC_DOCS) $(dist_doc_DATA) $(dist_html_DATA) $(MAN_HTML_FILES) $(BONUS_FILES) doxygen.stamp
122 $(AM_V_GEN)$(MKDIR_P) $@/api
123 $(AM_V_at)cp $(STATIC_DOCS) $@
124 $(AM_V_at)cp $(dist_doc_DATA) $@
125 $(AM_V_at)cp $(dist_html_DATA) $@
126 $(AM_V_at)cp $(MAN_HTML_FILES) $@
127 $(AM_V_at)cp $(BONUS_FILES) $@
128 $(AM_V_at)cp -r api/html $@/api
130 dbus-docs.tar.gz: dbus-docs
131 $(AM_V_GEN)tar czf $@ $<
133 DOC_SERVER = dbus.freedesktop.org
134 DOC_WWW_DIR = /srv/dbus.freedesktop.org/www
136 SPECIFICATION_SERVER = specifications.freedesktop.org
137 SPECIFICATION_PATH = /srv/specifications.freedesktop.org/www/dbus/1.0
139 maintainer-upload-docs: dbus-docs.tar.gz dbus-docs
140 scp dbus-docs.tar.gz $(DOC_SERVER):$(DOC_WWW_DIR)
141 rsync -rpvzP --chmod=Dg+s,ug+rwX,o=rX \
142 dbus-docs/ $(DOC_SERVER):$(DOC_WWW_DIR)/doc/
143 scp -p $(DTDS) $(SPECIFICATION_SERVER):$(SPECIFICATION_PATH)
145 maintainer-upload-docs:
146 @echo "Can't upload documentation! Re-run configure with"
147 @echo " --enable-doxygen-docs --enable-xml-docs"
148 @echo "and ensure that man2html is installed."
159 maintainer-clean-local:
160 rm -f $(XMLTO_OUTPUT)