On the 0x244 day of Apache Harmony Nadezhda Morozova wrote: > >-----Original Message----- > >From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED] > >Sent: Tuesday, December 19, 2006 6:16 PM > >To: [email protected] > >Subject: Re: [drlvm][doc] doxygen documentation > > > > > > > >Morozova, Nadezhda wrote: > >> Hi all, > >> > >> I've committed new config files to drlvm/trunk/vm/doc so that you can > >> build Doxygen documentation for drlvm interfaces locally. These > script > >> files are taken from HARMONY-2024. Suggestions/feedback welcome. > >> > > > >If you are working on that JIRA, I think that you should assign to > >yourself and keep working on it. > [Nadya] ok, actually forgot :) thanks for reminding > > > > > >> Generated versions are stored at http://people.apache.org/~nadinem/ - > >> intf_doc, drlvm_intf_doc, and vmcore_doc. I'll regenerate once in > while > >> to reflect recent functionality changes. Note that the files have the > >> nice starting page with the table (also taken from HARMONY-2024), but > >> you won't have it if you run Doxygen over your sources. To get the > >> starting page locally, apply the patch for vm.h to your source files. > > > >Can we start hanging this on the website somewhere? That would be > >useful.... > [Nadya] which ones? There are 3 bundle - the huge dirty one, the > external interfaces and the one for vmcore. If we decide to post, I > recommend the external interfaces one.
I would prefer the huge one > I'm also concerned about the place: don't want to store these in site > svn. Crazy idea: do you think we can store the doc bundle archives as we > store builds? Like, you can download the code and/or pre-generated > documentation. IMHO, if a developer wants a brief look at sources, s/he goes to the website Doxygen, if s/he wants a thorough look, s/he gets it from SVN. Easy to run scripts that generate Doxygen docs solve the problem (in the presence of tools...eh). So, I am feeling it is not worth the effort to create doc bundles.. > >geir > > > >> > >> Statistics on the quality/quantity of the Doxygen documentation is > >> collected on the Wiki page, > >> http://wiki.apache.org/harmony/DRLVM_Documentation_Quality > >> > >> Cheers Nadya > >> > >> > -- Egor Pasko
