Hmm... this looks promising: http://docs.oracle.com/javase/1.5.0/docs/api/java/lang/annotation/Documented.html
See the documentation section here: http://docs.oracle.com/javase/tutorial/java/javaOO/annotations.html On Thu, Dec 22, 2011 at 2:43 PM, Ted Dunning <ted.dunn...@gmail.com> wrote: > I think annotations are significantly better. The integration with > javadoc isn't impossible and the integration from javadoc markup to > annotation is impossible. > > Interestingly, the javadoc tool documentation tends to recommend an > annotation *and* a javadoc tag. That does make the integration simple. > > > On Thu, Dec 22, 2011 at 12:54 PM, Dmitriy Lyubimov <dlie...@gmail.com>wrote: > >> just a custom javadoc tag would be easy though bit it would be visible >> to javadoc tool only (and not even IDEs, so typo-prone). Maybe that's >> what we need, but the trend in the rest of hadoop world seems to be to >> use annotation-driven markers in this case. >> > >