svn commit: r1935433 - httpd/httpd/trunk/docs/manual/mod

Author: rbowen
Date: Tue Jun 16 18:35:00 2026
New Revision: 1935433

Log:
docs: Clarify who dispatches I/O events in motorz PollersPerChild (bz 70105)

The existing wording used "a single child can...dispatch I/O events"
which was ambiguous when the preceding paragraph already said pollers
do the dispatching. Reword to make the subject explicit: each poller
thread independently accepts and dispatches to the worker pool, so
adding pollers parallelizes those operations within a child process.

Modified:
   httpd/httpd/trunk/docs/manual/mod/motorz.xml

Modified: httpd/httpd/trunk/docs/manual/mod/motorz.xml
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/motorz.xml	Tue Jun 16 18:18:09 2026	(r1935432)
+++ httpd/httpd/trunk/docs/manual/mod/motorz.xml	Tue Jun 16 18:35:00 2026	(r1935433)
@@ -235,9 +235,11 @@ LoadModule mpm_motorz_module modules/mod
     <p>The <directive>PollersPerChild</directive> directive sets the number of
     poller threads created in each child process. Each poller owns its own
     pollset, timer ring and connection-recycle list, and handles a shard of
-    the child's connections, so adding pollers raises the rate at which a
-    single child can accept connections and dispatch I/O events and timer
-    expiries.</p>
+    the child's connections. Because each poller thread independently
+    accepts connections and dispatches ready I/O events and timer
+    expiries to the worker pool, adding pollers raises the rate at which a
+    single child process can handle these operations in parallel rather than
+    serializing them on one poll thread.</p>
 
     <p>A value of <code>0</code> (the default) means <em>auto</em>: the number
     of pollers is derived from the number of online CPUs, capped at a built-in