Mailing-List: contact harmony-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: harmony-dev@incubator.apache.org
Received-SPF: pass (herse.apache.org: domain of sianjanuary@googlemail.com
 designates 66.249.92.169 as permitted sender)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=googlemail.com;
        h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:references;
        b=GYGfMyC/eH/1qa35kzzEU1G3NGmnbBY5wblwXPC3llE5mnxRs8rUJxspYKAxGGPxiVk7CAzxklbqR5lcEHwchGA7bER8ay9O8MAjaUNdEokLEtXNwlppNp0qhM1IiZ4xXmyMKxt5krTWleXWNBpp88TOPTuuBB8JtDJlhKInemw=
Message-ID: <fc2fc95c0610300506o60106dd4wda27948d9808fa73@mail.gmail.com>
Date: Mon, 30 Oct 2006 13:06:46 +0000
From: "Sian January" <sianjanuary@googlemail.com>
To: harmony-dev@incubator.apache.org, geir@pobox.com
Subject: Re: [build] Building on Eclipse - FYI
In-Reply-To: <4545EEB6.3050305@pobox.com>
MIME-Version: 1.0
Content-Type: multipart/alternative;
	boundary="----=_Part_61573_1437798.1162213606571"
References: 
 <32CD23D8C6B1454C9120C1525D521D6765BDCA@nnsmsx411.ccr.corp.intel.com>
	 <fc2fc95c0610300241x5482b61fr1e9ac280a24b3e80@mail.gmail.com>
	 <4545EEB6.3050305@pobox.com>

------=_Part_61573_1437798.1162213606571
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

My concern is that if there is too much documentation and it's not well
structured then people won't be inclined to read any of it.  If 50% of the
"Getting Started With DRLVM" page is actually about Eclipse, my feeling is
that it won't be as useful for people who actually want to get started with
DRLVM than it would be if it was half the size and more concise.  In general
I think having Eclipse-related documentation on its own page (or
inline where it's relevant) is a good thing, I was just commenting on the
amount of seemingly unrelated Eclipse documentation that is currently
included in the DRLVM page (
http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started.html).
Just my 2p worth...

Thanks,

Sian


On 30/10/06, Geir Magnusson Jr. <geir@pobox.com> wrote:
>
>
>
> Sian January wrote:
> > I'm actually not sure if that first page is up to date or not  (
> >
> http://incubator.apache.org/harmony/subcomponents/classlibrary/dev_eclipse.html
> ).
> >
> > I think it should be but I have not ever been able to get it to work
> > myself.  Can anyone else confirm whether it is still in date or not?
> >
> > Also I'm just wondering whether we really need steps 5-14 of "Running an
> > Application in Eclipse" or any of "Debugging an Application in Eclipse"?
> > There doesn't seem to be anything Harmony-specific in those steps, it's
> > just
> > about using Eclipse.  I know Eclipse itself contains that kind of
> > documentation in its help system so IMHO it seems like it could be a
> little
> > redundant to duplicate that on the Harmony website.
> >
>
> I think that if we have an eclipse document, and the info is accurate, I
> say why not?
>
> We're trying to suck people into the whirling vortex that is our little
> project, and if it's someone that isn't an eclipse user, but was
> intrigued by our ability to run it, etc, etc, it seem to be harmless.  I
> assume that it won't change often, so the maintenance is minor?
>
> geir
>
> > Thanks,
> >
> > Sian
> >
> >
> > On 27/10/06, Konovalova, Svetlana <svetlana.konovalova@intel.com> wrote:
> >>
> >> Sian,
> >>
> >> Thanks a lot for the detailed description of what I should do. I'll
> >> follow your recommendations. :)
> >>
> >> I'll investigate what we have already written about Eclipse to avoid
> >> redundant info and repeating pages.
> >>
> >> What I've just come across are:
> >> 1) The page describing how to set up Eclipse to develop Java code in
> >> Apache Harmony
> >> [
> http://incubator.apache.org/harmony/subcomponents/classlibrary/dev_ecli
> >> pse.html];
> >> 2) The sections "Running an Application in Eclipse" and "Debugging an
> >> Application in Eclipse "in the Getting Started with DRL
> >> [
> file:///C:/SVN-23-10/docs/subcomponents/drlvm/getting_started.html#Ecli
> >> pse_Hello_world]
> >>
> >> Would be great, if you find a chance to check whether the
> aforementioned
> >> info is up-to-date :)
> >>
> >> Cheers,
> >> Sveta
> >> -----Original Message-----
> >> From: Sian January [mailto:sianjanuary@googlemail.com]
> >> Sent: Friday, October 27, 2006 3:34 PM
> >> To: harmony-dev@incubator.apache.org
> >> Subject: Re: [build] Building on Eclipse - FYI
> >>
> >> Hi Sveta,
> >>
> >> That sounds like a great idea.  I think the two main things you need to
> >> do
> >> extra on Eclipse on Windows are as follows:
> >>
> >> 1. Make a copy of vsvars32.bat from your Visual Studio install
> >> directory.
> >> If you have chosen the defaults when installing you will find it in
> >> "C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\Tools".
> >> Copy it
> >> to somewhere convenient such as the desktop and add the following line
> >> (just
> >> below the last line that begins "@set..."):
> >> start C:\...\eclipse\eclipse.exe -vmargs -Xmx512M
> >> (where ... is the path to your eclipse installation).  NB. using
> >> "-vmargs
> >> -Xmx512M" is optional, but helpful to stop Eclipse running out of
> >> memory.
> >> Now just double click on this file to start Eclipse.
> >>
> >> 2. After you have started Eclipse and checked out Harmony from SVN,
> copy
> >> ecj_3.2.jar into ..\eclipse\plugins\org.apache.ant_1.6.5\lib and change
> >> the
> >> Ant settings to include this jar (Window > Preferences > Ant > Runtime
> >> then
> >> select 'Global Entries' then 'Add External Jars' and add ecj_3.2.jar
> >> from
> >> the org.apache.ant_1.6.5\lib directory).
> >>
> >> If you're happy to add that to the document that would be great.
> >>
> >> On Linux you will also need to do 2, but I'm not sure if there's an
> >> equivalent to 1 or not.  Has anyone else tried building in Eclipse on
> >> Linux?
> >>
> >> Thanks,
> >>
> >> Sian
> >>
> >>
> >> On 26/10/06, Konovalova, Svetlana <svetlana.konovalova@intel.com>
> wrote:
> >> >
> >> > Folks,
> >> >
> >> > I see that we do need one more building doc describing Eclipse
> >> > specifics.
> >> > The main doc containing building instructions now is the "Getting
> >> > Started for Contributors" page.
> >> > [http://incubator.apache.org/harmony/quickhelp_contributors.html].
> >> > My suggestion is to add one more section to it describing building
> >> > instructions for Eclipse. How about that?
> >> >
> >> > If you need my help, I'll be glad to manage the doc creation:)
> >> >
> >> > Cheers,
> >> > Sveta
> >> >
> >> > -----Original Message-----
> >> > From: Sian January [mailto:sianjanuary@googlemail.com]
> >> > Sent: Thursday, October 26, 2006 4:06 PM
> >> > To: harmony-dev@incubator.apache.org
> >> > Subject: Re: [build] Building on Eclipse - FYI
> >> >
> >> > Hi Nathan,
> >> >
> >> > Yes - I was trying to run the enitre build in Eclipse and this is
> >> always
> >> > my
> >> > preferred method of building.  There is at least one other extra step
> >> > apart
> >> > from the one discussed in this thread so I think some additional
> >> > documentation would be useful.
> >> >
> >> > Thanks,
> >> >
> >> > Sian
> >> >
> >> >
> >> >
> >> > On 25/10/06, Nathan Beyer <nbeyer@gmail.com> wrote:
> >> > >
> >> > > Are you referring to running the build scripts via Eclipse? Just
> >> > > wanted to make sure I understand.
> >> > >
> >> > > Personally, I only import the module projects one at a time and run
> >> > > the full builds outside of Eclipse, so I've never tried this.
> >> Perhaps
> >> > > some additional documentation on using Eclipse in this fashion.
> This
> >> > > might be helpful additionally.
> >> > >
> >> > > On 10/24/06, Sian January <sianjanuary@googlemail.com> wrote:
> >> > > > Hello,
> >> > > >
> >> > > > I encountered a problem today building on Eclipse, and I just
> >> > thought
> >> > > I'd
> >> > > > post about it here in case anyone sees the same problem in the
> >> > > future.  I
> >> > > > was getting the error:
> >> > > >
> >> > > >
> >> > > > BUILD FAILED
> >> > > > *
> >> > > >
> >> > > > C:\eclipse32harmony\eclipse\workspace\Harmony\build.xml:108: The
> >> > > following
> >> > > > error occurred while executing this line:
> >> > > >
> >> > > >
> >> > C:\eclipse32harmony\eclipse\workspace\Harmony\make\build-java.xml
> :127:
> >> > > The
> >> > > > Eclipse compiler class for Ant could not be found. Please place
> >> the
> >> > ECJ
> >> > > JAR
> >> > > > in ANT_HOME/lib. The JAR can copied from
> >> > > CLASSLIB_TRUNK/depends/jars/ecj_3.2
> >> > > > folder after the fetch-depends target has been run.
> >> > > > *
> >> > > >
> >> > > > The solution to this is to copy ecj_3.2.jar into
> >> > > > ..\plugins\org.apache.ant_1.6.5\lib and *also* change the Ant
> >> > settings
> >> > > to
> >> > > > include this jar (Window > Preferences > Ant > Runtime then
> select
> >> > > 'Global
> >> > > > Entries' then 'Add External Jars' and add ecj_3.2.jar from the
> >> > > > org.apache.ant_1.6.5\lib directory).
> >> > > >
> >> > > > I don't know if many people build on Eclipse, and I know there
> >> have
> >> > been
> >> > > > some conversations about having too many instructions on the
> >> > website,
> >> > > but
> >> > > > since the steps are slightly different for Eclipse I wondered if
> >> it
> >> > > might be
> >> > > > worth augmenting the instructions or adding some Eclipse-specific
> >> > ones
> >> > > at
> >> > > > some point?
> >> > > >
> >> > > > Sian
> >> > > >
> >> > > > --
> >> > > > Sian January
> >> > > >
> >> > > > IBM Java Technology Centre, UK
> >> > > >
> >> > > >
> >> > >
> >> >
> >> >
> >> >
> >> > --
> >> > Sian January
> >> >
> >> > IBM Java Technology Centre, UK
> >> >
> >>
> >>
> >>
> >> --
> >> Sian January
> >>
> >> IBM Java Technology Centre, UK
> >>
> >
> >
> >
>


-- 
Sian January

IBM Java Technology Centre, UK

------=_Part_61573_1437798.1162213606571--