Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support for @deprecated annotations (as structured doc comments) #3753

Closed
pq opened this issue Jun 19, 2012 · 4 comments
Closed

Support for @deprecated annotations (as structured doc comments) #3753

pq opened this issue Jun 19, 2012 · 4 comments
Assignees
Labels
area-analyzer Use area-analyzer for Dart analyzer issues, including the analysis server and code completion. type-enhancement A request for a change that isn't a bug
Milestone

Comments

@pq
Copy link
Member

pq commented Jun 19, 2012

This follows-up on basic support required for dartbug.com/3752.

In short, references to deprecated elements (functions, fields, types) should get a warning marker (and possibly a strikethrough semantic highlighting).

As a first cut, we will use the following simple format:

  // @­deprecated

and insist that it be on a line immediately preceding a member declaration. For example:

  // @­deprecated
  interface TimeZone default TimeZoneImplementation

As for scope, we want to at least be able to flag members (fields, methods) and this is certainly a reasonable starting point. Statement-level scope is more contentious but very much on the table.

@sethladd
Copy link
Contributor

Added Triaged label.

@sethladd
Copy link
Contributor

Please see the metadata proposal: http://news.dartlang.org/2012/06/proposal-to-add-metadata-to-dart.html

@scheglov
Copy link
Contributor

@scheglov
Copy link
Contributor

@pq pq added Type-Enhancement area-analyzer Use area-analyzer for Dart analyzer issues, including the analysis server and code completion. labels Jun 29, 2012
@pq pq added this to the M1 milestone Jun 29, 2012
@kevmoo kevmoo added type-enhancement A request for a change that isn't a bug and removed type-enhancement labels Mar 1, 2016
This issue was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-analyzer Use area-analyzer for Dart analyzer issues, including the analysis server and code completion. type-enhancement A request for a change that isn't a bug
Projects
None yet
Development

No branches or pull requests

4 participants