[ http://jira.codehaus.org/browse/MJAVADOC-87?page=comments#action_77471 ] Nathan Beyer (Cerner) commented on MJAVADOC-87: -----------------------------------------------
I've found a workaround for the configuration of the javadoc plugin. The "-sourcepath" that's generated by default is this "${project.basedir}/src/main/java;${project.basedir}/src/main/javadoc" (with the properties resolved to their absolute value. If you put the 'javadoc' folder first, everything is copied as expected. Below is a configuration snippet that copies all the doc-files correctly. <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <sourcepath>${project.basedir}/src/main/javadoc;${project.basedir}/src/main/java</sourcepath> <docfilessubdirs>true</docfilessubdirs> </configuration> </plugin> I do think this needs to be reopened, but I don't think non-commiters can do that. At least I know my user can't do that. > 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 > Assigned To: Vincent Siveton > Fix For: 2.1 > > Attachments: my-app.zip > > > 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