On 28 May 2011, at 02:25, Kevin Wright wrote: > > On May 28, 2011 1:39 AM, "Alexey Zinger" <[email protected]> wrote: > > > > Isn't that why we have doclets? Personally, I rarely find current standard > > doclets lacking. > > > > Not really, I'm thinking more along the lines of: > > - JavaScript-based searching > - full CSS layout > - Redesigned look and feel > - In-place expansion of a method definition when clicking on it to see more > detail > - All of the above by default, not just a latent possibility for customising, > repeatedly, for each and every project > - Something that might plausibly have been designed within the last decade > - etc. > have you looked at doclava?
http://code.google.com/p/doclava/ it generates Android-style javadoc, such as: http://google-guice.googlecode.com/svn/trunk/javadoc/packages.html though it's still a doclet, not a complete rewrite > > Alexey > > 2001 Honda CBR600F4i (CCS) > > 1998 Honda RS125 (CCS) > > 2002 Suzuki Bandit 1200S > > http://weatherblackjack.appspot.com > > http://azinger.blogspot.com > > http://bsheet.sourceforge.net > > http://wcollage.sourceforge.net > > > > ________________________________ > > From: Kevin Wright <[email protected]> > > To: [email protected] > > Sent: Friday, May 27, 2011 8:29 PM > > Subject: [The Java Posse] JavaDoc due for an overhaul > > > > Looking over the new JavaFX 2.0 API, I couldn't help but notice how dated > > the JavaDoc format now looks. > > > > We started here: http://docstore.mik.ua/jdk/api/packages.html > > and advanced to: http://download.oracle.com/javase/6/docs/api/ > > > > Then it all stopped, until... > > we went from this: > > http://img.surfpack.com/img/thumbs/j/java.sun.com_favicon.jpg > > to this: http://img.pho.to/img/thumbs/l/landingpad.oracle.com_favicon.jpg > > > > > > Did innovation really stop at framesets? > > Is a new favicon really the only change we can expect to JavaDoc? > > > > There's so much potential here for a revised design, some search > > capabilities, a spot of script even! > > Am I alone in thinking this? > > > > > > > > -- > > Kevin Wright > > > > gtalk / msn : [email protected] > > mail: [email protected] > > vibe / skype: kev.lee.wright > > quora: http://www.quora.com/Kevin-Wright > > twitter: @thecoda > > > > "My point today is that, if we wish to count lines of code, we should not > > regard them as "lines produced" but as "lines spent": the current > > conventional wisdom is so foolish as to book that count on the wrong side > > of the ledger" ~ Dijkstra > > > > -- > > 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. > > -- > 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.
