From 71beb275034cdd65f5220c403c35b299003aa701 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Tue, 8 Jul 2014 11:52:06 -0700
Subject: [PATCH] tools: build haddocks by package, using cabal

---
 Makefile | 106 +++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 71 insertions(+), 35 deletions(-)

diff --git a/Makefile b/Makefile
index 1dbc9a77f..8abe5a83c 100644
--- a/Makefile
+++ b/Makefile
@@ -55,17 +55,21 @@ SOURCEFILES:= \
 	hledger-web/Hledger/*.hs \
 	hledger-web/Settings/*.hs
 
-# a more careful list suitable for for haddock
-HADDOCKSOURCEFILES:= \
-	hledger-lib/Hledger.hs \
-	hledger-lib/Hledger/*hs \
-	hledger-lib/Hledger/*/*hs \
-	hledger/Hledger/*hs \
-	hledger/Hledger/*/*hs \
-	# hledger-web/Hledger/*hs \
-	# hledger-web/Hledger/*/*hs \
-	# hledger-web/app/*.hs \
-	# hledger-web/Settings/*.hs
+# # a more careful list suitable for for haddock-all
+# HADDOCKSOURCEFILES:= \
+# 	hledger-lib/Hledger.hs \
+# 	hledger-lib/Hledger/*hs \
+# 	hledger-lib/Hledger/*/*hs \
+# 	hledger/Hledger/*hs \
+# 	hledger/Hledger/*/*hs \
+# 	hledger-web/Application.hs \
+# 	hledger-web/Foundation.hs \
+# 	hledger-web/Hledger/*hs \
+# 	hledger-web/Hledger/*/*hs \
+# 	hledger-web/Import.hs \
+# 	hledger-web/Settings.hs \
+# 	hledger-web/Settings/*hs \
+# 	hledger-web/app/*hs \
 
 CABALFILES:= \
 	hledger/hledger.cabal \
@@ -660,31 +664,63 @@ savehelp:
 # generate api & other code docs
 codedocs: haddock hscolour coverage #sourcegraph #hoogle
 
-#http://www.haskell.org/haddock/doc/html/invoking.html
+# cf http://www.haskell.org/haddock/doc/html/invoking.html
+# --ghc-options=-optP-P is a workaround for http://trac.haskell.org/haddock/ticket/284
+HADDOCKFLAGS= \
+	--haddock-options='--no-warnings' \
+	--ghc-options='-optP-P' \
+
+# build per-package haddocks using cabal
+haddock: haddock-lib haddock-cli haddock-web
+
+haddock-lib:
+	(cd hledger-lib; cabal haddock $(HADDOCKFLAGS))
+
+haddock-cli:
+	(cd hledger; cabal haddock $(HADDOCKFLAGS))
+
+haddock-web:
+	(cd hledger-web; cabal haddock $(HADDOCKFLAGS))
+
+# view-haddock-cli
+view-haddock-cli:
+	$(VIEWHTML) hledger/dist/doc/html/hledger/index.html
+
+# view-haddock-lib, view-haddock-web
+view-haddock-%:
+	$(VIEWHTML) hledger-$*/dist/doc/html/hledger-$*/index.html
+
+# HADDOCKALLFLAGS= \
+#		--no-warnings \
+# 	--prologue .haddockallprologue \
+# 	--optghc='-optP-include' \
+# 	--optghc='-optPhledger/dist/build/autogen/cabal_macros.h'
+# #	 --optghc='-XCPP'
+# #	--optghc="$(WEBLANGEXTS)"
+# #	--optghc='-hide-package monads-tf' 
 #$(subst -D,--optghc=-D,$(DEFINEFLAGS))
-HADDOCKFLAGS= --no-warnings --prologue .haddockprologue \
-	--optghc='-optP-include' --optghc='-optPhledger/dist/build/autogen/cabal_macros.h'
-	#--optghc='-hide-package monads-tf' 
-
-.haddocksynopsis: hledger/hledger.cabal
-	grep synopsis $< | sed -e 's/synopsis: *//' >$@
-
-.haddockprologue: hledger/hledger.cabal
-	cat $< | perl -ne 'print if (/^description:/../^$$/)' | sed -e 's/^description: *//' >$@
-	printf "\nThis haddock covers all hledger-* packages, for individual package haddocks see hackage.\n" >>$@
-
-# generate api docs for the whole project
-haddock: .haddockprologue
-	$(HADDOCK) $(HADDOCKFLAGS) --title "hledger-* API docs" \
-	 -o site/api \
-	 --html \
-	 --source-module=src/%{MODULE/./-}.html \
-	 --source-entity=src/%{MODULE/./-}.html#%N \
-	 $(HADDOCKSOURCEFILES)
-
-# browse the api docs
-viewhaddock:
-	$(VIEWHTML) site/api/frames.html
+#
+# # .haddockallsynopsis: hledger/hledger.cabal
+# # 	grep synopsis $< | sed -e 's/synopsis: *//' >$@
+#
+# .haddockallprologue: hledger/hledger.cabal
+# 	cat $< | perl -ne 'print if (/^description:/../^$$/)' | sed -e 's/^description: *//' >$@
+# 	printf "\nThis haddock covers all hledger-* packages, for individual package haddocks see hackage.\n" >>$@
+#
+# # build haddock docs for the whole project
+# haddock-all: .haddockallprologue
+# 	$(HADDOCK) \
+# 		$(HADDOCKALLFLAGS) \
+# 		--title "hledger-* API docs" \
+# 		-o site/api \
+# 		--html \
+# 		--source-module=src/%{MODULE/./-}.html \
+# 		--source-entity=src/%{MODULE/./-}.html#%N \
+# 		$(HADDOCKSOURCEFILES)
+#
+# # browse the whole-project haddock
+# view-haddock-all:
+# 	$(VIEWHTML) site/api/frames.html
 
 # http://www.cs.york.ac.uk/fp/darcs/hscolour/
 HSCOLOUR=HsColour -css