Tracked as ticket: https://github.com/akka/akka/issues/17970
On Sat, Jul 11, 2015 at 11:51 PM, Konrad Malawski < konrad.malaw...@typesafe.com> wrote: > 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 <http://akka.io> @ Typesafe <http://typesafe.com> > > 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. > -- Akka Team Typesafe - Reactive apps on the JVM Blog: letitcrash.com Twitter: @akkateam -- >>>>>>>>>> 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.
