Fix #43: Add @javadoc directive

[jonas]

No description provided.

[jroper]

I find linking directly to the javadoc class HTML to give a terrible user experience, because then they don't have the navigation from the frames that is very often needed.

In Lagom and Play, we always link to index.html?com/example/SomeClass.html, this links to the frames version. The one problem with this approach is linking to specific methods doesn't work out of the box, to fix this you need to generate javadocs with a little javascript snippet to scroll to the right place on the frame, we do it like this in Lagom:

https://github.com/lagom/lagom/blob/master/project/Doc.scala#L60

[dwijnand]

FYI note that the frames are gone, at least in the official Scala API docs: http://www.scala-lang.org/api/current/scala/Int.html

[jroper]

Yep but this is for javadocs, not scaladocs.

[jonas]

OK, I will update the PR and rebase to add support for referenced source definitions.

[jonas]

The main goal here is to avoid links that will automatically redirect, yet allow to spell them out with .../index.html if so desired.

[jonas]

I believe I've addressed all comments.

• javadoc links uses ? to show frames
• Fix scaladoc links to work with Scala 2.12