RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-17 Thread Morozova, Nadezhda
! On 11/16/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Andrey, I personally like the metric. It does not always reflect the proportional amount of documentation, but the files at the top of the list (the worst files) indeed require attention :) I guess the metric shows both

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-16 Thread Morozova, Nadezhda
Engineering -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] Sent: Friday, November 03, 2006 6:26 PM To: harmony-dev@incubator.apache.org Subject: RE: Re: [doc] What should be improved in DRLVM Doxygen documentation? Egor, I agree with you on the idea

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-16 Thread Morozova, Nadezhda
and put on harmonytest.org (or even Wiki) regularly? It should encourage people (like me) to document sources better. Or it is too much effort? With best regards, Alexei Fedotov, Intel Java XML Engineering -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-16 Thread Morozova, Nadezhda
text. So do I :-) Thanks! On 11/16/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Andrey, I personally like the metric. It does not always reflect the proportional amount of documentation, but the files at the top of the list (the worst files) indeed require attention :) I guess the metric

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-13 Thread Morozova, Nadezhda
Harmony Pavel Ozhdikhin wrote: 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

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-13 Thread Morozova, Nadezhda
is outdated On the 0x21C day of Apache Harmony Pavel Ozhdikhin wrote: 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

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-13 Thread Morozova, Nadezhda
Sent: Thursday, November 09, 2006 5:33 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc][drlvm] The document Getting started with DRL is outdated On the 0x21C day of Apache Harmony Pavel Ozhdikhin wrote: On 11/9/06, Morozova

RE: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-13 Thread Morozova, Nadezhda
PROTECTED] On Behalf Of Egor Pasko Sent: Thursday, November 09, 2006 5:33 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc][drlvm] The document Getting started with DRL is outdated On the 0x21C day of Apache Harmony Pavel Ozhdikhin wrote: On 11/9/06, Morozova, Nadezhda [EMAIL

RE: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-13 Thread Morozova, Nadezhda
-Original Message- From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] Sent: Monday, November 13, 2006 5:14 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc][drlvm] The document Getting started with DRL is outdated what's the link we're talking about? Morozova, Nadezhda wrote: What

RE: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-13 Thread Morozova, Nadezhda
there, anyway. geir Morozova, Nadezhda wrote: http://incubator.apache.org/harmony/subcomponents/drlvm/getting_started. html#Disclaimer http://incubator.apache.org/harmony/subcomponents/drlvm/developers_guide .html - these seem to have apache and intel copyright (can be resolved) + the Unicode disclaimer

RE: [doc] site.css

2006-11-13 Thread Morozova, Nadezhda
My two cents below. Thank you, Nadya Morozova -Original Message- From: Ivanov, Alexey A [mailto:[EMAIL PROTECTED] Sent: Monday, November 13, 2006 5:56 PM To: harmony-dev@incubator.apache.org Subject: [doc] site.css Hi all, I've updated formatting of definition lists DL on site:

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-13 Thread Morozova, Nadezhda
section here. Thanks, Pavel On 11/13/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Successfully added a patch to fix getting Started outdated content to http://issues.apache.org/jira/browse/HARMONY-2150. The patch is not final - need help to add more content. The current structure

[doc] Anybody tried DRLVM+Eclipse and can share? [WAS: Re: FW: [build] Building on Eclipse - FYI]

2006-11-12 Thread Morozova, Nadezhda
Resending the email. Really sad that we haven't received any feedback yet. Thank you, Nadya Morozova -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] Sent: Thursday, November 09, 2006 11:11 PM To: harmony-dev@incubator.apache.org Subject: Anybody tried DRLVM

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-10 Thread Morozova, Nadezhda
Of Egor Pasko Sent: Thursday, November 09, 2006 5:33 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc][drlvm] The document Getting started with DRL is outdated On the 0x21C day of Apache Harmony Pavel Ozhdikhin wrote: On 11/9/06, Morozova, Nadezhda [EMAIL

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-10 Thread Morozova, Nadezhda
To: harmony-dev@incubator.apache.org Subject: Re: [doc][drlvm] The document Getting started with DRL is outdated On the 0x21C day of Apache Harmony Pavel Ozhdikhin wrote: On 11/9/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Egor, +1 for Just idea

RE: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-10 Thread Morozova, Nadezhda
is outdated Morozova, Nadezhda wrote: Alexei, Tutorials might be fine for mature projects, but I do not think ours is ready for a big flow of users yet, that would require a tutorial. So +1 for having a nice good tutorial ... one day. If there are volunteers to write the tutorial now, I'd

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-10 Thread Morozova, Nadezhda
] The document Getting started with DRL is outdated On the 0x21C day of Apache Harmony Pavel Ozhdikhin wrote: On 11/9/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Egor, +1 for Just idea: Getting Started may contain a collection of links

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-09 Thread Morozova, Nadezhda
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

RE: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-09 Thread Morozova, Nadezhda
contains no more than two lines. This page has fourty lines of legal staff. Is it really needed? Thanks! On 11/8/06, Morozova, Nadezhda [EMAIL PROTECTED] 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

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-09 Thread Morozova, Nadezhda
/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

RE: [jira] Good issue resolution guideline (was: [classlib]volunteer to supply patches for old JIRAs)

2006-11-09 Thread Morozova, Nadezhda
, Alexey. Best regards, Sveta -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] Sent: Wednesday, November 08, 2006 11:18 AM To: harmony-dev@incubator.apache.org Subject: RE: [jira] Good issue resolution guideline (was: [classlib]volunteer to supply patches for old JIRAs

Anybody tried DRLVM+Eclipse and can share? [WAS: Re: FW: [build] Building on Eclipse - FYI]

2006-11-09 Thread Morozova, Nadezhda
Folks, Has anybody tried working with DRLVM in Eclipse? did you have to screw it before it ran ok? Do you have anything to share? Let's write a doc! Background We've been trying to gather useful info on working with Eclipse and our code base. Eclipse+classlib page has been updated, see JIRA

RE: [build] Building on Eclipse - FYI

2006-11-09 Thread Morozova, Nadezhda
Sian, As I understand, thanks to your patches, we now have a nice webpage that describes generics + classlib specifics, with a few items for drlvm. This is an achievement as it is, so perhaps, we can hold off rolling back to classlib only :) I sent an email just now to ask people whether anybody

RE: Re: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-09 Thread Morozova, Nadezhda
On the 0x21C day of Apache Harmony Pavel Ozhdikhin wrote: 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

RE: [doc][drlvm] The document Getting started with DRL is outdated

2006-11-08 Thread Morozova, Nadezhda
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

RE: FW: [build] Building on Eclipse - FYI

2006-11-08 Thread Morozova, Nadezhda
About strange things in the website structure: good catch! I guess the site is just in the middle of some transition: dev_eclipse_movie.html and dev_eclipse.html probably should be under documentation, not under subcomponents/classlib. And build_classlib is just outdated and should not be there

RE: [jira] Good issue resolution guideline (was: [classlib]volunteer to supply patches for old JIRAs)

2006-11-07 Thread Morozova, Nadezhda
Alexey, Would be great if there we some page that had a link to the page; otherwise, you cannot find it from within wiki, only from the link in your mail :( Thank you, Nadya Morozova -Original Message- From: Alexey Petrenko [mailto:[EMAIL PROTECTED] Sent: Tuesday, November 07, 2006

RE: Re: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-07 Thread Morozova, Nadezhda
Java XML Engineering -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] Sent: Friday, November 03, 2006 6:26 PM To: harmony-dev@incubator.apache.org Subject: RE: Re: [doc] What should be improved in DRLVM Doxygen documentation? Egor, I agree with you

RE: Re: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-07 Thread Morozova, Nadezhda
: [doc] What should be improved in DRLVM Doxygen documentation? On the 0x21A day of Apache Harmony Mikhail Fursov wrote: On 11/7/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: +1 For in much wisdom is much grief: and he that increaseth knowledge increaseth sorrow I'm also +1 to document

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-07 Thread Morozova, Nadezhda
Mikhail, Do you think it is part of 'culture' to update a comment when changing behavior of its function? Otherwise, you can erase all comments altogether since you don't guarantee they're up-to-date :) Thank you, Nadya Morozova -Original Message- From: Mikhail Fursov [mailto:[EMAIL

RE: [jira] Good issue resolution guideline (was: [classlib]volunteer to supply patches for old JIRAs)

2006-11-07 Thread Morozova, Nadezhda
are welcome. SY, Alexey 2006/11/7, Morozova, Nadezhda [EMAIL PROTECTED]: Alexey, Would be great if there we some page that had a link to the page; otherwise, you cannot find it from within wiki, only from the link in your mail :( Thank you, Nadya Morozova -Original Message- From: Alexey

RE: [doc][drlvm] new docs added - JIT compiler

2006-11-06 Thread Morozova, Nadezhda
, Nadya Morozova -Original Message- From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] Sent: Tuesday, October 31, 2006 2:18 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc][drlvm] new docs added - JIT compiler oh, thankyou thankyou thankyou Morozova, Nadezhda wrote: Yeah

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-03 Thread Morozova, Nadezhda
Great to hear that! Let me know if you need help. Thank you, Nadya Morozova -Original Message- From: Leviev, Ilia A [mailto:[EMAIL PROTECTED] Sent: Friday, November 03, 2006 3:35 PM To: harmony-dev@incubator.apache.org Subject: RE: [doc] What should be improved in DRLVM Doxygen

RE: Re: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-03 Thread Morozova, Nadezhda
Egor, I agree with you on the idea of simplicity: documented vs. non-documented. An additional point: do you think we need/want to evaluate quality of comments? we could check for required Doxygen tags in certain elements. For example, a function is almost certain to include @param and @return.

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-03 Thread Morozova, Nadezhda
documentation size. It would also decrease a number of well documented pages on garbage collection, since new GCs don't have as much comments in their code as old GC V4. [NM] yeah, I read the news :) Thank you for nice catches, Alexei On 11/2/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Wow! Alexei

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-03 Thread Morozova, Nadezhda
Recommended well-documented source code (personal preference) Ongoing development: Class.h - see JIRA-1558 for latest patch Done: in vm - StackIterator.h, Verifier.h, vm_gc.h; in jit - jet, ControlFlowGraph.h; JPDA sources... Thank you, Nadya Morozova -Original Message- From: Alexei

RE: [drlvm] more self-dependent VM tasks, newbies welcome

2006-11-02 Thread Morozova, Nadezhda
] more self-dependent VM tasks, newbies welcome Nadya, Thanks for the links, I added new subpage to TODO_List_for_DRLVM. 2006/11/2, Morozova, Nadezhda [EMAIL PROTECTED]: Alexey, Do you think you can post these on Wiki? We actually have several pages there that can help arrange and store

RE: [doc]Please help to remove outdated info from the site

2006-11-02 Thread Morozova, Nadezhda
PROTECTED] Sent: Thursday, November 02, 2006 2:21 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc]Please help to remove outdated info from the site Nice - buy why not put the tasks in JIRA? Morozova, Nadezhda wrote: Thanks all who helped with the what can we do now page - the new page

RE: [classlib][portlib] Docs?

2006-11-02 Thread Morozova, Nadezhda
it is still to be done. Morozova, Nadezhda wrote: Not that I know of :( bits of things are in the devguide, maybe. But you probably won't find that of much notice. Anyone, please tell me it's not true! Thank you, Nadya Morozova -Original Message- From: Alexey

RE: [doc] What should be improved in DRLVM Doxygen documentation?

2006-11-02 Thread Morozova, Nadezhda
Wow! Alexei, great start! ... and so many pages marked with 0 rank. I really appreciate your effort - it sets me back on earth and to work. I hope this rating would also make owners of code more ambitious, and would inspire them to write more/better comments to get a better rating :) Question on

RE: [classlib][portlib] Docs?

2006-11-01 Thread Morozova, Nadezhda
Not that I know of :( bits of things are in the devguide, maybe. But you probably won't find that of much notice. Anyone, please tell me it's not true! Thank you, Nadya Morozova -Original Message- From: Alexey Petrenko [mailto:[EMAIL PROTECTED] Sent: Wednesday, November 01, 2006

RE: [doc] No Doxygen reference for code :(

2006-11-01 Thread Morozova, Nadezhda
mean? Thank you, Nadya Morozova -Original Message- From: Paulex Yang [mailto:[EMAIL PROTECTED] Sent: Wednesday, November 01, 2006 4:33 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc] No Doxygen reference for code :( Morozova, Nadezhda wrote: Hi everyone, I've noticed

RE: [doc] No Doxygen reference for code :(

2006-11-01 Thread Morozova, Nadezhda
/browse/HARMONY-2024, so committers could now put documentation to the web site and everyone could contribute to the documentation quality. With best regards, Alexei Fedotov, Intel Java XML Engineering -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] Sent: Tuesday, October

RE: [doc] No Doxygen reference for code :(

2006-11-01 Thread Morozova, Nadezhda
: http://incubator.apache.org/harmony/subcomponents/classlibrary/index.htm l 2006/11/1, Paulex Yang [EMAIL PROTECTED]: Morozova, Nadezhda wrote: Hi everyone, I've noticed that there's no API reference documentation for Harmony code - generated by Doxygen/Javadoc. I guess many will agree

RE: [doc] No Doxygen reference for code :(

2006-11-01 Thread Morozova, Nadezhda
explanation. How about we put the API document in each subcomponents(classlib/drlvm/jchevm), but also add their link in documentation/documentation.html? 2006/11/1, Paulex Yang [EMAIL PROTECTED]: Morozova, Nadezhda wrote: Hi everyone, I've noticed that there's no API reference documentation

RE: [drlvm] more self-dependent VM tasks, newbies welcome

2006-11-01 Thread Morozova, Nadezhda
Alexey, Do you think you can post these on Wiki? We actually have several pages there that can help arrange and store such development items: Starting point, choose your subpage http://wiki.apache.org/harmony/TODO_List_for_DRLVM Sample http://wiki.apache.org/harmony/JIT_Development_Tasks Wiki

RE: [doc]Please help to remove outdated info from the site

2006-11-01 Thread Morozova, Nadezhda
Thanks all who helped with the what can we do now page - the new page is shorter but none the less useful. My suggestion is to add more links to the page. It now only links to the applist. More candidates: classlib status page [1], wiki drlvm todo items [2], website doc development [3]. What

RE: [doc][drlvm] new docs added - JIT compiler

2006-10-31 Thread Morozova, Nadezhda
-Original Message- From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] Sent: Tuesday, October 31, 2006 2:18 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc][drlvm] new docs added - JIT compiler oh, thankyou thankyou thankyou Morozova, Nadezhda wrote: Yeah! No problem, I was just thinking

RE: [doc] No Doxygen reference for code :(

2006-10-31 Thread Morozova, Nadezhda
it, but Doxygen's main idea is to get docs straight from code. So any change to doxygen's input should probably be a patch in JIRA. We've had such patches before. With best regards, Alexei Fedotov, Intel Java XML Engineering -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL

RE: [build] Building on Eclipse - FYI

2006-10-31 Thread Morozova, Nadezhda
it as it is? Is it actually out of date? Cheers, Sveta -Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] Sent: Monday, October 30, 2006 6:45 PM To: harmony-dev@incubator.apache.org Subject: RE: [build] Building on Eclipse - FYI Sveta, I've taken a brief

[doc][drlvm] new docs added - JIT compiler

2006-10-30 Thread Morozova, Nadezhda
All, New documents have been added to HARMONY-2003. These are a description of the Jitrino.OPT and .JET compilers, with a supplementary doc on the pipeline management framework inside the JITs. The docs describe the architecture, processes and usage of the components. It would be great if

RE: [build] Building on Eclipse - FYI

2006-10-30 Thread Morozova, Nadezhda
Sveta, I've taken a brief look at the patch, and I like most of your corrections. The page looks neater this way, and holds important data. One question: can't we say that some of the tips given on the page apply to harmony code in general, not just classlib? So a side idea would be to have one

RE: [build] Building on Eclipse - FYI

2006-10-30 Thread Morozova, Nadezhda
+1 Thank you, Nadya Morozova -Original Message- From: Konovalova, Svetlana [mailto:[EMAIL PROTECTED] Sent: Monday, October 30, 2006 5:05 PM To: harmony-dev@incubator.apache.org Subject: RE: [build] Building on Eclipse - FYI Well, my 2cents: My concern is that if there is too much

RE: [build] Building on Eclipse - FYI

2006-10-30 Thread Morozova, Nadezhda
Geir, about your suggestion I think that if we have an eclipse document, and the info is accurate, I say why not? I also think that the more docs the better :) issues that I see with this particular doc: - info is not always up-to-date: old cmd options, old java executable name, many other

RE: [doc][drlvm] new docs added - JIT compiler

2006-10-30 Thread Morozova, Nadezhda
, heck, I don't want to download each of those separate thingies... I just want a zip or tgz of them... easier to handle... So please? :) geir Morozova, Nadezhda wrote: All, New documents have been added to HARMONY-2003. These are a description of the Jitrino.OPT and .JET compilers

RE: [doc] List of current open doc issues

2006-10-26 Thread Morozova, Nadezhda
Perhaps, you can store it on JIRA? I do get an email a third time, and none of them has an attachment:( Thank you, Nadya Morozova -Original Message- From: Konovalova, Svetlana [mailto:[EMAIL PROTECTED] Sent: Thursday, October 26, 2006 5:01 PM To: harmony-dev@incubator.apache.org

RE: [general] POLL : supported platforms

2006-10-25 Thread Morozova, Nadezhda
My two cents... I do not understand the lifecycle of this page. If I report today that my platform works OK, but the next commit brokes it, who will update the page? IMHO if the next commit breakes the work-ok-platform and if you notice it, why not to update the wiki page? Or you can let

RE: [general] POLL : supported platforms

2006-10-25 Thread Morozova, Nadezhda
updates. That's a job for the test results' collator. Regards, Tim Salikh Zakirov wrote: Morozova, Nadezhda wrote: My two cents... I do not understand the lifecycle of this page. If I report today that my platform works OK, but the next commit brokes it, who will update the page? IMHO

RE: [vote] Graduate Apache Harmony podling from the Incubator

2006-10-23 Thread Morozova, Nadezhda
+1 Thank you, Nadya Morozova -Original Message- From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] Sent: Friday, October 20, 2006 11:30 PM To: harmony-dev@incubator.apache.org Subject: [vote] Graduate Apache Harmony podling from the Incubator We're trying something a little

RE: Re: [drlvm] How to debug the drlvm with gdb?

2006-10-20 Thread Morozova, Nadezhda
Egor, You're a treasure keeper, so many useful tips :) As you mentioned yourself, this info should be on the website, and I side with you on this. We actually have some debugging tips already: http://incubator.apache.org/harmony/subcomponents/drlvm/debugging_VM_and _JIT.html However, they don't

RE: Re: [drlvm] How to debug the drlvm with gdb?

2006-10-20 Thread Morozova, Nadezhda
Egor, Thanks for a detailed an proactive response. Surely, I think we can start accumulating new content on Wiki - this is more visible and editable than patches to website. When we're done with the bulk of content, I'll migrate the stable stuff to the site. * Thaking the one above into

RE: Re: [drlvm] How to debug the drlvm with gdb?

2006-10-20 Thread Morozova, Nadezhda
] Sent: Friday, October 20, 2006 4:59 PM To: harmony-dev@incubator.apache.org Subject: Re: Re: [drlvm] How to debug the drlvm with gdb? On 10/20/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Summing up: the decision for now = Add new pages for Wiki = - Debugging on Linux - Egor has volunteered

RE: [drlvm] A list of drlvm enhancements and limitations

2006-10-18 Thread Morozova, Nadezhda
I side with all those who suggest that we write things down on Wiki. Grouping issues by component might also work out fine. Another suggestion: distinguish between Known Issues and TODOs - that is, between bugs and non-implemented features. I think this will allow us to see what needs to be

RE: Re: Hot to Write GC requires improvement

2006-10-18 Thread Morozova, Nadezhda
a little bit of advertising the tool which I personally consider the best for the purposes of documentation authoring. Morozova, Nadezhda wrote: About concern for updating resulting HTML and not the source TXT for Asciidoc-generated documents: However, for the How to Write a GC document, I do

[doc]too many building instructions?

2006-10-17 Thread Morozova, Nadezhda
Folks, I've had a strange impression just now that we have too many building instructions for Harmony sources: [1] http://incubator.apache.org/harmony/subcomponents/classlibrary/build_cla sslib.html Building Class Library only [2] http://incubator.apache.org/harmony/quickhelp_contributors.htm

RE: Re: Hot to Write GC requires improvement

2006-10-17 Thread Morozova, Nadezhda
Folks, Yes, I do have a newer version of the source file that produced the GC-howto document currently on the site - see attached. I am not sure we actually need to sync up with the original Asciidoc-input file. Will send a separate email with my thoughts soon. Thank you, Nadya Morozova

FW: [doc]too many building instructions?

2006-10-17 Thread Morozova, Nadezhda
-Original Message- From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] Sent: Tuesday, October 17, 2006 1:26 PM To: harmony-dev@incubator.apache.org Subject: [doc]too many building instructions? Folks, I've had a strange impression just now that we have too many building instructions for Harmony

RE: Re: Hot to Write GC requires improvement

2006-10-17 Thread Morozova, Nadezhda
Salikh, About your concern for updating resulting HTML and not the source TXT for Asciidoc-generated documents: I agree that technically Sveta's approach is not professional :) However, for the How to Write a GC document, I do not think that the issue is big enough because the doc seems quite

RE: Hot to Write GC requires improvement

2006-10-17 Thread Morozova, Nadezhda
Weldon, all, I've a question about the GC interface (just double-checking): We currently have gc_cc, gc_gen, and gcv4 folders in VM, corresponding to three different collectors, right? Do then all use an identical API? do they all work exactly as the doc describes? Thank you, Nadya Morozova

RE: Hot to Write GC requires improvement

2006-10-17 Thread Morozova, Nadezhda
improvement On 10/17/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Weldon, all, I've a question about the GC interface (just double-checking): We currently have gc_cc, gc_gen, and gcv4 folders in VM, corresponding to three different collectors, right? Coorect. Do then all use an identical

RE: [doc] no progress on patches for the website

2006-10-13 Thread Morozova, Nadezhda
Geir, I have a question: The Quick Help guides (with patches applied) now list the required and additional tools that are needed to get and build our sources. Do you think we can also include some sure-to-work configurations that are now discussed in thread [general] version of gcc and other

[doc] need help: lost classlib porting docs

2006-10-13 Thread Morozova, Nadezhda
Folks, I've a problem. We used to have the class library porting documentation generated automatically and stored in enhanced/classlib/trunk/doc/vm_doc. It is not there any more. I vaguely recollect that we had a decision to port the docs to the website. Is this done? The old place does not have

RE: [doc] need help: lost classlib porting docs

2006-10-13 Thread Morozova, Nadezhda
. so I believe you can find it in your local working copy. On 10/13/06, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Folks, I've a problem. We used to have the class library porting documentation generated automatically and stored in enhanced/classlib/trunk/doc/vm_doc. It is not there any more. I

RE: [doc] need help: lost classlib porting docs

2006-10-13 Thread Morozova, Nadezhda
, Morozova, Nadezhda [EMAIL PROTECTED] wrote: Thanks. But I think it would be also nice if the doc is available from the site somehow, like, via a link to the index.html file. Someone might just want the big picture without downloading the sources. And other docs might want to link to this one

RE: FW: Images missing from webpages

2006-10-12 Thread Morozova, Nadezhda
... will be there in next few hours... geir Morozova, Nadezhda wrote: Geir, I seem to have replied to a wrong address, and so the issue was not resolved :( could you please look below There's one webpage, the description of the thread manager, that has no graphics displayed with it ;( It would be great

RE: README.txt patch Was: [drlvm] NPE is thrown when the kernel tests are run on Windows at revision 448448

2006-10-06 Thread Morozova, Nadezhda
JIRA 1730 for these changes? [1] http://incubator.apache.org/harmony/quickhelp_users.html [2] http://incubator.apache.org/harmony/quickhelp_contributors.html Best regards, Nadya Morozova -Original Message- From: Fedotov, Alexei A Sent: Friday, October 06, 2006 12:23 AM To: Morozova

RE: README.txt patch Was: [drlvm] NPE is thrown when the kernel tests are run on Windows at revision 448448

2006-10-06 Thread Morozova, Nadezhda
in the README.txt to the website. geir Morozova, Nadezhda wrote: Thanks for the fix, Alexei. I think this is a good start for updating the README. I've looked at the current version, and many other things are out-of-date (such as ij as the name of our executable). Some things are also duplicated

RE: README.txt patch Was: [drlvm] NPE is thrown when the kernel tests are run on Windows at revision 448448

2006-10-06 Thread Morozova, Nadezhda
it on the website, and put a pointer in the README.txt to the website. geir Morozova, Nadezhda wrote: Thanks for the fix, Alexei. I think this is a good start for updating the README. I've looked at the current version, and many other things are out-of-date (such as ij as the name of our

RE: [doc] new Getting Started guides

2006-09-29 Thread Morozova, Nadezhda
... My two cents: The path to a component should end with component's status info - ideally it should give the newbie enough info not to search though harmony-dev mail archive or JIRA at all. Good point, but am not sure we're ready for it just now. I haven't found nice wiki pages for each

RE: [jira] Good issue resolution guideline (was: [classlib]volunteer to supply patches for old JIRAs)

2006-09-28 Thread Morozova, Nadezhda
+1 for Wiki. This is a more edit-friendly solution. I can also add a link to your Wiki page from the website - for people to know where to look for guidelines ;) Best regards, Nadya Morozova -Original Message- From: Alexey Petrenko [mailto:[EMAIL PROTECTED] Sent: Thursday,

RE: [classlib][drlvm][doc]Recommend to remove trunk\doc\kernel_doc and trunk\doc\vm_doc from svn repository.

2006-09-28 Thread Morozova, Nadezhda
Paulex, I agree to your suggestions on keeping the config files for generated docs only. As for And, maybe we can add a build-doc target in the classlib/trunk/build.xml to make document creation more handy. I fully side with that. Moreover, I'd suggest that we add such a target for DRLVM

RE: [classlib][doc]Recommend to remove trunk\doc\kernel_doc and trunk\doc\vm_doc from svn repository.

2006-09-28 Thread Morozova, Nadezhda
Do you think we can have the docs built on a regular basis (like, a script that triggers Doxygen build say 2 times a week + on demand to push updates if needed) and resulting docs stored on the website? This way, you don't have SVN versioning for auto-generated content and keep info available for

[website][doc] please fix wrong link to the developer's guide

2006-09-28 Thread Morozova, Nadezhda
Hi, There's a little glitch in website: DRLVM page links into SVN for the developer's guide though the site directory has the correct file. Could somebody please apply the fix attached to JIRA 1631 https://issues.apache.org/jira/browse/HARMONY-1631? Nadya Morozova

RE: [doc] new Getting Started guides

2006-09-26 Thread Morozova, Nadezhda
Geir, I double-checked the documentation.html page - it still has no site.css attached and does not display nicely. :( Best regards, Nadya Morozova -Original Message- From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] Sent: Tuesday, September 26, 2006 4:28 PM To:

RE: [doc] new Getting Started guides

2006-09-26 Thread Morozova, Nadezhda
6:47 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc] new Getting Started guides Do you mean : http://incubator.apache.org/harmony/documentation/documentation.html looks ok to me... will look closely at source later geir On Sep 26, 2006, at 10:27 AM, Morozova, Nadezhda wrote: Geir

RE: [doc] Why do we have boxes drawn around source now?

2006-09-22 Thread Morozova, Nadezhda
Geir, That's right, we have pre tag set to have a border around code snippets. You can change it if you like. The initial border setting has come with the drl-style presentation. Note: some (but not all) code snippets, like the apache license quote presented as a text, have a border, but it is

RE: [doc] new Getting Started guides

2006-09-22 Thread Morozova, Nadezhda
Geir, Do you think it might be easier to use Wiki as storage for all FAQs like that for now? I mean, not all of those who help find FAQ entries have ever checked out the website and would be willing to make patches to a FAQ.xml page. Wiki is easier to use when we're accumulating info. We could

RE: [doc] Why do we have boxes drawn around source now?

2006-09-22 Thread Morozova, Nadezhda
Geir, I know where the outer box comes from - site.vsl, special handling of source snippets. Can send you a quick patch to remove the outer box. Best regards, Nadya Morozova -Original Message- From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] Sent: Friday, September 22, 2006 4:25

RE: [doc] problem w/ css locally?

2006-09-22 Thread Morozova, Nadezhda
Geir, One question: if I (or somebody else for that matter) decide to change the site.css file, which copy in the checked-out version do I modify? Sorry if this sounds stupid... Best regards, Nadya Morozova -Original Message- From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED]

RE: [doc] new Getting Started guides

2006-09-22 Thread Morozova, Nadezhda
On Sep 22, 2006, at 8:28 AM, Morozova, Nadezhda wrote: Geir, Do you think it might be easier to use Wiki as storage for all FAQs like that for now? I mean, not all of those who help find FAQ entries have ever checked out the website and would be willing to make patches to a FAQ.xml page

RE: [doc] Why do we have boxes drawn around source now?

2006-09-22 Thread Morozova, Nadezhda
want to verify before I check it in? geir On Sep 22, 2006, at 8:43 AM, Geir Magnusson Jr. wrote: On Sep 22, 2006, at 8:34 AM, Morozova, Nadezhda wrote: Geir, I know where the outer box comes from - site.vsl, special handling of source snippets. Can send you a quick patch to remove

Re: [doc] problem w/ css locally?

2006-09-22 Thread Morozova, Nadezhda
Geir, In the website, the folder docs/documentation does not seem to have a copy of the site.css file for some reason. This way, pages documentation.html, build_website.html and a couple of others look real ugly. Could you please fix? I've verified all other pages on the website, they look

RE: [doc] new Getting Started guides

2006-09-22 Thread Morozova, Nadezhda
PM To: harmony-dev@incubator.apache.org Subject: Re: [doc] new Getting Started guides On Sep 22, 2006, at 8:28 AM, Morozova, Nadezhda wrote: Geir, Do you think it might be easier to use Wiki as storage for all FAQs like that for now? I mean, not all of those who help find FAQ entries have

[doc] no progress on patches for the website :(

2006-09-21 Thread Morozova, Nadezhda
Folks, I have been wondering about the patches to the website and documentation: could somebody please take a look and apply them if they're ok? I mean, some patches have new info that can be important; others improve our website and all. Why not just look into them? Thank you very much.

RE: [doc] no progress on patches for the website :(

2006-09-21 Thread Morozova, Nadezhda
for the website :( Hi Nadya, I'll take a look. Regards, Tim Morozova, Nadezhda wrote: Folks, I have been wondering about the patches to the website and documentation: could somebody please take a look and apply them if they're ok? I mean, some patches have new info that can be important

RE: [doc] no progress on patches for the website :(

2006-09-21 Thread Morozova, Nadezhda
site looks fine to me, so is there something I need to do to preview properly? Regards, Tim Morozova, Nadezhda wrote: Great to hear that. Please let me know if you need any help. Best regards, Nadya Morozova -Original Message- From: Tim Ellison [mailto:[EMAIL PROTECTED

RE: [doc] no progress on patches for the website :(

2006-09-21 Thread Morozova, Nadezhda
to. I hope to grind through this all today. geir On Sep 21, 2006, at 6:37 AM, Morozova, Nadezhda wrote: Folks, I have been wondering about the patches to the website and documentation: could somebody please take a look and apply them if they're ok? I mean, some patches have new info

RE: [doc] no progress on patches for the website :(

2006-09-21 Thread Morozova, Nadezhda
of that issue 'manually' so please check carefully that it was done right. The live site may take a while to be updated. Regards, Tim Morozova, Nadezhda wrote: Tim, I guess the issue is with the link to site.css that is in harmony/site. I have not been able to devise a nice way to preview

RE: [drlvm] Trouble Building DRLVM

2006-09-18 Thread Morozova, Nadezhda
Geir, Ok - it's clear I need to doc this. This is a trigger phrase for me. We have README and Getting Started for DRLVM that are terribly out-of-date. Now, if we update them, and keep them up-to-date, Armand would not need to write to the mailing list but would just follow the guide to

RE: [classlib][luni] Put setInterruptAction() in our j.l.Thread stub?

2006-09-14 Thread Morozova, Nadezhda
As I got it, the referenced documentation is created from code already, so I don't quite get Geir's comment ;( Anyway, I agree that keeping docs up-to-date is important. Do you think we can ask the community to update comments with the code changes? This way, the docs will never be out-of-sync.

  1   2   >