spec - comment_reference_resting

Katz0.146

Summary

In non- `.rq` source comments, every `rq:…` token must show a resting underline so it is clear the site is link-shaped.
Use TextMate scope `meta.link.reqlan markup.underline` via the comment injection grammar.
Do not rely on file document links for that cue — those stay stripped ( editor_reference_activation ).
Navigation remains Ctrl + click go-to-definition for resolved sites ( references_in_functional_code_comments ).
Related: comment_reference_resting_underline, comment_support.

Jump to outbound references

Jump to inbound references

Navigation

Source file

reqlan rq/extension/language/comment-references/functional-code-comment-references.rq

community 1

community cluster

functional-code-comment-references.rq

file cluster

reqlan rq/extension/language/comment-references

folder cluster

status: done

status cluster

tag: Not present

tag cluster

Printable page

Static print-friendly idea sheet.

Attributes

Key	Value
implementation	reqlan-comment.injection.json, package.json
status	done
tests	editor-link-activation.test.ts:comment injection link scope includes markup.underline, editor-link-activation.test.ts:package.json contributes comment.rq.injection

Browse all attributes

Ancestor context

No ancestor chain recorded.

Outbound references

Kind	Idea	Path	Snippet
references	editor_reference_activation	reqlan rq/extension/language/syntax/features-syntax-highlighting.rq	editor_reference_activation
references	references_in_functional_code_comments	reqlan rq/extension/language/comment-references/functional-code-comment-references.rq	references_in_functional_code_comments
references	comment_support	reqlan rq/extension/language/syntax/features-syntax.rq	comment_support
file_reference	"../../../../packages/extension/grammars/reqlan-comment.injection.json"	packages/extension/grammars/reqlan-comment.injection.json	reqlan-comment.injection.json
file_reference	"../../../../packages/extension/package.json"	packages/extension/package.json	package.json
file_reference	"../../../../packages/extension/test/editor-link-activation.test.ts:comment injection link scope includes markup.underline"	packages/extension/test/editor-link-activation.test.ts	["../../../../packages/extension/test/editor-link-activation.test.ts:comment injection link scope includes markup.underl
file_reference	"../../../../packages/extension/test/editor-link-activation.test.ts:package.json contributes comment.rq.injection"	packages/extension/test/editor-link-activation.test.ts	editor-link-activation.test.ts:package.json contributes comment.rq.injection

Inbound references

Kind	Idea	Path	Snippet
references	references_in_functional_code_comments	reqlan rq/extension/language/comment-references/functional-code-comment-references.rq	comment_reference_resting_underline
references	comment_reference_language_blocklist	reqlan rq/extension/language/comment-references/functional-code-comment-references.rq	comment_reference_resting_underline
references	editor_reference_activation	reqlan rq/extension/language/syntax/features-syntax-highlighting.rq	comment_reference_resting_underline
references	comment_support	reqlan rq/extension/language/syntax/features-syntax.rq	comment_reference_resting_underline

Unresolved references

Kind	Idea	Path	Snippet
None

Local graph

Initialising graph…