Repository navigation
The first stable release of clice, a C/C++ language server built on Clang, and the command line beside it that shares its configuration, caches and index. Documentation: https://docs.clice.io
The VS Code extension is on the Visual Studio Marketplace and Open VSX; nightly builds continue on their pre-release channel as 1.1.x.
Upgrading from 0.x: clice.toml
The [project] and [tracker] tables are gone. Settings for the whole server are top-level keys or sit in [workers]; settings that can differ per file are fields of [[rules]] — to set one for every file, write it on a last rule without patterns.
| Before 1.0 | 1.0 |
|---|---|
[project] cache_dir |
top-level cache_dir |
[project] logging_dir |
top-level logging_dir |
[tracker] workspace_poll_seconds |
top-level poll_seconds |
[project] stateful_worker_count |
[workers] foreground |
[project] stateless_worker_count |
[workers] background |
[project] max_stateless_worker_count |
[workers] max |
[project] idle_timeout_ms |
[workers] background_delay_ms |
[project] enable_indexing = false |
background_index = false on a last rule without patterns |
[[rules]] index |
[[rules]] background_index |
[project] skip_header_bodies |
[[rules]] skip_function_body |
[project] index_library_bodies |
[[rules]] index_function_body |
[project] standard_library_instantiations |
[[rules]] index_function_body |
[project] readonly |
[[rules]] readonly |
[project] test_hooks |
the environment variable CLICE_TEST_HOOKS |
[project] min_stateless_worker_count |
gone: an idle server keeps one worker of its own accord |
[project] max_resident_documents |
gone: how many open files stay compiled follows the memory |
0 no longer stands for a special value: a count the machine decides is "auto" ([workers] background, [workers] max), a lifted limit "unlimited" ([code_completion] limit, [references] limit, [inlay_hints.max_length]). A worker count of 0 is an error. ${env:NAME} expands wherever ${workspace} does.
An old key is an error naming where it went, in clice.toml and in the editor's settings alike, and nothing of the project is served until it is fixed:
error: clice.toml:2:13: moved to the top-level `cache_dir` in clice 1.0 at project.cache_dir
clice.toml:12:9: moved to `background_index` in clice 1.0 at rules[0].index
The editor shows the same message as an error on the key; settings from initializationOptions name it as initializationOptions: moved to the rules' readonly in clice 1.0 at project.readonly. clice command <file> shows the value of every per-file field for a file and the rule deciding it.
Downloads
Symbol packages hold GSYM data for crash log symbolization via scripts/symbolize.py.