Mailing-List: contact harmony-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: harmony-dev@incubator.apache.org
Received-SPF: pass (asf.osuosl.org: local policy)
Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain;
	charset="US-ASCII"
Subject: RE: newbie to project-where to start from
Content-Transfer-Encoding: quoted-printable
Date: Thu, 16 Feb 2006 16:15:00 +1100
Message-ID: <272759CB7575F644B77D952E5CCCA6A407D047BA@sydmsg3.int.f2.com.au>
Thread-Topic: newbie to project-where to start from
Thread-Index: AcYytfLNj996YsuMQRmnZF4ZRvb2IAAAdutg
From: "Matthew Johnson" <mjohnson@fairfaxdigital.com.au>
To: <harmony-dev@incubator.apache.org>

JCSC is a Java Coding Standard Checker - ie, just conformance, not
coverage. There's a good list of code coverage tools at
http://java-source.net/open-source/code-coverage.


Matt=20

> -----Original Message-----
> From: Mikhail Loenko [mailto:mloenko@gmail.com]=20
> Sent: Thursday, 16 February 2006 4:00 PM
> To: harmony-dev@incubator.apache.org
> Subject: Re: newbie to project-where to start from
>=20
> Hi Karan
>=20
> if there is some area that you are interesting in the most, you might
> want to say it and people who developed classes in that area
> could advise for which of them are untested.
>=20
> All,
>=20
> I think it makes sense to include into the build a target=20
> that calculates
> coverage - that would advise people where to contribute the tests.
> BTW, what do you think about JCSC coverage tool?
> http://jcsc.sourceforge.net/
>=20
> Thanks,
> Mikhail
>=20
>=20
> On 2/16/06, karan malhi <karan.malhi@gmail.com> wrote:
> > Tim,
> >
> > Thanks for such a detailed reply. I have a couple of  more=20
> questions:
> > 1. Do I have to sign and fax back the questionnaire before I start
> > working on harmony ?
> > 2. I know this is dumb but I saw in some previous posts=20
> that the tests
> > were being compiled with jrockit. I guess I can use any=20
> compiler (sun)
> > without causing any licensing issues - right? Sorry, but I=20
> am very poor
> > with this licensing stuff. Just want to make sure I am=20
> playing within
> > the rules of the game.
> >
> >
> > Tim Ellison wrote:
> >
> > >karan malhi wrote:
> > >
> > >
> > >>I need to know how I can start on harmony. I would like=20
> to start by
> > >>writing some tests.
> > >>
> > >>
> > >
> > >That would be great -- thanks Karan!
> > >
> > >If you have detailed knowledge of another implementation=20
> of Java then we
> > >need to talk further, otherwise dive right in.  Examples=20
> of 'detailed
> > >knowledge' can be found in the Harmony Questionnaire [0]
> > >
> > >[0] http://incubator.apache.org/harmony/auth_cont_quest.html
> > >
> > >
> > >
> > >>Here are my questions :
> > >>1. Are there any predefined assertions to test or do we=20
> simply write
> > >>test after looking at the api docs for each method
> > >>
> > >>
> > >
> > >Looking at the spec and writing tests is a pretty good=20
> start.  There are
> > >some tests in the repository already, and some more=20
> incoming, but we'll
> > >worry about merging new code into the full test suite.
> > >
> > >
> > >
> > >>2. Are there any naming conventions for test cases
> > >>
> > >>
> > >
> > >Yes.
> > >
> > >Pick a module [1] that interests you and from there the=20
> test code is in
> >=20
> ><module_name>/src/test/java/org.apache.harmony.tests.<pkg>.<t
> ype>Test.java
> > >where <pkg> and <type> are the package and type under=20
> test; see here [2]
> > >for an example.
> > >
> > >We are using JUnit, so your test class extends=20
> junit.framework.TestCase.
> > > Each test method is "public void test_<methodID>()" where=20
> <methodID> is
> > >the method under test including param types; e.g. [3].
> > >
> > >Don't worry too much about the names, we'll fix them on=20
> the way in if
> > >necessary.
> > >
> > >[1]
> >=20
> >http://svn.apache.org/viewcvs.cgi/incubator/harmony/enhanced/
> classlib/trunk/modules/
> > >[2]
> >=20
> >http://svn.apache.org/viewcvs.cgi/incubator/harmony/enhanced/
classlib/trunk/modules/luni/src/test/java/org/apache/harmony/tests/java/
net/
> > >[3]
> >=20
> >http://svn.apache.org/viewcvs.cgi/incubator/harmony/enhanced/
classlib/trunk/modules/luni/src/test/java/org/apache/harmony/tests/java/
net/InetAddressT> est.java?view=3Dmarkup
> > >
> > >
> > >
> > >>3. When one files a JIRA for a failed test, does one also=20
> attach the
> > >>test to the JIRA
> > >>
> > >>
> > >
> > >Yes please, a succinct description with a unit test is=20
> great, and if you
> > >have a proposed patch that would be even better ;-)
> > >
> > >We have had lots of good examples of bug reports, here's=20
> one I picked at
> > >random to show the type of thing we like to see:
> > >       https://issues.apache.org/jira/browse/HARMONY-53
> > >
> > >Thanks again for your offer of help.
> > >
> > >Regards,
> > >Tim
> > >
> > >
> > >
> >
> > --
> > Karan Singh
> >
> >
>=20