事实证明,Haddock不为类型类呈现每个参数的文档 方法:
class Foo a where
foo
:: Int -- ^ This string will be ignored by Haddock
-> a
这会导致我维护的库的用户遇到某些问题,因为 在我的情况下,方法有很长的签名。我一直都有描述 格式化的源(当然适用于普通函数),但是 原来Haddock没有显示它们(并没有抱怨它们 任一)。
有没有办法用Haddock显示每个参数的文档?也许有些解决方法?
答案 0 :(得分:3)
好的,这是一个回归。这个东西应该工作(并在2.16.1版本中工作),但是停止了(2.17.1和更高版本)。
我已经报告了这个:https://github.com/haskell/haddock/issues/647,应该在版本2.18中修复(你可以看到已经存在PR)。