New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
it'd sure be nice if Scaladoc processed doc comments in Java source files #4826
Comments
Imported From: https://issues.scala-lang.org/browse/SI-4826?orig=1 |
Pedro Furlanetto (pedrofurla) said: I wonder if t3415 would be easily fixable. Scala Reviewer, I'd like to give a shoot on this one. |
Markus Kahl (machisuji) said: |
@adriaanm said: |
Margaret Leber (MaggieL) said: |
Pedro Furlanetto (pedrofurla) said: Thoughts? [1] http://docs.oracle.com/javase/1.5.0/docs/guide/javadoc/doclet/overview.html |
@SethTisue said (edited on Nov 18, 2013 8:44:33 PM UTC): What I had in mind was to generate Scaladoc from Scaladoc comments in Java sources. I'm sure there are advantages both ways. But a huge advantage of the latter approach is that I would think it would be easier to do, since Scaladoc already understands Scaladoc format, but doesn't know the Javadoc format. Without going back and looking, I'm not sure which approach r22605 actually took. |
@adriaanm said: |
Scaladoc already processes Java sources and produces Scaladoc for them.
It just ignores the doc comments.
Many of our Scala codebases have at least some Java in them for various reasons.
It'd be SUPER AWESOME (well, "nice" at least) if Scaladoc could generate full documentation for these
mixed codebases, including all doc comments.
It appears this was added briefly by Donna in r22605, then reverted in r22619.
The text was updated successfully, but these errors were encountered: