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

Directive vs comments when no space after :: #46

Open
Carreau opened this issue Oct 2, 2023 · 2 comments
Open

Directive vs comments when no space after :: #46

Carreau opened this issue Oct 2, 2023 · 2 comments
Labels
decision needed A decision needs to be taken to solve this

Comments

@Carreau
Copy link

Carreau commented Oct 2, 2023

FYI, docutils seem to support not having a space (and emit a directive). Tree sitter make it a comment if there is no space.

The spec is unclear.

from the https://docutils.sourceforge.io/docs/ref/rst/directives.html

followed by the directive type and two colons (collectively, the "directive marker"

https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#directives

followed by the directive type, two colons, and whitespace (together called the "directive marker"

Emphasis mine.

@Carreau
Copy link
Author

Carreau commented Oct 2, 2023

Feel free to close, I just wanted to just have a note of it – I think the current behavior is better.

@stsewd
Copy link
Owner

stsewd commented Oct 24, 2023

Yeah, I have found several of things like this in the spec that docutils follows loosely. I'm not 100% sure about what to do here...

@stsewd stsewd added the decision needed A decision needs to be taken to solve this label Dec 29, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
decision needed A decision needs to be taken to solve this
Projects
None yet
Development

No branches or pull requests

2 participants