On ecj and @Override annotations for interface methods

[Mark Wielaard]

Hi Joe,

On Tue, 2008-09-23 at 07:12 -0700, Joseph D. Darcy wrote:
> > Are these manpages written by hand these days? It has a comment that
> > says: "Generated by html2man", but it doesn't say what the original html
> > file is that it was generated from.
> >   
> The process used in the past for man pages was that the docs team works 
> with us developers to write the HTML man pages, which are in turn 
> converted to SGML and *roff for Solaris and Linux, respectively.  It 
> looks like the last update to the HTML page, 6392810 "javac manpage 
> needs to be updated to include JSR 269 and other Mustang options," did 
> not get converted to the other formats.  If the actual *nix man pages, 
> regardless of format, are supposed to be generated in this fashion, it 
> would admittedly be a better architecture to have them as generated 
> files during the build and not track all three versions of the man page 
> under version control.

So if the preferred form of the for making modifications to these
documents is the HTML or SGML version that the doc team maintains it
would be good to get those in the openjdk tree. Does the documentation
team maintain their own repository for these documents?

Thanks,

Mark