Makefile

@@ -16,12 +16,14 @@ $(DROSS)/test.pdf: $(ALL_FILES) $(DROSS)
 	$(GLOS) test
 	$(RUN) test.tex
 
-docs.pdf: images/wide.jpg STYLE_FILES | $(DROSS)
+$(DBOOK): docs.pdf
+	$(CP) $< $@
+docs.pdf: images/wide.jpg STYLE_FILES | $(DROSS) ## Make documentation
 	$(RUN) docs.tex
 	$(GLOS) docs
 	$(RUN) docs.tex
 	$(CP) $(DROSS)/docs.pdf docs.pdf
-character_sheets.pdf: HANDOUTS STYLE_FILES | $(DROSS)
+character_sheets.pdf: HANDOUTS STYLE_FILES | $(DROSS) ## Character sheets
 	$(RUN) character_sheets.tex
 	$(RUN) character_sheets.tex
 	$(CP) $(DROSS)/character_sheets.pdf character_sheets.pdf
@@ -36,15 +38,13 @@ booklet.pdf: | STYLE_FILES HANDOUTS $(DROSS)
 
 /tmp/p_2.pdf: booklet.pdf
 	pdfjam --angle '-90' $< 2 --outfile $@
-rules.pdf: /tmp/p_1.pdf /tmp/p_2.pdf
+rules.pdf: /tmp/p_1.pdf /tmp/p_2.pdf ## One-page rules summary
 	pdfunite $^ $@
 
-markets.pdf: config/market.sty $(wildcard config/markets/*) | $(DROSS)
+markets.pdf: config/market.sty $(wildcard config/markets/*) | $(DROSS) ## Price-sheets for baileys and town
 	$(RUN) -jobname markets markets/all.tex
 	$(RUN) -jobname markets markets/all.tex
 	$(CP) $(DROSS)/$@ .
 
-.PHONY: all clean
-all: docs.pdf rules.pdf character_sheets.pdf $(DROSS)/test.pdf 
-clean:
-	$(CLEAN) images/wide.jpg .count.tex
+targets += docs.pdf rules.pdf character_sheets.pdf $(DROSS)/test.pdf markets.pdf
+output += images/wide.jpg

vars

@@ -14,12 +14,16 @@ COMPILER = latexmk -file-line-error -output-directory=$(DROSS) -pdflua -interact
 RELEASE = $(TITLE).pdf
 GLOS := makeglossaries -d $(DROSS)
 RUN := lualatex -output-directory $(DROSS) -shell-escape
-CLEAN := $(RM) -r $(DROSS) $(LOCAL_DROSS) qr.tex *.pdf .switch-gls svg-inkscape
 
+targets += check
 
+.PHONY: book
+book: $(RELEASE) ## Compile the pdf
 $(RELEASE): $(DBOOK)
 	@$(CP) $< $@
 
+targets += $(RELEASE)
+
 .PHONY: LOCTEX
 LOCTEX: $(wildcard *.tex)
 
@@ -37,6 +41,7 @@ qr.tex: README.md config/vars
 .switch-gls:
 	@touch .switch-gls
 
+output += qr.tex .switch-gls svg-inkscape
 
 images/extracted/:
 	mkdir -p $@
@@ -45,31 +50,38 @@ images/extracted/inclusion.tex: images/extracted/
 	printf '%s\n' '\externaldocument{$(BOOK)}' > $@
 	printf '%s\n' '\newcommand\bookTitle{$(TITLE)}' | tr '_' ' ' >> $@
 
+output += images/extracted/
+
 $(DROSS):
 	mkdir $(DROSS)
 
-check:
+output += $(DROSS)
+
+.PHONY: check
+check: ## Check you have the project dependencies
 	@command -v git >/dev/null || ( echo install git && exit 1 )
 	@command -v git-lfs >/dev/null || ( echo install git-lfs && exit 1 )
 	@command -v lualatex >/dev/null || ( echo install lualatex && exit 1 )
 	@command -v latexmk >/dev/null || ( echo install latexmk && exit 1 )
 	@command -v inkscape >/dev/null || ( echo install inkscape && exit 1 )
 
-help:
-	@echo 'BIND version $(VERSION)'
-	@echo ''
-	@echo 'Check you have the requirements with'
-	@echo '$$ make check'
-	@echo ''
-	@echo 'Compile with'
-	@echo '$$ make'
-	@echo ''
-	@echo 'Required tlmgr packages are in'
-	@echo 'config/Docker/tlmgrDeps.sh'
-	@echo ''
-
-graph:
+help: ## Print the help message
+	@awk 'BEGIN {FS = ":.*?## "} /^[0-9a-zA-Z._-]+:.*?## / {printf "\033[36m%s\033[0m : %s\n", $$1, $$2}' $(MAKEFILE_LIST) | \
+		sort | \
+		column -s ':' -t
+
+graph: ## Show a dependency graph (needs graph-easy and make2graph)
 	make -Bind $(TARG) | make2graph | graph-easy --boxart
 
 print_%.pdf: %.pdf
 	pdfjam --landscape --paper a3paper --nup 1x1 --signature 12 $< -o $@
+
+output += $(targets)
+
+.PHONY: all
+all: ## All standard targets
+	make $(targets)
+
+.PHONY: clean
+clean: ## Clean repo, including cross-reference files
+	$(RM) -r $(output)