haskell - Haddock 文档中使用 unicode 字符

Question

Haddock 似乎错误地对 UTF-8 编码源文件中的文档中的非 ASCII 字符进行了重新编码。我经常需要在文档中包含数学公式，如果可以使用一些常见的数学符号(例如求和 (Σ))，它们的可读性会更高。

但是，通过 haddock 运行文件后，这些符号变成空白方 block 。Haddock 有选项 --use-unicode 但它只是将函数签名等中的函数箭头转换为 unicode 字符，同时仍然破坏实际文档。

如果可以通过 cabal haddock 进行控制那就更好了!

我使用的是 Haddock 版本 2.9.4。

Answer 1

请注意，Haddock 使用 GHC API 进行解析。 GHC < 7.4 无法正确处理注释中的非 ASCII 字符，但在 GHC 7.4 中似乎可以正常工作。