[ 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

        

Reply via email to