From 930b17a2e2ec99433210d57e6f53313ddb95e18b Mon Sep 17 00:00:00 2001 From: Philip Ginsbach Date: Mon, 19 Jan 2026 14:06:45 +0000 Subject: [PATCH] clarify compileForOverlayEval only needed in language packs --- docs/codeql/ql-language-reference/annotations.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/codeql/ql-language-reference/annotations.rst b/docs/codeql/ql-language-reference/annotations.rst index 3a7657ca9ae..17a4c2cc76e 100644 --- a/docs/codeql/ql-language-reference/annotations.rst +++ b/docs/codeql/ql-language-reference/annotations.rst @@ -530,10 +530,11 @@ support is enabled for a language. .. note:: - Overlay annotations only affect evaluation when overlay compilation is enabled for a - QL pack (via ``compileForOverlayEval: true`` in ``qlpack.yml``) and the evaluator is - running in overlay mode. Otherwise, these annotations are validated but have no effect - on evaluation. + Overlay annotations only affect evaluation when overlay compilation is enabled + (via ``compileForOverlayEval: true`` in ``qlpack.yml``) and the evaluator is running + in overlay mode. This setting is typically only needed in the language's library pack; + custom query packs do not need it. Outside of overlay mode, these annotations are + validated but have no effect on evaluation. ``overlay[local]`` ------------------