Re: [PATCH 0/3] Better organize the core-api manual

From: Jonathan Corbet
Date: Mon Mar 02 2020 - 18:23:50 EST


On Mon, 2 Mar 2020 14:59:43 -0800
Kees Cook <keescook@xxxxxxxxxxxx> wrote:

> Random thought while looking through it: there's
> stuff in the driver-api that seems like maybe it should move into the
> core (e.g. Documentation/driver-api/basics.rst) but I'm not sure what
> the line between "core" and "driver" is. I would think the "driver API"
> docs should be driver-specific, in which case much of basics.rst should
> be moved into "core".

Sigh...driver-api is, of course, an even bigger mess than core-api. I
mean to delve into it and create some order there as well, when I get a
chance.

The original idea was that driver-api would contain stuff you need to know
if you're writing drivers but can ignore otherwise. We can always rethink
that, of course.

Thanks,

jon