maxjhandsome
/
llvm-project
forked from OSchip/llvm-project
1
0
Fork 0
Code Issues Pull Requests Packages Releases Wiki Activity

[docs] don't use :option: for Wall Wextra 

The bots are sad that they're not documented.

llvm-svn: 367918
This commit is contained in:
JF Bastien 2019-08-05 19:59:07 +00:00
parent f1b0a93e3a
commit 6e33c647f3
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
clang/docs/UsersManual.rst
View File

@ -1000,13 +1000,13 @@ often disable many diagnostics such as `-Wno-c++98-compat` and `-Wno-c++-compat`
because they contradict recent C++ standards.
Since :option:`-Weverything` enables every diagnostic, we generally don't
recommend using it. :option:`-Wall` :option:`-Wextra` are a better choice for
most projects. Using :option:`-Weverything` means that updating your compiler is
more difficult because you're exposed to experimental diagnostics which might be
of lower quality than the default ones. If you do use :option:`-Weverything`
then we advise that you address all new compiler diagnostics as they get added
to Clang, either by fixing everything they find or explicitly disabling that
diagnostic with its corresponding `Wno-` option.
recommend using it. `-Wall` `-Wextra` are a better choice for most projects.
Using :option:`-Weverything` means that updating your compiler is more difficult
because you're exposed to experimental diagnostics which might be of lower
quality than the default ones. If you do use :option:`-Weverything` then we
advise that you address all new compiler diagnostics as they get added to Clang,
either by fixing everything they find or explicitly disabling that diagnostic
with its corresponding `Wno-` option.
Note that when combined with :option:`-w` (which disables all warnings),
disabling all warnings wins.