如何将更改日志添加到Cabal包中？

Question

我看到Hackage 2有一个changelog字段.这是我长期以来想要的功能.但是,多次谷歌搜索未能找到关于如何填充此字段的单一文档.有谁知道怎么做？

Answer 1

我无法立即找到文档,但代码:

它没有字段,但它只是在tarball中查找一个名为的文件changelog,change_log或者changes(文件的结尾.txt,.md并且.markdown是允许的).案件没关系.

请注意,cabal sdist除非您以某种方式将其添加到cabal文件中,否则此文件不一定会添加到tarball中.一种方法是将其添加到Extra-source-files:cabal文件顶层的字段中.例如:

Extra-Source-Files:  changelog.md

Cabal的.cabal文件就是这样做的,并提供了一个很好的例子.