On 11/9/06, Morozova, Nadezhda <[EMAIL PROTECTED]> wrote:
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.
We already have one page having links to the resources about DRLVM:
http://incubator.apache.org/harmony/subcomponents/drlvm/index.html
Why do you think we need another one?
+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?
I think we can describe basic options for every component there. Only those
that might be interesting for any user. The place for other options is in
the run-time help or Developer's Guide for a component.
Thanks,
Pavel
Thank you,
Nadya Morozova
-----Original Message-----
From: news [mailto:[EMAIL PROTECTED] 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:[EMAIL PROTECTED]
> 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 <[EMAIL PROTECTED]> 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
