@@ -518,13 +518,15 @@ Warning flags
518
518
+ ``-Wthread-safety-reference ``: Checks when guarded variables are passed by reference.
519
519
520
520
* ``-Wthread-safety-addressof ``: Warn when the address of guarded variables is
521
- obtained (``&var ``). Since obtaining the address of a variable doesn't
522
- necessarily imply a read or write, the warning is off by default. In
523
- codebases that prefer passing pointers rather than references (for C++
524
- codebases), or passing pointers is ubiquitous (for C codebases), enabling
525
- this warning will result in fewer false negatives; for example, where the
526
- manipulation of common data structures is done via functions that take
527
- pointers to instances of the data structure.
521
+ obtained (``&var ``). Since obtaining the address of a variable does *not
522
+ necessarily imply a read or write *, the warning is off by default to avoid
523
+ false positives. In codebases that prefer passing pointers rather than
524
+ references (for C++ codebases), or passing pointers is ubiquitous (for C
525
+ codebases), enabling this warning will result in fewer false negatives; for
526
+ example, where the manipulation of common data structures is done via
527
+ functions that take pointers to instances of the data structure. Note,
528
+ however, that the analysis does not track pointers, and false positives *and *
529
+ negatives are still possible.
528
530
529
531
:ref: `negative ` are an experimental feature, which are enabled with:
530
532
0 commit comments