aaron.ballman added a comment.

In D66397#1639376 <https://reviews.llvm.org/D66397#1639376>, @xbolva00 wrote:

> I fixed and enabled this checker to warn for macros too.
>
> @aaron.ballman is right. Yes, as he said... If the user has a time to add 
> -Wno-xor.... to build systems, he/she has also time to improve code 
> readability and use hexadecimal literals.
>
> But I am a bit worried that the user does not realize that he/she could fix 
> it using hexadecimal literals... Should this be part of silence note? (any 
> proposed wording?) or add to Clang docs?


That's a reasonable concern, but I'm not certain it's worth adding the text to 
the note for it. This seems more like a documentation issue. We have some 
automation for generating documentation for warning flags (see 
ClangDiagnosticsEmitter.cpp), and it looks like there may be a way to have the 
diagnostic itself provide the documentation so that it appears in 
https://clang.llvm.org/docs/DiagnosticsReference.html automatically. To me, 
that would be the best place for this documentation to live, but I have no idea 
if there's further work needed to support that.


CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D66397/new/

https://reviews.llvm.org/D66397



_______________________________________________
cfe-commits mailing list
cfe-commits@lists.llvm.org
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to