From 7c0295994460cb779e8c72ec653bc76cbdb48605 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Sun, 19 Jul 2015 09:34:23 -0700
Subject: [PATCH] doc: devguide: how to run tests

---
 doc/developer-guide.md | 33 ++++++++++++++++++++++++++++++---
 1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/doc/developer-guide.md b/doc/developer-guide.md
index 47650aa77..0a8700e1e 100644
--- a/doc/developer-guide.md
+++ b/doc/developer-guide.md
@@ -255,9 +255,36 @@ If you're new to this process, [help.github.com](http://help.github.com) may be
 
 ### Run the tests
 
-- set up for hledger development
-- cabal install shelltestrunner
-- make test
+This command will install haskell dependencies (you might need to
+install additional system dependencies yourself) and run the package
+test suites.  Currently these consist of hledger-lib's unit tests,
+hledger's unit tests, and hledger-web's functional tests:
+
+```shell
+$ stack test [PKG]
+```
+
+Run the hledger-lib and hledger unit tests as a built-in hledger command:
+```shell
+$ [stack exec] hledger test
+```
+
+Run the hledger functional tests:
+```{.shell .bold}
+$ stack install shelltestrunner  # if not already done
+$ make functest
+```
+
+Run both unit and functional tests:
+```{.shell .bold}
+$ make test
+```
+
+Test haddock doc generation:
+```shell
+$ make haddocktest
+```
+
 
 ### Add a test