Haskell:在Haddock中注释元组
我有一个带有长元组的Haskell函数签名,我正试图为Haddock注释它:Haskell:在Haddock中注释元组,haskell,tuples,haddock,Haskell,Tuples,Haddock,我有一个带有长元组的Haskell函数签名,我正试图为Haddock注释它: gssAcceptSecContext :: Maybe GssCtxId -- ^ context_handle -> Maybe GssCredId -- ^ acceptor_cred_handle -> GssToken -- ^ input_token_buffer -> Maybe Gss
gssAcceptSecContext ::
Maybe GssCtxId -- ^ context_handle
-> Maybe GssCredId -- ^ acceptor_cred_handle
-> GssToken -- ^ input_token_buffer
-> Maybe GssChannelBindings -- ^ input_chan_bindings
-> IO (Either GssError -- failure: error message
-- success: return values
(GssCtxId, -- context_handle
Maybe GssToken, -- output_token
Bool, -- continue? (GSS_S_CONTINUE_NEEDED is set)
GssName, -- src_name
GssOid, -- mech_type
[GssService], -- ret_flags
Int, -- time_rec
Maybe GssCredId)) -- delegated_cred_handle
如果我将元组成员上的注释转换为Haddock标记(--^
,与前面的参数类型一样),Haddock将带着解析错误退出。我发现一些评论表明,这只是一个限制,没有什么可做的;是这样吗?这很糟糕;文档和摘要栏都在屏幕边缘,无法阅读。我真的不想为了满足Haddock的需要而引入一个单独的类型来代替元组
谢谢
(更新:有一个开放的Haddock,它似乎证实了当前不支持此功能;我在那里添加了我的+1-但我对是否有人有补丁或解决方法感兴趣。)作为解决方法,使用记录类型而不是元组,并记录记录字段。谢谢,我知道这个选项。我在我的问题中确实说过,“我真的不想为了满足Haddock而引入一个单独的类型来代替元组。”