stack.yaml的build:haddock-arguments选项的用法

Question

如何将选项从stack.yaml传递给stack haddock？无论是在文档中还是在堆栈源代码中，我都找不到任何纠正语法的线索。

文档描述了以下内容：

build: haddock-arguments: ""

Naive haddock-arguments: "--odir=./docs"失败，类型错误：

…failed to parse field 'haddock-arguments': expected HaddockOptsMonoid, encountered String

我想它应该是这样的：

build: haddock-arguments: odir: "./docs"

但是，它会失败，并显示错误Unrecognized field in HaddockOptsMonoid: odir。

通过stack.yaml将参数从haddock手册传递到堆栈的正确语法是什么？在我特定情况下，我希望指定自定义输出目录。

Answer 1

在查看源代码后，我发现其语法是

build:
  haddock-arguments:
    haddock-args:
    - "--odir=./docs"

在示例项目中，这将产生以下结果(请注意.stack-work中docs目录的位置)：

$ ls .stack-work/install/x86_64-linux/lts-6.3/7.10.3/doc/docs/ | cat
doc-index.html
frames.html
haddock-util.js
hslogo-16.png
index-frames.html
index.html
minus.gif
ocean.css
plus.gif
synopsis.png

index.html中的链接断开了，所以我有点悲观地认为，您可以通过这种方式向haddock传递参数来实现您想要的结果。