| Re: [eclipse-dev] Does @noreference tag need PMC approval? |
|
I agree with Martin. If something is already documented as not
referencable then you are just cleaning that up. People who get API
warnings as a result are either free to ignore them as they were
already doing or to remove their references (better to know now then
later). Jeff Oberhuber, Martin wrote: Hi Tomasz, my personal opinion would be that adding an API Tooling tag that just makes something machine-readable that had been in the Javadocs before (though expressed in plain English language) is not an API change and therefore doesn't require approval. I'd like to hear other opinions, though, and at any rate you should inform others about your change to ensure that any automated scans for changes in API don't surprise people who are not aware of what you've been changing. Cheers, -- Martin Oberhuber, Senior Member of Technical Staff, Wind River Target Management Project Lead, DSDP PMC Member http://www.eclipse.org/dsdp/tm-----Original Message----- From: eclipse-dev-bounces@xxxxxxxxxxx [mailto:eclipse-dev-bounces@xxxxxxxxxxx] On Behalf Of Tomasz Zarna Sent: Mittwoch, 15. April 2009 11:49 To: eclipse-dev@xxxxxxxxxxx Subject: [eclipse-dev] Does @noreference tag need PMC approval? Regarding latest comment on https://bugs.eclipse.org/bugs/show_bug.cgi?id=271343#c4: Does adding tags like @noreference in a case where the javadoc clearly states the method is for internal use only and cannot by called by clients requires PMC approval? I thought the change I made on the bug was not an API change, but Olivier may be right here. Have any of you had a similar problem? Do I need to ask for the approval? Cheers, -- Tomasz Zarna _______________________________________________ eclipse-dev mailing list eclipse-dev@xxxxxxxxxxx To change your delivery options, retrieve your password, or unsubscribe from this list, visit https://dev.eclipse.org/mailman/listinfo/eclipse-dev_______________________________________________ eclipse-dev mailing list eclipse-dev@xxxxxxxxxxx To change your delivery options, retrieve your password, or unsubscribe from this list, visit https://dev.eclipse.org/mailman/listinfo/eclipse-dev |