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.
This removes a warning about ---- being interpreted as a rule and not expected text just after it.