Re: since, status and specnote tags

[Michael Koch]

Am Mittwoch, 12. Januar 2005 02:11 schrieb Robert Schuster:

> That means adding it to other symbols too is not forbidden but not
> encouraged ... makes me unhappy as well
> and a general policy would help.
>
> Please do not misunderstand me: I would love too see an agreement
> that says
>
> You should add @someTag whenever bla foo baz.
>
> But this does not mean 'You must add @ ...'.

Well, the @since tags should be the same as with JDK as the java 
compiler might use this tags to support -target option and to fail if 
you use to new API stuff.

> Anyone else feeling better if could reduce the vagueness of these
> tags?

The @status and @version tags can be used. Its up to the author of the 
code.


Michael
-- 
Homepage: http://www.worldforge.org/