mirror of
https://github.com/coredns/coredns.git
synced 2025-10-27 08:14:18 -04:00
f8aa208cc0
Mmark recently became able to create manual pages. This removed the dependency on 'ronn' and just uses mmark (Go program). Re-hookup Makefile.doc to generate the correct header mmark needs to see and regenate them all. Spot checking a few pages suggest they look good and actually better than rendered with ronn, esp. lists in lists. Fixes #2757 Signed-off-by: Miek Gieben <miek@miek.nl>
44 lines
1.3 KiB
Makefile
44 lines
1.3 KiB
Makefile
MMARK:=mmark -man
|
|
PLUGINS:=$(wildcard plugin/*/README.md)
|
|
READMES:=$(subst plugin/,,$(PLUGINS))
|
|
READMES:=$(subst /README.md,,$(READMES))
|
|
PLUGINS:=$(subst plugin/,coredns-,$(PLUGINS))
|
|
PLUGINS:=$(subst /README.md,(7),$(PLUGINS))
|
|
|
|
ifeq (, $(shell which mmark))
|
|
$(warning "No mmark in $$PATH, exiting, see github.com/mmarkdown/mmark")
|
|
all:
|
|
@echo "noop"
|
|
else
|
|
all: man/coredns.1 man/corefile.5 plugins
|
|
endif
|
|
|
|
man/coredns.1: coredns.1.md
|
|
@/bin/echo -e '%%%\n title = "coredns 1"\n' \
|
|
'area = "CoreDNS"\n workgroup = "CoreDNS"\n%%%\n\n' > $@.header
|
|
@cat $@.header $< > $@.md && rm $@.header
|
|
@sed -i -e "s/@@PLUGINS@@/$(PLUGINS)/" $@.md
|
|
$(MMARK) $@.md > $@ && rm $@.md
|
|
|
|
man/corefile.5: corefile.5.md
|
|
@/bin/echo -e '%%%\n title = "corefile 5"\n' \
|
|
'area = "CoreDNS"\n workgroup = "CoreDNS"\n%%%\n\n' > $@.header
|
|
@cat $@.header $< > $@.md && rm $@.header
|
|
$(MMARK) $@.md > $@ && rm $@.md
|
|
|
|
.PHONY: plugins
|
|
plugins:
|
|
for README in $(READMES); do \
|
|
$(MAKE) -f Makefile.doc man/coredns-$$README.7; \
|
|
done
|
|
|
|
man/coredns-%.7: plugin/%/README.md
|
|
@/bin/echo -e "%%%\n title = \"`basename $@ | sed s\/\.7\/\/` 7\"\n" \
|
|
'area = "CoreDNS"\n workgroup = "CoreDNS Plugins"\n%%%\n\n' > $@.header
|
|
@cat $@.header $< > $@.md && rm $@.header
|
|
$(MMARK) $@.md > $@ && rm $@.md
|
|
|
|
PHONY: clean
|
|
clean:
|
|
rm -f man/*
|