[daemon-fix] fixed querying about name information
[platform/upstream/dbus.git] / doc / Makefile.am
index e8156c6..aa5c7e1 100644 (file)
@@ -1,26 +1,32 @@
 apidir = @htmldir@/api
 
-# automake normally assumes that man pages are generated files;
-# these ones aren't, so we need the dist_ prefix to say that they're
-# their own source code
-dist_man1_MANS = \
+MAN_XML_FILES = \
+       dbus-cleanup-sockets.1.xml \
+       dbus-daemon.1.xml \
+       dbus-launch.1.xml \
+       dbus-monitor.1.xml \
+       dbus-run-session.1.xml \
+       dbus-send.1.xml \
+       dbus-uuidgen.1.xml \
+       $(NULL)
+
+if DBUS_XML_DOCS_ENABLED
+man1_MANS = \
        dbus-cleanup-sockets.1 \
+       dbus-daemon.1 \
        dbus-launch.1 \
        dbus-monitor.1 \
+       dbus-run-session.1 \
        dbus-send.1 \
        dbus-uuidgen.1
-
-# on the other hand, this one is generated
-man1_MANS = \
-       dbus-daemon.1
-
-MAN_IN_FILES = dbus-daemon.1.in
+endif
 
 MAN_HTML_FILES = \
        dbus-cleanup-sockets.1.html \
        dbus-daemon.1.html \
        dbus-launch.1.html \
        dbus-monitor.1.html \
+       dbus-run-session.1.html \
        dbus-send.1.html \
        dbus-uuidgen.1.html
 
@@ -28,47 +34,52 @@ DTDS = \
        busconfig.dtd \
        introspect.dtd
 
+dist_doc_DATA = system-activation.txt
+
+# uploaded and distributed, but not installed
 STATIC_DOCS = \
-       diagram.png \
-       diagram.svg \
        dbus-faq.xml \
        dbus-specification.xml \
        dbus-test-plan.xml \
        dbus-tutorial.xml \
        dcop-howto.txt \
        introspect.xsl \
-       system-activation.txt \
        $(DTDS)
 
 EXTRA_DIST = \
        file-boilerplate.c \
        doxygen_to_devhelp.xsl \
-       $(STATIC_DOCS) \
-       $(MAN_IN_FILES)
+       $(STATIC_DOCS)
 
-HTML_FILES=                                    \
-       dbus-faq.html                           \
-       dbus-specification.html                 \
-       dbus-test-plan.html                     \
-       dbus-tutorial.html
+html_DATA =
 
-if DBUS_XML_DOCS_ENABLED
-all-local:: $(HTML_FILES)
+dist_html_DATA =
 
-EXTRA_DIST += $(HTML_FILES)
+# diagram.png/diagram.svg aren't really HTML, but must go in the same
+# directory as the HTML to avoid broken links
+STATIC_HTML = \
+       diagram.png \
+       diagram.svg \
+       $(NULL)
 
-dbus-specification.html: dbus-specification.xml
-       $(XMLTO) html-nochunks $<
+dist_html_DATA += $(STATIC_HTML)
 
-dbus-test-plan.html: dbus-test-plan.xml
-       $(XMLTO) html-nochunks $<
+XMLTO_HTML =                                   \
+       dbus-faq.html                           \
+       dbus-specification.html                 \
+       dbus-test-plan.html                     \
+       dbus-tutorial.html                      \
+       $(MAN_HTML_FILES)                       \
+       $(NULL)
 
-dbus-tutorial.html: dbus-tutorial.xml
-       $(XMLTO) html-nochunks $<
+if DBUS_XML_DOCS_ENABLED
+html_DATA += $(XMLTO_HTML)
 
-dbus-faq.html: dbus-faq.xml
+%.html: %.xml
        $(XMLTO) html-nochunks $<
 
+%.1: %.1.xml
+       $(XMLTO) man $<
 endif
 
 if DBUS_DOXYGEN_DOCS_ENABLED
@@ -79,7 +90,7 @@ doxygen.stamp: $(wildcard $(top_srcdir)/dbus/*.[ch])
        @touch $@
 
 if DBUS_HAVE_XSLTPROC
-api_DATA = dbus.devhelp
+html_DATA += dbus.devhelp
 
 dbus.devhelp: $(srcdir)/doxygen_to_devhelp.xsl doxygen.stamp
        $(XSLTPROC) -o $@ $< api/xml/index.xml
@@ -95,17 +106,15 @@ uninstall-local::
        rm -f $(DESTDIR)$(apidir)/*.html
        rm -f $(DESTDIR)$(apidir)/*.png
        rm -f $(DESTDIR)$(apidir)/*.css
+       rm -f $(DESTDIR)$(apidir)/*.js
+       rm -f $(DESTDIR)$(htmldir)/*.html
+       rm -f $(DESTDIR)$(docdir)/*.txt
+       rm -f $(DESTDIR)$(htmldir)/*.png
+       rm -f $(DESTDIR)$(htmldir)/*.svg
        rmdir --ignore-fail-on-non-empty $(DESTDIR)$(apidir) || \
                rmdir $(DESTDIR)$(apidir)
 endif
 
-if DBUS_HAVE_MAN2HTML
-all-local:: $(MAN_HTML_FILES)
-
-%.1.html: %.1
-       $(AM_V_GEN)( $(MAN2HTML) $< > $@.tmp && mv $@.tmp $@ )
-endif
-
 if DBUS_CAN_UPLOAD_DOCS
 BONUS_FILES = \
        $(top_srcdir)/README \
@@ -115,14 +124,18 @@ BONUS_FILES = \
        $(top_srcdir)/COPYING \
        $(top_srcdir)/ChangeLog
 
-dbus-docs: $(STATIC_DOCS) $(HTML_FILES) $(MAN_HTML_FILES) $(BONUS_FILES) doxygen.stamp
-       $(AM_V_at)rm -rf $@
-       $(AM_V_GEN)$(MKDIR_P) $@/api
-       $(AM_V_at)cp $(STATIC_DOCS) $@
-       $(AM_V_at)cp $(HTML_FILES) $@
-       $(AM_V_at)cp $(MAN_HTML_FILES) $@
-       $(AM_V_at)cp $(BONUS_FILES) $@
-       $(AM_V_at)cp -r api/html $@/api
+dbus-docs: $(STATIC_DOCS) $(MAN_XML_FILES) $(dist_doc_DATA) $(dist_html_DATA) $(MAN_HTML_FILES) $(BONUS_FILES) doxygen.stamp $(XMLTO_HTML)
+       $(AM_V_at)rm -rf $@ $@.tmp
+       $(AM_V_GEN)$(MKDIR_P) $@.tmp/api
+       $(AM_V_at)cd $(srcdir) && cp $(STATIC_DOCS) @abs_builddir@/$@.tmp
+       $(AM_V_at)cd $(srcdir) && cp $(dist_doc_DATA) @abs_builddir@/$@.tmp
+       $(AM_V_at)cd $(srcdir) && cp $(STATIC_HTML) @abs_builddir@/$@.tmp
+       $(AM_V_at)cp $(XMLTO_HTML) @abs_builddir@/$@.tmp
+       $(AM_V_at)cp $(MAN_HTML_FILES) @abs_builddir@/$@.tmp
+       $(AM_V_at)cp $(MAN_XML_FILES) @abs_builddir@/$@.tmp
+       $(AM_V_at)cp $(BONUS_FILES) @abs_builddir@/$@.tmp
+       $(AM_V_at)cp -r api/html @abs_builddir@/$@.tmp/api
+       $(AM_V_at)mv $@.tmp $@
 
 dbus-docs.tar.gz: dbus-docs
        $(AM_V_GEN)tar czf $@ $<
@@ -134,10 +147,10 @@ SPECIFICATION_SERVER = specifications.freedesktop.org
 SPECIFICATION_PATH = /srv/specifications.freedesktop.org/www/dbus/1.0
 
 maintainer-upload-docs: dbus-docs.tar.gz dbus-docs
-       scp dbus-docs.tar.gz $(DOC_SERVER):$(DOC_WWW_DIR)
-       rsync -rvzP --chmod=Dg+s,ug+rwX,o=rX \
+       scp dbus-docs.tar.gz $(DOC_SERVER):$(DOC_WWW_DIR)/
+       rsync -rpvzP --chmod=Dg+s,ug+rwX,o=rX \
                dbus-docs/ $(DOC_SERVER):$(DOC_WWW_DIR)/doc/
-       scp -p $(DTDS) $(SPECIFICATION_SERVER):$(SPECIFICATION_PATH)
+       cd $(srcdir) && scp -p $(DTDS) $(SPECIFICATION_SERVER):$(SPECIFICATION_PATH)/
 else
 maintainer-upload-docs:
        @echo "Can't upload documentation! Re-run configure with"
@@ -146,11 +159,15 @@ maintainer-upload-docs:
        @false
 endif
 
+CLEANFILES = \
+       $(man1_MANS) \
+       $(MAN_XML_FILES) \
+       $(XMLTO_HTML) \
+       $(NULL)
+
 clean-local:
+       rm -f $(html_DATA)
        rm -rf api
-       rm -rf dbus-docs
+       rm -rf dbus-docs dbus-docs.tmp
        rm -f *.1.html
        rm -f doxygen.stamp
-
-maintainer-clean-local:
-       rm -f $(HTML_FILES)