mbox series

[v4,0/1] docs/mm: start filling out new structure

Message ID 20230115184212.996298-1-rppt@kernel.org (mailing list archive)
Headers show
Series docs/mm: start filling out new structure | expand

Message

Mike Rapoport Jan. 15, 2023, 6:42 p.m. UTC
Hi,

Last year at LSF/MM Matthew promptly created the new structure for MM
documentation, but there still was no patches with content.

I've started to work on it a while ago and I wanted to send it out in a
more complete form, but I've got distracted and didn't have time to work
on this.

With fast changes around struct page and the threat of Lorenzo's book,
I've decided to send out what I have till now with a hope that we can
really make this a collaborative effort with people filling paragraph
here and there.

If somebody does not feel like sending formal patches, just send me the
"raw" text my way and I'll deal with the rest.

The text is relatively heavily formatted because I believe the target
audience will prefer html version.

v4:
* squash commits into one (Bagas)
* fix references formatting (kbuild)
* add Reviewed-by and Acked-by tags

v3: https://lore.kernel.org/all/20230112091616.824565-1-rppt@kernel.org
* rephrase ZONE_DMA(32) and ZONE_MOVABLE description (Michal)
* add cross-reference to DMA API

v2: https://lore.kernel.org/all/20230110152358.2641910-1-rppt@kernel.org
* rephrase the paragraph inroducing zones (Lorenzo)
* update formatting (Bagas)
* add section stubs (Bagas)
* small fixes here and there

v1: https://lore.kernel.org/all/20230101094523.1522109-1-rppt@kernel.org

Mike Rapoport (IBM) (1):
  docs/mm: Physical Memory: add structure, introduction and nodes
    description

 Documentation/core-api/dma-api.rst   |   2 +
 Documentation/mm/page_reclaim.rst    |   2 +
 Documentation/mm/physical_memory.rst | 346 +++++++++++++++++++++++++++
 3 files changed, 350 insertions(+)

Comments

Mike Rapoport Jan. 22, 2023, 5:30 a.m. UTC | #1
Gentle ping.

On Sun, Jan 15, 2023 at 08:42:11PM +0200, Mike Rapoport wrote:
> Hi,
> 
> Last year at LSF/MM Matthew promptly created the new structure for MM
> documentation, but there still was no patches with content.
> 
> I've started to work on it a while ago and I wanted to send it out in a
> more complete form, but I've got distracted and didn't have time to work
> on this.
> 
> With fast changes around struct page and the threat of Lorenzo's book,
> I've decided to send out what I have till now with a hope that we can
> really make this a collaborative effort with people filling paragraph
> here and there.
> 
> If somebody does not feel like sending formal patches, just send me the
> "raw" text my way and I'll deal with the rest.
> 
> The text is relatively heavily formatted because I believe the target
> audience will prefer html version.
> 
> v4:
> * squash commits into one (Bagas)
> * fix references formatting (kbuild)
> * add Reviewed-by and Acked-by tags
> 
> v3: https://lore.kernel.org/all/20230112091616.824565-1-rppt@kernel.org
> * rephrase ZONE_DMA(32) and ZONE_MOVABLE description (Michal)
> * add cross-reference to DMA API
> 
> v2: https://lore.kernel.org/all/20230110152358.2641910-1-rppt@kernel.org
> * rephrase the paragraph inroducing zones (Lorenzo)
> * update formatting (Bagas)
> * add section stubs (Bagas)
> * small fixes here and there
> 
> v1: https://lore.kernel.org/all/20230101094523.1522109-1-rppt@kernel.org
> 
> Mike Rapoport (IBM) (1):
>   docs/mm: Physical Memory: add structure, introduction and nodes
>     description
> 
>  Documentation/core-api/dma-api.rst   |   2 +
>  Documentation/mm/page_reclaim.rst    |   2 +
>  Documentation/mm/physical_memory.rst | 346 +++++++++++++++++++++++++++
>  3 files changed, 350 insertions(+)
> 
> -- 
> 2.35.1
>
Jonathan Corbet Jan. 22, 2023, 5:43 p.m. UTC | #2
Mike Rapoport <rppt@kernel.org> writes:

> Gentle ping.

Is that your way of saying that you think it's perhaps ready to be
applied?  I've been watching the discussion but wasn't sure if things
have settled or not.

Thanks,

jon
Mike Rapoport Jan. 22, 2023, 6:41 p.m. UTC | #3
On Sun, Jan 22, 2023 at 10:43:06AM -0700, Jonathan Corbet wrote:
> Mike Rapoport <rppt@kernel.org> writes:
> 
> > Gentle ping.
> 
> Is that your way of saying that you think it's perhaps ready to be
> applied?  I've been watching the discussion but wasn't sure if things
> have settled or not.

Well, everybody who participated in the discussion acked the patch, so
yeah, I think it's ready ;-)
 
> Thanks,
> 
> jon