Updated dist and jar tasks

[Nick Burch <ni...@torchbox.com>]

Hi All

I've gone through Henri's list of suggested improvements to the build
artificats, and hopefully implemented all of them.

The main updates are:
* The jars (binary and maven) now include NOTICE and LEGAL, at their
   top level
* The zips and tgzs now unpack into a directory called poi-<version>/,
   rather than into the current directory. In there, you will also now
   find NOTICE and LEGAL (and not in some subdirectory)
* The KEYS file is now updated

It'd be great if a few people could try the "jar", "maven-dist" and "dist"
ant tasks, and check that they're outputting the artifacts that would be
expected.  Any further suggested improvements gratefully accepted :)

Nick

---------------------------------------------------------------------
To unsubscribe, e-mail: poi-dev-unsubscribe@jakarta.apache.org
Mailing List:    http://jakarta.apache.org/site/mail2.html#poi
The Apache Jakarta POI Project: http://jakarta.apache.org/poi/

Re: Updated dist and jar tasks

[Mark Thomas <ma...@apache.org>]

Mark Thomas wrote:
> dist - I can't build with forrest 0.7 due to antproxy support being
> removed. I am working on what changes are required to get this working

Having tried, and failed, to get the build working with both 0.7 and
the latest source from svn I reverted to 0.5.1

I am still getting a build error in the documentation - a broken link
with hslf/hslf_shapes.gif

I am not familiar with forrest or the POI documentation structure but
I believe the following change is required to fix it:
move hslf_shapes.gif from src/documentation/content/xdocs/hslf to
src/documentation/resources/images

With this change the dist target works for me.

For consistency with the other docs, the img tag in
src/documentation/content/xdocs/hslf/how-to-shapes.xml should change
from <img src="hslf_shapes.gif" ... /> to
<img src="images/hslf_shapes.gif" ... />

On a related note the DTDs in src/documentation/content/xdocs/dtd
appear to be ignored. The documentation certainly doesn't conform to
them - it appears modified versions supplied by forrest are used
instead. It is probably worth removing these to prevent confusion.

HTH,

Mark

---------------------------------------------------------------------
To unsubscribe, e-mail: poi-dev-unsubscribe@jakarta.apache.org
Mailing List:    http://jakarta.apache.org/site/mail2.html#poi
The Apache Jakarta POI Project: http://jakarta.apache.org/poi/

Re: Updated dist and jar tasks

[Mark Thomas <ma...@apache.org>]

Nick Burch wrote:
> Hi All
> 
> I've gone through Henri's list of suggested improvements to the build
> artificats, and hopefully implemented all of them.
> 
> The main updates are:
> * The jars (binary and maven) now include NOTICE and LEGAL, at their
>    top level

I think NOTICE and LICENSE should be under META-INF rather than in the
root of the JAR. I have tried to find a reference for this but can't.

The maven sources don't include:
font_metrics.properties
empty.ppt
should they? (I don't use maven so don't know what is required here)

> * The zips and tgzs now unpack into a directory called poi-<version>/,
>    rather than into the current directory. In there, you will also now
>    find NOTICE and LEGAL (and not in some subdirectory)
> * The KEYS file is now updated
> 
> It'd be great if a few people could try the "jar", "maven-dist" and "dist"
> ant tasks, and check that they're outputting the artifacts that would be
> expected. 

jar - builds fine, no problems
dist - I can't build with forrest 0.7 due to antproxy support being
removed. I am working on what changes are required to get this working
maven-dist - builds fine no problems

> Any further suggested improvements gratefully accepted :)
Some source files do not contain the licence header. These include:
font_metrics.properties
various package.html files
various xml files

It is probably required for some of these files. The definitive
guidance is in "What files in an Apache release do not require a
license header?" at http://www.apache.org/legal/src-headers.html

If we decide a large number of files need this text added, I'm happy
to lend a had to do it but I don't want to start doing something we
later decide is unnecessary.

On Tomcat we have had problems with people mis-using the Tomcat name
and/or logo. We should consider adding something similar to the
Trademarks text at http://tomcat.apache.org/legal.html to the POI
legal page.

HTH,

Mark

---------------------------------------------------------------------
To unsubscribe, e-mail: poi-dev-unsubscribe@jakarta.apache.org
Mailing List:    http://jakarta.apache.org/site/mail2.html#poi
The Apache Jakarta POI Project: http://jakarta.apache.org/poi/