Guard incomplete clangd references

This commit is contained in:
2026-06-04 16:10:42 +02:00
parent 576b58b061
commit ca452f46e1
3 changed files with 31 additions and 7 deletions

View File

@@ -94,10 +94,13 @@ Known local toolchain state:
`scripts/dev/clangd_nav.py` provides agent-friendly symbol, definition,
declaration, implementation, reference, and hover lookup through clangd using
the current `compile_commands.json` from `windows-clangcl-asan`,
`android-arm64`, or a caller-provided build directory. It disables clangd
background indexing by default for quick current-translation-unit lookups; pass
`--background-index` when broader cross-file references are worth the extra
indexing work.
`android-arm64`, or a caller-provided build directory. Symbol, hover,
declaration, definition, and implementation lookups are the reliable use case.
Reference lookup is guarded because a one-shot clangd process may not have a
complete project index: pass `--background-index` for broader best-effort
results or `--allow-incomplete-references` for explicitly
current-translation-unit-only results, and do not treat incomplete references
as proof that no other users exist.
- Android arm64 headless configure/build passes through root CMake and the
`platform-build` automation wrapper for `pp_foundation`, `pp_assets`,
`pp_paint`, `pp_document`, `pp_renderer_api`, `pp_renderer_gl`,