Skip to content

Cannot link to operator[] #1285

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

Open
lrhn opened this issue Dec 1, 2016 · 2 comments
Open

Cannot link to operator[] #1285

lrhn opened this issue Dec 1, 2016 · 2 comments
Labels
P2 A bug or feature request we're likely to work on type-bug Incorrect behavior (everything from a crash to more subtle misbehavior)

Comments

@lrhn
Copy link
Member

lrhn commented Dec 1, 2016

If I write [[]] it acts like a code quote, but it doesn't actually link to the operator [].

This is used an several places, e.g., https://api.dartlang.org/stable/1.20.1/dart-collection/LinkedHashMap/LinkedHashMap.html.

From testing, I can't refer to a type imported with a prefix. If I write [prefix.AClass] it does not link to that class.

Also, I can't find a good way to refer to the unary- operator. I tried [unary-] and it didn't link. Using [-] links to the binary minus operator.

Here's an example of things that could/should work: https://gist.github.com/lrhn/32617fc179ed1b4d53e443d56a21343b

(I'm not sure the [setter=] syntax needs to work, but it would be convenient and consistent that the actual name of the member can be used).

@devoncarew devoncarew added the type-bug Incorrect behavior (everything from a crash to more subtle misbehavior) label Dec 1, 2016
@jcollins-g
Copy link
Contributor

#1390 addresses some cases here but is not a complete solution.

@jcollins-g jcollins-g added the P2 A bug or feature request we're likely to work on label May 1, 2017
@jcollins-g
Copy link
Contributor

A way that currently works to link an operator bracket operator in dartdoc is [operator []], but we should also support [[]], and even that doesn't work outside the currently documented class. The prefix linking is covered in #1402.

@jcollins-g jcollins-g changed the title Cannot link to operator[] or prefix.something. Cannot link to operator[] Dec 19, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
P2 A bug or feature request we're likely to work on type-bug Incorrect behavior (everything from a crash to more subtle misbehavior)
Projects
None yet
Development

No branches or pull requests

3 participants