commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dennis Lundberg <denn...@apache.org>
Subject Re: [VOTE] Release commons-parent 7
Date Wed, 09 Jan 2008 16:02:20 GMT
Niall Pemberton wrote:
> On Jan 8, 2008 7:55 PM, Dennis Lundberg <dennisl@apache.org> wrote:
>> Niall Pemberton wrote:
>>> On Jan 8, 2008 7:12 PM, Niall Pemberton <niall.pemberton@gmail.com> wrote:
>>>> On Jan 8, 2008 6:49 PM, Dennis Lundberg <dennisl@apache.org> wrote:
>>>>> Niall Pemberton wrote:
>>>>>> On Jan 8, 2008 4:19 PM, Jochen Wiedmann <jochen.wiedmann@gmail.com>
wrote:
>>>>>>> On Jan 8, 2008 12:11 PM, Niall Pemberton <niall.pemberton@gmail.com>
wrote:
>>>>>>>
>>>>>>>>> Sorry, if I am coming up with this question so late.
Nevertheless:
>>>>>>>>> Does the current parent pom deal with adding NOTICE.txt
and
>>>>>>>>> LICENSE.txt to the javadoc jar files?
>>>>>>>> No - but AIUI it doesn't need to since it only contains the
generated
>>>>>>>> javadoc and not anything we develop.
>>>>>>> I'll be more than happy if we'll be able to get rid of that policy.
>>>>>>> Nevertheless it is what I was forced to do for releases of
>>>>>>> commons-fileupload and commons-io in the past. And, AFAIK, it
is
>>>>>>> automatically enforced by the maven-remote-resources-plugin.
>>>>>> Actually remote resourcs doesn't.
>>>>> Actually it does. maven-remote-resources-plugin places the remotely
>>>>> fetched resources in a special directory. These resources are then
>>>>> included into the created jar file by maven-javadoc-plugin and
>>>>> maven-source-plugin.
>>>> Well I tried it and it didn't.
>>> Apologies - I just tried specifying the latest javadoc plugin version
>>> (2.3) and it worked. I'm just wondering why the javadoc jar plugin
>>> doesn't also do the "local" resources as well?
>> You normally don't want the javadoc-plugin to include your normal
>> resources, the ones that end up in target/classes during the build. You
>> can however tell the javadoc-plugin to use special javadoc resources if
>> you want to:
>>
>> http://maven.apache.org/plugins/maven-javadoc-plugin/examples/javadoc-resources.html
> 
> I tried adding that to the javadoc plugin configuration
>    <javadocDirectory>target/classes/META-INF</javadocDirectory>
> 
> but it didn't work and looking at the copyJavadocResources() method in
> AbstractJavadocMojo (http://tinyurl.com/2ewwyz) it appears to pass an
> includes parameter of "**/doc-files" to Plexus's FileUtils
> getDirectoryNames() method (http://tinyurl.com/2cnokz) - so my reading
> is these files would need to be in a "doc-files" directory - is this
> correct or am I doing something wrong?

Reading the page I supplied a little more carefully I think that you a 
right. It can't do what I thought it could, so you can't use that to 
include license and notice files.

> Niall
> 
>>> Niall
>>>
>>>> Niall
>>>>
>>>>>> Niall
>>>>>>
>>>>>>> Jochen
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 
> 


-- 
Dennis Lundberg

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message