[PATCH v2 2/2] Docs/admin-guide/mm/damon/reclaim: rewrite complex parts

From: Manuel Ebner

Date: Tue Oct 27 2026 - 15:08:18 EST


Rewrite and refine complex sentences.

Suggested-by: Aveline Noir <jm5905938@xxxxxxxxx>
Signed-off-by: Manuel Ebner <manuelebnerli@xxxxxxxxxxx>
---
Documentation/admin-guide/mm/damon/reclaim.rst | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/Documentation/admin-guide/mm/damon/reclaim.rst b/Documentation/admin-guide/mm/damon/reclaim.rst
index 0bab2299ea..a18c8e2165 100644
--- a/Documentation/admin-guide/mm/damon/reclaim.rst
+++ b/Documentation/admin-guide/mm/damon/reclaim.rst
@@ -30,12 +30,13 @@ guests could mitigate this problem.
How It Works?
=============

-DAMON_RECLAIM finds memory regions that weren't accessed for specific time
-duration and page out. To avoid it consuming too much CPU for the paging out
-operation, a speed limit can be configured. Under the speed limit, it pages
-out memory regions that weren't accessed longer time first. System
-administrators can also configure under what situation this scheme should
-automatically be activated and deactivated with three memory pressure watermarks.
+DAMON_RECLAIM identifies memory regions that have not been accessed for a
+specified period and attempts to pages out those. To avoid it consuming
+too much CPU for the paging out operation, a speed limit can be configured.
+Within the configured speed limit, it prioritizes regions that have been
+idle longer for reclamation. System administrators can also configure under
+what situation this scheme should automatically be activated and deactivated
+with three memory pressure watermarks.

Interface: Module Parameters
============================
@@ -137,7 +138,7 @@ quota_mem_pressure_us

Desired level of memory pressure-stall time in microseconds.

-While keeping the caps that are set by other quotas, DAMON_RECLAIM automatically
+While respecting the limits imposed by other quotas, DAMON_RECLAIM automatically
increases and decreases the effective level of the quota aiming this level of
memory pressure is incurred. System-wide ``some`` memory PSI in microseconds
per quota reset interval (``quota_reset_interval_ms``) is collected and
--
2.55.0