黑线鳕 - 未生成数据记录字段名称
Haddock - Data record fields names not being generated
我无法让 haddock 显示我的数据记录的字段名称。我的一些数据类型有许多不同的数值,因此记录名称是关键。
示例数据记录:
-- | API response container for daily price history
data PriceHistoryResponse = PriceHistoryResponse {
responseData :: [PriceHistoryResponseData], -- ^ the actual response, list of price entries
timeTo :: Maybe Integer, -- ^ latest price returned
timeFrom :: Maybe Integer -- ^ earliest price returned
} deriving (Show, Generic)
正在导出有问题的数据类型,如下所示:
-- more module exports above ..
, PriceHistoryResponse(..)
, PriceHistoryResponseData(..)
-- more below ...
对于这个定义(以及所有其他类似的定义),生成的唯一文档是构造函数的类型签名。但是,不会生成对所涉及值的解释。
一个可能相关的细节是我在此文件中启用了 DuplicateRecordFields
。
$ stack exec -- haddock --version
Haddock version 2.17.3
我是犯了一个明显的错误,还是遗漏了什么?很高兴提供任何其他有用的信息。
确实是DuplicateRecordFields
的问题。当我消除歧义并删除扩展名时,这些字段生成得很好。
我无法让 haddock 显示我的数据记录的字段名称。我的一些数据类型有许多不同的数值,因此记录名称是关键。
示例数据记录:
-- | API response container for daily price history
data PriceHistoryResponse = PriceHistoryResponse {
responseData :: [PriceHistoryResponseData], -- ^ the actual response, list of price entries
timeTo :: Maybe Integer, -- ^ latest price returned
timeFrom :: Maybe Integer -- ^ earliest price returned
} deriving (Show, Generic)
正在导出有问题的数据类型,如下所示:
-- more module exports above ..
, PriceHistoryResponse(..)
, PriceHistoryResponseData(..)
-- more below ...
对于这个定义(以及所有其他类似的定义),生成的唯一文档是构造函数的类型签名。但是,不会生成对所涉及值的解释。
一个可能相关的细节是我在此文件中启用了 DuplicateRecordFields
。
$ stack exec -- haddock --version
Haddock version 2.17.3
我是犯了一个明显的错误,还是遗漏了什么?很高兴提供任何其他有用的信息。
确实是DuplicateRecordFields
的问题。当我消除歧义并删除扩展名时,这些字段生成得很好。