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: Re: [doc][drlvm] The document "Getting started with DRL" is outdated
Date Thu, 09 Nov 2006 11:38:19 GMT
Egor, 
+1 for 
Just idea: "Getting Started" may contain a collection of links to the
main website and other resources with short descriptions ("Site Map"
or something) so that people are comfortable floating around in the web.

+1 for 
* preparing the "Commonly Used Options for DRLVM" (omitting the word
  "supported" intentionally)
Question on this one: will the page contain vm-only options? What about
JIT, GC, other? I'd have them all in one place, but we have separate
docs for EM/jit stuff. What do you say?

Thank you, 
Nadya Morozova
 
-----Original Message-----
From: news [mailto:news@sea.gmane.org] On Behalf Of Egor Pasko
Sent: Thursday, November 09, 2006 5:51 AM
To: harmony-dev@incubator.apache.org
Subject: Re: [doc][drlvm] The document "Getting started with DRL" is
outdated

On the 0x21B day of Apache Harmony Nadezhda Morozova wrote:
> All,
> I'd like to share everyone's grief at the sight of outdated Getting
> Started document. However, I'd not hurry to eliminate the page as
such.
> We might reconsider some of its contents, change structure, and update
> individual bits, but please think carefully before removing the page.
> 
> I think Getting Started (as the title shows) is aimed to help a newbie
> work with our vm. I know that many primarily interested in other
things
> - conformance, architecture, internal specifics. However, we should
also
> think how the vm is used. AFAIK, Getting started is now the *only* doc
> that tries to show how to use our vm. You tell people how to download
> and build, but almost nothing about how to run and configure (with the
> exception of EM/JIT). 
> 
> My suggestion would be to think of what you want to tell people about
> usage - with or without eclipse specifics. And store this info on the
> page. I know it is hard - and I offer my help and support in this
> burdensome initiative. Any thoughts? i might be inobjective and
> emotional :)

Nadya,

I believe, almost everyone coming across Harmony knows how to use
J5SE. We are striving for this compatibility, and we are happy that
all DRLVM-specific pecularities are gone.

So, I vote for:
* removing the "Getting Started" (also because of irritating windows
  screenshots:)
* preparing the "Commonly Used Options for DRLVM" (omitting the word
  "supported" intentionally)

Just idea: "Getting Started" may contain a collection of links to the
main website and other resources with short descriptions ("Site Map"
or something) so that people are comfortable floating around in the web.

> -----Original Message-----
> From: Mikhail Fursov [mailto:mike.fursov@gmail.com] 
> Sent: Wednesday, November 08, 2006 6:03 PM
> To: harmony-dev@incubator.apache.org
> Subject: Re: [doc][drlvm] The document "Getting started with DRL" is
> outdated
> 
> It's not a hard to write a documenation once, it's hard to support it
:)
> More problems:
> 1) -Xem options are obsolete.
> 2) -Xjit options are also obsolete.
> 3) Do we really need this page today? AFAIU users expect Harmony VM is
> able
> to run the same apps as RI..
> ?
> 
> On 11/8/06, Pavel Ozhdikhin <pavel.ozhdikhin@gmail.com> wrote:
> >
> > Hello all,
> > I've read through the "Getting Started with
> > DRL<
> >
>
http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started.
> html
> > >"
> > document on the Harmony web and found it completely outdated, for
> example:
> >
> >
> >    - the term DRL is used instead of DRLVM
> >    - eclipse.bat and eclipse.sh are obsolete - we don't need them
> anymore
> >    to run Eclipse. It can be started with DRLVM the same way as with
> any
> > other
> >    VM.
> >    - We don't need to set PATH and LD_LIBRARY_PATH anymore, at least
> on
> >    Windows/MSVC
> >    - ij was renamed to java
> >
> > We took a big step to unification with other Java VMs and now
> > we don't need anything specific to run Eclipse, for example. After
> > removing
> > all irrelevant info the document would contain only the list of
> > command-line
> > options. I think we can move this list to a separate document (Wiki,
> > Developer's Guide?) and remove the "Getting Started" itself.
> >
> > Any opinions?
> >
> > Thanks,
> > Pavel
> > <
> >
>
http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started.
> html
> > >
> >
> >
> 
> 
> -- 
> Mikhail Fursov
> 

-- 
Egor Pasko

Mime
View raw message