Hi Sebb, the reason you explained are enough to justify to keep Doclava out for the moment, I'll ping the core developers and convince them to support standard javadoc tags :) Thanks for the feedback!!! Simo
http://people.apache.org/~simonetripodi/ http://www.99soft.org/ On Sun, Jan 2, 2011 at 2:03 PM, sebb <[email protected]> wrote: > On 2 January 2011 12:19, Simone Tripodi <[email protected]> wrote: >> Hi all Commons developers, >> and happy new year!!! :) >> >> I recently joined the Google Doclava[1] team and helped them deploying >> it on the Maven Central repo, so I'd like to propose the adoption of >> this Doclet in the parent pom. >> For those don't know Google Doclava, it is the Google Android doclet, >> made as independent project, with amazing features like the 'search' >> box or the code syntax highlight, if you want to see it in action you >> can check the Google Guice APIs[2]. >> >> The only "dark side" is that Doclava requires Java6, but it can be >> easily included in a proper profile, activated when Java6 is detected, >> so it won't cause any damage for other platforms, as shown in[3] in >> the bottom page (see Warning section). > > Looks nice, but I don't like the fact that it does not support the > same tags as standard Javadoc. > > In particular, it does not yet support @since and @version, which we > use extensively in Commons. > > It also adds some new tags. > Not sure I think that is a good idea - if any such tags are used, they > will tie the code to using Doclava in future (and they won't be > supported by IDEs). > One way round this would be to run Doclava in "compatibility" mode, if > it exists. > If not, you may wish to consider adding it to the doclet. > . >> If there are no objections, I can take care about it, just let me know. >> Have a nice day, and happy new year once again, all the best!!! >> Simo >> >> [1] http://code.google.com/p/doclava/ >> [2] http://google-guice.googlecode.com/svn/trunk/javadoc/packages.html >> [3] http://code.google.com/p/doclava/wiki/GettingStarted >> >> http://people.apache.org/~simonetripodi/ >> http://www.99soft.org/ >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: [email protected] >> For additional commands, e-mail: [email protected] >> >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
