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