1

我迷路了。我不明白如何使用 cabal 在本地生成文档。我想要的是 cabal install gtk3 ,它也会生成文档。或者如果这不起作用我如何在本地生成文档?

我已经把它从 cabal 放到了我的 .config 文件中: -- 文档:True

但是做的不好,找不到文档

我想这很简单,我根本看不到....

好的,在一些评论的帮助下,我走得更远了。无论如何,cabal 只是为我作为用户进行本地安装,它给了我一个警告,不推荐使用 global。在这里我找到了https://wiki.haskell.org/Cabal-Install

我应该为全局安装等做些什么,但如果我不使用它,我会收到有关不应使用全局的警告,即使使用文档集做文档:True 我没有得到 haskell 的更新平台文档。

所以我不应该使用 cabal 来全局安装文件?

4

2 回答 2

5

我相信您正在寻找cabal haddock或者如果您正在使用新命令,cabal new-haddock. 观察:

% cabal unpack gps
Unpacking to gps-1.2/
% cd gps-1.2
% cabal --help | grep document
  upload           Uploads source packages or documentation to Hackage.
  haddock          Generate Haddock HTML documentation.
  new-haddock      Build Haddock documentation
% cabal haddock
Resolving dependencies...
Configuring gps-1.2...
Preprocessing library for gps-1.2..
Running Haddock on library for gps-1.2..
... snip ...
Documentation created: dist/doc/html/gps/index.html
cabal haddock  3.42s user 1.00s system 92% cpu 4.784 total
于 2018-04-03T16:58:01.977 回答
0

好吧,我花了一些时间,这里的一些帖子为我指明了正确的方向。

一开始,是我的错。我确实在文档下将 False 替换为 True ,但没​​有取消注释该行,因此默认发生的不是生成文档(不能将其视为一个好的默认值 - YMMV)

然后 cabal 在本地正常工作,有一个标志 --global 可以更改它,或者您可以在 ~/.cabal/config 中更改 int

现在文档发生的情况如下。该文档在主目录中生成,但所有文档都链接到新生成的 index.html 文件中。因此,您可以从全局安装和本地安装中获取文档。

现在我仍然没有得到一些东西。我不知道为什么不应该在全球范围内使用 cabal 将所有填充物安装到全球位置。

是的,我偶然发现了堆栈、沙箱和 new-xxxx(命令),但我仍然不知道如何利用它们......但我猜这是另一个问题。

于 2018-04-06T02:00:54.650 回答