From: Alan T. DeKok Date: Mon, 25 Feb 2013 16:14:48 +0000 (-0500) Subject: Use boilermake for documentation. X-Git-Tag: release_3_0_0_beta1~944 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f8194162c83c7d6cab8c2d4509751bfaba0c0e8b;p=thirdparty%2Ffreeradius-server.git Use boilermake for documentation. --- diff --git a/Makefile b/Makefile index 9689e75abf1..243300262f9 100644 --- a/Makefile +++ b/Makefile @@ -22,7 +22,7 @@ export DESTDIR := $(R) include scripts/boiler.mk # These are not yet converted to the new system -SUBDIRS = $(wildcard raddb doc) +SUBDIRS = $(wildcard raddb) .PHONY: tests tests: diff --git a/doc/Makefile b/doc/Makefile deleted file mode 100644 index aaf7675ac13..00000000000 --- a/doc/Makefile +++ /dev/null @@ -1,47 +0,0 @@ -# -# Makefile -# -# Version: $Id$ -# - -include ../Make.inc - -SUBDIRS = examples rfc -WHAT_TO_MAKE = all - -RST_FILES := $(wildcard *.rst) - -all: - @$(MAKE) $(MFLAGS) WHAT_TO_MAKE=$@ common - -clean: - @$(MAKE) $(MFLAGS) WHAT_TO_MAKE=$@ common - @rm -f *~ - -install: - @if [ "$(docdir)" = no ]; then \ - echo 'Documentation files will NOT be installed.'; \ - else \ - $(INSTALL) -d -m 755 $(R)$(docdir); \ - for file in *[!~]; do \ - if [ -f $$file -a $$file != Makefile ]; then \ - $(INSTALL) -m 644 $$file $(R)$(docdir); \ - fi; \ - done; \ - $(MAKE) $(MFLAGS) WHAT_TO_MAKE=$@ common; \ - fi - -common: $(SUBDIRS) - -$(SUBDIRS): - @echo "Making $(WHAT_TO_MAKE) in $@..." - @$(MAKE) $(MFLAGS) -C $@ $(WHAT_TO_MAKE) - -.PHONY: all clean install common $(SUBDIRS) - -%.html: %.rst - @rst2html.py $^ > $@ - -.PHONY: html -html: $(RST_FILES:.rst=.html) - diff --git a/doc/all.mk b/doc/all.mk new file mode 100644 index 00000000000..5698f21a27e --- /dev/null +++ b/doc/all.mk @@ -0,0 +1,42 @@ +ifneq "$(docdir)" "no" +install: install.doc + +clean: clean.doc + +DOCFILES := $(filter-out %~ %/Makefile doc/00-OLD doc/examples doc/rfc doc/source,$(wildcard doc/* doc/rfc/*.txt doc/examples/*)) +DOCINSTALL := $(patsubst doc/%,$(R)$(docdir)/%,$(DOCFILES)) + +DOCDIRS := $(R)/$(docdir)/ $(R)/$(docdir)/rfc/ $(R)/$(docdir)/examples/ + + +# Create the directories +$(DOCDIRS): + @echo INSTALL $@ + @$(INSTALL) -d -m 755 $@ + +# Files depend on directories (order only). +# We don't care if the directories change. +$(DOCINSTALL): | $(DOCDIRS) + +# Wildcard installation rule +$(R)$(docdir)/%: doc/% + @echo INSTALL $< + @$(INSTALL) -m 644 $< $@ + +install.doc: $(DOCINSTALL) + +.PHONY: clean.doc +clean.doc: + @rm -f *~ rfc/*~ examples/*~ + +# +# Deal with these later +# +DOCRST := $(wildcard *.rst) +%.html: %.rst + @rst2html.py $^ > $@ + +.PHONY: html +html: $(DOCRST:.rst=.html) + +endif diff --git a/doc/examples/Makefile b/doc/examples/Makefile deleted file mode 100644 index c02b369be9b..00000000000 --- a/doc/examples/Makefile +++ /dev/null @@ -1,22 +0,0 @@ -# -# Makefile -# -# Version: $Id$ -# - -include ../../Make.inc - -all: - -clean: - @rm -f *~ - -install: - $(INSTALL) -d -m 755 $(R)$(docdir)/examples - for file in *[!~]; do \ - if [ -f $$file -a $$file != Makefile ]; then \ - $(INSTALL) -m 644 $$file $(R)$(docdir)/examples; \ - fi; \ - done - -.PHONY: all clean install diff --git a/doc/rfc/Makefile b/doc/rfc/Makefile index de84b2ced3c..d999cc5e233 100644 --- a/doc/rfc/Makefile +++ b/doc/rfc/Makefile @@ -28,10 +28,4 @@ refs: $(RFC) clean: @rm -f refs *rfc*.html *~ .rewrite index.html -install: - $(INSTALL) -d -m 755 $(R)$(docdir)/rfc - for file in `ls -1 *.txt *.html`; do \ - $(INSTALL) -m 644 $$file $(R)$(docdir)/rfc; \ - done - -.PHONY: all clean install html +.PHONY: all clean html diff --git a/main.mk b/main.mk index 79d45ce7998..666d5b90c10 100644 --- a/main.mk +++ b/main.mk @@ -1 +1 @@ -SUBMAKEFILES := src/all.mk +SUBMAKEFILES := src/all.mk scripts/all.mk doc/all.mk