llvm-project/clang-tools-extra/docs
Whisperity 0fba450b97 [clang-tidy] Suppress reports to patternedly named parameters in 'bugprone-easily-swappable-parameters'
While the original check's purpose is to identify potentially dangerous
functions based on the parameter types (as identifier names do not mean
anything when it comes to the language rules), unfortunately, such a plain
interface check rule can be incredibly noisy. While the previous
"filtering heuristic" is able to find many similar usages, there is an entire
class of parameters that should not be warned about very easily mixed by that
check: parameters that have a name and their name follows a pattern,
e.g. `text1, text2, text3, ...`.`

This patch implements a simple, but powerful rule, that allows us to detect
such cases and ensure that no warnings are emitted for parameter sequences that
follow a pattern, even if their types allow for them to be potentially mixed at a call site.

Given a threshold `k`, warnings about two parameters are filtered from the
result set if the names of the parameters are either prefixes or suffixes of
each other, with at most k letters difference on the non-common end.
(Assuming that the names themselves are at least `k` long.)

 - The above `text1, text2` is an example of this. (Live finding from Xerces.)
 - `LHS` and `RHS` are also fitting the bill here. (Live finding from... virtually any project.)
 - So does `Qmat, Tmat, Rmat`. (Live finding from I think OpenCV.)

Reviewed By: aaron.ballman

Differential Revision: http://reviews.llvm.org/D97297
2021-06-28 10:49:37 +02:00
..
_static
_templates
clang-tidy [clang-tidy] Suppress reports to patternedly named parameters in 'bugprone-easily-swappable-parameters' 2021-06-28 10:49:37 +02:00
clangd
CMakeLists.txt
ModularizeUsage.rst
README.txt
ReleaseNotes.rst [clang-tidy] Add 'bugprone-easily-swappable-parameters' check 2021-06-28 10:49:37 +02:00
clang-doc.rst
clang-include-fixer.rst
clang-modernize.rst
clang-rename.rst
clang-tidy.rst
clangd.rst
conf.py
cpp11-migrate.rst
doxygen-mainpage.dox
doxygen.cfg.in
index.rst
make.bat
modularize.rst
pp-trace.rst

README.txt

----------------------------------
Documentation in clang-tools-extra
----------------------------------

To generate documentation in HTML format from files in clang-tools-extra/docs,
build the docs-clang-tools-html target.

To generate documentation from the source code using Doxygen, build the
doxygen-clang-tools target.