rest-* documentation builder

README

The script utilizes `cabal sandbox` to keep the guts from spilling into system packages.

The documentation builder is `standalone-haddock`[1] so you have to install it and put on your PATH first. A `hscolour` have to be installed to provide source links.

[1]: https://hackage.haskell.org/package/standalone-haddock
[2]: https://hackage.haskell.org/package/hscolour

standalone-haddock.sh

#!/usr/bin/env bash

OUTPUT="docs-sh"
PACKAGES="rest-client rest-core rest-gen rest-happstack rest-snap rest-wai rest-types rest-stringmap code-builder"

PACKAGES_SANDBOX=".cabal-sandbox/*-packages.conf.d"
PACKAGE_DB=`readlink -f $PACKAGES_SANDBOX`

ARGS="${@:2}"
PACKAGE_ARGS="${ARGS:-$PACKAGES}"

function help {
    echo "$0 <init|build|clean>"
    exit
}

function init {
    cabal sandbox init
    CONFIG=`readlink -f cabal.sandbox.config`
    for package in $PACKAGE_ARGS; do
        echo $package
        cd $package
        CABAL_SANDBOX_CONFIG=$CONFIG cabal install -j
        CABAL_SANDBOX_CONFIG=$CONFIG cabal configure
        cd ..
    done
}

function build {
    standalone-haddock -o $OUTPUT --package-db $PACKAGE_DB --hyperlink-source $PACKAGE_ARGS
}

function clean {
    cabal sandbox delete
}

case "x$1" in
"x") help ;;
"xinit") init ;;
"xbuild") build ;;
"xclean") clean ;;
esac