summaryrefslogtreecommitdiffstats
path: root/utils/Makefile
diff options
context:
space:
mode:
authorTim Bielawa <tbielawa@redhat.com>2016-09-27 08:14:18 -0700
committerTim Bielawa <tbielawa@redhat.com>2016-09-27 08:17:42 -0700
commitee76824bd773ca91a0e76af61d96547ff4b196ba (patch)
treebb756e642464dad82b5bab124474464ff8240b5c /utils/Makefile
parent93c242367ee6e29ab0cb2b1f33da9ed8c4f084a7 (diff)
downloadopenshift-ee76824bd773ca91a0e76af61d96547ff4b196ba.tar.gz
openshift-ee76824bd773ca91a0e76af61d96547ff4b196ba.tar.bz2
openshift-ee76824bd773ca91a0e76af61d96547ff4b196ba.tar.xz
openshift-ee76824bd773ca91a0e76af61d96547ff4b196ba.zip
Add a manpage for atomic-openshift-installer
Diffstat (limited to 'utils/Makefile')
-rw-r--r--utils/Makefile21
1 files changed, 21 insertions, 0 deletions
diff --git a/utils/Makefile b/utils/Makefile
index 79c27626a..078d6f184 100644
--- a/utils/Makefile
+++ b/utils/Makefile
@@ -25,6 +25,12 @@ NAME := oo-install
TESTPACKAGE := oo-install
SHORTNAME := ooinstall
+# This doesn't evaluate until it's called. The -D argument is the
+# directory of the target file ($@), kinda like `dirname`.
+ASCII2MAN = a2x -D $(dir $@) -d manpage -f manpage $<
+MANPAGES := docs/man/man1/atomic-openshift-installer.1
+VERSION := 1.3
+
sdist: clean
python setup.py sdist
rm -fR $(SHORTNAME).egg-info
@@ -35,6 +41,21 @@ clean:
@rm -fR build dist rpm-build MANIFEST htmlcov .coverage cover ooinstall.egg-info oo-install
@rm -fR $(NAME)env
+
+# To force a rebuild of the docs run 'touch' on any *.in file under
+# docs/man/man1/
+docs: $(MANPAGES)
+
+# Regenerate %.1.asciidoc if %.1.asciidoc.in has been modified more
+# recently than %.1.asciidoc.
+%.1.asciidoc: %.1.asciidoc.in
+ sed "s/%VERSION%/$(VERSION)/" $< > $@
+
+# Regenerate %.1 if %.1.asciidoc or VERSION has been modified more
+# recently than %.1. (Implicitly runs the %.1.asciidoc recipe)
+%.1: %.1.asciidoc
+ $(ASCII2MAN)
+
viewcover:
xdg-open cover/index.html