harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Morozova, Nadezhda" <nadezhda.moroz...@intel.com>
Subject RE: [build] Building on Eclipse - FYI
Date Mon, 30 Oct 2006 15:45:54 GMT
+1

Thank you, 
Nadya Morozova
 

-----Original Message-----
From: Konovalova, Svetlana [mailto:svetlana.konovalova@intel.com] 
Sent: Monday, October 30, 2006 5:05 PM
To: harmony-dev@incubator.apache.org
Subject: RE: [build] Building on Eclipse - FYI

Well, my 2cents:

>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.  

I'm with you here. It goes without saying that when a person comes
across a long description, he/she just skips it. In our documentation we
should provide DRLVM-related information only. My suggestions are:
1) To remove "just-using-Eclipse" information from the "Getting Started
with DRLVM" doc
[http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started
] to make the doc purely DRLVM-oriented;
2) To add certain links from the doc to external sources providing
general information about Eclipse.

How about that?

AFAIU we should get two docs guiding the Eclipse users:
1) The "Getting Started with DRLVM" doc including step-by-step
instructions on running a Java application in the Eclipse environment.
[http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started
];
2) The "Developing Apache Harmony class library code with Eclipse" page
providing instructions to help users set up Eclipse to develop Java code
in Apache Harmony.  
[http://incubator.apache.org/harmony/subcomponents/classlibrary/dev_ecli
pse.html]

Any comments?
    
Cheers,
Sveta

-----Original Message-----
From: Sian January [mailto:sianjanuary@googlemail.com] 
Sent: Monday, October 30, 2006 4:07 PM
To: harmony-dev@incubator.apache.org; geir@pobox.com
Subject: Re: [build] Building on Eclipse - FYI

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_eclip
se.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

Mime
View raw message