added docs-publish toplevel goal

This one is long overdue as I keep forgetting to update the published copy of generated documentation all the time. Note that you must pass DOCS_PUBLISH (as a local directory or host:dir suitable for rsync/ssh) via make arguments, environment or ~/.mkimage/profiles.mk file.

added docs-publish toplevel goal
e0004a26 · Michael Shigorin · a2d79414 · e0004a26 · e0004a26
Commit e0004a26 authored Jun 24, 2014 by Michael Shigorin
Hide whitespace changes
Inline Side-by-side

Showing with 16 additions and 2 deletions

Makefile Makefile +3 -0

Makefile doc/Makefile +13 -2

No files found.
--- a/Makefile
+++ b/Makefile
@@ -68,3 +68,6 @@ SHELL = /bin/bash

 docs:
 	@$(MAKE) -C doc
+
+docs-publish:
+	@$(MAKE) -C doc publish
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -8,6 +8,9 @@ ifdef DEBUG
 VERBOSE = --verbose
 endif

+# avoid common DEBUG for the time being
+-include $(HOME)/.mkimage/profiles.mk
+
 PROJECT = mkimage-profiles
 TOPLEVEL_DOC = $(PROJECT).asciidoc
 RESOURCE_FILES = /etc/asciidoc
@@ -24,10 +27,19 @@ COMMON_ARGS = -d book -a lang="$L" $(DEST) $(VERBOSE) $(TOPLEVEL_DOC)
 HTML_ARGS = -a data-uri --icons -r $(RESOURCE_FILES) -r . \
 	    --xsltproc-opts='$(XSLT_ARGS)' $(COMMON_ARGS)

+# most convenient deliverables
+DOCS_OUT = $(PROJECT).pdf $(PROJECT).html docbook-xsl.css
+
 .PHONY: all prep chunked xhtml pdf clean

 all: chunked xhtml pdf

+# NB: destination defined externally
+publish: all
+	@if [ -n "$(DOCS_PUBLISH)" ]; then \
+		rsync -qa $(DOCS_OUT) "$(DOCS_PUBLISH)"; \
+	fi
+
 prep:
 	@if [ -n "$(BUILDDIR)" ]; then mkdir -p "$(BUILDDIR)"; fi

@@ -46,5 +58,4 @@ pdf: prep
 clean:
 	@echo "** cleaning up"
 	@if [ -d "$(BUILDDIR)" ]; then cd "$(BUILDDIR)"; fi; \
-	rm -f $(PROJECT).pdf $(PROJECT).html docbook-xsl.css; \
-	rm -rf $(PROJECT).chunked/
+	rm -rf $(DOCS_OUT) $(PROJECT).chunked/