如何让scaladoc显示默认参数值？

Question

我有很多方法，比如

def foo(..., ..., runFinalizer: Boolean = true)
         (implicit finalizer: Finalizer): Result = ...

但是当我运行 scaladoc（使用 sbt）时，它没有记录 runFinalizer 具有默认值。这是相当有问题的，因为用户很少将参数设置为false，并且生成的文档没有显示可以省略。

到目前为止，我有两种解决方案，没有一种完全令人满意：

1. 记录runFinalizer 可以在其@param 块内省略的事实。它有帮助，但会导致在文档中的许多地方重复这样的句子，并且用户可能会忽略它。
2. 创建该方法的两个变体，一个带有runFinalizers（没有默认值），一个没有。但这会不必要地使方法数量增加一倍，并使代码和文档变得混乱。

Answer 1

这很可能是一个错误，仅在某些情况下发生：SI-4922 Omitted default argument values 。我升级到 Scala 2.10.1。它工作正常。