• Iustin Pop's avatar
    Expand Haddock to run over test files as well · 7ddd8e4c
    Iustin Pop authored
    This patch does multiple enhancements to the way we build the Haddock
    docs, motivated by the fact that if we don't run Haddock over test
    files as well, bad formatting can be submitted and will accumulate
    over time (without any checks).
    The patch does:
    - replace manual built ALL_APIDOC_HS_DIRS with automatically built one
      (from HS_DIRS)
    - change Haddock so that it runs from the top directory (instead of
      from src/)
    - change HsColour target file to be built via bash parameter
      substitution, rather than sed (I don't know how to do it in one go,
      so I use 2 intermediate variables)
    - change 'hs-apidoc' target so that it depends on the real target
      file; in case no source file has been modified, running 'make
      hs-apidoc' twice will not result in two runs
    - run HsColour/Haddock under en_US.UTF-8 locale, otherwise they can't
      parse correctly the Unicode chars in the test files
    Additionally, wrong formatting (oops) in a test file has been
    Signed-off-by: default avatarIustin Pop <iustin@google.com>
    Reviewed-by: default avatarMichele Tartara <mtartara@google.com>
Makefile.am 56.7 KB