[undertow-dev] package-info.java

David M. Lloyd david.lloyd at redhat.com
Tue May 14 10:38:03 EDT 2013


A package-info.java file for tests is just noise.  We do not create 
JavaDoc for test files.

On 05/14/2013 09:24 AM, Anil Saldhana wrote:
> Stuart,
>     I see that you removed the package-info.java from my commit.
> https://github.com/anilsaldhana/undertow/commit/c25390580543c0da729a9667379db96efd6b4912
>
> http://docs.oracle.com/javase/7/docs/technotes/tools/solaris/javadoc.html#packagecomment
> ============
> To create a package comment file, you have a choice of two files to
> place your comments:
>
>       package-info.java - Can contain a package declaration, package
> annotations, package comments and Javadoc tags. This file is generally
> preferred over package.html.
>       package.html - Can contain only package comments and Javadoc tags,
> no package annotations.
> =============
>
> You do not recommend?  I know some IDEs have issues.
>
> Regards,
> Anil
> _______________________________________________
> undertow-dev mailing list
> undertow-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/undertow-dev
>


-- 
- DML


More information about the undertow-dev mailing list