有没有办法让 Haddock 为类型 class 方法呈现每个参数的文档?

Is there a way to make Haddock render per-argument docs for type class methods?

事实证明,Haddock 不会为类型 class 呈现每个参数的文档 方法:

class Foo a where

  foo
    :: Int -- ^ This string will be ignored by Haddock
    -> a

这会对我维护的库的用户造成某些问题,因为 在我的例子中,这些方法有相当长的签名。我一直有描述 像这样格式化的源代码(当然适用于普通函数),但是 结果黑线鳕不显示它们(并且不抱怨它们 要么)。

有没有办法用 Haddock 显示每个参数的文档?也许有一些解决方法?

好的,这是一个倒退。这个东西应该可以工作(并且在版本 2.16.1 中工作),但是停止了(2.17.1 和更高版本)。

我已经报告了这个:https://github.com/haskell/haddock/issues/647,应该在 2.18 版中修复(你可以看到已经有一个 PR)。