]> www.infradead.org Git - users/jedix/linux-maple.git/commit
mm/page_alloc: clarify should_claim_block() commentary
authorBrendan Jackman <jackmanb@google.com>
Tue, 25 Feb 2025 15:29:49 +0000 (15:29 +0000)
committerAndrew Morton <akpm@linux-foundation.org>
Fri, 28 Feb 2025 01:00:33 +0000 (17:00 -0800)
commit23c638e093207721facef995cfd47f9e159320e1
tree9259be47f2da72c9d9ba296bf5eaa7acd07032ee
parentfbc2bf5860476d2cf02de00a43b2d509c55b9f52
mm/page_alloc: clarify should_claim_block() commentary

There's lots of text here but it's a little hard to follow, this is an
attempt to break it up and align its structure more closely with the code.

Reword the top-level function comment to just explain what question the
function answers from the point of view of the caller.

Break up the internal logic into different sections that can have their
own commentary describing why that part of the rationale is present.

Note the page_groupy_by_mobility_disabled logic is not explained in the
commentary, that is outside the scope of this patch...

Link: https://lkml.kernel.org/r/20250225-clarify-steal-v3-2-f2550ead0139@google.com
Signed-off-by: Brendan Jackman <jackmanb@google.com>
Cc: Johannes Weiner <hannes@cmpxchg.org>
Cc: Mel Gorman <mgorman@techsingularity.net>
Cc: Michal Hocko <mhocko@kernel.org>
Cc: Vlastimil Babka <vbabka@suse.cz>
Cc: Yosry Ahmed <yosry.ahmed@linux.dev>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
mm/page_alloc.c