]> granicus.if.org Git - clang/commitdiff
[docs] don't use :option: for Wall Wextra
authorJF Bastien <jfbastien@apple.com>
Mon, 5 Aug 2019 19:59:07 +0000 (19:59 +0000)
committerJF Bastien <jfbastien@apple.com>
Mon, 5 Aug 2019 19:59:07 +0000 (19:59 +0000)
The bots are sad that they're not documented.

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@367918 91177308-0d34-0410-b5e6-96231b3b80d8

docs/UsersManual.rst

index e041e388762d7180a024b5318d3dbaaabe5cbbca..ef64e9dcb7bd098d84d54012c6ff28f1353133ff 100644 (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.