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.