On ecj and @Override annotations for interface methods

[Joseph D. Darcy]

Mark Wielaard wrote:
> Hi Joe,
>
> On Thu, 2008-09-18 at 11:55 -0700, Joseph D. Darcy wrote:
>   
>> Mark Wielaard wrote:
>>     
>>> On Thu, 2008-09-18 at 07:21 -0700, Joseph D. Darcy wrote:
>>>   
>>>       
>>>>>     Note: No language changes were introduced in JDK 6, so the values
>>>>>     1.6 and 6 are not valid.
>>>>>       
>>>>>           
>>>> Where are you seeing this documented?  The information is not correct 
>>>> and other sources give the correct information:
>>>> http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html
>>>>         
>>> It is from the javac manual page in:
>>> openjdk6/jdk/src/linux/doc/man/javac.1
>>> which seems to be a copy of the one in:
>>> openjdk6/jdk/src/solaris/doc/sun/man/man1/javac.1
>>>   
>>>       
>> Well that's a problem!  I'll talk to Jon about getting it fixed.
>>     
>
> Note that the version(s) in the openjdk7 tree are also stale and have
> the above (wrong) information in them.
>
> 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.

The -help output from a command should also be in-sync with the tool's 
capabilities.

-Joe