diff mbox

sparse: document that -Wbitwise is default

Message ID 20171017233136.24533-1-jacob.e.keller@intel.com (mailing list archive)
State Mainlined, archived
Headers show

Commit Message

Jacob Keller Oct. 17, 2017, 11:31 p.m. UTC
In commit commit 02a886bfa3d9 ("Introduce keyword driven
attribute parsing", 2007-03-08) the -Wbitwise keyword was broken and did
not actually work. Instead, bitwise checks were always enabled.

This was fixed by commit commit 0dfda0d1f0fe ("make -Wbitwise
operational again", 2017-02-18) which allowed -Wbitwise and -Wno-bitwise
to work as expected.

However, since -Wbitwise was enabled for so long, that commit changed
the default of -Wbitwise to be enabled, rather than the documented
"disabled".

Fix the documentation to match, and explain that -Wbitwise is enabled by
default and must be disabled.

Signed-off-by: Jacob Keller <jacob.e.keller@intel.com>
---
 sparse.1 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

Comments

Luc Van Oostenryck Oct. 18, 2017, 3:35 p.m. UTC | #1
On Tue, Oct 17, 2017 at 04:31:36PM -0700, Jacob Keller wrote:
> Fix the documentation to match, and explain that -Wbitwise is enabled by
> default and must be disabled.

Thanks for noticing this (and for the patch, of course).

Acked-by: Luc Van Oostenryck <luc.vanoostenryck@gmail.com>
--
To unsubscribe from this list: send the line "unsubscribe linux-sparse" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Christopher Li Oct. 18, 2017, 7:29 p.m. UTC | #2
On Tue, Oct 17, 2017 at 4:31 PM, Jacob Keller <jacob.e.keller@intel.com> wrote:
> In commit commit 02a886bfa3d9 ("Introduce keyword driven
> attribute parsing", 2007-03-08) the -Wbitwise keyword was broken and did
> not actually work. Instead, bitwise checks were always enabled.
>
> This was fixed by commit commit 0dfda0d1f0fe ("make -Wbitwise
> operational again", 2017-02-18) which allowed -Wbitwise and -Wno-bitwise
> to work as expected.
>
> However, since -Wbitwise was enabled for so long, that commit changed
> the default of -Wbitwise to be enabled, rather than the documented
> "disabled".
>
> Fix the documentation to match, and explain that -Wbitwise is enabled by
> default and must be disabled.

Thanks. Will apply.

Chris
--
To unsubscribe from this list: send the line "unsubscribe linux-sparse" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox

Patch

diff --git a/sparse.1 b/sparse.1
index fd4527aa5c95..bdfe14902ba6 100644
--- a/sparse.1
+++ b/sparse.1
@@ -67,8 +67,8 @@  kind of like "NULL" for pointers). So "gfp_t" or the "safe endianness"
 types would be __bitwise: you can only operate on them by doing
 specific operations that know about *that* particular type.
 
-Generally, you want bitwise if you are looking for type safety. Sparse
-does not issue these warnings by default.
+Sparse issues these warnings by default.  To turn them off, use
+\fB\-Wno\-bitwise\fR.
 .
 .TP
 .B \-Wcast\-to\-as