On Friday 29 January 2010 07:50:32 pm David P Grove wrote: > Christoph Pospiech <christoph.pospi...@de.ibm.com> wrote on 01/24/2010 > 10:17:27 AM: > > I know that writing documentation is always tedious > > and may appear lost work, > > when things are still on the move. > > But would it be possible to copy some of > > the comment lines from the code of the methods > > and classes (assuming that > > there are any) to the description in > > http://dist.codehaus.org/x10/xdoc/2.0/, > > say marked as "additional hint" ? > > -- > > The problem is mainly that there aren't enough comments. We're working on > it... > > We posted a refresh of the x10doc on x10-lang.org a few minutes ago that > (a) has more comments on a few more key classes in x10.lang (still lots to > do unfortunately) and (b) only includes the public/protected methods (as is > standard for javadoc in Java). The later should help make it easier to see > at a glance what the intended public API of the various classes is. >
David, this is >>MUCH<< better now. Particularly, the restriction to public/protected methods clarified a lot already. Indeed, I was able to write a correct program - which I didn't manage before. Thank you very much for the help ! -- Mit freundlichen Grüßen / Kind regards Dr. Christoph Pospiech High Performance & Parallel Computing Phone: +49-351 86269826 Mobile: +49-171-765 5871 E-Mail: christoph.pospi...@de.ibm.com ------------------------------------- IBM Deutschland GmbH Vorsitzender des Aufsichtsrats: Erich Clementi Geschäftsführung: Martin Jetter (Vorsitzender), Reinhard Reschke, Christoph Grandpierre, Klaus Lintelmann, Michael Diemer, Martina Koederitz Sitz der Gesellschaft: Ehningen / Registergericht: Amtsgericht Stuttgart, HRB 14562 WEEE-Reg.-Nr. DE 99369940 ------------------------------------------------------------------------------ The Planet: dedicated and managed hosting, cloud storage, colocation Stay online with enterprise data centers and the best network in the business Choose flexible plans and management services without long-term contracts Personal 24x7 support from experience hosting pros just a phone call away. http://p.sf.net/sfu/theplanet-com _______________________________________________ X10-users mailing list X10-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/x10-users
