Sian January wrote:
> 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.
Agreed.
> 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.
Agreed. It should be about IDEA anyway :)
> 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...
I agree that our basic "getting started with Harmony" stuff should be
relatively independent of any IDE, but have links with material for
specific IDE's if people contribute the material.
What I thought I was responding to was the idea that we we should limit
the amount of Eclipse tutorial in our *document about Eclipse*. Sorry
if I misunderstood.
geir
>
> Thanks,
>
> Sian
>
>
> On 30/10/06, *Geir Magnusson Jr.* <geir@pobox.com
> <mailto: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
> <mailto: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
> <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
> <mailto:sianjanuary@googlemail.com>]
> >> Sent: Friday, October 27, 2006 3:34 PM
> >> To: harmony-dev@incubator.apache.org
> <mailto: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
> <mailto: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
> <mailto:sianjanuary@googlemail.com>]
> >> > Sent: Thursday, October 26, 2006 4:06 PM
> >> > To: harmony-dev@incubator.apache.org
> <mailto: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
> <mailto: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
> <mailto: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
|