如何合并SBT多项目的文档？

Question

我正在为一些SBT项目生成ScalaDoc HTML文件(在多项目配置中).如果我在SBT控制台中执行doc,则可以很好地生成文档,但它会部署在每个项目的独立目录中.由于所有项目彼此非常相关(就包名而言),我想生成一个唯一的ScalaDoc目录作为输出.值得一提的是,由于某些涉及的宏所需的双重编译过程,我无法将所有源集中在一起.有没有办法解决这个问题？

Answer 1

不幸的是，scaladoc 不支持单独编译，因为它无法合并生成的文档。必须立即为所有来源生成文档。宏问题的解决方案是在 scaladoc 生成期间使用-Ymacro-no-expand不扩展宏。另请参阅https://issues.scala-lang.org/browse/SI-6812