[ 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
