Hi,

2008/8/10 Jochen Wiedmann <[EMAIL PROTECTED]>:
> Hi,
>
> I have attempted to use the javadocDirectory plugin of the
> maven-javadoc-plugin. In 2.4, this parameter is documented like this:
>
>    Specifies the Javadoc ressources directory to be included in the
> Javadoc (i.e. package.html, images...).
>
> I read this like I could use the parameter for the typical Apache use
> case (add NOTICE.txt and LICENSE.txt files). However, obviously this
> won't work.
>

All ASF resources are already included with
maven-remote-resources-plugin. So add it in your pom like defined in
[1], around the build tag.

> First of all, it seems that the parameter is used only when generating
> a report: Within javadoc:jar the method copyJavadocResources is never
> invoked. Second, the implementation is based on a call

copyJavadocResources is invoked following the Tool logic, ie when the
docfilessubdirs parameter is flagged [2]
It works for javadoc:javadoc and javadoc:jar goals

>
>    FileUtils.getDirectoryNames( javadocDir, "**/doc-files",
> StringUtils.join( FileUtils
>                .getDefaultExcludes(), "," ), false, true )
>
> which I do not understand at all. Why should I have a directory "doc-files"?

It is the Javadoc Tool spec. Please read [3] or [4] for more information.

>
> Are these bugs that we should fix? Otherwise: Could we add a
> "resources" parameter to the javadoc plugin?

Why do you need this parameter? What is your use case?

Cheers,

Vincent

[1] https://svn.apache.org/repos/asf/maven/pom/trunk/maven/pom.xml
[2] 
http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/javadoc.html#docfilessubdirs
[3] http://java.sun.com/j2se/javadoc/writingdoccomments/
[4] 
http://maven.apache.org/plugins/maven-javadoc-plugin/examples/javadoc-resources.html

> Thanks,
>
> Jochen
>
>
> --
> Look, that's why there's rules, understand? So that you think before
> you break 'em.
>
>  -- (Terry Pratchett, Thief of Time)
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to