Hi Sam, Yes, interesting catch - we do not publish scaladocs as a jar. I guess we did not bump into this previously since many Scala devs (including us) use IDEs which understand Java => understand JavaDoc (or they use source jars, I think IntelliJ does).
I don't know the initial reasoning about rolling out genjavadoc and `-javadoc` being "real javadoc", however it makes sense in the big picture of things. Maybe what we could consider is publishing the pure ScalaDoc as `-scaladoc`. Would you mind opening a ticket about this so we can don't forget about this and discuss it during a planning session? I quickly looked at what Play is doing, since they also have java / scala apis and docs. Interesting fact is that play also publishes `playdoc` as artifacts, I wasn't aware of this (but also kind of unrelated to your question). -- Cheers, Konrad 'ktoso’ Malawski Akka @ Typesafe On 11 July 2015 at 22:50:02, Sam Halliday (sam.halli...@gmail.com) wrote: Hi all, I often find myself wanting to read the scaladocs for Akka using the built-in ENSIME documentation browser (e.g. "show me docs of the symbol at point"). But the doc artefact that comes with Akka, via the standard sbt `updateClassifiers` call, seems to be the Javadocs, not the Scaladocs. For developing in Scala, these are not as good so it gets quite awkward. Are you publishing the scaladocs to maven central? If so, is there some special classifier we need to be asking for? Admittedly, we are asking for the javadoc classifier, but it is very standard to use this for scaladocs https://github.com/ensime/ensime-sbt/blob/master/src/main/scala/EnsimePlugin.scala#L179 I should imagine that adding another classifier lookup to the sbt generator would slow things down for people significantly. It's already depressingly slow. Best regards, Sam -- >>>>>>>>>> Read the docs: http://akka.io/docs/ >>>>>>>>>> Check the FAQ: >>>>>>>>>> http://doc.akka.io/docs/akka/current/additional/faq.html >>>>>>>>>> Search the archives: https://groups.google.com/group/akka-user --- You received this message because you are subscribed to the Google Groups "Akka User List" group. To unsubscribe from this group and stop receiving emails from it, send an email to akka-user+unsubscr...@googlegroups.com. To post to this group, send email to akka-user@googlegroups.com. Visit this group at http://groups.google.com/group/akka-user. For more options, visit https://groups.google.com/d/optout. -- >>>>>>>>>> Read the docs: http://akka.io/docs/ >>>>>>>>>> Check the FAQ: >>>>>>>>>> http://doc.akka.io/docs/akka/current/additional/faq.html >>>>>>>>>> Search the archives: https://groups.google.com/group/akka-user --- You received this message because you are subscribed to the Google Groups "Akka User List" group. To unsubscribe from this group and stop receiving emails from it, send an email to akka-user+unsubscr...@googlegroups.com. To post to this group, send email to akka-user@googlegroups.com. Visit this group at http://groups.google.com/group/akka-user. For more options, visit https://groups.google.com/d/optout.
