Extra Clang Tools 21.0.0git (In-Progress) Release Notes¶

Written by the LLVM Team

Warning

These are in-progress notes for the upcoming Extra Clang Tools 21 release. Release notes for previous releases can be found on the Download Page.

Introduction ¶

This document contains the release notes for the Extra Clang Tools, part of the Clang release 21.0.0git. Here we describe the status of the Extra Clang Tools in some detail, including major improvements from the previous release and new feature work. All LLVM releases may be downloaded from the LLVM releases web site.

For more information about Clang or LLVM, including information about the latest release, please see the Clang Web Site or the LLVM Web Site.

Note that if you are reading this file from a Git checkout or the main Clang web page, this document applies to the next release, not the current one. To see the release notes for a specific release, please see the releases page.

Added BuiltinHeaders config key which controls whether clangd’s built-in headers are used or ones extracted from the driver.

Deprecated the -insert and -remove command line options, and added the -disable-remove and -disable-insert command line options as replacements. The previous command line options were confusing because they did not imply the default state of the option (which is inserts and removes being enabled). The new options are easier to understand the semantics of.

Improvements to clang-tidy ¶

Changed the check_clang_tidy.py tool to use FileCheck’s --match-full-lines instead of strict-whitespace for CHECK-FIXES clauses. Added a --match-partial-fixes option to keep previous behavior on specific tests. This may break tests for users with custom out-of-tree checks who use check_clang_tidy.py as-is.
Improved clang-tidy-diff.py script. Add the -warnings-as-errors argument to treat warnings as errors.
Fixed bug in clang-tidy by which HeaderFilterRegex did not take effect when passed via the .clang-tidy file.
Fixed bug in run_clang_tidy.py where the program would not correctly display the checks enabled by the top-level .clang-tidy file.

New checks ¶

New bugprone-capturing-this-in-member-variable check.

Finds lambda captures and bind function calls that capture the this pointer and store it as class members without handle the copy and move constructors and the assignments.
New bugprone-unintended-char-ostream-output check.

Finds unintended character output from unsigned char and signed char to an ostream.
New readability-ambiguous-smartptr-reset-call check.

Finds potentially erroneous calls to reset method on smart pointers when the pointee type also has a reset method.

New check aliases ¶

Changes in existing checks ¶

Improved bugprone-optional-value-conversion check to detect conversion in argument of std::make_optional.
Improved bugprone-string-constructor check to find suspicious calls of std::string constructor with char pointer, start position and length parameters.
Improved bugprone-unchecked-optional-access fixing false positives from smart pointer accessors repeated in checking has_value and accessing value. The option IgnoreSmartPointerDereference should no longer be needed and will be removed. Also fixing false positive from const reference accessors to objects containing optional member.
Improved bugprone-unsafe-functions check to allow specifying additional C++ member functions to match.
Improved cert-err33-c check by fixing false positives when a function name is just prefixed with a targeted function name.
Improved misc-const-correctness check by adding the option AllowedTypes, that excludes specified types from const-correctness checking and fixing false positives when modifying variant by operator[] with template in parameters and supporting to check pointee mutation by AnalyzePointers option and fixing false positives when using const array type.
Improved misc-redundant-expression check by providing additional examples and fixing some macro related false positives.
Improved misc-unused-using-decls check by fixing false positives on operator"" with template parameters.
Improved misc-use-internal-linkage check by fix false positives for function or variable in header file which contains macro expansion and excluding variables with thread_local storage class specifier from being matched.
Improved modernize-use-default-member-init check by matching constexpr and static` values on member initialization and by detecting explicit casting of built-in types within member list initialization.
Improved modernize-use-designated-initializers check by avoiding diagnosing designated initializers for std::array initializations.
Improved modernize-use-ranges check by updating suppress warnings logic for nullptr in std::find.
Improved modernize-use-starts-ends-with check by adding more matched scenarios of find and rfind methods and fixing false positives when those methods were called with 3 arguments.
Improved modernize-use-std-numbers check to support math functions of different precisions.
Improved performance-move-const-arg check by fixing false negatives on ternary operators calling std::move.
Improved performance-unnecessary-value-param check performance by tolerating fix-it breaking compilation when functions is used as pointers to avoid matching usage of functions within the current compilation unit.

Extra Clang Tools 21.0.0git documentation