harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Pavel Ozhdikhin (JIRA)" <j...@apache.org>
Subject [jira] Commented: (HARMONY-2150) [doc] getting_started.html is outdated
Date Tue, 14 Nov 2006 06:17:39 GMT
    [ http://issues.apache.org/jira/browse/HARMONY-2150?page=comments#action_12449579 ] 
            
Pavel Ozhdikhin commented on HARMONY-2150:
------------------------------------------

1st paragraph:
Text:
The Dynamic Runtime Layer (DRL) is a clean-room ...
Comment:
There is no DRL in Harmony, only DRLVM.
Suggested text:
The Dynamic Runtime Layer Virtual Machine (DRLVM) is a clean-room implementation of the VM
for the Java 2 Platform,...

"Overview" section:
Text: ...please write to the mailing list or add your issue to the Troubleshooting listing.

Comment: Troubleshooting listing looks strange - do we really have such listing? I also prefer
the word "page" instead of "listing" because "listing" usually stands for output of some program,
a code dump etc.

Text: ... Wiki command-line options listing
Comment: Again, the word "listing".

Section "Running an Application":
Text:  The scenario uses the Hello.class Java* class distributed with the product as the sample
Java* application. 
Comment: The DRLVM build does not contain Hello.class anymore. A user need to run his own
application.

Text:
On Linux*, make sure that you can run applications and load dynamic libraries from the current
directory. For example: 
export PATH=.:${PATH}
export LD_LIBRARY_PATH=${PWD}:${LD_LIBRARY_PATH}
Comment:
I think this text is not needed anymore. On Linux I can start DRLVM without setting this manually.
I'm not sure about further note about ICC libraries.

Section "Running an Application in Eclipse":
Text:
In the project workspage, create a new Java class. For example, to get a class that prints
Hello World, you can create a HelloWorld class with the the public static void main(String[]
args) option selected. After the class is created successfully, the workspace gets updated.

Comment:
This text is too wordy for an experienced programmer and too brief for a newbie. Either write:
  In the project workspage, create HelloWorld class with the public static void main(String[]
args) method containing the following code:
    int i=18;
    System.out.println("Hello, World!");
or repeate step-by-step instruction from the original version with the menu items etc.

Section "Configuring VM Operation ":
Why do we need this section if we give a link to the Wiki command-line options page in the
overview?

I think this page also need to be reviewed by someone who knows more abou debugging using
DRLVM (Gregory, Eugeny?)


> [doc] getting_started.html is outdated
> --------------------------------------
>
>                 Key: HARMONY-2150
>                 URL: http://issues.apache.org/jira/browse/HARMONY-2150
>             Project: Harmony
>          Issue Type: Bug
>          Components: Website/Documentation
>            Reporter: Alexei Fedotov
>         Attachments: getting_started.patch
>
>
> Pavel Ozhdikhin wrote at
> http://mail-archives.apache.org/mod_mbox/incubator-harmony-dev/200611.mbox/%3c469bff730611080622p8c04144yaadff2bc4a53cb58@mail.gmail.com%3e
> The document  http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started.html
is 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
> Mikhail added at
> http://mail-archives.apache.org/mod_mbox/incubator-harmony-dev/200611.mbox/%3cbc79dd600611080702w5f725ac6lf43c029c755aa2a4@mail.gmail.com%3e
> 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..

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message