[PATCH 0/4] coding-style: recommend reusing macros from split headers instead of kernel.h

Yueh-Shun Li
2024-01-08T16:15:45Z

Dear Maintainers,

This series of patches targets the "Linux kernel coding style"
documentation and recommend reusing macros inside the include/linux
directory instead of the obsolete header "include/linux/kernel.h".

This addresses the issue 'Irrelevant documentation recommending the use
of "include/linux/kernel.h"'[1][2] and help deprecating "kernel.h".

If applied, developers will no longer be confused by the contradiction
between "Linux kernel style guide" suggestions and the deprecation
notice on top of "kernel.h".

There's also a patch that adds an example to show how reusing macro
definition from shared headers help prevent naming collisions.

This series contains the update to the zh_TW and zh_CN translation of
the corresponding documentation changes.

Best regards,

Shamrock

[1]: https://lore.kernel.org/linux-doc/bc63acd7ef43bdd8d9609fa48dbf92f9@posteo.net/
[2]: https://lore.kernel.org/linux-doc/107b6b5e-ca14-4b2b-ba2e-38ecd74c0ad3@infradead.org/

Yueh-Shun Li (4):
coding-style: recommend split headers instead of kernel.h
coding-style: show how reusing macros prevents naming collisions
doc/zh_TW: coding-style: update content for section 18
doc/zh_CN: coding-style: update content of section 18

Documentation/process/coding-style.rst | 41 +++++++++++++++----
.../zh_CN/process/coding-style.rst | 39 ++++++++++++++----
.../zh_TW/process/coding-style.rst | 39 ++++++++++++++----
3 files changed, 95 insertions(+), 24 deletions(-)

--
2.42.0