It depends greatly on the API. E.g., JButton has around 380 public methods and a lot of Swing is like that. Most of those are irrelevant and some are actually harmful, but they'll all appear when you type 'button.' and wait.
For Swing, the tutorials are far more useful than the Javadocs. -----Original Message----- From: Cédric Beust [email protected] Sender: [email protected] Date: Thu, 8 Dec 2011 09:47:18 To: <[email protected]> Reply-To: [email protected] Subject: Re: [The Java Posse] Re: Joshua Bloch joins the Dart team as core libraries architect On Thu, Dec 8, 2011 at 8:20 AM, Josh Berry <[email protected]> wrote: > I can't help but thinking the "javadoc" style of thinking > you can jump in at any given method to fully understand what is > happening somewhere is a fallacy that causes more harm than is > admitted. > How is that a fallacy? I think it has worked very, very well overall. I consult Javadocs several times a day (most of the time from my IDE, which is another great progress in documentation browsing) and it does help my productivity significantly. Obviously, a Javadoc is only as good as the quality of the comment, but by now, Java has some very spectacularly well written doc across the board (both the JDK and external libraries such as Guice or Guava). Just this morning, somebody posted on scala-debate a very interesting report of his experience getting up to speed on Scala, and here is one of his points: There is definitely a huge price to pay developing Scala code because the IDE support is so poor. Writing Java code in Eclipse goes so much easier because of all the help the IDE editors give you. The fact that Eclipse lets you hover the cursor over things and brings up these great semi-persistent tool-tips with hyperlinked javadoc makes productivity incredibly high. -- Cédric -- You received this message because you are subscribed to the Google Groups "The Java Posse" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/javaposse?hl=en. -- You received this message because you are subscribed to the Google Groups "The Java Posse" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/javaposse?hl=en.
