harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Morozova, Nadezhda" <nadezhda.moroz...@intel.com>
Subject [drlvm][doc] new version of Doxygen docs published <WAS: RE: fix comments in vmcore external interface headers>
Date Thu, 15 Mar 2007 18:14:55 GMT
Hi all,
I've deployed a fresher version of the Doxygen documentation generated
from DRLVM sources [1]. I've used the latest fixes from HARMONY-2814 and
further improved the infrastructure. 
There are several open JIRAs with, but most commonly without, patches
that improve our documentation. I'll be looking at those and
regenerating docs as soon as some new comments get added. More patches
welcome ;)
I've also added simple instructions on generating Doxygen docs locally
[1], see Regenerating the Reference. You can now easily test the
comments you write. 

[1] http://harmony.apache.org/subcomponents/drlvm/DoxygenStart.html 

Cheers, 
Nadya
 
>-----Original Message-----
>From: Konovalova, Svetlana [mailto:svetlana.konovalova@intel.com]
>Sent: Friday, March 02, 2007 3:10 PM
>To: dev@harmony.apache.org
>Subject: [drlvm][doc] fix comments in vmcore external interface headers
><was:RE: [doxygen][doc] commenting bkms draft published on wiki>
>
>Dear all,
>
>Many source header files for generating readable Doxygen
>reference materials [10] lack ample and well-formatted comments. Our
aim
>is to get easily readable, complete and useful reference for DRLVM
>Interface Reference and Java class library reference.
>In this connection, I've opened the following JIRAs including
>suggestions on improving Doxygen output. Would be great if you could
>find time to look through them and provide patches. The code commenting
>BKMs [11] can be useful.
>
>[1] http://issues.apache.org/jira/browse/HARMONY-3262
>    Covers VM_Common interface header files
>
>[2] http://issues.apache.org/jira/browse/HARMONY-3263
>    Covers VM_JIT and VM_EM interface header files
>
>[3] http://issues.apache.org/jira/browse/HARMONY-3264
>    Covers VM_Interpreter interface header files
>
>[4] http://issues.apache.org/jira/browse/HARMONY-3273
>    Covers VM_GC interface and VM_Thread interface header files
>
>[5] http://issues.apache.org/jira/browse/HARMONY-3274
>    Covers JNI and JVMTI interface header files
>
>[6] http://issues.apache.org/jira/browse/HARMONY-3275
>    Covers Execution manager external interface headers
>
>[7] http://issues.apache.org/jira/browse/HARMONY-3277
>    Covers Thread manager external interface headers
>
>[8] http://issues.apache.org/jira/browse/HARMONY-3278
>    Covers Garbage collector and Execution engine external interface
>headers
>
>[9] http://issues.apache.org/jira/browse/HARMONY-3284
>    Covers OS portability layer external interface
>
>
>Best regards,
>Sveta
>
>[10]
>http://harmony.apache.org/subcomponents/drlvm/doxygen/intf/html/index.h
t
>ml
>[11] http://wiki.apache.org/harmony/Code_Commenting
>
>
>
>-----Original Message-----
>From: Konovalova, Svetlana
>Sent: Wednesday, February 28, 2007 1:49 PM
>To: 'dev@harmony.apache.org'
>Subject: [drlvm]fix comments in vmcore external interface headers
><was:RE: [doxygen][doc] commenting bkms draft published on wiki>
>
>
>>You can get involved in one of the following areas or open new JIRAs
>>with your own suggestions/fixes:
>
>Trying to improve scarce comments in VM Core external interface
headers,
>I've opened the following JIRAs with improvement suggestions:
>
>[1] http://issues.apache.org/jira/browse/HARMONY-3262
>    Covers VM_Common interface header files
>[2] http://issues.apache.org/jira/browse/HARMONY-3263
>    Covers VM_JIT and VM_EM interface header files
>[3] http://issues.apache.org/jira/browse/HARMONY-3264
>    Covers VM_Interpreter interface header files
>
>Would be great if you could find time to look through the proposed
>changes and provide patches. :)
>
>Best regards,
>Sveta
>-----Original Message-----
>From: Morozova, Nadezhda [mailto:nadezhda.morozova@intel.com]
>Sent: Tuesday, February 20, 2007 7:33 PM
>To: dev@harmony.apache.org
>Subject: [doxygen][doc] commenting bkms draft published on wiki
>
>Hi everyone,
>I have posted several tips/suggestions [1] about writing nice code
>comments in source header files for generating readable Doxygen
>reference materials [2]. These guidelines are to define some ground
>formatting and stylistic rules that would be good to follow when adding
>comments to code.
>Your feedback is most welcome because together we can find the best
>solutions.
>
>The current reference documentation is often incomplete, out-of-date
>and/or not formatted correctly, which greatly decreases its usefulness.
>Volunteers are very welcome to supply patches with more commented code.
>The BKMs, samples and quoted bugs are mostly based on DRLVM materials,
>so classlib input is also welcomed.
>
>You can get involved in one of the following areas or open new JIRAs
>with your own suggestions/fixes:
>
>[3] improving formatting of code comments so that Doxygen parses them
>correctly
>[4] enabling creation of structurally meaningful doc bundles and adding
>intros (mainpage content) to each bundle
>[5] beautifying Doxygen output
>[6] monitoring quality and quantity of available Doxygen documentation
>
>Thanks,
>Nadya Morozova
>
>[1] http://wiki.apache.org/harmony/Code_Commenting
>[2] http://harmony.apache.org/subcomponents/drlvm/DoxygenStart.html
>[3] https://issues.apache.org/jira/browse/HARMONY-2802
>[4] https://issues.apache.org/jira/browse/HARMONY-2814
>[5]
http://wiki.apache.org/harmony/Doxygen_Docs_Look%26Feel_Improvements
>
>[6] http://wiki.apache.org/harmony/DRLVM_Documentation_Quality

Mime
View raw message