From a20efa02eef21b70c2cc3183217b55ce470b2826 Mon Sep 17 00:00:00 2001 From: Simon Hengel Date: Thu, 18 Oct 2012 08:48:02 +0200 Subject: Use markdown for html-test/README --- html-test/README | 24 ------------------------ html-test/README.markdown | 27 +++++++++++++++++++++++++++ 2 files changed, 27 insertions(+), 24 deletions(-) delete mode 100644 html-test/README create mode 100644 html-test/README.markdown diff --git a/html-test/README b/html-test/README deleted file mode 100644 index 082104b0..00000000 --- a/html-test/README +++ /dev/null @@ -1,24 +0,0 @@ -This is a testsuite for Haddock that uses the concept of "golden files". That -is, it compares output files against a set of reference files. - -To add a new test: - - 1) Create a module in the "html-test/src" directory. - - 2) Run "cabal test". You should now have "html-test/out/.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 accept.lhs - -Tips and tricks: - -To "accept" all output files (copy them to reference files), run - runhaskell accept.lhs - -You can run all tests despite failing tests, like so - cabal test --test-option=all - -You can pass extra options to haddock like so - cabal test --test-options='all --title="All Tests"' - diff --git a/html-test/README.markdown b/html-test/README.markdown new file mode 100644 index 00000000..8d57acab --- /dev/null +++ b/html-test/README.markdown @@ -0,0 +1,27 @@ +This is a testsuite for Haddock that uses the concept of "golden files". That +is, it compares output files against a set of reference files. + +To add a new test: + + 1. Create a module in the `html-test/src` directory. + + 2. Run `cabal test`. You should now have `html-test/out/.html`. + The test passes since there is no reference file to compare with. + + 3. To make a reference file from the output file, run + + html-test/accept.lhs + +Tips and tricks: + +To "accept" all output files (copy them to reference files), run + + runhaskell accept.lhs + +You can run all tests despite failing tests, like so + + cabal test --test-option=all + +You can pass extra options to haddock like so + + cabal test --test-options='all --title="All Tests"' -- cgit v1.2.3