scala - sbt 忽略我的 scaladoc 设置

Question

我正在尝试关注 sbt documentation用于 scaladoc 生成。我有一个多项目(即与子项目聚合)构建，它是 ./build.sbt用于一般设置。我在以下示例中添加了最后一个条目:

scalacOptions in ThisBuild ++= Seq("-deprecation", "-unchecked", "-feature")

scalacOptions in ThisBuild += "-no-specialization"

// API docs
scalacOptions in ThisBuild in (Compile,doc) ++= Seq(
  "-diagrams", "-doc-title", name.value
)

这没有任何影响。 scaladoc 也不会尝试生成图表，也不会设置主文档标题，因此这些设置将被忽略。同样，如果我添加一个 "-foobar"选项，不会出现错误。

如何解决这个问题(在 build.sbt 中，我不想进入 project/Build.scala ，谢谢)

Answer 1

正如乔希所说，不知何故 ThisBuild/ThisProject东西会互相覆盖。

解决方案是迁移 project/Build.sbt从 sbt 的 0.12 倍变成 build.sbt ，幸运的是主要是复制+粘贴，因为 sbt 0.13 现在在那里接受很多普通的 Scala 代码(不是 object s，虽然......)。

然后我定义

lazy val commonSettings = Project.defaultSettings ++ Seq(
  ...
  scalacOptions  ++= Seq(
    "-no-specialization",
    // "-Xelide-below", "INFO", // elide debug logging!
    "-deprecation", "-unchecked", "-feature"
  ),
  // API docs:
  scalacOptions in (Compile, doc) ++= Seq(
    "-diagrams",
    "-diagrams-dot-path", "/usr/local/bin/dot",
    // "-diagrams-dot-timeout", "20", "-diagrams-debug",
    "-doc-title", name.value
  ),
  ...
)

它有效。

最后一个恼人的一点是对 "-diagrams-dot-path" 的要求，这真的很糟糕，因为它是一个开源项目，我不想把这条路强加给其他人。为什么找不到 dot在我的 $PATH其中包括 /user/local/bin ?