From 092241a30450710b0cd4e6c66876bf5884c9afa6 Mon Sep 17 00:00:00 2001 From: firewave Date: Sun, 7 Sep 2025 17:10:42 +0200 Subject: [PATCH] TUNING.md: mention `--no-check-unused-templates` and `--file-filter` [skip ci] --- TUNING.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/TUNING.md b/TUNING.md index e5e7e9d070a..76ba9383293 100644 --- a/TUNING.md +++ b/TUNING.md @@ -111,6 +111,18 @@ So if you do not require the additional safety you might want to switch to the u Note: For Windows binaries we currently do not provide the possibility of using processes so this does not apply. +### Disable Analyzing Of Unused Templated Functions + +Currently all templated functions (either locally or in headers) will be analyzed regardless if they are instantiated or not. If you have template-heavy includes that might lead to unnecessary work and findings, and might slow down the analysis. This behavior can be disabled with `--no-check-unused-templates`. + +Note: This might lead to "false negatives" in such functions if they are never instantiated. You should make sure that you have proper coverage of the affected functions in your code before enabling this. + +### Limit Analysis Of Projects + +If you specify a project all files will be analyzed by default. But in some cases you might only be interested in the results in a subset of those (e.g. in IDE integrations). + +Using the `--file-filter=` CLI option you can select files using a globbing syntax. Using `--file-filter=-` you can provide the filters directly on the CLI. + ## Advanced Tuning ### Re-order The Files