aboutsummaryrefslogtreecommitdiffstats
path: root/manual/build.mk
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2021-12-21 15:23:20 +0100
committerJay Berkenbilt <ejb@ql.org>2021-12-21 15:52:41 +0100
commit36916619f0b07b4412df5a96683579552dd96285 (patch)
tree29df82de9a033570826c2791f9b6457ac7b63bd5 /manual/build.mk
parente058247bcfb132866dae5c873db7591bcc13db7e (diff)
downloadqpdf-36916619f0b07b4412df5a96683579552dd96285.tar.zst
Stop adding pre-built documentation to the source distribution
Diffstat (limited to 'manual/build.mk')
-rw-r--r--manual/build.mk39
1 files changed, 25 insertions, 14 deletions
diff --git a/manual/build.mk b/manual/build.mk
index b07bf830..bca1253d 100644
--- a/manual/build.mk
+++ b/manual/build.mk
@@ -6,7 +6,10 @@ HTML_TARGET := $(HTML_OUT)/index.html
PDF_OUT := $(DOC_OUT)/latex
PDF_TARGET := $(PDF_OUT)/qpdf.pdf
-TARGETS_manual := doc/qpdf.1 doc/fix-qdf.1 doc/zlib-flate.1
+TARGETS_manual := \
+ $(DOC_OUT)/qpdf.1 \
+ $(DOC_OUT)/fix-qdf.1 \
+ $(DOC_OUT)/zlib-flate.1
ifeq ($(BUILD_HTML),1)
TARGETS_manual += $(HTML_TARGET) $(S_HTML_TARGET)
endif
@@ -22,23 +25,31 @@ MANUAL_DEPS = $(wildcard manual/*.rst) manual/conf.py
# the error "_pickle.UnpicklingError: pickle data was truncated"
$(HTML_TARGET): $(MANUAL_DEPS)
$(SPHINX) -M html manual $(DOC_OUT) -W
- mkdir -p doc
- rm -rf doc/html
- cp -r $(DOC_OUT)/html doc
$(S_HTML_TARGET): $(MANUAL_DEPS) | $(HTML_TARGET)
$(SPHINX) -M singlehtml manual $(DOC_OUT) -W
- mkdir -p doc
- rm -rf doc/singlehtml
- cp -r $(DOC_OUT)/singlehtml doc
$(PDF_TARGET): $(MANUAL_DEPS) | $(S_HTML_TARGET) $(HTML_TARGET)
$(SPHINX) -M latexpdf manual $(DOC_OUT) -W
- mkdir -p doc
- cp $(PDF_TARGET) doc/qpdf-manual.pdf
-doc/%.1: manual/%.1.in
- mkdir -p doc
- sed -e 's:@PACKAGE_VERSION@:$(PACKAGE_VERSION):g' \
- -e 's:@docdir@:$(docdir):g' \
- < $< > $@
+$(DOC_OUT)/%.1: manual/%.1.in
+ sed -e 's:@PACKAGE_VERSION@:$(PACKAGE_VERSION):g' < $< > $@
+
+# The doc-dist target must not removed $(DOC_DEST) so that it works to
+# do stuff like make doc-dist DOC_DEST=$(DESTDIR)/$(docdir). Make sure
+# what this does is consistent with ../README-doc.txt and the
+# information in the manual and ../README.md.
+.PHONY: doc-dist
+doc-dist: build_manual
+ @if test x"$(DOC_DEST)" = x; then \
+ echo DOC_DEST must be set 1>& 2; \
+ false; \
+ fi
+ if test -d $(DOC_DEST); then \
+ $(RM) -rf $(DOC_DEST)/*html $(DOC_DEST)/*.pdf; \
+ else \
+ mkdir -p $(DOC_DEST); \
+ fi
+ cp -r $(DOC_OUT)/html doc
+ cp -r $(DOC_OUT)/singlehtml doc
+ cp $(PDF_TARGET) $(DOC_DEST)/qpdf-manual.pdf