有没有办法让 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)。
事实证明,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)。