[RFC 08/47] doc: suggest bsd_queue.h

Stephen Hemminger
2025-08-18T23:33:32Z

Don't suggest use of sys/queue.h

Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
doc/guides/contributing/coding_style.rst | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/guides/contributing/coding_style.rst b/doc/guides/contributing/coding_style.rst
index 243a3c2959..1f3d5d9acb 100644
--- a/doc/guides/contributing/coding_style.rst
+++ b/doc/guides/contributing/coding_style.rst
@@ -324,12 +324,12 @@ Structure Declarations
Queues
~~~~~~

-Use queue(3) macros rather than rolling your own lists, whenever possible.
+Use queue(3) macros defined in <bsd_queue.h> rather than rolling your own lists.
Thus, the previous example would be better written:

.. code-block:: c

- #include <sys/queue.h>
+ #include <bsd_queue.h>

struct foo {
LIST_ENTRY(foo) link; /* Use queue macros for foo lists. */
--
2.47.2