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 \
31 dist_doc_DATA = system-activation.txt
33 # uploaded and distributed, but not installed
36 dbus-specification.xml \
45 doxygen_to_devhelp.xsl \
53 # diagram.png/diagram.svg aren't really HTML, but must go in the same
54 # directory as the HTML to avoid broken links
60 dist_html_DATA += $(STATIC_HTML)
64 dbus-specification.html \
68 if DBUS_XML_DOCS_ENABLED
69 html_DATA += $(XMLTO_OUTPUT)
71 dbus-specification.html: dbus-specification.xml
72 $(XMLTO) html-nochunks $<
74 dbus-test-plan.html: dbus-test-plan.xml
75 $(XMLTO) html-nochunks $<
77 dbus-tutorial.html: dbus-tutorial.xml
78 $(XMLTO) html-nochunks $<
80 dbus-faq.html: dbus-faq.xml
81 $(XMLTO) html-nochunks $<
84 if DBUS_DOXYGEN_DOCS_ENABLED
85 all-local:: doxygen.stamp
87 doxygen.stamp: $(wildcard $(top_srcdir)/dbus/*.[ch])
88 $(AM_V_GEN)cd $(top_builddir) && doxygen Doxyfile
92 html_DATA += dbus.devhelp
94 dbus.devhelp: $(srcdir)/doxygen_to_devhelp.xsl doxygen.stamp
95 $(XSLTPROC) -o $@ $< api/xml/index.xml
98 # this assumes CREATE_SUBDIRS isn't set to YES in Doxyfile
99 # (which it isn't currently)
100 install-data-local:: doxygen.stamp
101 $(MKDIR_P) $(DESTDIR)$(apidir)
102 $(INSTALL_DATA) api/html/* $(DESTDIR)$(apidir)
105 rm -f $(DESTDIR)$(apidir)/*.html
106 rm -f $(DESTDIR)$(apidir)/*.png
107 rm -f $(DESTDIR)$(apidir)/*.css
108 rm -f $(DESTDIR)$(apidir)/*.js
109 rm -f $(DESTDIR)$(htmldir)/*.html
110 rm -f $(DESTDIR)$(docdir)/*.txt
111 rm -f $(DESTDIR)$(htmldir)/*.png
112 rm -f $(DESTDIR)$(htmldir)/*.svg
113 rmdir --ignore-fail-on-non-empty $(DESTDIR)$(apidir) || \
114 rmdir $(DESTDIR)$(apidir)
117 if DBUS_HAVE_MAN2HTML
118 html_DATA += $(MAN_HTML_FILES)
121 $(AM_V_GEN)( $(MAN2HTML) < $< > $@.tmp && mv $@.tmp $@ )
124 if DBUS_CAN_UPLOAD_DOCS
126 $(top_srcdir)/README \
127 $(top_srcdir)/HACKING \
128 $(top_srcdir)/AUTHORS \
130 $(top_srcdir)/COPYING \
131 $(top_srcdir)/ChangeLog
133 dbus-docs: $(STATIC_DOCS) $(dist_doc_DATA) $(dist_html_DATA) $(MAN_HTML_FILES) $(BONUS_FILES) doxygen.stamp $(XMLTO_OUTPUT)
134 $(AM_V_at)rm -rf $@ $@.tmp
135 $(AM_V_GEN)$(MKDIR_P) $@.tmp/api
136 $(AM_V_at)cd $(srcdir) && cp $(STATIC_DOCS) @abs_builddir@/$@.tmp
137 $(AM_V_at)cd $(srcdir) && cp $(dist_doc_DATA) @abs_builddir@/$@.tmp
138 $(AM_V_at)cd $(srcdir) && cp $(STATIC_HTML) @abs_builddir@/$@.tmp
139 $(AM_V_at)cp $(XMLTO_OUTPUT) @abs_builddir@/$@.tmp
140 $(AM_V_at)cp $(MAN_HTML_FILES) @abs_builddir@/$@.tmp
141 $(AM_V_at)cp $(BONUS_FILES) @abs_builddir@/$@.tmp
142 $(AM_V_at)cp -r api/html @abs_builddir@/$@.tmp/api
143 $(AM_V_at)mv $@.tmp $@
145 dbus-docs.tar.gz: dbus-docs
146 $(AM_V_GEN)tar czf $@ $<
148 DOC_SERVER = dbus.freedesktop.org
149 DOC_WWW_DIR = /srv/dbus.freedesktop.org/www
151 SPECIFICATION_SERVER = specifications.freedesktop.org
152 SPECIFICATION_PATH = /srv/specifications.freedesktop.org/www/dbus/1.0
154 maintainer-upload-docs: dbus-docs.tar.gz dbus-docs
155 scp dbus-docs.tar.gz $(DOC_SERVER):$(DOC_WWW_DIR)/
156 rsync -rpvzP --chmod=Dg+s,ug+rwX,o=rX \
157 dbus-docs/ $(DOC_SERVER):$(DOC_WWW_DIR)/doc/
158 cd $(srcdir) && scp -p $(DTDS) $(SPECIFICATION_SERVER):$(SPECIFICATION_PATH)/
160 maintainer-upload-docs:
161 @echo "Can't upload documentation! Re-run configure with"
162 @echo " --enable-doxygen-docs --enable-xml-docs"
163 @echo "and ensure that man2html is installed."
170 rm -rf dbus-docs dbus-docs.tmp
174 maintainer-clean-local:
175 rm -f $(XMLTO_OUTPUT)