Re: [PATCH] docs/mm: Physical Memory: add "Memory map" section

From: Matthew Wilcox
Date: Wed Sep 06 2023 - 10:09:53 EST


On Wed, Sep 06, 2023 at 03:52:14PM +0300, Mike Rapoport wrote:
> On Wed, Sep 06, 2023 at 01:21:02PM +0100, Matthew Wilcox wrote:
> > I don't understand why you've done all this instead of linking to the
> > kernel-doc I wrote.
>
> We can't have it both in Documentation/core-api/mm-api.rst and here without
> sphinx complaining:

I didn't say "include it here", I said "link to it".

I don't see the value in documenting all of these structs here. They
should be documented in the subsystem that actually uses them. Just a
note that there's per-allocation data stored in struct page should be
enough, I think.