directory-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Emmanuel Lecharny <elecha...@gmail.com>
Subject Re: Javadocs fixing/creating
Date Mon, 07 Jun 2010 08:25:50 GMT
On 6/7/10 10:04 AM, Felix Knecht wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hi dev
>
> Are you aware of
> http://maven.apache.org/plugins/maven-javadoc-plugin/fix-mojo.html?
>
> This will create (depending on the properties you set on CLI) missing
> javadocs on in the source files. Properties can also be configured in
> each project pom.xml.
>
> I suggest to fix at least ClassComments for now. Resulting is shown in
> sample below.
>
> WDYT?
>    

Yes, sure, we can use this guy. But I would rather expect that we 
manually add the missing Javadoc, assuming that the generated reports 
tell us which ones are missing.

My fear is that we consider a missing header as a non issue, as the mavn 
plugin will 'fix it'...

Also it may create some burden as you will have some more file to commit.

May be we can run it once, but we then should add a @Todo Javadoc 
generated by Maven on the header.-----END PGP SIGNATURE-----
>    


-- 
Regards,
Cordialement,
Emmanuel L├ęcharny
www.nextury.com



Mime
View raw message