[PATCH 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions

Song Hu posted 4 patches 2 weeks, 1 day ago
There is a newer version of this series
.../ABI/testing/sysfs-kernel-mm-damon         | 29 ++++++++++++++-----
1 file changed, 22 insertions(+), 7 deletions(-)
[PATCH 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions
Posted by Song Hu 2 weeks, 1 day ago
This series fixes typos and fills in missing entries in the DAMON
sysfs ABI document (Documentation/ABI/testing/sysfs-kernel-mm-damon).

Patch 1 fixes a path typo, "intrvals_goal" -> "intervals_goal", in
four What: entries; the documented path points to a non-existent
directory, so it is Cc'ed to stable.

Patch 2 fixes two further typos ("WDate:", "manimum").

Patches 3 and 4 add ABI entries that exist in the kernel and are
already described in usage.rst but are missing from the canonical ABI
document: the 'update_tuned_intervals' state command (patch 3) and the
'tried_regions/<R>/probes/<P>/hits' file (patch 4).

Song Hu (4):
  Docs/ABI/damon: fix typo in intervals_goal sysfs path
  Docs/ABI/damon: fix typos
  Docs/ABI/damon: document update_tuned_intervals state command
  Docs/ABI/damon: document tried_regions probe hits

 .../ABI/testing/sysfs-kernel-mm-damon         | 29 ++++++++++++++-----
 1 file changed, 22 insertions(+), 7 deletions(-)

-- 
2.43.0
Re: [PATCH 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions
Posted by SJ Park 2 weeks, 1 day ago
'hkml patch check' [1] says you forgot Cc-ing below people who are recommended
by get_maintainer.pl.  I Cc-ed them.  Please Cc all recipients who
get_maitnainer.pl is recommending, from the next time.  'hkml patch format' [2]
could also help you doing so.

- Andrew Morton <akpm@linux-foundation.org>
- David Hildenbrand <david@kernel.org>
- Lorenzo Stoakes <ljs@kernel.org>
- "Liam R. Howlett" <liam@infradead.org>
- Vlastimil Babka <vbabka@kernel.org>
- Mike Rapoport <rppt@kernel.org>
- Suren Baghdasaryan <surenb@google.com>
- Michal Hocko <mhocko@suse.com>

On Fri, 10 Jul 2026 12:47:33 +0800 Song Hu <husong@kylinos.cn> wrote:

> This series fixes typos and fills in missing entries in the DAMON
> sysfs ABI document (Documentation/ABI/testing/sysfs-kernel-mm-damon).
> 
> Patch 1 fixes a path typo, "intrvals_goal" -> "intervals_goal", in
> four What: entries; the documented path points to a non-existent
> directory, so it is Cc'ed to stable.
> 
> Patch 2 fixes two further typos ("WDate:", "manimum").
> 
> Patches 3 and 4 add ABI entries that exist in the kernel and are
> already described in usage.rst but are missing from the canonical ABI
> document: the 'update_tuned_intervals' state command (patch 3) and the
> 'tried_regions/<R>/probes/<P>/hits' file (patch 4).

Looks good overall.  Patch 3 looks unnecessary, though.  Let me add comments to
each patch.

> 
> Song Hu (4):
>   Docs/ABI/damon: fix typo in intervals_goal sysfs path
>   Docs/ABI/damon: fix typos
>   Docs/ABI/damon: document update_tuned_intervals state command
>   Docs/ABI/damon: document tried_regions probe hits
> 
>  .../ABI/testing/sysfs-kernel-mm-damon         | 29 ++++++++++++++-----
>  1 file changed, 22 insertions(+), 7 deletions(-)
> 
> -- 
> 2.43.0

[1] https://github.com/sjp38/hackermail/blob/master/USAGE.md#checking-patches
[2] https://github.com/sjp38/hackermail/blob/master/USAGE.md#formatting-patches


Thanks,
SJ
Re: [PATCH 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions
Posted by SJ Park 2 weeks, 1 day ago
On Fri, 10 Jul 2026 07:16:38 -0700 SJ Park <sj@kernel.org> wrote:

[...]
> On Fri, 10 Jul 2026 12:47:33 +0800 Song Hu <husong@kylinos.cn> wrote:
> 
> > This series fixes typos and fills in missing entries in the DAMON
> > sysfs ABI document (Documentation/ABI/testing/sysfs-kernel-mm-damon).
> > 
> > Patch 1 fixes a path typo, "intrvals_goal" -> "intervals_goal", in
> > four What: entries; the documented path points to a non-existent
> > directory, so it is Cc'ed to stable.
> > 
> > Patch 2 fixes two further typos ("WDate:", "manimum").
> > 
> > Patches 3 and 4 add ABI entries that exist in the kernel and are
> > already described in usage.rst but are missing from the canonical ABI
> > document: the 'update_tuned_intervals' state command (patch 3) and the
> > 'tried_regions/<R>/probes/<P>/hits' file (patch 4).
> 
> Looks good overall.  Patch 3 looks unnecessary, though.  Let me add comments to
> each patch.

Sorry, I was misreading patch 3.  All patches including the third one looks
good to me now.

This series is applied to damon/next [1] tree.  If this series is not added to
mm.git in short term (~1 week?), I will ask mm.git maintainer (Andrew Morton)
to pick this.  So, no action from your side is needed for now.  If it seems I
also forgot doing that or you cannot wait for my action, please feel free to
directly ask that to Andrew.

[1] https://origin.kernel.org/doc/html/latest/mm/damon/maintainer-profile.html#scm-trees


Thanks,
SJ

[...]