* [PATCH] mm,doc: Add new documentation structure
@ 2022-05-03 6:30 Matthew Wilcox (Oracle)
2022-05-04 6:30 ` Bagas Sanjaya
` (2 more replies)
0 siblings, 3 replies; 10+ messages in thread
From: Matthew Wilcox (Oracle) @ 2022-05-03 6:30 UTC (permalink / raw)
To: linux-mm, linux-doc; +Cc: Matthew Wilcox (Oracle)
Closely following the outline of Mel Gorman's book "Understanding the
Linux Virtual Memory Manager", add a new outline. Preserve the current
contents of the mm underneath the new outline so we can transition those
documents to a more sensible place later.
Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
---
Documentation/vm/bootmem.rst | 5 +++++
Documentation/vm/index.rst | 27 +++++++++++++++++++++++----
Documentation/vm/oom.rst | 5 +++++
Documentation/vm/page_allocation.rst | 5 +++++
Documentation/vm/page_cache.rst | 5 +++++
Documentation/vm/page_reclaim.rst | 5 +++++
Documentation/vm/page_tables.rst | 5 +++++
Documentation/vm/physical_memory.rst | 5 +++++
Documentation/vm/process_addrs.rst | 5 +++++
Documentation/vm/shmfs.rst | 5 +++++
Documentation/vm/slab.rst | 5 +++++
Documentation/vm/swap.rst | 5 +++++
Documentation/vm/vmalloc.rst | 5 +++++
13 files changed, 83 insertions(+), 4 deletions(-)
create mode 100644 Documentation/vm/bootmem.rst
create mode 100644 Documentation/vm/oom.rst
create mode 100644 Documentation/vm/page_allocation.rst
create mode 100644 Documentation/vm/page_cache.rst
create mode 100644 Documentation/vm/page_reclaim.rst
create mode 100644 Documentation/vm/page_tables.rst
create mode 100644 Documentation/vm/physical_memory.rst
create mode 100644 Documentation/vm/process_addrs.rst
create mode 100644 Documentation/vm/shmfs.rst
create mode 100644 Documentation/vm/slab.rst
create mode 100644 Documentation/vm/swap.rst
create mode 100644 Documentation/vm/vmalloc.rst
diff --git a/Documentation/vm/bootmem.rst b/Documentation/vm/bootmem.rst
new file mode 100644
index 000000000000..eb2b31eedfa1
--- /dev/null
+++ b/Documentation/vm/bootmem.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+===========
+Boot Memory
+===========
diff --git a/Documentation/vm/index.rst b/Documentation/vm/index.rst
index 44365c4574a3..bc495a846871 100644
--- a/Documentation/vm/index.rst
+++ b/Documentation/vm/index.rst
@@ -2,12 +2,32 @@
Linux Memory Management Documentation
=====================================
+This is a guide to understanding the memory management subsystem
+of Linux. If you are looking for advice on simply allocating memory,
+see the :ref:`memory_allocation`. For controlling and tuning guides,
+see the :doc:`admin guide <../admin-guide/mm/index>`.
+
+.. toctree::
+ :maxdepth: 1
+
+ physical_memory
+ page_tables
+ process_addrs
+ bootmem
+ page_allocation
+ vmalloc
+ slab
+ highmem
+ page_reclaim
+ swap
+ page_cache
+ shmfs
+ oom
+
This is a collection of documents about the Linux memory management (mm)
subsystem internals with different level of details ranging from notes and
mailing list responses for elaborating descriptions of data structures and
-algorithms. If you are looking for advice on simply allocating memory, see the
-:ref:`memory_allocation`. For controlling and tuning guides, see the
-:doc:`admin guide <../admin-guide/mm/index>`.
+algorithms.
.. toctree::
:maxdepth: 1
@@ -18,7 +38,6 @@ algorithms. If you are looking for advice on simply allocating memory, see the
damon/index
free_page_reporting
frontswap
- highmem
hmm
hwpoison
hugetlbfs_reserv
diff --git a/Documentation/vm/oom.rst b/Documentation/vm/oom.rst
new file mode 100644
index 000000000000..18e9e40c1ec1
--- /dev/null
+++ b/Documentation/vm/oom.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+======================
+Out Of Memory Handling
+======================
diff --git a/Documentation/vm/page_allocation.rst b/Documentation/vm/page_allocation.rst
new file mode 100644
index 000000000000..d9b4495561f1
--- /dev/null
+++ b/Documentation/vm/page_allocation.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+===============
+Page Allocation
+===============
diff --git a/Documentation/vm/page_cache.rst b/Documentation/vm/page_cache.rst
new file mode 100644
index 000000000000..75eba7c431b2
--- /dev/null
+++ b/Documentation/vm/page_cache.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+==========
+Page Cache
+==========
diff --git a/Documentation/vm/page_reclaim.rst b/Documentation/vm/page_reclaim.rst
new file mode 100644
index 000000000000..50a30b7f8ac3
--- /dev/null
+++ b/Documentation/vm/page_reclaim.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+============
+Page Reclaim
+============
diff --git a/Documentation/vm/page_tables.rst b/Documentation/vm/page_tables.rst
new file mode 100644
index 000000000000..96939571d7bc
--- /dev/null
+++ b/Documentation/vm/page_tables.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+===========
+Page Tables
+===========
diff --git a/Documentation/vm/physical_memory.rst b/Documentation/vm/physical_memory.rst
new file mode 100644
index 000000000000..2ab7b8c1c863
--- /dev/null
+++ b/Documentation/vm/physical_memory.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+===============
+Physical Memory
+===============
diff --git a/Documentation/vm/process_addrs.rst b/Documentation/vm/process_addrs.rst
new file mode 100644
index 000000000000..e8618fbc62c9
--- /dev/null
+++ b/Documentation/vm/process_addrs.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+=================
+Process Addresses
+=================
diff --git a/Documentation/vm/shmfs.rst b/Documentation/vm/shmfs.rst
new file mode 100644
index 000000000000..8b01ebb4c30e
--- /dev/null
+++ b/Documentation/vm/shmfs.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+========================
+Shared Memory Filesystem
+========================
diff --git a/Documentation/vm/slab.rst b/Documentation/vm/slab.rst
new file mode 100644
index 000000000000..87d5a5bb172f
--- /dev/null
+++ b/Documentation/vm/slab.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+===============
+Slab Allocation
+===============
diff --git a/Documentation/vm/swap.rst b/Documentation/vm/swap.rst
new file mode 100644
index 000000000000..78819bd4d745
--- /dev/null
+++ b/Documentation/vm/swap.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+====
+Swap
+====
diff --git a/Documentation/vm/vmalloc.rst b/Documentation/vm/vmalloc.rst
new file mode 100644
index 000000000000..363fe20d6b9f
--- /dev/null
+++ b/Documentation/vm/vmalloc.rst
@@ -0,0 +1,5 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+======================================
+Virtually Contiguous Memory Allocation
+======================================
--
2.34.1
^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-03 6:30 [PATCH] mm,doc: Add new documentation structure Matthew Wilcox (Oracle)
@ 2022-05-04 6:30 ` Bagas Sanjaya
2022-05-04 16:58 ` Matthew Wilcox
2022-05-04 13:12 ` John Hubbard
2022-05-06 21:10 ` Johannes Weiner
2 siblings, 1 reply; 10+ messages in thread
From: Bagas Sanjaya @ 2022-05-04 6:30 UTC (permalink / raw)
To: Matthew Wilcox (Oracle); +Cc: linux-mm, linux-doc
On Tue, May 03, 2022 at 07:30:32AM +0100, Matthew Wilcox (Oracle) wrote:
> Closely following the outline of Mel Gorman's book "Understanding the
> Linux Virtual Memory Manager", add a new outline. Preserve the current
> contents of the mm underneath the new outline so we can transition those
> documents to a more sensible place later.
>
> Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
> ---
> Documentation/vm/bootmem.rst | 5 +++++
> Documentation/vm/index.rst | 27 +++++++++++++++++++++++----
> Documentation/vm/oom.rst | 5 +++++
> Documentation/vm/page_allocation.rst | 5 +++++
> Documentation/vm/page_cache.rst | 5 +++++
> Documentation/vm/page_reclaim.rst | 5 +++++
> Documentation/vm/page_tables.rst | 5 +++++
> Documentation/vm/physical_memory.rst | 5 +++++
> Documentation/vm/process_addrs.rst | 5 +++++
> Documentation/vm/shmfs.rst | 5 +++++
> Documentation/vm/slab.rst | 5 +++++
> Documentation/vm/swap.rst | 5 +++++
> Documentation/vm/vmalloc.rst | 5 +++++
> 13 files changed, 83 insertions(+), 4 deletions(-)
> create mode 100644 Documentation/vm/bootmem.rst
> create mode 100644 Documentation/vm/oom.rst
> create mode 100644 Documentation/vm/page_allocation.rst
> create mode 100644 Documentation/vm/page_cache.rst
> create mode 100644 Documentation/vm/page_reclaim.rst
> create mode 100644 Documentation/vm/page_tables.rst
> create mode 100644 Documentation/vm/physical_memory.rst
> create mode 100644 Documentation/vm/process_addrs.rst
> create mode 100644 Documentation/vm/shmfs.rst
> create mode 100644 Documentation/vm/slab.rst
> create mode 100644 Documentation/vm/swap.rst
> create mode 100644 Documentation/vm/vmalloc.rst
>
These new documents are stub, right?
--
An old man doll... just what I always wanted! - Clara
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-03 6:30 [PATCH] mm,doc: Add new documentation structure Matthew Wilcox (Oracle)
2022-05-04 6:30 ` Bagas Sanjaya
@ 2022-05-04 13:12 ` John Hubbard
2022-05-04 17:01 ` Matthew Wilcox
2022-05-04 20:29 ` Matthew Wilcox
2022-05-06 21:10 ` Johannes Weiner
2 siblings, 2 replies; 10+ messages in thread
From: John Hubbard @ 2022-05-04 13:12 UTC (permalink / raw)
To: Matthew Wilcox (Oracle), linux-mm, linux-doc
On 5/2/22 11:30 PM, Matthew Wilcox (Oracle) wrote:
> Closely following the outline of Mel Gorman's book "Understanding the
> Linux Virtual Memory Manager", add a new outline. Preserve the current
> contents of the mm underneath the new outline so we can transition those
> documents to a more sensible place later.
>
> Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
> ---
> Documentation/vm/bootmem.rst | 5 +++++
> Documentation/vm/index.rst | 27 +++++++++++++++++++++++----
> Documentation/vm/oom.rst | 5 +++++
> Documentation/vm/page_allocation.rst | 5 +++++
> Documentation/vm/page_cache.rst | 5 +++++
> Documentation/vm/page_reclaim.rst | 5 +++++
> Documentation/vm/page_tables.rst | 5 +++++
> Documentation/vm/physical_memory.rst | 5 +++++
> Documentation/vm/process_addrs.rst | 5 +++++
> Documentation/vm/shmfs.rst | 5 +++++
> Documentation/vm/slab.rst | 5 +++++
> Documentation/vm/swap.rst | 5 +++++
> Documentation/vm/vmalloc.rst | 5 +++++
> 13 files changed, 83 insertions(+), 4 deletions(-)
> create mode 100644 Documentation/vm/bootmem.rst
> create mode 100644 Documentation/vm/oom.rst
> create mode 100644 Documentation/vm/page_allocation.rst
> create mode 100644 Documentation/vm/page_cache.rst
> create mode 100644 Documentation/vm/page_reclaim.rst
> create mode 100644 Documentation/vm/page_tables.rst
> create mode 100644 Documentation/vm/physical_memory.rst
> create mode 100644 Documentation/vm/process_addrs.rst
> create mode 100644 Documentation/vm/shmfs.rst
> create mode 100644 Documentation/vm/slab.rst
> create mode 100644 Documentation/vm/swap.rst
> create mode 100644 Documentation/vm/vmalloc.rst
>
> diff --git a/Documentation/vm/bootmem.rst b/Documentation/vm/bootmem.rst
> new file mode 100644
> index 000000000000..eb2b31eedfa1
> --- /dev/null
> +++ b/Documentation/vm/bootmem.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +===========
> +Boot Memory
> +===========
> diff --git a/Documentation/vm/index.rst b/Documentation/vm/index.rst
> index 44365c4574a3..bc495a846871 100644
> --- a/Documentation/vm/index.rst
> +++ b/Documentation/vm/index.rst
> @@ -2,12 +2,32 @@
> Linux Memory Management Documentation
> =====================================
>
> +This is a guide to understanding the memory management subsystem
> +of Linux. If you are looking for advice on simply allocating memory,
> +see the :ref:`memory_allocation`. For controlling and tuning guides,
> +see the :doc:`admin guide <../admin-guide/mm/index>`.
This needs to be properly merged with the existing index. Otherwise
the result here is very confusing because there are two summaries
and no explanation of what is going on here.
If I get a moment today, I'll take a quick shot at at merging them,
and post some suggestions here, but just wanted to point that out
before this goes in as-is.
thanks,
--
John Hubbard
NVIDIA
> +
> +.. toctree::
> + :maxdepth: 1
> +
> + physical_memory
> + page_tables
> + process_addrs
> + bootmem
> + page_allocation
> + vmalloc
> + slab
> + highmem
> + page_reclaim
> + swap
> + page_cache
> + shmfs
> + oom
> +
> This is a collection of documents about the Linux memory management (mm)
> subsystem internals with different level of details ranging from notes and
> mailing list responses for elaborating descriptions of data structures and
> -algorithms. If you are looking for advice on simply allocating memory, see the
> -:ref:`memory_allocation`. For controlling and tuning guides, see the
> -:doc:`admin guide <../admin-guide/mm/index>`.
> +algorithms.
>
> .. toctree::
> :maxdepth: 1
> @@ -18,7 +38,6 @@ algorithms. If you are looking for advice on simply allocating memory, see the
> damon/index
> free_page_reporting
> frontswap
> - highmem
> hmm
> hwpoison
> hugetlbfs_reserv
> diff --git a/Documentation/vm/oom.rst b/Documentation/vm/oom.rst
> new file mode 100644
> index 000000000000..18e9e40c1ec1
> --- /dev/null
> +++ b/Documentation/vm/oom.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +======================
> +Out Of Memory Handling
> +======================
> diff --git a/Documentation/vm/page_allocation.rst b/Documentation/vm/page_allocation.rst
> new file mode 100644
> index 000000000000..d9b4495561f1
> --- /dev/null
> +++ b/Documentation/vm/page_allocation.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +===============
> +Page Allocation
> +===============
> diff --git a/Documentation/vm/page_cache.rst b/Documentation/vm/page_cache.rst
> new file mode 100644
> index 000000000000..75eba7c431b2
> --- /dev/null
> +++ b/Documentation/vm/page_cache.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +==========
> +Page Cache
> +==========
> diff --git a/Documentation/vm/page_reclaim.rst b/Documentation/vm/page_reclaim.rst
> new file mode 100644
> index 000000000000..50a30b7f8ac3
> --- /dev/null
> +++ b/Documentation/vm/page_reclaim.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +============
> +Page Reclaim
> +============
> diff --git a/Documentation/vm/page_tables.rst b/Documentation/vm/page_tables.rst
> new file mode 100644
> index 000000000000..96939571d7bc
> --- /dev/null
> +++ b/Documentation/vm/page_tables.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +===========
> +Page Tables
> +===========
> diff --git a/Documentation/vm/physical_memory.rst b/Documentation/vm/physical_memory.rst
> new file mode 100644
> index 000000000000..2ab7b8c1c863
> --- /dev/null
> +++ b/Documentation/vm/physical_memory.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +===============
> +Physical Memory
> +===============
> diff --git a/Documentation/vm/process_addrs.rst b/Documentation/vm/process_addrs.rst
> new file mode 100644
> index 000000000000..e8618fbc62c9
> --- /dev/null
> +++ b/Documentation/vm/process_addrs.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +=================
> +Process Addresses
> +=================
> diff --git a/Documentation/vm/shmfs.rst b/Documentation/vm/shmfs.rst
> new file mode 100644
> index 000000000000..8b01ebb4c30e
> --- /dev/null
> +++ b/Documentation/vm/shmfs.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +========================
> +Shared Memory Filesystem
> +========================
> diff --git a/Documentation/vm/slab.rst b/Documentation/vm/slab.rst
> new file mode 100644
> index 000000000000..87d5a5bb172f
> --- /dev/null
> +++ b/Documentation/vm/slab.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +===============
> +Slab Allocation
> +===============
> diff --git a/Documentation/vm/swap.rst b/Documentation/vm/swap.rst
> new file mode 100644
> index 000000000000..78819bd4d745
> --- /dev/null
> +++ b/Documentation/vm/swap.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +====
> +Swap
> +====
> diff --git a/Documentation/vm/vmalloc.rst b/Documentation/vm/vmalloc.rst
> new file mode 100644
> index 000000000000..363fe20d6b9f
> --- /dev/null
> +++ b/Documentation/vm/vmalloc.rst
> @@ -0,0 +1,5 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +======================================
> +Virtually Contiguous Memory Allocation
> +======================================
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-04 6:30 ` Bagas Sanjaya
@ 2022-05-04 16:58 ` Matthew Wilcox
0 siblings, 0 replies; 10+ messages in thread
From: Matthew Wilcox @ 2022-05-04 16:58 UTC (permalink / raw)
To: Bagas Sanjaya; +Cc: linux-mm, linux-doc
On Wed, May 04, 2022 at 01:30:18PM +0700, Bagas Sanjaya wrote:
> On Tue, May 03, 2022 at 07:30:32AM +0100, Matthew Wilcox (Oracle) wrote:
> > Closely following the outline of Mel Gorman's book "Understanding the
> > Linux Virtual Memory Manager", add a new outline. Preserve the current
^^^^^^^^^^^^^^^^^
> These new documents are stub, right?
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-04 13:12 ` John Hubbard
@ 2022-05-04 17:01 ` Matthew Wilcox
2022-05-04 20:29 ` Matthew Wilcox
1 sibling, 0 replies; 10+ messages in thread
From: Matthew Wilcox @ 2022-05-04 17:01 UTC (permalink / raw)
To: John Hubbard; +Cc: linux-mm, linux-doc
On Wed, May 04, 2022 at 06:12:09AM -0700, John Hubbard wrote:
> > @@ -2,12 +2,32 @@
> > Linux Memory Management Documentation
> > =====================================
> > +This is a guide to understanding the memory management subsystem
> > +of Linux. If you are looking for advice on simply allocating memory,
> > +see the :ref:`memory_allocation`. For controlling and tuning guides,
> > +see the :doc:`admin guide <../admin-guide/mm/index>`.
>
> This needs to be properly merged with the existing index. Otherwise
> the result here is very confusing because there are two summaries
> and no explanation of what is going on here.
Hm? It reads OK to me the way I sent it out:
Linux Memory Management Documentation¶
This is a guide to understanding the memory management subsystem of
Linux. If you are looking for advice on simply allocating memory,
see the Memory Allocation Guide. For controlling and tuning guides,
see the admin guide.
[... list ...]
This is a collection of documents about the Linux memory management
(mm) subsystem internals with different level of details ranging from
notes and mailing list responses for elaborating descriptions of data
structures and algorithms.
[... another list ...]
> If I get a moment today, I'll take a quick shot at at merging them,
> and post some suggestions here, but just wanted to point that out
> before this goes in as-is.
Happy to sit down with you in a free moment. I have all this on my
laptop, including an htmldocs built version.
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-04 13:12 ` John Hubbard
2022-05-04 17:01 ` Matthew Wilcox
@ 2022-05-04 20:29 ` Matthew Wilcox
2022-05-05 0:39 ` John Hubbard
2022-05-05 4:43 ` Randy Dunlap
1 sibling, 2 replies; 10+ messages in thread
From: Matthew Wilcox @ 2022-05-04 20:29 UTC (permalink / raw)
To: John Hubbard; +Cc: linux-mm, linux-doc
On Wed, May 04, 2022 at 06:12:09AM -0700, John Hubbard wrote:
> This needs to be properly merged with the existing index. Otherwise
> the result here is very confusing because there are two summaries
> and no explanation of what is going on here.
>
> If I get a moment today, I'll take a quick shot at at merging them,
> and post some suggestions here, but just wanted to point that out
> before this goes in as-is.
John and I have chatted to understand what he was getting at here,
but haven't had a chance to review this change in-person yet.
+++ b/Documentation/vm/index.rst
@@ -2,6 +2,9 @@
Linux Memory Management Documentation
=====================================
+Memory Management Guide
+=======================
+
This is a guide to understanding the memory management subsystem
of Linux. If you are looking for advice on simply allocating memory,
see the :ref:`memory_allocation`. For controlling and tuning guides,
@@ -24,10 +27,14 @@ see the :doc:`admin guide <../admin-guide/mm/index>`.
shmfs
oom
-This is a collection of documents about the Linux memory management (mm)
-subsystem internals with different level of details ranging from notes and
-mailing list responses for elaborating descriptions of data structures and
-algorithms.
+Legacy Documentation
+====================
+
+This is a collection of older documents about the Linux memory management
+(mm) subsystem internals with different level of details ranging from
+notes and mailing list responses for elaborating descriptions of data
+structures and algorithms. It should all be integrated nicely into the
+above structured documentation, or deleted if it has served its purpose.
.. toctree::
:maxdepth: 1
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-04 20:29 ` Matthew Wilcox
@ 2022-05-05 0:39 ` John Hubbard
2022-05-05 4:43 ` Randy Dunlap
1 sibling, 0 replies; 10+ messages in thread
From: John Hubbard @ 2022-05-05 0:39 UTC (permalink / raw)
To: Matthew Wilcox; +Cc: linux-mm, linux-doc
On 5/4/22 1:29 PM, Matthew Wilcox wrote:
> On Wed, May 04, 2022 at 06:12:09AM -0700, John Hubbard wrote:
>> This needs to be properly merged with the existing index. Otherwise
>> the result here is very confusing because there are two summaries
>> and no explanation of what is going on here.
>>
>> If I get a moment today, I'll take a quick shot at at merging them,
>> and post some suggestions here, but just wanted to point that out
>> before this goes in as-is.
>
> John and I have chatted to understand what he was getting at here,
> but haven't had a chance to review this change in-person yet.
>
> +++ b/Documentation/vm/index.rst
> @@ -2,6 +2,9 @@
> Linux Memory Management Documentation
> =====================================
>
> +Memory Management Guide
> +=======================
> +
> This is a guide to understanding the memory management subsystem
> of Linux. If you are looking for advice on simply allocating memory,
> see the :ref:`memory_allocation`. For controlling and tuning guides,
> @@ -24,10 +27,14 @@ see the :doc:`admin guide <../admin-guide/mm/index>`.
> shmfs
> oom
>
> -This is a collection of documents about the Linux memory management (mm)
> -subsystem internals with different level of details ranging from notes and
> -mailing list responses for elaborating descriptions of data structures and
> -algorithms.
> +Legacy Documentation
> +====================
> +
> +This is a collection of older documents about the Linux memory management
> +(mm) subsystem internals with different level of details ranging from
> +notes and mailing list responses for elaborating descriptions of data
> +structures and algorithms. It should all be integrated nicely into the
> +above structured documentation, or deleted if it has served its purpose.
>
> .. toctree::
> :maxdepth: 1
>
Reviewed-by: John Hubbard <jhubbard@nvidia.com>
thanks,
--
John Hubbard
NVIDIA
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-04 20:29 ` Matthew Wilcox
2022-05-05 0:39 ` John Hubbard
@ 2022-05-05 4:43 ` Randy Dunlap
2022-05-05 4:49 ` Matthew Wilcox
1 sibling, 1 reply; 10+ messages in thread
From: Randy Dunlap @ 2022-05-05 4:43 UTC (permalink / raw)
To: Matthew Wilcox, John Hubbard; +Cc: linux-mm, linux-doc
On 5/4/22 13:29, Matthew Wilcox wrote:
> On Wed, May 04, 2022 at 06:12:09AM -0700, John Hubbard wrote:
>> This needs to be properly merged with the existing index. Otherwise
>> the result here is very confusing because there are two summaries
>> and no explanation of what is going on here.
>>
>> If I get a moment today, I'll take a quick shot at at merging them,
>> and post some suggestions here, but just wanted to point that out
>> before this goes in as-is.
>
> John and I have chatted to understand what he was getting at here,
> but haven't had a chance to review this change in-person yet.
>
> +++ b/Documentation/vm/index.rst
> @@ -2,6 +2,9 @@
> Linux Memory Management Documentation
> =====================================
>
> +Memory Management Guide
> +=======================
> +
> This is a guide to understanding the memory management subsystem
> of Linux. If you are looking for advice on simply allocating memory,
> see the :ref:`memory_allocation`. For controlling and tuning guides,
> @@ -24,10 +27,14 @@ see the :doc:`admin guide <../admin-guide/mm/index>`.
> shmfs
> oom
>
> -This is a collection of documents about the Linux memory management (mm)
> -subsystem internals with different level of details ranging from notes and
> -mailing list responses for elaborating descriptions of data structures and
> -algorithms.
> +Legacy Documentation
> +====================
> +
> +This is a collection of older documents about the Linux memory management
> +(mm) subsystem internals with different level of details ranging from
I prefer (MM).
Otherwise LGTM.
Acked-by: Randy Dunlap <rdunlap@infradead.org>
Thanks.
> +notes and mailing list responses for elaborating descriptions of data
> +structures and algorithms. It should all be integrated nicely into the
> +above structured documentation, or deleted if it has served its purpose.
>
> .. toctree::
> :maxdepth: 1
>
--
~Randy
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-05 4:43 ` Randy Dunlap
@ 2022-05-05 4:49 ` Matthew Wilcox
0 siblings, 0 replies; 10+ messages in thread
From: Matthew Wilcox @ 2022-05-05 4:49 UTC (permalink / raw)
To: Randy Dunlap; +Cc: John Hubbard, linux-mm, linux-doc
On Wed, May 04, 2022 at 09:43:04PM -0700, Randy Dunlap wrote:
>
>
> On 5/4/22 13:29, Matthew Wilcox wrote:
> > On Wed, May 04, 2022 at 06:12:09AM -0700, John Hubbard wrote:
> >> This needs to be properly merged with the existing index. Otherwise
> >> the result here is very confusing because there are two summaries
> >> and no explanation of what is going on here.
> >>
> >> If I get a moment today, I'll take a quick shot at at merging them,
> >> and post some suggestions here, but just wanted to point that out
> >> before this goes in as-is.
> >
> > John and I have chatted to understand what he was getting at here,
> > but haven't had a chance to review this change in-person yet.
> >
> > +++ b/Documentation/vm/index.rst
> > @@ -2,6 +2,9 @@
> > Linux Memory Management Documentation
> > =====================================
> >
> > +Memory Management Guide
> > +=======================
> > +
> > This is a guide to understanding the memory management subsystem
> > of Linux. If you are looking for advice on simply allocating memory,
> > see the :ref:`memory_allocation`. For controlling and tuning guides,
> > @@ -24,10 +27,14 @@ see the :doc:`admin guide <../admin-guide/mm/index>`.
> > shmfs
> > oom
> >
> > -This is a collection of documents about the Linux memory management (mm)
> > -subsystem internals with different level of details ranging from notes and
> > -mailing list responses for elaborating descriptions of data structures and
> > -algorithms.
> > +Legacy Documentation
> > +====================
> > +
> > +This is a collection of older documents about the Linux memory management
> > +(mm) subsystem internals with different level of details ranging from
>
> I prefer (MM).
> Otherwise LGTM.
Heh, I just moved that around; it's how it was before. I have no
preference here, so I'll just change it to be the way you like it.
Thanks!
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH] mm,doc: Add new documentation structure
2022-05-03 6:30 [PATCH] mm,doc: Add new documentation structure Matthew Wilcox (Oracle)
2022-05-04 6:30 ` Bagas Sanjaya
2022-05-04 13:12 ` John Hubbard
@ 2022-05-06 21:10 ` Johannes Weiner
2 siblings, 0 replies; 10+ messages in thread
From: Johannes Weiner @ 2022-05-06 21:10 UTC (permalink / raw)
To: Matthew Wilcox (Oracle); +Cc: linux-mm, linux-doc
On Tue, May 03, 2022 at 07:30:32AM +0100, Matthew Wilcox (Oracle) wrote:
> Closely following the outline of Mel Gorman's book "Understanding the
> Linux Virtual Memory Manager", add a new outline. Preserve the current
> contents of the mm underneath the new outline so we can transition those
> documents to a more sensible place later.
>
> Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Acked-by: Johannes Weiner <hannes@cmpxchg.org>
^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2022-05-06 21:11 UTC | newest]
Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-05-03 6:30 [PATCH] mm,doc: Add new documentation structure Matthew Wilcox (Oracle)
2022-05-04 6:30 ` Bagas Sanjaya
2022-05-04 16:58 ` Matthew Wilcox
2022-05-04 13:12 ` John Hubbard
2022-05-04 17:01 ` Matthew Wilcox
2022-05-04 20:29 ` Matthew Wilcox
2022-05-05 0:39 ` John Hubbard
2022-05-05 4:43 ` Randy Dunlap
2022-05-05 4:49 ` Matthew Wilcox
2022-05-06 21:10 ` Johannes Weiner
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.