Simon Marlow wrote:
Brian Hulley wrote:
I've been looking at the docs for Haddock at
http://haskell.org/haddock/haddock-html-0.7/index.html but I can't
seem to find any option to recursively traverse a directory
generating hyperlinked docs for all modules anywhere in the
directory or any sub directory etc.
Is there a simple undocumented flag I'm missing?
Haddock doesn't do this on its own, but Cabal can do it (./setup
haddock). You do have to specify all the modules in the .cabal file
though, so it's not really "traversing a directory".
Thanks for this suggestion. I've also got things to work quite well by using
the following makefile on a Windows command shell (using a Win32 port of gnu
make and based on a helpful example makefile received offlist):
# Makefile for Haddock docs
GHCFLAGS = -fglasgow-exts -fffi
API_FILES := $(wildcard *.hs)
# preprocess for Haddock
%.haddock:%.hs
ghc $(GHCFLAGS) -cpp -E -optP-P -D__HADDOCK__ $^ -o docs/$@
# generate docs
docs: $(patsubst %.hs,%.haddock,$(API_FILES))
haddock -o docs -h $(addprefix docs/, $^)
This works as long as all the subdirectories containing modules are
explicitly listed in API_FILES, and the whole directory tree (including the
docs directory) is manually created (for Windows, since Windows doesn't
automatically create directories that don't exist when it tries to open a
file for writing when the filename contains a path) - not a big problem
since the directory tree only needs to be created once.
Regards, Brian.
_______________________________________________
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe
