>From the Maven point of view, all resources files MUST be kept in the resources folder. Iy you don't follow this Maven convention, then you must declare your java folders as resources folder but this will have an impact on the JAR plugin: you must then tell this plugin not to use .java files from the resources folders. So I would not encourage such a use. So we should remove these files and switch to the Javadoc kind of use.
Regards Jeff MAURY On 8/4/08, 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 > > -- La mélancolie c'est communiste Tout le monde y a droit de temps en temps La mélancolie n'est pas capitaliste C'est même gratuit pour les perdants La mélancolie c'est pacifiste On ne lui rentre jamais dedans La mélancolie oh tu sais ça existe Elle se prend même avec des gants La mélancolie c'est pour les syndicalistes Il faut juste sa carte de permanent Miossec (2006) http://www.jeffmaury.com http://riadiscuss.jeffmaury.com http://www.lastfm.fr/listen/user/jeffmaury/personal Mes CDs à récupérer: http://spreadsheets.google.com/ccc?key=pNeg4Doa_oCsh7CepKPaPTA&hl=en
