X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=doc%2FMakefile.am;h=aa5c7e1f354bfb8ff5e793122f59614966160a73;hb=3ccb027c907f9ee2890028e83b60296204bbf478;hp=e8156c6bfe6f1d6de828f23302d1701c72a412b8;hpb=23d4a2ec5d065cde06b265d8d0ef34e8d856effa;p=platform%2Fupstream%2Fdbus.git diff --git a/doc/Makefile.am b/doc/Makefile.am index e8156c6..aa5c7e1 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -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)