Re: [PATCH v2 2/2] core-api/memory-hotplug.rst: divide Locking Internal section by different locks

2018-12-05 Thread Mike Rapoport
id: words arrangement] > > Signed-off-by: Wei Yang Reviewd-by: Mike Rapoport > --- > v2: adjustment based on David and Mike comment > --- > Documentation/core-api/memory-hotplug.rst | 27 --- > 1 file changed, 24 insertions(+), 3 deletions(-) >

Re: [PATCH 2/2] core-api/memory-hotplug.rst: divide Locking Internal section by different locks

2018-12-05 Thread Mike Rapoport
On Wed, Dec 05, 2018 at 10:34:26AM +0800, Wei Yang wrote: > Currently locking for memory hotplug is a little complicated. > > Generally speaking, we leverage the two global lock: > > * device_hotplug_lock > * mem_hotplug_lock > > to serialise the process. > > While for the long term, we

Re: [PATCH 1/2] admin-guide/memory-hotplug.rst: remove locking internal part from admin-guide

2018-12-05 Thread Mike Rapoport
ation completion of remove works by OS to firmware. > > - Guard from remove if not yet. [ ... ] > > Future Work > > === > > > > > > I reported this yesterday to Jonathan and Mike > > https://lkml.org/lkml/2018/12/3/340 Somehow I've missed it... > Anyhow > > Reviewed-by: David Hildenbrand Acked-by: Mike Rapoport > > -- > > Thanks, > > David / dhildenb > -- Sincerely yours, Mike.

[PATCH] docs/core-api: make mm-api.rst more structured

2018-11-28 Thread Mike Rapoport
long "More Memory Management Functions" section into several smaller sections makes the generated html more usable. Signed-off-by: Mike Rapoport --- Documentation/core-api/mm-api.rst | 29 - 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/Docum

Re: [PATCH] Link the memory allocation guide from the MM docs

2018-11-19 Thread Mike Rapoport
Wilcox Acked-by: Mike Rapoport > > diff --git a/Documentation/core-api/memory-allocation.rst > b/Documentation/core-api/memory-allocation.rst > index f8bb9aa120c4..8954a88ff5b7 100644 > --- a/Documentation/core-api/memory-allocation.rst > +++ b/Documentation/core-api/mem

[PATCH] docs/mm: update kmalloc kernel-doc description

2018-11-11 Thread Mike Rapoport
Add references to GFP documentation and the memory-allocation.rst and remove GFP_USER, GFP_DMA and GFP_NOIO descriptions. While on it slightly change the formatting so that the list of GFP flags will be rendered as "description" in the generated html. Signed-off-by: Mike Rapoport ---

[PATCH v2] docs/admin-guide/mm/concepts.rst: grammar and style fixups

2018-11-11 Thread Mike Rapoport
Signed-off-by: Mike Rapoport Reviewed-by: Randy Dunlap --- v2: address Matthew's feedback Documentation/admin-guide/mm/concepts.rst | 51 --- 1 file changed, 26 insertions(+), 25 deletions(-) diff --git a/Documentation/admin-guide/mm/concepts.rst b/Documentation

[PATCH] mm/gup: fix follow_page_mask kernel-doc comment

2018-11-07 Thread Mike Rapoport
escription to match Documentation/doc-guide/kernel-doc.rst guidelines. Signed-off-by: Mike Rapoport --- mm/gup.c | 10 -- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/mm/gup.c b/mm/gup.c index f76e77a..aa43620 100644 --- a/mm/gup.c +++ b/mm/gup.c @@ -385,11 +385,17 @@ sta

Re: [PATCH] docs/admin-guide/mm/concepts.rst: grammar fixups

2018-11-06 Thread Mike Rapoport
On Mon, Nov 05, 2018 at 11:29:27PM -0800, Randy Dunlap wrote: > On 11/5/18 10:35 PM, Mike Rapoport wrote: > > On Mon, Nov 05, 2018 at 01:12:40PM -0800, Matthew Wilcox wrote: > >> On Mon, Nov 05, 2018 at 09:58:15PM +0200, Mike Rapoport wrote: > >>> @@ -21,10 +

Re: [PATCH] docs/admin-guide/mm/concepts.rst: grammar fixups

2018-11-05 Thread Mike Rapoport
On Mon, Nov 05, 2018 at 01:12:40PM -0800, Matthew Wilcox wrote: > On Mon, Nov 05, 2018 at 09:58:15PM +0200, Mike Rapoport wrote: > > @@ -21,10 +21,10 @@ Virtual Memory Primer > > The physical memory in a computer system is a limited resource and > > even for systems that s

[PATCH] docs/admin-guide/mm/concepts.rst: grammar fixups

2018-11-05 Thread Mike Rapoport
From: Mike Rapoport Signed-off-by: Mike Rapoport Cc: Randy Dunlap --- There was a couple of grammar fixes Randy suggested a while ago, but it seems I've never sent them out. Documentation/admin-guide/mm/concepts.rst | 39 --- 1 file changed, 20 insertions(+), 19

Re: [PATCH 2/2] docs/vm: split memory hotplug notifier description to Documentation/core-api

2018-10-07 Thread Mike Rapoport
On Sun, Oct 07, 2018 at 08:46:40AM -0600, Jonathan Corbet wrote: > On Fri, 5 Oct 2018 01:11:01 +0300 > Mike Rapoport wrote: > > > The memory hotplug notifier description is about kernel internals rather > > than admin/user visible API. Place it appropriately. > &g

[PATCH 2/2] docs/vm: split memory hotplug notifier description to Documentation/core-api

2018-10-04 Thread Mike Rapoport
The memory hotplug notifier description is about kernel internals rather than admin/user visible API. Place it appropriately. Signed-off-by: Mike Rapoport --- Documentation/admin-guide/mm/memory-hotplug.rst| 83 - Documentation/core-api/index.rst | 2

[PATCH 1/2] docs: move memory hotplug description into admin-guide/mm

2018-10-04 Thread Mike Rapoport
The memory hotplug description in Documentation/memory-hotplug.txt is already formatted as ReST and can be easily added to admin-guide/mm section. While on it, slightly update formatting to make it consistent with the doc-guide. Signed-off-by: Mike Rapoport --- Documentation/admin-guide/mm

[PATCH 0/2] docs: ReSTify memory-hotplug description

2018-10-04 Thread Mike Rapoport
changes. Mike Rapoport (2): docs: move memory hotplug description into admin-guide/mm docs/vm: split memory hotplug notifier description to Documentation/core-api Documentation/admin-guide/mm/index.rst | 1 + .../mm/memory-hotplug.rst} | 152

Re: [PATCH v3 1/2] Documentation/sphinx: allow "functions" with no parameters

2018-06-30 Thread Mike Rapoport
On Sat, Jun 30, 2018 at 04:21:56AM -0700, Matthew Wilcox wrote: > On Sat, Jun 30, 2018 at 12:05:10AM +0300, Mike Rapoport wrote: > > @@ -488,14 +488,19 @@ doc: *title* > > .. kernel-doc:: drivers/gpu/drm/i915/intel_audio.c > > :doc: High Definition Audio over

[PATCH v3 0/2] Documentation/sphinx: add kind of "nodocs" directive

2018-06-29 Thread Mike Rapoport
has "IDA description" and "idr synchronization" twice. v3 changes: * add description for empty "functions" directive to Documentation/doc-guide/kernel-doc.rst v2 changes: * Use empty "functions" directive instead of "nodocs", as per Jani's s

[PATCH v3 1/2] Documentation/sphinx: allow "functions" with no parameters

2018-06-29 Thread Mike Rapoport
ption" in the "IDA usage" section and in the middle of the API reference. This patch enables using "functions" directive without parameters to output all the documentation excluding DOC: sections. [1] https://www.kernel.org/doc/html/v4.17/core-api/idr.html Signed-off-by: Mi

[PATCH v3 2/2] docs/idr: use empty "functions" directive

2018-06-29 Thread Mike Rapoport
to avoid duplication of DOC: sections in the middle of the API reference. Signed-off-by: Mike Rapoport Acked-by: Matthew Wilcox --- Documentation/core-api/idr.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/core-api/idr.rst b/Documentation/core-api/idr.rst index 9078a5c

Re: [PATCH v2 1/2] Documentation/sphinx: allow "functions" with no parameters

2018-06-20 Thread Mike Rapoport
On Wed, Jun 20, 2018 at 10:19:36AM +0300, Jani Nikula wrote: > On Wed, 20 Jun 2018, Mike Rapoport wrote: > > When kernel-doc:: specified in .rst document without explicit directives, > > it outputs both comment and DOC: sections. If a DOC: section was explicitly > > included

[PATCH v2 2/2] docs/idr: use empty "functions" directive

2018-06-19 Thread Mike Rapoport
to avoid duplication of DOC: sections in the middle of the API reference. Signed-off-by: Mike Rapoport Acked-by: Matthew Wilcox --- Documentation/core-api/idr.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/core-api/idr.rst b/Documentation/core-api/idr.rst index 9078a5c

[PATCH v2 1/2] Documentation/sphinx: allow "functions" with no parameters

2018-06-19 Thread Mike Rapoport
ption" in the "IDA usage" section and in the middle of the API reference. This patch enables using "functions" directive without parameters to output all the documentation excluding DOC: sections. [1] https://www.kernel.org/doc/html/v4.17/core-api/idr.html Signed-off-by: Mi

[PATCH v2 0/2] Documentation/sphinx: add kind of "nodocs" directive

2018-06-19 Thread Mike Rapoport
has "IDA description" and "idr synchronization" twice. v2 changes: * Use empty "functions" directive instead of "nodocs", as per Jani's suggestion Mike Rapoport (2): Documentation/sphinx: allow "functions" with no parameters docs/idr: us

Re: [PATCH 0/2] Documentation/sphinx: add "nodocs" directive

2018-06-19 Thread Mike Rapoport
On Tue, Jun 19, 2018 at 07:11:56AM -0700, Matthew Wilcox wrote: > On Mon, Jun 18, 2018 at 10:10:28AM -0700, Matthew Wilcox wrote: > > On Mon, Jun 18, 2018 at 04:36:34PM +0300, Mike Rapoport wrote: > > > Hi, > > > > > > These patches allow passing "-no-doc-

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-19 Thread Mike Rapoport
On Tue, Jun 19, 2018 at 11:09:42AM +0300, Jani Nikula wrote: > On Tue, 19 Jun 2018, Mike Rapoport wrote: > > On Tue, Jun 19, 2018 at 10:29:20AM +0300, Jani Nikula wrote: > >> On Tue, 19 Jun 2018, Mike Rapoport wrote: > >> > On Mon, Jun 18, 2018 at 11:01

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-19 Thread Mike Rapoport
On Tue, Jun 19, 2018 at 10:29:20AM +0300, Jani Nikula wrote: > On Tue, 19 Jun 2018, Mike Rapoport wrote: > > On Mon, Jun 18, 2018 at 11:01:32PM +0300, Jani Nikula wrote: > >> On Mon, 18 Jun 2018, Mike Rapoport wrote: > >> > When kernel-doc:: specified in .rst docume

Re: [PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-18 Thread Mike Rapoport
On Mon, Jun 18, 2018 at 11:01:32PM +0300, Jani Nikula wrote: > On Mon, 18 Jun 2018, Mike Rapoport wrote: > > When kernel-doc:: specified in .rst document without explicit directives, > > it outputs both comment and DOC: sections. If a DOC: section was explictly > > included

[PATCH 2/2] docs/idr: use "nodocs" directive

2018-06-18 Thread Mike Rapoport
to avoid duplication of DOC: sections in the middle of the API reference. Signed-off-by: Mike Rapoport --- Documentation/core-api/idr.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/core-api/idr.rst b/Documentation/core-api/idr.rst index 9078a5c..15eadf8 100644

[PATCH 0/2] Documentation/sphinx: add "nodocs" directive

2018-06-18 Thread Mike Rapoport
has "IDA description" and "idr synchronization" twice. [1] https://www.kernel.org/doc/html/v4.17/core-api/idr.html Mike Rapoport (2): Documentation/sphinx: add "nodocs" directive docs/idr: use "nodocs" directive Documentation/core-api/idr.rst| 2 ++ D

[PATCH 1/2] Documentation/sphinx: add "nodocs" directive

2018-06-18 Thread Mike Rapoport
ption" in the "IDA usage" section and in the middle of the API reference. Addition of "nodocs" directive prevents the duplication without the need to explicitly define what functions should be include in the API reference. [1] https://www.kernel.org/doc/html/v4.17/core-api

[PATCH] docs/vm: move ksm and transhuge from "user" to "internals" section.

2018-05-29 Thread Mike Rapoport
After the userspace interface description for KSM and THP was split to Documentation/admin-guide/mm, the remaining parts belong to the section describing MM internals. Signed-off-by: Mike Rapoport --- Documentation/vm/index.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff

[PATCH 0/3] docs/vm: transhuge: split userspace bits to admin-guide/mm

2018-05-14 Thread Mike Rapoport
related bits to Documentation/admin-guide/mm, which is done by the third patch. Mike Rapoport (3): docs/vm: transhuge: change sections order docs/vm: transhuge: minor updates docs/vm: transhuge: split userspace bits to admin-guide/mm/transhuge Documentation/admin-guide/kernel-parameters.txt

[PATCH 1/3] docs/vm: transhuge: change sections order

2018-05-14 Thread Mike Rapoport
so that userspace interface and implementation description will be grouped together Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/transhuge.rst | 82 +- 1 file changed, 41 insertions(+), 41 deletions(-) diff

[PATCH 2/3] docs/vm: transhuge: minor updates

2018-05-14 Thread Mike Rapoport
Some formatting changes and addition of a sentence introducing khugepaged Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/transhuge.rst | 47 -- 1 file changed, 36 insertions(+), 11 deletions(-) diff --git a/Documentat

[PATCH 1/3] docs/vm: numa_memory_policy: formatting and spelling updates

2018-05-08 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/numa_memory_policy.rst | 24 +--- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/Documentation/vm/numa_memory_policy.rst b/Documentation/vm/numa_memory_policy.rst index 8

[PATCH 0/3] docs/vm: move numa_memory_policy.rst to admin-guide/mm

2018-05-08 Thread Mike Rapoport
Hi, These patches include minor formatting and spelling updates to Documentation/vm/numa_memory_policy.rst and move this file to Documentation/admin-guide/mm. Mike Rapoport (3): docs/vm: numa_memory_policy: formatting and spelling updates docs/vm: numa_memory_policy: s/Linux memory policy

[PATCH 3/3] docs/vm: move numa_memory_policy.rst to Documentation/admin-guide/mm

2018-05-08 Thread Mike Rapoport
The document describes userspace API and as such it belongs to Documentation/admin-guide/mm Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/admin-guide/mm/hugetlbpage.rst| 2 +- Documentation/admin-guide/mm/index.rst

[PATCH 2/3] docs/vm: numa_memory_policy: s/Linux memory policy/NUMA memory policy/

2018-05-08 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/numa_memory_policy.rst | 14 +++--- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/Documentation/vm/numa_memory_policy.rst b/Documentation/vm/numa_memory_policy.rst index ac0b396

[PATCH 2/7] docs/vm: ksm: (mostly) formatting updates

2018-04-24 Thread Mike Rapoport
Aside from the formatting: * fixed typos * added section and sub-section headers * moved ksmd overview after the description of KSM origins Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/ksm.rst | 110 +-- 1 file c

[PATCH 6/7] docs/vm: ksm: udpate description of stable_node_{dups,chains}

2018-04-24 Thread Mike Rapoport
Remove implementation details from sysfs parameter descriptions. Also move the paragraph discussing fragmentation issues and their possible solution to the "Design" section. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/ksm.rst | 21 ++---

[PATCH 7/7] docs/vm: ksm: split userspace interface to admin-guide/mm/ksm.rst

2018-04-24 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/admin-guide/mm/index.rst | 1 + Documentation/admin-guide/mm/ksm.rst | 189 + Documentation/vm/ksm.rst | 176 +- 3 files changed, 191 inse

[PATCH 5/7] docs/vm: ksm: update stable_node_chains_prune_millisecs description

2018-04-24 Thread Mike Rapoport
Make the description of stable_node_chains_prune_millisecs sysfs parameter less implementation aware and add a few words about this parameter in the "Design" section. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/ksm.rst | 19 +++ 1

[PATCH 1/7] mm/ksm: docs: extend overview comment and make it "DOC:"

2018-04-24 Thread Mike Rapoport
The existing comment provides a good overview of KSM implementation. Let's update it to reflect recent additions of "chain" and "dup" variants of the stable tree nodes and mark it as "DOC:" for inclusion into the KSM documentation. Signed-off-by: Mike Rapoport <

[PATCH 3/7] docs/vm: ksm: add "Design" section

2018-04-24 Thread Mike Rapoport
Include the KSM description from the source code comment, add a subsection about reverse mapping and include kernel-doc references for KSM data structures. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/ksm.rst | 39 +++

[PATCH 0/7] docs/vm: update KSM documentation

2018-04-24 Thread Mike Rapoport
. The description of these implementation details are moved to the new "Design" section. The last patch in the series depends on the patchset that create Documentation/admin-guide/mm [1], all the rest applies cleanly to the current docs-next. [1] https://lkml.org/lkml/2018/4/18/110 Mik

[PATCH 4/7] docs/vm: ksm: reshuffle text between "sysfs" and "design" sections

2018-04-24 Thread Mike Rapoport
The description of "max_page_sharing" sysfs attribute includes lots of implementation details that more naturally belong in the "Design" section. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/ksm.rst | 51 --

[PATCH 3/7] docs/vm: pagemap: formatting and spelling updates

2018-04-18 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/pagemap.rst | 16 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/vm/pagemap.rst b/Documentation/vm/pagemap.rst index d54b4bf..9644bc0 100644 --- a/Documentation/vm/pagem

[PATCH 2/7] docs/vm: hugetlbpage: move section about kernel development to hugetlbfs_reserv

2018-04-18 Thread Mike Rapoport
The hugetlbpage describes hugetlbfs from the user perspective and newer hugetlbfs_reserv document targets kernel developers. Hence the section about hugetlbfs kernel development naturally belongs there. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentat

[PATCH 6/7] docs/admin-guide/mm: start moving here files from Documentation/vm

2018-04-18 Thread Mike Rapoport
Several documents in Documentation/vm fit quite well into the "admin/user guide" category. The documents that don't overload the reader with lots of implementation details and provide coherent description of certain feature can be moved to Documentation/admin-guide/mm. Signed-of

[PATCH 7/7] docs/admin-guide/mm: convert plain text cross references to hyperlinks

2018-04-18 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/admin-guide/mm/hugetlbpage.rst| 3 ++- Documentation/admin-guide/mm/idle_page_tracking.rst | 5 +++-- Documentation/admin-guide/mm/pagemap.rst| 18 +++--- 3 files changed, 16 inse

[PATCH 5/7] docs/admin-guide: introduce basic index for mm documentation

2018-04-18 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/admin-guide/index.rst| 1 + Documentation/admin-guide/mm/index.rst | 19 +++ 2 files changed, 20 insertions(+) create mode 100644 Documentation/admin-guide/mm/index.rst diff --git a/Documentation

[PATCH 4/7] docs/vm: pagemap: change document title

2018-04-18 Thread Mike Rapoport
"pagemap from the Userspace Perspective" is not very descriptive for unaware readers. Since the document describes how to examine a process page tables, let's title it "Examining Process Page Tables" Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Docume

[PATCH 0/7] docs/vm: start moving files do Documentation/admin-guide`

2018-04-18 Thread Mike Rapoport
Hi, These pacthes begin categorizing memory management documentation. The documents that describe userspace APIs and do not overload the reader with implementation details can be moved to Documentation/admin-guide, so let's do it :) Mike Rapoport (7): docs/vm: hugetlbpage: minor improvements

[PATCH 1/7] docs/vm: hugetlbpage: minor improvements

2018-04-18 Thread Mike Rapoport
* fixed mistypes * added internal cross-references for sections Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/hugetlbpage.rst | 17 ++--- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/Documentation/vm/hugetlbpage.rst b/Documentat

Re: [PATCH 00/32] docs/vm: convert to ReST format

2018-04-15 Thread Mike Rapoport
On Fri, Apr 13, 2018 at 01:55:51PM -0600, Jonathan Corbet wrote: > Sorry for the silence, I'm pedaling as fast as I can, honest... > > On Sun, 1 Apr 2018 09:38:58 +0300 > Mike Rapoport <r...@linux.vnet.ibm.com> wrote: > > > My thinking was to start wit

Re: [PATCH 00/32] docs/vm: convert to ReST format

2018-04-10 Thread Mike Rapoport
Jon, Andrew, How do you suggest to continue with this? On Sun, Apr 01, 2018 at 09:38:58AM +0300, Mike Rapoport wrote: > (added akpm) > > On Thu, Mar 29, 2018 at 03:46:07PM -0600, Jonathan Corbet wrote: > > On Wed, 21 Mar 2018 21:22:16 +0200 > > Mike Rapoport <r...@l

Re: [PATCH 00/32] docs/vm: convert to ReST format

2018-04-01 Thread Mike Rapoport
(added akpm) On Thu, Mar 29, 2018 at 03:46:07PM -0600, Jonathan Corbet wrote: > On Wed, 21 Mar 2018 21:22:16 +0200 > Mike Rapoport <r...@linux.vnet.ibm.com> wrote: > > > These patches convert files in Documentation/vm to ReST format, add an > > initial index a

[PATCH 02/32] docs/vm: balance: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/balance | 15 +++ 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/Documentation/vm/balance b/Documentation/vm/balance index 9645954..6a1fadf 100644 --- a/Documentation/vm/balance

[PATCH 01/32] docs/vm: active_mm.txt convert to ReST format

2018-03-21 Thread Mike Rapoport
Just add a label for cross-referencing and indent the text to make it ``literal`` Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/active_mm.txt | 174 + 1 file changed, 91 insertions(+), 83 deletions(-) diff

[PATCH 00/32] docs/vm: convert to ReST format

2018-03-21 Thread Mike Rapoport
changes. I've tried to keep the formatting as consistent as possible, but I could miss some places that needed markup and add some markup where it was not necessary. Mike Rapoport (32): docs/vm: active_mm.txt convert to ReST format docs/vm: balance: convert to ReST format docs/vm

[PATCH 04/32] docs/vm: frontswap.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/frontswap.txt | 59 ++ 1 file changed, 37 insertions(+), 22 deletions(-) diff --git a/Documentation/vm/frontswap.txt b/Documentation/vm/frontswap.txt index c71a019..1979f43

[PATCH 03/32] docs/vm: cleancache.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/cleancache.txt | 105 1 file changed, 62 insertions(+), 43 deletions(-) diff --git a/Documentation/vm/cleancache.txt b/Documentation/vm/cleancache.txt index e4b49df..6

[PATCH 07/32] docs/vm: hugetlbpage.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/hugetlbpage.txt | 243 ++- 1 file changed, 139 insertions(+), 104 deletions(-) diff --git a/Documentation/vm/hugetlbpage.txt b/Documentation/vm/hugetlbpage.txt index faf077d..3

[PATCH 08/32] docs/vm: hugetlbfs_reserv.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/hugetlbfs_reserv.txt | 212 ++ 1 file changed, 135 insertions(+), 77 deletions(-) diff --git a/Documentation/vm/hugetlbfs_reserv.txt b/Documentation/vm/hugetlbfs_reserv.txt index 9

[PATCH 09/32] docs/vm: hwpoison.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/hwpoison.txt | 141 +- 1 file changed, 70 insertions(+), 71 deletions(-) diff --git a/Documentation/vm/hwpoison.txt b/Documentation/vm/hwpoison.txt index e912d7e..b1a8c24

[PATCH 12/32] docs/vm: mmu_notifier.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/mmu_notifier.txt | 108 -- 1 file changed, 57 insertions(+), 51 deletions(-) diff --git a/Documentation/vm/mmu_notifier.txt b/Documentation/vm/mmu_notifier.txt index 23b4625..4

[PATCH 10/32] docs/vm: idle_page_tracking.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/idle_page_tracking.txt | 55 + 1 file changed, 36 insertions(+), 19 deletions(-) diff --git a/Documentation/vm/idle_page_tracking.txt b/Documentation/vm/idle_page_tracking.txt

[PATCH 13/32] docs/vm: numa_memory_policy.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/numa_memory_policy.txt | 533 +--- 1 file changed, 283 insertions(+), 250 deletions(-) diff --git a/Documentation/vm/numa_memory_policy.txt b/Documentation/vm/numa_memory_policy.txt

[PATCH 17/32] docs/vm: pagemap.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/pagemap.txt | 164 +++ 1 file changed, 89 insertions(+), 75 deletions(-) diff --git a/Documentation/vm/pagemap.txt b/Documentation/vm/pagemap.txt index eafcefa..bd6d717

[PATCH 16/32] docs/vm: numa: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/numa | 4 1 file changed, 4 insertions(+) diff --git a/Documentation/vm/numa b/Documentation/vm/numa index a31b85b..c81e7c5 100644 --- a/Documentation/vm/numa +++ b/Documentation/vm/numa @@ -1,6 +1,10 @@ +..

[PATCH 15/32] docs/vm: page_frags convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/page_frags | 5 - 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Documentation/vm/page_frags b/Documentation/vm/page_frags index a671456..637cc49 100644 --- a/Documentation/vm/page_frags

[PATCH 18/32] docs/vm: page_migration: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/page_migration | 149 +--- 1 file changed, 77 insertions(+), 72 deletions(-) diff --git a/Documentation/vm/page_migration b/Documentation/vm/page_migration index 0478ae2..0

[PATCH 21/32] docs/vm: slub.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/slub.txt | 357 -- 1 file changed, 188 insertions(+), 169 deletions(-) diff --git a/Documentation/vm/slub.txt b/Documentation/vm/slub.txt index 8465241..3a775fd

[PATCH 20/32] docs/vm: remap_file_pages.txt: conert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/remap_file_pages.txt | 6 ++ 1 file changed, 6 insertions(+) diff --git a/Documentation/vm/remap_file_pages.txt b/Documentation/vm/remap_file_pages.txt index f609142..7bef671 100644 --- a/Documentat

[PATCH 23/32] docs/vm: split_page_table_lock: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/split_page_table_lock | 12 +--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/Documentation/vm/split_page_table_lock b/Documentation/vm/split_page_table_lock index 62842a8..889b00b

[PATCH 22/32] docs/vm: soft-dirty.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/soft-dirty.txt | 20 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/Documentation/vm/soft-dirty.txt b/Documentation/vm/soft-dirty.txt index 55684d1..cb0cfd6 100644 --- a/Documen

[PATCH 25/32] docs/vm: transhuge.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/transhuge.txt | 286 - 1 file changed, 166 insertions(+), 120 deletions(-) diff --git a/Documentation/vm/transhuge.txt b/Documentation/vm/transhuge.txt index 4dde03b..5

[PATCH 24/32] docs/vm: swap_numa.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/swap_numa.txt | 55 +- 1 file changed, 33 insertions(+), 22 deletions(-) diff --git a/Documentation/vm/swap_numa.txt b/Documentation/vm/swap_numa.txt index d5960c9..e0466f2

[PATCH 30/32] docs/vm: zswap.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/zswap.txt | 71 +++--- 1 file changed, 42 insertions(+), 29 deletions(-) diff --git a/Documentation/vm/zswap.txt b/Documentation/vm/zswap.txt index 0b3a114..1444ecd

[PATCH 27/32] docs/vm: userfaultfd.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/userfaultfd.txt | 66 1 file changed, 39 insertions(+), 27 deletions(-) diff --git a/Documentation/vm/userfaultfd.txt b/Documentation/vm/userfaultfd.txt index bb2f945..5

[PATCH 28/32] docs/vm: z3fold.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/z3fold.txt | 6 +- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Documentation/vm/z3fold.txt b/Documentation/vm/z3fold.txt index 38e4dac..224e3c6 100644 --- a/Documentation/vm/z3fold.txt

[PATCH 26/32] docs/vm: unevictable-lru.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/unevictable-lru.txt | 117 +++ 1 file changed, 49 insertions(+), 68 deletions(-) diff --git a/Documentation/vm/unevictable-lru.txt b/Documentation/vm/unevictable-lru.txt index e

[PATCH 29/32] docs/vm: zsmalloc.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/zsmalloc.txt | 60 ++- 1 file changed, 36 insertions(+), 24 deletions(-) diff --git a/Documentation/vm/zsmalloc.txt b/Documentation/vm/zsmalloc.txt index 64ed63c..6e79893

[PATCH 31/32] docs/vm: rename documentation files to .rst

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/ABI/stable/sysfs-devices-node| 2 +- .../ABI/testing/sysfs-kernel-mm-hugepages | 2 +- Documentation/ABI/testing/sysfs-kernel-mm-ksm | 2 +- Documentation/ABI/testing/sysfs-kernel-slab

[PATCH 32/32] docs/vm: add index.rst and link MM documentation to top level index

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/index.rst| 3 ++- Documentation/vm/conf.py | 10 + Documentation/vm/index.rst | 56 ++ 3 files changed, 68 insertions(+), 1 deletion(-) create mode

[PATCH 19/32] docs/vm: page_owner: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/page_owner.txt | 34 +- 1 file changed, 21 insertions(+), 13 deletions(-) diff --git a/Documentation/vm/page_owner.txt b/Documentation/vm/page_owner.txt index 143..0ed5ab8

[PATCH 14/32] docs/vm: overcommit-accounting: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/overcommit-accounting | 107 ++--- 1 file changed, 57 insertions(+), 50 deletions(-) diff --git a/Documentation/vm/overcommit-accounting b/Documentation/vm/overcommit-accounting index c

[PATCH 11/32] docs/vm: ksm.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/ksm.txt | 215 --- 1 file changed, 110 insertions(+), 105 deletions(-) diff --git a/Documentation/vm/ksm.txt b/Documentation/vm/ksm.txt index 6686bd2..87e7eef

[PATCH 05/32] docs/vm: highmem.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/highmem.txt | 87 ++-- 1 file changed, 36 insertions(+), 51 deletions(-) diff --git a/Documentation/vm/highmem.txt b/Documentation/vm/highmem.txt index 4324d24..0f69a9f

[PATCH 06/32] docs/vm: hmm.txt: convert to ReST format

2018-03-21 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/hmm.txt | 66 1 file changed, 28 insertions(+), 38 deletions(-) diff --git a/Documentation/vm/hmm.txt b/Documentation/vm/hmm.txt index 4d3aac9..3fafa33

[PATCH] docs/vm: update 00-INDEX

2018-03-21 Thread Mike Rapoport
Several files were added to Documentation/vm without updates to 00-INDEX. Fill in the missing documents Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/vm/00-INDEX | 18 ++ 1 file changed, 18 insertions(+) diff --git a/Documentation/vm/00-I

[PATCH 1/3] mm/nommu: remove description of alloc_vm_area

2018-02-25 Thread Mike Rapoport
The alloc_mm_area in nommu is a stub, but it's description states it allocates kernel address space. Remove the description to make the code and the documentation agree. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- mm/nommu.c | 12 1 file changed, 12 deletions(-)

[PATCH 3/3] mm: kernel-doc: add missing parameter descriptions

2018-02-25 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- mm/cma.c| 5 + mm/compaction.c | 1 + mm/kmemleak.c | 10 ++ mm/memory_hotplug.c | 6 ++ mm/oom_kill.c | 2 ++ mm/pagewalk.c | 3 +++ mm/rmap.c | 1 + mm/zsma

[PATCH 0/3] mm: docs: more trivial updates

2018-02-25 Thread Mike Rapoport
Hi, Here's another set of (mostly) trivial updates for kernel-doc descriptions in the mm code. Mike Rapoport (3): mm/nommu: remove description of alloc_vm_area mm/swap: remove @cold parameter description for release_pages mm: kernel-doc: add missing parameter descriptions mm/cma.c

[PATCH] doc-guide: kernel-doc: add comment about formatting verification

2018-02-20 Thread Mike Rapoport
Currently there is no automated checking for kernel-doc comments except running 'kernel-doc -v -none '. Mention the possibility to run kernel-doc to verify formatting of the comments in the kernel-doc guide. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- v2: * fix typo

[PATCH] doc-guide: kernel-doc: add comment about formatting verification

2018-02-20 Thread Mike Rapoport
Currently there is no automated checking for kernel-doc comments except running 'kernel-doc -v -none '. Mention the possibility to run kernel-doc to verify formatting of the comments in the kernel-doc guide. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- Documentation/doc

[PATCH] scripts: kernel_doc: fixup reporting of function identifiers

2018-02-13 Thread Mike Rapoport
When function description includes brackets after the function name as suggested by Documentation/doc-guide/kernel-doc, the kernel-doc script omits the function name from "Scanning doc for" report. Extending match for identifier name with optional brackets fixes this issue. Signed-of

[PATCH 3/3] mm: docs: add blank lines to silence sphinx "Unexpected indentation" errors

2018-01-23 Thread Mike Rapoport
Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- mm/pagewalk.c | 1 + mm/process_vm_access.c | 2 ++ mm/vmscan.c| 1 + 3 files changed, 4 insertions(+) diff --git a/mm/pagewalk.c b/mm/pagewalk.c index 23a3e415ac2c..8d2da5dec1e0 100644 --- a/mm/pagewalk.c ++

[PATCH 1/3] mm: docs: fixup punctuation

2018-01-23 Thread Mike Rapoport
so that kernel-doc will properly recognize the parameter and function descriptions. Signed-off-by: Mike Rapoport <r...@linux.vnet.ibm.com> --- mm/ksm.c| 2 +- mm/memcontrol.c | 4 ++-- mm/mlock.c | 2 +- mm/nommu.c | 2 +- mm/sparse-vmemmap.c | 4 ++

[PATCH 0/3] mm: docs: trivial fixes

2018-01-23 Thread Mike Rapoport
Hi, These are some trvial fixes to the kernel-doc descriptions. Mike Rapoport (3): mm: docs: fixup punctuation mm: docs: fix parameter names mismatch mm: docs: add blank lines to silence sphinx "Unexpected indentation" errors mm/bootmem.c | 2 +- mm/ksm.c

  1   2   >