Comments (2)
This is tricky because [List<int>]
is special DartDoc syntax, not CommonMark syntax.
The CommonMark interpretation is to treat the [
and ]
literally, unless you have a
[List<int>]: linkTarget
declaration somewhere in the file. Then it is a shorthand link. (Which means parsing is not context free.)
In either case the <int>
will be considered an HTML tag when rendered.
If DartDoc replaces remaining [List<int>]
s by something else, then ... we probably need to figure out which criteria are used for that, and which approach is used to find the tags in the DartDoc code.
(Does it do Commonmark parsing first, then look for remaining [...]
s which were not parsed as a link? if so, is the contents of [...]
already markdown parsed too? Has it removed the unknown HTML tag <int>
like it would remove <int>
outside of a [...]
? Is that why it works? Does [List<div>]
work the same?)
Doesn't feel like a slam-dunk, but we probably can recognize \[[^`[\]]*\](?![([])
to ignore the contents of the [...]
. It just won't find
Is [foo<upper>2</upper>] valid?
[foo<upper>2</upper>]: https://example.com
where you intended to write <sup>
instead of <upper>
.
from sdk.
I found an example where this might be the best way to write it.
Here its useful to link to the exception since it's novel, and it's useful to include the detail of the generic matching the generic on the method call. I can't find a way like prefer to phrase it where these aren't the same word.
from sdk.
Related Issues (20)
- unintended_html_in_doc_comment triggers on some variants of allowed html tags in package:web HOT 1
- js_interop changes in 3.6 (master) to JSTypedArray subtypes break passing SharedArrayBuffer as the underlying buffer. HOT 3
- Dart analyzer fails to analyze condition in a list construction in enhanced enum constructor HOT 2
- [CP] Fix crashes due to unhandled StructuralParameterTypes in UP in the CFE HOT 1
- [dart2wasm][ffi] Error: Argument to 'Native.addressOf' must be annotated with @Native. HOT 3
- Macro with Map param doesn't work properly HOT 1
- [native assets] Add dynamic linking integration test for `dart` HOT 1
- Analyzer doesn't notice incorrect return type of generic method HOT 5
- [cfe/ffi] Cascading error on wrong types when using `.address` HOT 1
- Call dart function from a dynamic lib HOT 3
- [CP] Fix analysis_options.yaml "include:" for nested folders in workspace. HOT 1
- [breaking change] Compute closures of type schemas in the upper bound computations in the CFE as specified HOT 2
- Assists for adding and maybe removing digit separators from number literals
- [breaking change] Mark `IOOverrides` as `base` HOT 3
- Check if current is available within Iterator without moving the iterator HOT 1
- A directory which is "excluded" via analysis options should not be searched for other analysis options. HOT 1
- Missing unnecessary `!` warning with nested extension types
- Analysis Server Error HOT 1
- http library throws `HttpException: Connection closed before full header was received` without a stack trace HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from sdk.