Hi,
what is our policy regarding the since, status and specnote tags? I have
seen @status entries being replaced by @specnote and thought they should
not be used any more but then I found them again in newer classes. That
leads my to following questions:
What should @specnote or @status
Hi,
I found another tag that seems to be outdated: @version
Should @version tags removed whenever seen?
cu
Robert
___
Classpath mailing list
Classpath@gnu.org
http://lists.gnu.org/mailman/listinfo/classpath
Am Mittwoch, 12. Januar 2005 00:28 schrieb Robert Schuster:
> Hi,
> what is our policy regarding the since, status and specnote tags? I
> have seen @status entries being replaced by @specnote and thought
> they should not be used any more but then I found them again in
> newer clas
Hi again.
Michael Koch wrote:
Am Mittwoch, 12. Januar 2005 00:28 schrieb Robert Schuster:
Hi,
what is our policy regarding the since, status and specnote tags? I
have seen @status entries being replaced by @specnote and thought
they should not be used any more but then I found
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 sh
Am Mittwoch, 12. Januar 2005 00:45 schrieb Robert Schuster:
> Hi,
> I found another tag that seems to be outdated: @version
>
> Should @version tags removed whenever seen?
The @version tag is unused. Some classes use it. We should remove it
everywhere as I don't see it gives any real informations
> "Robert" == Robert Schuster <[EMAIL PROTECTED]> writes:
Robert> What should @specnote or @status describe?
I agree with Michael about the meaning of @specnote.
Sometimes we mention the class status in the header comments (perhaps
with @status, though I haven't looked for that). I usually
7 matches
Mail list logo