harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From karan malhi <karan.ma...@gmail.com>
Subject Re: deprecated methods , javadocs
Date Wed, 01 Mar 2006 16:53:15 GMT
Geir Magnusson Jr wrote:

> We want any javadoc for javax.* classes to have a pointer to the sun 
> javadoc (so it's clear we aren't trying to reproduce the spec) and 
> have information about *our* implementation, clarifications, how we 
> interpreted the spec, etc.
>
Thanks. Thats what I wanted to know, javadocs  for javax.* classes.

>
> karan malhi wrote:
>
>> Will the javadoc have to match exactly with the RI api docs?
>>
>> Geir Magnusson Jr wrote:
>>
>>>
>>>
>>> karan malhi wrote:
>>>
>>>> Do we need to add javadoc comments in classes?
>>>
>>>
>>>
>>> Sure.  Javadoc is good.
>>>
>>>> How to deal with deprecated classes,methods and constructors?
>>>
>>>
>>>
>>> Mark them deprecated?
>>>
>>>> My guess is that we should not care whether something is deprecated 
>>>> or not. We would still need that stuff for backward compatibility. 
>>>> However, I still would like to know if we need to keep certain 
>>>> rules/guidelines in mind when implementing deprecated stuff.
>>>
>>>
>>>
>>> People use deprecated stuff.  I think that there is no difference in 
>>> "rules", but probably in how much effort....
>>>
>>> geir
>>>
>>>
>>
>

-- 
Karan Singh


Mime
View raw message