diff options
Diffstat (limited to 'Documentation/include.mk')
-rw-r--r-- | Documentation/include.mk | 73 |
1 files changed, 49 insertions, 24 deletions
diff --git a/Documentation/include.mk b/Documentation/include.mk index 4669ac54..28b69aed 100644 --- a/Documentation/include.mk +++ b/Documentation/include.mk @@ -4,60 +4,85 @@ all:: RSYNC = rsync RSYNC_DEST = public-inbox.org:/srv/public-inbox/ -docs := README COPYING INSTALL TODO $(shell git ls-files 'Documentation/*.txt') +docs := README COPYING INSTALL TODO HACKING +docs += $(shell git ls-files 'Documentation/*.txt') INSTALL = install -POD2MAN = pod2man -POD2MAN_OPTS = -v --stderr -d 1994-10-02 -c 'public-inbox user manual' -pod2man = $(POD2MAN) $(POD2MAN_OPTS) -POD2TEXT = pod2text -POD2TEXT_OPTS = --stderr -pod2text = $(POD2TEXT) $(POD2TEXT_OPTS) - +PODMAN = pod2man +PODMAN_OPTS = -v --stderr -d 1993-10-02 -c 'public-inbox user manual' +PODMAN_OPTS += -r public-inbox.git +podman = $(PODMAN) $(PODMAN_OPTS) +PODTEXT = pod2text +PODTEXT_OPTS = --stderr +podtext = $(PODTEXT) $(PODTEXT_OPTS) + +# MakeMaker only seems to support manpage sections 1 and 3... m1 = m1 += public-inbox-mda +m1 += public-inbox-httpd +m1 += public-inbox-nntpd +m1 += public-inbox-watch +m1 += public-inbox-index m5 = +m5 += public-inbox-config m7 = +m7 += public-inbox-overview +m8 = +m8 += public-inbox-daemon man1 := $(addsuffix .1, $(m1)) man5 := $(addsuffix .5, $(m5)) man7 := $(addsuffix .7, $(m7)) +man8 := $(addsuffix .8, $(m8)) all:: man html -man: $(man1) $(man5) $(man7) +man: $(man1) $(man5) $(man7) $(man8) +prefix ?= $(PREFIX) prefix ?= $(HOME) mandir ?= $(prefix)/share/man man1dir = $(mandir)/man1 man5dir = $(mandir)/man5 man7dir = $(mandir)/man7 +man8dir = $(mandir)/man8 install-man: man - test -z "$(man1)" || $(INSTALL) -d -m 755 $(DESTDIR)$(man1dir) - test -z "$(man5)" || $(INSTALL) -d -m 755 $(DESTDIR)$(man5dir) - test -z "$(man7)" || $(INSTALL) -d -m 755 $(DESTDIR)$(man7dir) - test -z "$(man1)" || $(INSTALL) -m 644 $(man1) $(DESTDIR)$(man1dir) - test -z "$(man5)" || $(INSTALL) -m 644 $(man5) $(DESTDIR)$(man5dir) - test -z "$(man7)" || $(INSTALL) -m 644 $(man7) $(DESTDIR)$(man7dir) - -%.1 : Documentation/%.pod - $(pod2man) -s 1 $< $@+ && mv $@+ $@ - -mantxt = $(addprefix Documentation/, $(addsuffix .txt, $(m1))) + $(INSTALL) -d -m 755 $(DESTDIR)$(man1dir) + $(INSTALL) -d -m 755 $(DESTDIR)$(man5dir) + $(INSTALL) -d -m 755 $(DESTDIR)$(man7dir) + $(INSTALL) -d -m 755 $(DESTDIR)$(man8dir) + $(INSTALL) -m 644 $(man1) $(DESTDIR)$(man1dir) + $(INSTALL) -m 644 $(man5) $(DESTDIR)$(man5dir) + $(INSTALL) -m 644 $(man7) $(DESTDIR)$(man7dir) + $(INSTALL) -m 644 $(man8) $(DESTDIR)$(man8dir) + +doc_install :: install-man + +%.1 %.5 %.7 %.8 : Documentation/%.pod + $(podman) -s $(subst .,,$(suffix $@)) $< $@+ && mv $@+ $@ + +manuals := +manuals += $(m1) +manuals += $(m5) +manuals += $(m7) +manuals += $(m8) + +mantxt = $(addprefix Documentation/, $(addsuffix .txt, $(manuals))) docs += $(mantxt) all :: $(mantxt) Documentation/%.txt : Documentation/%.pod - $(pod2text) $< $@+ && mv $@+ $@ + $(podtext) $< $@+ && mv $@+ $@ -txt2pre = ./Documentation/txt2pre < $< > $@+ && touch -r $< $@+ && mv $@+ $@ +txt2pre = $(PERL) -I lib ./Documentation/txt2pre <$< >$@+ && \ + touch -r $< $@+ && mv $@+ $@ txt := INSTALL README COPYING TODO dtxt := design_notes.txt design_www.txt dc-dlvr-spam-flow.txt dtxt := $(addprefix Documentation/, $(dtxt)) $(mantxt) %.html: %.txt - $(txt2pre) + TITLE="$(basename $(<F))" $(txt2pre) %.html: % $(txt2pre) @@ -66,7 +91,7 @@ html: $(docs_html) gz_docs := $(addsuffix .gz, $(docs) $(docs_html)) rsync_docs := $(gz_docs) $(docs) $(txt) $(docs_html) %.gz: % - gzip -9 --rsyncable < $< > $@+ + gzip -9 --rsyncable <$< >$@+ touch -r $< $@+ mv $@+ $@ |