[gentoo-java] contributing to Gentoo Java

[gentoo-java] contributing to Gentoo Java

[Scott Amort]

Hello,

I have recently been tasked with developing and maintaining a web server
at work using Apache's Lenya CMS (lenya.apache.org).  I thought setting
up a mock system on my Gentoo box would give me a good place to play and
learn.  However, I notice many of the ebuilds required for Lenya (i.e.
Cocoon, Excalibur and even Lenya itself) are either missing or quite
outdated.  I am happy to create/update and contribute these ebuilds, but
I will need some guidance and assistance.  I have worked with and edited
ebuilds in the past, but quite rarely for Java apps.  Here are some
starter questions:

1) Has anyone else already started this work?  I don't want to duplicate
other people's work.

2) I have read and will follow the ebuild documentation at:
http://www.gentoo.org/proj/en/java/java-devel.xml, however it is rather
basic.  My first major question is how to deal with Java Ant files that
get jar dependencies rather than provide them (the example that just
deletes distributed jars will not work in this instance)?

3) Many of Lenya's Java dependencies are part of the Excalibur project
which contains updates to the now closed Avalon project (i.e.
avalon-logkit, avalon-framework-api, avalon-framework-imp).  Has there
been any discussion on where/how to deal with these new libraries?  Is
anyone aware of API changes or other possible issues?

Finally, while I have a strong programming background, it has been
mainly focused around some C++ apps as of late, so my Java is a bit
rusty, and my familiarity with Ant is limited.  I may need some basic
assistance while I get myself up to speed.

So, I guess I am wondering what the best way to get started on this is?
Thanks for any assistance.

Best,
Scott

-- 
gentoo-java@gentoo.org mailing list

Re: [gentoo-java] contributing to Gentoo Java

[Joshua Nichols]

Scott Amort wrote:
> 1) Has anyone else already started this work?  I don't want to duplicate
> other people's work.
>
>   
Not recently that I am aware of.
> 2) I have read and will follow the ebuild documentation at:
> http://www.gentoo.org/proj/en/java/java-devel.xml, however it is rather
> basic.  My first major question is how to deal with Java Ant files that
> get jar dependencies rather than provide them (the example that just
> deletes distributed jars will not work in this instance)?
>
>   
I'm not sure what you mean. Are you referring to ant scripts that
download their dependencies? Is there a specific build.xml that you're
not sure to handle? If so, please share and we can take a look at it.
> 3) Many of Lenya's Java dependencies are part of the Excalibur project
> which contains updates to the now closed Avalon project (i.e.
> avalon-logkit, avalon-framework-api, avalon-framework-imp).  Has there
> been any discussion on where/how to deal with these new libraries?  Is
> anyone aware of API changes or other possible issues?
>
>   
There hasn't been any talk that I'm aware of.

Regards,

-- 
Joshua Nichols
Gentoo/Java - Project Lead

-- 
gentoo-java@gentoo.org mailing list

Re: [gentoo-java] contributing to Gentoo Java

[Scott Amort]

Hi Joshua,

On Fri, 2006-09-22 at 14:31 -0400, Joshua Nichols wrote:
> I'm not sure what you mean. Are you referring to ant scripts that
> download their dependencies? Is there a specific build.xml that you're
> not sure to handle? If so, please share and we can take a look at it.

Yes, here is an example:

  </target>
  <target name="get-deps" unless="noget" depends="init">
    <!--Proxy settings works only with a JDK 1.2 and higher.-->

    <setproxy>
    </setproxy>
    <get dest="${libdir}/avalon-logkit-2.1.jar" usetimestamp="true"
ignoreerrors="true"
src="http://www.ibiblio.org/maven/avalon-logkit/jars/avalon-logkit-2.1.jar">
    </get>
  </target>

What approach should I use to prevent the build from downloading this
jar and instead using one provided by the avalon-logkit ebuild?

Thanks!

Scott 

-- 
gentoo-java@gentoo.org mailing list

Re: [gentoo-java] contributing to Gentoo Java

[Vlastimil Babka]

Scott Amort wrote:
>   </target>
>   <target name="get-deps" unless="noget" depends="init">
>     <!--Proxy settings works only with a JDK 1.2 and higher.-->
> 
>     <setproxy>
>     </setproxy>
>     <get dest="${libdir}/avalon-logkit-2.1.jar" usetimestamp="true"
> ignoreerrors="true"
> src="http://www.ibiblio.org/maven/avalon-logkit/jars/avalon-logkit-2.1.jar">
>     </get>
>   </target>
> 
> What approach should I use to prevent the build from downloading this
> jar and instead using one provided by the avalon-logkit ebuild?
> 

You can call eant with -Dnoget=true to trigger the "unless" clause 
causing the target not performed (no downloading). I think there are 
already some ebuilds that do this.

-- 
Vlastimil Babka (Caster)
Gentoo/Java
-- 
gentoo-java@gentoo.org mailing list

Re: [gentoo-java] contributing to Gentoo Java

[Scott Amort]

On Fri, 2006-09-22 at 22:24 +0200, Vlastimil Babka wrote:
> You can call eant with -Dnoget=true to trigger the "unless" clause 
> causing the target not performed (no downloading). I think there are 
> already some ebuilds that do this.

Great.. thanks that worked.  Next question - how do I disable JUnit
tests?  The build.xml sets a test depend on the jar target:

<target name="jar" description="o Create the jar"
depends="compile,test">

Thanks again,
Scott


-- 
gentoo-java@gentoo.org mailing list

Re: [gentoo-java] contributing to Gentoo Java

[Miroslav Šulc]

[-- Attachment #1: Type: text/plain, Size: 368 bytes --]

Scott Amort wrote:
> Great.. thanks that worked.  Next question - how do I disable JUnit
> tests?  The build.xml sets a test depend on the jar target:
>
> <target name="jar" description="o Create the jar"
> depends="compile,test">
>
> Thanks again,
> Scott
You have to create patch for build.xml that removes the test from the
depends.

--
Miroslav Šulc

[-- Attachment #2: miroslav.sulc.vcf --]
[-- Type: text/x-vcard, Size: 349 bytes --]

begin:vcard
fn;quoted-printable:Miroslav =C5=A0ulc
n;quoted-printable:=C5=A0ulc;Miroslav
org:StartNet s.r.o.
adr;quoted-printable;quoted-printable:;;Schodov=C3=A1 309/10;Praha 5;;150 00;=C4=8Cesk=C3=A1 republika
email;internet:miroslav.sulc@startnet.cz
tel;cell:+420 603 711 413
x-mozilla-html:TRUE
url:http://www.startnet.cz
version:2.1
end:vcard

Re: [gentoo-java] contributing to Gentoo Java

[William L. Thomson Jr.]

[-- Attachment #1: Type: text/plain, Size: 928 bytes --]

Darn reply to list got me, doh :) Re-sending to list.

On Fri, 2006-09-22 at 16:59 -0400, Scott Amort wrote:
> On Fri, 2006-09-22 at 22:24 +0200, Vlastimil Babka wrote:
> > You can call eant with -Dnoget=true to trigger the "unless" clause 
> > causing the target not performed (no downloading). I think there are 
> > already some ebuilds that do this.
> 
> Great.. thanks that worked.  Next question - how do I disable JUnit
> tests?  The build.xml sets a test depend on the jar target:
> 
> <target name="jar" description="o Create the jar"
> depends="compile,test">

I am not saying this is the case now, but at times you might have to
manually modify the build.xml files. Then create a patch to be called
and applied by the ebuild.

This might be a case where a patch is required to remove the test target
from depends unless the test USE flag or etc is set.

-- 
William L. Thomson Jr.
Gentoo/Java

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-java] contributing to Gentoo Java

[Vlastimil Babka]

William L. Thomson Jr. wrote:
> This might be a case where a patch is required to remove the test target
> from depends unless the test USE flag or etc is set.

Actually, even in case of FEATURES=test (and USE=test), you want to 
remove the test target from depends. Because testing (including building 
of the test cases, often done in compile-tests target upon which test 
target depends) should be invoked in src_test() phase, not in 
src_compile() as part of main build process. So you patch build.xml in 
any case, and do something like "eant test" in src_test().

-- 
Vlastimil Babka (Caster)
Gentoo/Java
-- 
gentoo-java@gentoo.org mailing list

Re: [gentoo-java] contributing to Gentoo Java

[robert burrell donkin]

On 9/23/06, Vlastimil Babka <caster@gentoo.org> wrote:
> William L. Thomson Jr. wrote:
> > This might be a case where a patch is required to remove the test target
> > from depends unless the test USE flag or etc is set.
>
> Actually, even in case of FEATURES=test (and USE=test), you want to
> remove the test target from depends. Because testing (including building
> of the test cases, often done in compile-tests target upon which test
> target depends) should be invoked in src_test() phase, not in
> src_compile() as part of main build process. So you patch build.xml in
> any case, and do something like "eant test" in src_test().

i'm currently preparing content for a guide for apache releases for
use in the incubator (through which all new projects enter). advice on
best practices will be included.

being able to selectively turn off tests sounds like it be suitable
for inclusion.

anyone else care to offer any other advise on how to create more
friendly builds etc...?

- robert
-- 
gentoo-java@gentoo.org mailing list

Re: [gentoo-java] contributing to Gentoo Java

[Joshua Nichols]

robert burrell donkin wrote:
> i'm currently preparing content for a guide for apache releases for
> use in the incubator (through which all new projects enter). advice on
> best practices will be included.
>
> being able to selectively turn off tests sounds like it be suitable
> for inclusion.
>
> anyone else care to offer any other advise on how to create more
> friendly builds etc...?
>
We started this document:
https://overlays.gentoo.org/proj/java/wiki/How_to_be_a_good_upstream

It is by no means complete or thorough, but we do add to it as we run
into things that make packaging more difficult.

Regards,

-- 
Joshua Nichols
Gentoo/Java Project Lead
-- 
gentoo-java@gentoo.org mailing list