Enable scaladoc and "classical" comments

It turns out that `/**` comments fail with the `-Xlint` option, so I just removed it for the `doc` task.
Also there is a weird literal inference with Scaladoc and the `Date` macro. My fix doesn't seem to affect the production code, just the Scaladoc production.
That's my expectation too. I tested that the `-Xlint` options are still there when running normal `compile` and they are.