>>>>> "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 find this not very useful, since often the class is updated and the status is not. I think we should just drop @status (and @version). Robert> Regarding the @since tag: Should we strive to version every class and Robert> method? In my opinion, everything except those classes and methods that were present in 1.0 should have an @since tag. In 1.5 we could introduce an [EMAIL PROTECTED]' attribute and make this information available to compilers and other tools. I'm not sure if this is useful or not, I just thought I'd throw it out there. Tom _______________________________________________ Classpath mailing list [email protected] http://lists.gnu.org/mailman/listinfo/classpath
