[ http://jira.codehaus.org/browse/MJAVADOC-87?page=comments#action_73842 ] Matthew Beermann commented on MJAVADOC-87: ------------------------------------------
It might be worth expanding on the Standard Directory Layout (http://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html) to include a generic folder for documentation. The "resources" folder(s) don't really seem appropriate - we don't want javadoc artifacts included in the endstate. Nor does the "site" folder, because they don't become part of the Maven site. > doc-files ignored if they reside in the resources directory > ----------------------------------------------------------- > > Key: MJAVADOC-87 > URL: http://jira.codehaus.org/browse/MJAVADOC-87 > Project: Maven 2.x Javadoc Plugin > Issue Type: Bug > Affects Versions: 2.0 > Reporter: Matthew Beermann > > It looks like MJAVADOC-76 was closed prematurely, or maybe it just had a bad > summary. The bug is this: if you have a "doc-files" folder in the > "src/main/resources" branch of your project, its contents will be omitted > from the Javadoc output. However, if you move the same folder over to > "src/main/java", it will be included in the output. This bug is present in > the released (2.0) version of the plugin. > The file "package.html", by comparison, will be included in the Javadoc > output no matter where it is. This is the expected behavior, AFAICT. More > information about the "doc-files" directory can be found here: > http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#unprocessed -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira
