Agreed. If we move to a new Doclet, it should at least support Javadoc's standard tags. It's a non-starter otherwise IMO.
Gary > -----Original Message----- > From: [email protected] [mailto:[email protected]] On Behalf Of > Simone Tripodi > Sent: Sunday, January 02, 2011 10:35 > To: Commons Developers List > Subject: Re: [ALL] [PROPOSAL] adding Google Doclava in the parent pom > > 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]
