Idea detail
comment_reference
reqlan rq/language/syntax.rq:569
block
done
Summary
Reqlan references may appear in line comments of arbitrary source files.
Comment reference syntax is `rq:idea` or `rq:idea` ( quoted path, optional extra qualification ).
Qualified paths use the same path forms as imports, including import-root aliases such as `@/` — configuration_import_root_alias, comment_reference_import_root_alias.
Discovery skips quoted strings, including Rust raw strings ( `r#"…"#`, `r##"…"##`, `br#"…"#` ), so `rq:…` text in a string is not a live comment.
Editor language coverage is a blocklist, not an allowlist: comment_reference_language_blocklist.
Indexed as `comment_link` by index_code_files.
Unresolved targets: comment_reference_resolution_error.
Indexer listing: test_references.
Refactors: comment_reference_refactor_support.
Navigation
Attributes
| Key | Value |
|---|---|
| implementation | comment.rs, reqlan-comment-resolver.ts, reqlan-comment-diagnostics.ts, reqlan-path-resolve.ts, register-comment-reference-links.ts, comment-reference-path-context.ts, comment-reference-languages.ts |
| status | done |
| tests | comment.rs:ignores_rq_inside_strings, comment.rs:ignores_rq_inside_rust_raw_strings, comment.rs:click_rs_fixture_string_is_not_a_comment_ref, comment.rs:still_finds_line_comment_after_a_raw_string, references.test.ts:skips rq tokens inside Rust raw strings, comment-reference-resolution.test.ts:creates a document link for an import-root aliased comment reference, comment.rs:resolves_aliased_qualified_comment_path |
Ancestor context
No ancestor chain recorded.
Outbound references
Inbound references
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| references | commands | reqlan rq/cli/cli_package.rq | comment_reference |
| references | code_comment_syntax_errors | reqlan rq/core_analysis/check.rq | comment_reference |
| references | test_references | reqlan rq/core_analysis/core.rq | comment_reference |
| references | comment_reference_language_blocklist | reqlan rq/extension/language/comment-references/functional-code-comment-references.rq | comment_reference |
| references | comment_reference_import_root_alias | reqlan rq/extension/language/comment-references/functional-code-comment-references.rq | comment_reference |
| references | comment_reference_refactor_support | reqlan rq/extension/mutation/refactor_support.rq | comment_reference |
| references | index_code_files | reqlan rq/indexer/indexer.rq | comment_reference |
| references | comment_reference_resolution_error | reqlan rq/language/syntax.rq | comment_reference |
| references | comment_reference | reqlan rq/reference_types.rq | comment_reference |
Unresolved references
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| None | |||
Local graph
Initialising graph…