doc: Use stamp files to ensure man and html are downloaded once

diff --git a/.gitignore b/.gitignore
index 9cc3de80b998cc565f2f925a9b1d8ef0325a6f76..cc8c5d7553839ad7d6421e979ba5a8a35398cded 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -64,50 +64,11 @@ src/**/test-*
 doc/venv
 doc/documentation*
 doc/html
-doc/man/.doctrees
 
-doc/man/doveadm-acl.1
-doc/man/doveadm-altmove.1
-doc/man/doveadm-auth.1
-doc/man/doveadm-deduplicate.1
-doc/man/doveadm-dump.1
-doc/man/doveadm-exec.1
-doc/man/doveadm-expunge.1
-doc/man/doveadm-fetch.1
-doc/man/doveadm-flags.1
-doc/man/doveadm-fs.1
-doc/man/doveadm-fts.1
-doc/man/doveadm-import.1
-doc/man/doveadm-instance.1
-doc/man/doveadm-index.1
-doc/man/doveadm-indexer.1
-doc/man/doveadm-force-resync.1
-doc/man/doveadm-help.1
-doc/man/doveadm-kick.1
-doc/man/doveadm-log.1
-doc/man/doveadm-mailbox.1
-doc/man/doveadm-mailbox-cryptokey.1
-doc/man/doveadm-mount.1
-doc/man/doveadm-move.1
-doc/man/doveadm-penalty.1
-doc/man/doveadm-proxy.1
-doc/man/doveadm-purge.1
-doc/man/doveadm-pw.1
-doc/man/doveadm-quota.1
-doc/man/doveadm-rebuild.1
-doc/man/doveadm-replicator.1
-doc/man/doveadm-save.1
-doc/man/doveadm-stats.1
-doc/man/doveadm-search.1
-doc/man/doveadm-sync.1
-doc/man/doveadm-user.1
-doc/man/doveadm-who.1
-doc/man/doveadm.1
-doc/man/doveconf.1
-doc/man/dovecot-lda.1
-doc/man/dovecot.1
-doc/man/dovecot-sysreport.1
-doc/man/doveadm-search-query.7
+doc/man/*.1
+doc/man/*.7
+doc/stamp-man
+doc/stamp-html
 
 doc/example-config/README
 doc/wiki/*.txt

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 1303b72526d9818f5388fc2fc1d4ec5cb6bcad5d..8207a717c418434ebbcf90d31c88530feaa284d5 100644 (file)
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -25,23 +25,20 @@ SUBDIRS += man
 DOCDIRS += html
 endif
 
-extra_dist_extra += html
+extra_dist_extra += html stamp-html stamp-man
+BUILT_SOURCES = stamp-html stamp-man
 
-html-dl:
-       $(AM_V_at)$(WGET) -nv -O- $(DOCS_URL) | xz -d | $(am__untar)
+stamp-html:
+       $(AM_V_at)$(WGET) -nv -O- $(DOCS_URL) | xz -d | $(am__untar) && \
+               touch stamp-html || rm -f stamp-html
 
-man-dl:
-       $(AM_V_at)$(WGET) -nv -O- $(MAN_URL) | xz -d | $(am__untar)
+stamp-man:
+       $(AM_V_at)$(WGET) -nv -O- $(MAN_URL) | xz -d | $(am__untar) && \
+               touch stamp-man || rm -f stamp-man
 
 all-local: html
 
-html-local:
-       $(AM_V_at)if [ ! -e html/*/index.html ]; then \
-               $(MAKE) html-dl; \
-       fi
-       $(AM_V_at)if [ ! -e man/dovecot.1 ]; then \
-               $(MAKE) man-dl; \
-       fi
+html-local: stamp-html stamp-man
 
 install-data-local:
        $(MKDIR_P) $(DESTDIR)$(docdir); \
@@ -60,3 +57,8 @@ EXTRA_DIST = \
        dovecot-initd.sh \
        $(extra_dist_extra) \
        $(docfiles)
+
+distclean-local:
+       -if test "$(extra_dist_extra)" != ""; then \
+               rm -rf $(extra_dist_extra); \
+       fi