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:[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