On 19/08/16 14:52, Ellison Anne Williams wrote:
> Can you please take a look at PR 65 (PIRK-53) and let me know if we are
> ready to go with L&N for our first release?

I feel like I'm being the bad cop :-(

I'm trying to put myself into the shoes of somebody picking up one of
these artefacts, and figuring out what the terms are under which it was
received.  Having L&N files in there that are correct but mixed in
amongst other incorrect L&N files is just too confusing.  How can a user
know which ones apply?  So we have to filter out the rotten ones, and
place the correct ones where they would expect to be found.

Looking into each of the ZIP/JAR files produced from ellisonanne/pirk-53
branch, I see the following:

 apache-pirk-0.0.2-source-release.zip (Main source release)
        correct
                /LICENSE
                /NOTICE
                /DISCLAIMER
        confusing (but off topic)
                /logs - contains old log files

 apache-pirk-0.1.0.jar (Binary project JAR), and
 apache-pirk-0.1.0-sources.jar (Corresponding source for binary project JAR)
        correct
                /META-INF/LICENSE
                /META-INF/NOTICE
        incorrect
                /META-INF/bin-license-notice/licenses/* - does not relate to the
content of this JAR.
                /META-INF/bin-license-notice/LICENSE-bin - does not relate to 
the
content of this JAR.
                /META-INF/bin-license-notice/NOTICE-bin - does not relate to the
content of this JAR.
        confusing
                /META-INF/DISCLAIMER - missing, but probably ok.  Ideally would
appear in this JAR too.

 apache-pirk-0.1.0-exe.jar (Combined JAR with all dependencies included)
        incorrect
                /LICENSE.txt - this is a BSD license.           
                /META-INF/LICENSE - does not refer to subcomponents license/ 
directory.
                /META-INF/NOTICE - does not contain required notices from 
subcomponents.
                /META-INF/LICENSE.txt - contains additional license statements 
beyond
ALv2.
                /META-INF/NOTICE.txt - does not reference Pirk incubating, 
contains
ref to LICENSE.txt
                /META-INF/license/* - appears not the be the set of subcomponent
licenses (count=10)
                /META-INF/bin-license-notice/LICENSE-bin - not called LICENSE.
                /META-INF/bin-license-notice/NOTICE-bin - not called NOTICE.
        confusing
                /LICENSE-junit.txt - should be in license/ directory.
                /META-INF/bin-license-notice/licenses/* - should be in
/META-INF/license/*
                /META-INF/bin-license-notice/LICENSE-bin - should be in 
/META-INF/LICENSE
                /META-INF/bin-license-notice/NOTICE-bin - should be in 
/META-INF/NOTICE


I'd appreciate other mentors' close review of these built artefacts too.

Seems that the main project source release looks good, but the
convenience JARs still needs some filtering/moving work.

Regards,
Tim

Reply via email to