diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/Makefile.am | 29 |
1 files changed, 24 insertions, 5 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am index d1ed4e5..63d09de 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,10 +1,29 @@ HELP2MAN = $(SHELL) $(top_srcdir)/$(config_aux_dir)/missing --run help2man -man_MANS = $(srcdir)/postgresql$(DISTSUFF)-setup.1 +# The help2man call +# ================= +# Make the rules always dependant on source (thus on postgresql-setup.in, not on +# postgresql-setup), at least for distributed files. Otherwise, the '*.1' +# manual page is regenerated even when distributed and no code change actually +# happened. In case there exists some target generating other file directly +# depending on the generated manual page, we would need 'touch $@'. But it +# seems better to keep warning user about non-existing help2man when '.in' +# changed. +# TODO: make it non-fatal for cross-compilation case also +# TODO: separate it to its own m4 module (for easier distribution) -# TODO: distribute also help2man +HELP2MAN_RUN = \ + file=$< ; \ + file=$${file%%.in} ; \ + $(HELP2MAN) --output=$@ $$file -N ; \ + rs=$$? ; \ + if test $$rs -eq 127; then \ + test -f $@ ; \ + else \ + test $$rs -eq 0 ; \ + fi -$(srcdir)/postgresql$(DISTSUFF)-setup.1: $(top_srcdir)/postgresql-setup.in - $(AM_V_GEN)$(HELP2MAN) --output=$@ $(top_srcdir)/postgresql$(DISTSUFF)-setup -N +dist_man_MANS = $(srcdir)/postgresql$(DISTSUFF)-setup.1 -CLEANFILES=$(man_MANS) $(srcdir)/*.1 +$(srcdir)/postgresql$(DISTSUFF)-setup.1: $(top_srcdir)/postgresql-setup.in + $(AM_V_GEN)$(HELP2MAN_RUN) |