harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Mikhail Loenko" <mloe...@gmail.com>
Subject Re: deprecated methods , javadocs
Date Wed, 01 Mar 2006 17:37:16 GMT
So, are we going to mark deprecated stuff?

Thanks,
Mikhail

2006/3/1, karan malhi <karan.malhi@gmail.com>:
> 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