cabal-install配置文件的文档

Question

~/.cabal/config存储cabal-install使用的配置。我想在它上面做一些黑客的工作。(具体地说，如果安装了多个GHC版本，我希望有单独的文档索引)。

然而，我找不到任何关于它的语法或变量的文档，除了默认文件中包含的内容。有没有可用的文档？

编辑:我已经陈述了上面的目标，但让我添加一些细节:如果相同的包(例如。GTK)安装在两个版本的GHC中，它们最终保存在相同的文档索引文件中。我不希望为每个GHC安装单独创建本地文档索引。我相信在某种程度上使用文档目录设置是可能的，但必须有一个变量用于当前使用的GHC版本。如果没有，可能有一些可用的解决方案，但除非我看到文档，否则我无法说出这一点。

Answer 1

这似乎是有效的，尽管我只用GHC的一个版本进行了测试：

documentation: True
doc-index-file: $datadir/doc/$compiler/index.html

install-dirs user
    docdir: $datadir/doc/$compiler/$pkgid

将其他选项保留为默认值，这将生成.cabal/share/doc/<ghc-version>/<package-name>格式的文档和.cabal/share/doc/<ghc-version>/index.html格式的索引。

Answer 2

网上似乎很少-甚至连用于阴谋安装代码的黑线鳕鱼都没有。所以你最好的办法可能就是从源头上找出答案。cabal unpack cabal-install，或在线查看cabal-install repo。查看分发/客户端/配置.hs中的SavedConfig。例如，它从Setup.hs导入GlobalFlags；在下面的globalCommand函数中，各个标志(例如globalCacheDir )与它们的配置文件语法(这也是命令行语法)相关联，在本例中为remote-repo-cache。

你也应该在irc.freenode.net上的#haskell频道上询问dcoutts，以防他有新的文档可用。