Hi, all
I will volunteer to generate the document and add it to the website.
On 9/14/06, Geir Magnusson Jr. <[EMAIL PROTECTED]> wrote:
So - no matter what happens w/ the docs, we do need this in the code...
geir
Tim Ellison wrote:
> yep -- that's what I meant. The on-line doc should be generated from
> the code comments as it is today.
>
> Regards,
> Tim
>
> Morozova, Nadezhda wrote:
>> 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. And those reading the code
will
>> have a better understanding of what it does.
>>
>> Best regards,
>> Nadya Morozova
>>
>>
>> -----Original Message-----
>> From: Geir Magnusson Jr. [mailto:[EMAIL PROTECTED]
>> Sent: Thursday, September 14, 2006 5:36 PM
>> To: harmony-dev@incubator.apache.org
>> Subject: Re: [classlib][luni] Put setInterruptAction() in our
j.l.Thread
>> stub?
>>
>> true, but there's no reason why this couldn't be in the code too...
>>
>> geir
>>
>> Tim Ellison wrote:
>>> Our VM interface documentation[1] is drifting out of sync with code
>>> changes. If anyone has time to refresh it, with help from the dev
>> list,
>>> that would be a very valuable task. We should ensure that VM writers
>>> understand how to get the harmony class library code working with
>> their VM.
>>> [1] amongst others,
>>>
>>
http://svn.apache.org/viewvc/incubator/harmony/enhanced/classlib/trunk/d
>> oc/kernel_doc/html/index.html?view=co
>>> Regards,
>>> Tim
>>>
>>>
>>> Oliver Deakin wrote:
>>>> Geir Magnusson Jr. wrote:
>>>>> This came up in another thread.
>>>>>
>>>>> Currently, java.nio.channels.spi.AbstractInterruptibleChannel
>> depends
>>>>> on there being a setInterruptAction() method on java.lang.Thread.
>>>>>
>>>>> I certainly think that this kind of thing should be documented, so
>> the
>>>>> question - should we add this to our Thread stub class?
>>>> Yes we should - I didn't realise initially that this method was being
>>>> used (since it was private).
>>>> Now we know it's in use in AbstractInterruptibleChannel, we'd better
>> put
>>>> some doc in for future
>>>> kernel writers. Can someone just bring back the original comments and
>>>> method stub that was
>>>> there?
>>>>
>>>> Regards,
>>>> Oliver
>>>>
>>>>> geir
>>>>>
>>>>>
>> ---------------------------------------------------------------------
>>>>> Terms of use : http://incubator.apache.org/harmony/mailing.html
>>>>> To unsubscribe, e-mail: [EMAIL PROTECTED]
>>>>> For additional commands, e-mail:
>> [EMAIL PROTECTED]
>> ---------------------------------------------------------------------
>> Terms of use : http://incubator.apache.org/harmony/mailing.html
>> To unsubscribe, e-mail: [EMAIL PROTECTED]
>> For additional commands, e-mail: [EMAIL PROTECTED]
>>
>> ---------------------------------------------------------------------
>> Terms of use : http://incubator.apache.org/harmony/mailing.html
>> To unsubscribe, e-mail: [EMAIL PROTECTED]
>> For additional commands, e-mail: [EMAIL PROTECTED]
>>
>>
>
---------------------------------------------------------------------
Terms of use : http://incubator.apache.org/harmony/mailing.html
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
--
Leo Li
China Software Development Lab, IBM
