Re: [PATCH v2 1/1] docs: Update documentation to avoid mentioning of kernel.h
From: Andy Shevchenko
Date: Sun Dec 28 2025 - 13:02:25 EST
On Mon, Dec 22, 2025 at 03:00:24PM -0700, Jonathan Corbet wrote:
> Andy Shevchenko <andriy.shevchenko@xxxxxxxxxxxxxxx> writes:
>
> > For several years, and still ongoing, the kernel.h is being split
> > to smaller and narrow headers to avoid "including everything" approach
> > which is bad in many ways. Since that, documentation missed a few
> > required updates to align with that work. Do it here.
> >
> > Note, language translations are left untouched and if anybody willing
> > to help, please provide path(es) based on the updated English variant.
> >
> > Signed-off-by: Andy Shevchenko <andriy.shevchenko@xxxxxxxxxxxxxxx>
> > Reviewed-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> > ---
> >
> > v2: collected tag (Randy), fixed util_macros k-doc (Randy, me), fixed spelling (Randy)
> >
> > Documentation/core-api/kobject.rst | 2 +-
> > Documentation/dev-tools/checkpatch.rst | 2 +-
> > Documentation/driver-api/basics.rst | 17 ++++++++++++++++-
> > .../driver-api/driver-model/design-patterns.rst | 2 +-
> > Documentation/process/coding-style.rst | 10 +++++++---
> > Documentation/staging/rpmsg.rst | 7 +++++--
> > include/linux/util_macros.h | 2 +-
> > 7 files changed, 32 insertions(+), 10 deletions(-)
>
> Applied (finally) thanks.
Thank you! I leave the translations to the respective maintainers and native
speakers to decide.
--
With Best Regards,
Andy Shevchenko