为“cabal安装”启用--hyperlink-source

Question

命令cabal haddock非常有用--hyperlink-source选项。 我希望在使用cabal install构建文档时将源超链接。

门票＃517似乎就是这样：http://hackage.haskell.org/trac/hackage/ticket/517

但是，也许可以通过〜/ .cabal / config文件设置这个标志？

如果没有，我如何在没有安装Cabal-1.9的情况下使用＃517的补丁进行cabal-install构建，这是目前强制要求的（由于12月份的一个补丁）？

Answer 1

目前，在使用“all in one”--hyperlink-source命令时，您无法获得等效的cabal install选项。你引用的门票就是这个问题。

Answer 2

对我来说这很有效：

cabal update
cabal install haddock

修改配置文件~/.cabal/config

启用Documentation: True（在行的开头删除“ - ”就可以了）

---

Cabal Library：

cd ...someNicePlace...    

cabal unpack Cabal

修改文件Distribution/Simple/Setup.hs，其中找到defaultHaddockFlags = ...

我将其中一些从False切换为True：

... 
haddockHoogle       = Flag True,
...
haddockHtml         = Flag True,
...
haddockExecutables  = Flag True,
...
haddockHscolour     = Flag True,
...

拥有 haddockHscolour 唯一重要的一个（如果不想，则不必更改其他人）。

安装更新的Cabal Library：

sudo cabal install --global

---

cabal-install（cabal shell命令）

为了让更新的Cabal Libary在cabal shell命令中工作，我还重新安装了cabal-install：

cd ...someNicePlace...    

cabal unpack cabal-install

sudo cabal install --global

---

从那以后，shell命令cabal --version对我说：

cabal-install version 1.16.0.2 
using version 1.16.0.3 of the Cabal library 

并且，根据需要，任何新的cabal安装现在都安装完整的haddock html文档，其源代码默认为超链接。

Answer 3

Ticket＃517是关于通过cabal传递haddock选项，就像你有特殊需求，比如构建一个hoogle数据库或者是一个不同的CSS

大多数用户会对标准的黑线鳕和超链接源感到满意，但Cabal-1.8可以实现这一点。如果您有更大的需求，可以使用＃517号票。

只需拨打cabal haddock --hyperlink-source即可。

如果您希望将其作为默认设置，则可以按照提及的方式修改~/.cabal/config。