]> git.droids-corp.org - dpdk.git/blobdiff - doc/guides/contributing/coding_style.rst
fix dpdk.org URLs
[dpdk.git] / doc / guides / contributing / coding_style.rst
index 19445c113a25f31152914c14e89925b1f6ff7dac..d96698a7396309d3de9e8e262601dc4212b69c67 100644 (file)
@@ -247,6 +247,15 @@ Structure Declarations
 * Use of the structures should be by separate variable declarations and those declarations must be extern if they are declared in a header file.
 * Externally visible structure definitions should have the structure name prefixed by ``rte_`` to avoid namespace collisions.
 
 * Use of the structures should be by separate variable declarations and those declarations must be extern if they are declared in a header file.
 * Externally visible structure definitions should have the structure name prefixed by ``rte_`` to avoid namespace collisions.
 
+.. note::
+
+    Uses of ``bool`` in structures are not preferred as is wastes space and
+    it's also not clear as to what type size the bool is. A preferred use of
+    ``bool`` is mainly as a return type from functions that return true/false,
+    and maybe local variable functions.
+
+    Ref: `LKML <https://lkml.org/lkml/2017/11/21/384>`_
+
 Queues
 ~~~~~~
 
 Queues
 ~~~~~~