提交: 053bd84260104ac597d2f97b1b0dba0145419fe5 - git-mq (git)

Mercurial Queues Emulation for Git

Commit MetaInfo

• 修訂: 053bd84260104ac597d2f97b1b0dba0145419fe5 (tree)
• 時間: 2019-06-26 14:47:51
• 作者: Keith Marshall <keith@user...>
• Commiter: Keith Marshall

Log Message

Automate publication of documentation in optional formats.

* Makefile.in (pdf, all-pdf, install-pdf): Define new rules; these
format the man-pages, and store them as publication-ready PDF files.
(ps, all-ps, install-ps): Likewise, storing as PostScript files.
(dvi, all-dvi, install-dvi, html, all-html, install-html)
(info, all-info, install-info): Decline to publish.

Change Summary

• modified: Makefile.in

差異

--- a/Makefile.in
+++ b/Makefile.in
@@ -156,6 +156,7 @@ ${bindir} ${package_hooksdir} ${package_libexecdir} ${man1dir}:
 	$(MKDIR_P) $@
 
 INSTALL := @INSTALL@
+INSTALL_DATA := @INSTALL_DATA@
 install: installdirs install-bin-scripts install-libexec-scripts
 
 INSTALL_SCRIPTS = for script in $1; do $(call DO_INSTALL,$2 $$script,$3); done
@@ -228,6 +229,52 @@ manpage_installer_script = sed \
 manpage_template_subst = 's/@$1@/$($(if $2,$2,$1))/'
 
 
+# Documentation
+# =============
+#
+# Man-page documentation is required, to support "git help";
+# it is automatically provided when the package is installed.
+# The following will deliver copies of this documentation, in
+# optional PostScript and PDF formats, as built by invoking
+# GNU standard "ps", "install-ps", "pdf", and "install-pdf"
+# make objectives.
+#
+.PHONY: pdf install-pdf ps install-ps
+PACKAGE_DOCDIR := @docdir@/$(PACKAGE_VERSION)
+
+all_manpages := $(notdir $(wildcard ${srcdir}/man/*.man))
+all-pdf-internal all-ps-internal: all-%-internal: $(all_manpages:.man=.%)
+
+pdf ps: %: all-%
+all-pdf all-ps: all-%: ${CURDIR}/tmp/share/man/man1/timestamp
+	$(QUIET_MAKE) all-$*-internal prefix=${CURDIR}/tmp
+
+install-pdf install-ps: install-%: $(all_manpages:.man=.%)
+	$(MKDIR_P) ${PACKAGE_DOCDIR}/$*
+	$(INSTALL_DATA) $^ ${PACKAGE_DOCDIR}/$*
+
+${CURDIR}/tmp/share/man/man1/timestamp: configure
+	rm -rf $(dir $@) && $(MKDIR_P) $(dir $@) && > $@
+
+%.1: %.1.man ${CURDIR}/tmp/share/man/man1/timestamp
+	$(QUIET_MAKE) ${CURDIR}/tmp/share/man/man1/$@ prefix=${CURDIR}/tmp
+	rm -f $@; ln ${CURDIR}/tmp/share/man/man1/$@ $@
+
+%.1.pdf: %.1
+	MANPATH=${CURDIR}/tmp/share/man man -t $* | ps2pdf - $@
+
+%.1.ps: %.1
+	MANPATH=${CURDIR}/tmp/share/man man -t $* > $@
+
+# OTOH, we simply decline to support the other GNU standard
+# documentation formats, namely "info", "dvi", and "html".
+#
+dvi html info: %: all-%
+all-dvi all-html all-info: all-%: install-%
+install-dvi install-html install-info: install-%:
+	$(error "Sorry: '$*' documentation is unsupported for this package!")
+
+
 # Distribution
 # ============
 #
@@ -264,7 +311,6 @@ bindist: $(PACKAGE_TMPDIR)
 	cd $^; tar cf - * | xz -c > ../$(PACKAGE_DISTNAME)-bin.tar.xz
 	rm -rf $(PACKAGE_TMPDIR)
 
-PACKAGE_DOCDIR := @docdir@/$(PACKAGE_VERSION)
 bindist-licence: LICENCE FDL-1.3
 	$(MKDIR_P) ${PACKAGE_DOCDIR}
 	$(call INSTALL_SCRIPTS,$^,-m 644,${PACKAGE_DOCDIR})