News for hackers. Stuff that matters.
Re:Everything that's wrong with Java in a single class by aut0mat0n1c on Thursday September 20, 2012 @02:31PM (#4549943)
Hello and welcome to 2008!

Seriously though, if you are going to rehash this tired schtick then at least make intelligent points about the problems with the language. I have been writing Java for over a decade and I can tell you are a number.

Re:Everything that's wrong with Java in a single class by hmottestad on Thursday September 20, 2012 @02:39PM (#4549992)
No need to create javadoc, takes people 4 years to read it anyway :D
Re:Everything that's wrong with Java in a single class by sukuriant on Thursday September 20, 2012 @04:31PM (#4550520)
Hey now. I find Javadocs to be among the easiest to read formats of all the different documentation styles. Right up there with Python's standard one (or whatever tool python's default library as well as numpy and scipy use), maybe even better.
Re:Everything that's wrong with Java in a single class by chimeracoder on Thursday September 20, 2012 @05:25PM (#4550799)
Python's is far superior to Javadocs.

JavaDocs is one of the earliest (popular) standard tools for documentation, so I'll give it that, but it suffers a number of problems - problems which are partly relics of the Java language, but that's no excuse.

JavaDocs is too focused on documenting classes, rather than documenting functionality (Python docs, by contrast, focus on modules, which are themselves arbitrary chunks of code with connected functionality).

JavaDocs doesn't make the package/class hierarchy terribly clear - this is intrinsically tied to Java's overcomplicated class hierarchy and needlessly complicated package system, but it carries over into poor documentation as well.

JavaDocs also doesn't have a culture of providing complete examples of code, which exacerbates the two aforementioned problems.

That said, JavaDocs has inspired other good tools, so I'll give it some credit for that and write these criticisms off as vestiges from a time long past.

Re:Everything that's wrong with Java in a single class by ww520 on Thursday September 20, 2012 @06:40PM (#4551138)
I found Javadoc well better and more informative than Python doc. Python module is nothing but a watered down version of a static class, so whatever applied to a class, you can say the same thing on a module.
Re:Everything that's wrong with Java in a single class by hmottestad on Thursday September 20, 2012 @05:01PM (#4550659)
Actually, I do like reading javadoc. It's just a pain to create and the code feels a bit bloated with all those comments.