[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: NYIException
From: |
Ricky Clarkson |
Subject: |
Re: NYIException |
Date: |
27 Sep 2003 17:57:36 +0100 |
User-agent: |
Mutt/1.5.4i |
Hi,
I believe the functionality of @unimplemented would be adequately
replaced by @since and throw new UnsupportedOperationException.
To find out what methods of, e.g., JDK1.2 are unsupported, you can
simply search for methods that have @since 1.2 and throw
UnsupportedOperationException from their body.
I don't see how @unimplemented or NotYetImplementedException would give
extra information.
The reason for not implementing the method could be explained in normal
Javadoc comments, and this avoids generated documentation missing out
this information, as would happen if one ran Sun Javadoc over a method
with an @unimplemented tag, as far as I know.
Regards,
Ricky.
On Fri, Sep 26, 2003 at 02:38:30PM +0200, Sascha Brawer wrote:
> What would you say about defining a special Javadoc tag, such as the
> following?
>
> /**
> * @unimplemented 1.4 Here comes some explanation.
> */
> [class|method|field]
>
> It would not be too difficult to write a special doclet for the purpose
> of generating a document that summarizes the implementation status. Plus,
> it would be possible to document what exactly is not implemented, the
> reason, etc. The explanation text would also go into the generated
> documentation files.
>
> -- Sascha
>
> Sascha Brawer, address@hidden, http://www.dandelis.ch/people/brawer/
>
>
>
>
> _______________________________________________
> Classpath mailing list
> address@hidden
> http://mail.gnu.org/mailman/listinfo/classpath
- Re: NYIException, (continued)
- Re: NYIException, Arnaud Vandyck, 2003/09/25
- Re: NYIException, Ingo Prötel, 2003/09/25
- Re: NYIException, Etienne Gagnon, 2003/09/25
- Re: NYIException, Brian Jones, 2003/09/25
- Re: NYIException, Andy Walter, 2003/09/26
- Re: NYIException, Sascha Brawer, 2003/09/26
- Re: NYIException, Andy Walter, 2003/09/26
- Re: NYIException, Sascha Brawer, 2003/09/26
- Re: NYIException, Michael Koch, 2003/09/26
- Re: NYIException, Andy Walter, 2003/09/26
- Re: NYIException,
Ricky Clarkson <=
RE: NYIException, Regier Avery J, 2003/09/26
Re: NYIException, Dalibor Topic, 2003/09/27
RE: NYIException, Jeroen Frijters, 2003/09/27
RE: NYIException, Jeroen Frijters, 2003/09/27