Scaladoc源路径和源文件

Question

这个问题是针对Scala 2.12的Scaladoc。

scaladoc -help会排出很多行，包括这两行：

Usage: scaladoc <options> <source files>

-sourcepath <path>                   Specify location(s) of source files.

但是，没有提到源文件路径。我假设他们需要相对于-sourcepath值，如果指定，但我没有看到-sourcepath有任何影响。例如，以下每个调用都会产生相同的结果：

scaladoc root/src/test/scala/EtherTest.scala
scaladoc -sourcepath root root/src/test/scala/EtherTest.scala
scaladoc -sourcepath $PWD/root root/src/test/scala/EtherTest.scala

这似乎不对。我原以为sourcepath会充当Scala文件路径的前缀，如下所示：

scaladoc -sourcepath root src/test/scala/EtherTest.scala

不幸的是，以上产量：

error: source file 'src/test/scala/EtherTest.scala' could not be found

我错过了什么？

Answer 1

只需尝试进入src根路径src/test/scala，scaladoc就会找到源代码的正确路径。

完整命令

cd src/test/scala && scaladoc EtherTest.scala