Multiple -d in scaladoc

[BarkingBad]

Passing -d flag makes scaladoc throw warning about -d set multiple times. Probably comes from default values passed from sbt

[SethTisue]

It isn't clear to me this qualifies as a bug. sbt doesn't expect the user to pass -d directly; rather, it expects the user to customize Compile / doc / target.

(Also, wondering: is this any different than the Scala 2 behavior?)

[vincenzobaz]

Hi @SethTisue, @BarkingBad is helping me with a scaladoc tutorial and example setup and I complained about this warning. I used the -d flag instead of Compile / doc / target because it is shown in the documentation, here.

So probably this is a documentation bug rather than an implementation one :)

[BarkingBad]

Thanks Seth, you pointed me to the root of the problem I think. This is the line where is aggregated target value and scalacOptions value

The question is, if one wants to put the docs in the separate directory different than target/api and pass the -d option to the scalacOptions should we hide the warning for that option, or leave it as a reminder that one is overriding the target default one

[dwijnand]

The point is that if one wants that they should redefine Compile / doc / target, not pass the -d option. So I think there's no behavioural change to do here - but perhaps that doc page can make that clearer.

[BarkingBad]

Yeah, I will update the docs then