You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This was reported at dart-lang/dart-syntax-highlight#11 (comment). Dart highlighting on GitHub doesn't handle unterminated triple-backticks as expected. VS Code does handle it as expected.
However, while debugging this, I've become less certain that GitHub is wrong, and feel like VS Code might be.
Here's a trimmed down version of the grammar that shows the problem. It defines triple-slash comments, and supports triple-backtick code blocks inside:
It the triple backticks are unclosed, it looks reasonable:
However, it's not clear why the variable.other.source.dart scope was exited, because the "end" condition was never found. On GitHub, this does not happen and the rest of the document is consumed (note the first void here is red, but the second one is not because the variable context eats the rest of the document):
I can't find anything in the spec for textmate grammars to explain VS Code's behaviour. The most information I've found on it is here:
The other type of match is the one used by the second rule (lines 9-17). Here two regular expressions are given using the begin and end keys. [...] If there is no match for the end pattern, the end of the document is used.
With begin/end, if the end pattern is not found, the overall match does not fail: rather, once the begin pattern is matched, the overall match runs to the end pattern or to the end of the document, whichever comes first.
While VS Code's behaviour is convenient for me (because I'm not sure how to handle these unclosed triple-backticks if it behaved like GitHub), it doesn't seem correct, and it's more inconvenient if VS Code and GitHub disagree on what the behaviour should be because it makes it more difficult to author a grammar.
The text was updated successfully, but these errors were encountered:
This was reported at dart-lang/dart-syntax-highlight#11 (comment). Dart highlighting on GitHub doesn't handle unterminated triple-backticks as expected. VS Code does handle it as expected.
However, while debugging this, I've become less certain that GitHub is wrong, and feel like VS Code might be.
Here's a trimmed down version of the grammar that shows the problem. It defines triple-slash comments, and supports triple-backtick code blocks inside:
It renders like this:
It the triple backticks are unclosed, it looks reasonable:
However, it's not clear why the
variable.other.source.dart
scope was exited, because the"end"
condition was never found. On GitHub, this does not happen and the rest of the document is consumed (note the firstvoid
here is red, but the second one is not because the variable context eats the rest of the document):I can't find anything in the spec for textmate grammars to explain VS Code's behaviour. The most information I've found on it is here:
https://macromates.com/manual/en/language_grammars
https://www.apeth.com/nonblog/stories/textmatebundle.html
While VS Code's behaviour is convenient for me (because I'm not sure how to handle these unclosed triple-backticks if it behaved like GitHub), it doesn't seem correct, and it's more inconvenient if VS Code and GitHub disagree on what the behaviour should be because it makes it more difficult to author a grammar.
The text was updated successfully, but these errors were encountered: