aboutsummaryrefslogtreecommitdiff
path: root/tests/README
blob: 5c5bef6023fd3967df2a49ab9be6851cb802feea (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
A testsuite for Haddock that uses the concept of "golden files" (compares
output files against a set of reference files).

To add a new test: 

 1) Create a module in the "tests" directory.

 2) Run runtests.hs. You should now have output/<modulename>.html. The test
    passes since there is no reference file to compare with.

 3) To make a reference file from the output file, do
      runhaskell copy.hs <modulename>

Tips and tricks:

You can
  runhaskell copy.hs

to copy all output files into reference files.

You can
  runhaskell runtests.hs all

to continue despite a failing test.

You can pass extra options to haddock like so
  runhaskell runtests.hs --xhtml all