John, +1 for consistent use of package.html since that gets picked up by javadoc. [1]
[1] http://java.sun.com/j2se/javadoc/writingdoccomments/#packagecomments -- Arthur On Mon, Aug 4, 2008 at 8:18 PM, John Kaputin (gmail) <[EMAIL PROTECTED]> wrote: > The text files called 'about-this-package' were created initially to explain > the purpose of each package and were located in the actual java package > directory, along with the java source files. In the new source code > structure some of these files are still within the /java package directory > and some have been moved to the /resources directories. I think it would > reduce the overall size of the directory tree if all of these files were > kept within the package directories (under /java, not /resources) because in > most cases there is nothing else under the /resource directory - just the > 'about-this-package' file. > > 'about-this-package' files that appear under the /java directory: > > /woden211/woden-api/src/main/java/org/apache/woden/about-this-package > /woden211/woden-api/src/main/java/org/apache/woden/wsdl20/extensions/about-this-package > > 'about-this-package' files that appear under the /resources directory: > > /woden211/woden-ant/src/main/resources/org/apache/woden/ant/about-this-package > /woden211/woden-api/src/main/resources/org/apache/woden/wsdl20/extensions/about-this-package > /woden211/woden-api/src/main/resources/org/apache/woden/wsdl20/fragids/about-this-package > /woden211/woden-api/src/main/resources/org/apache/woden/wsdl20/xml/about-this-package > /woden211/woden-api/src/main/resources/org/apache/woden/wsdl20/about-this-package > /woden211/woden-api/src/main/resources/org/apache/woden/about-this-package > > Note, we never created these files consistently for all packages anyway, so > perhaps now they should either be deleted or replaced with consistent use of > package.html javadoc files. Thoughts? > > regards, > John > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
