better explanation for the overload feature

mojolicious · Jul 4, 2017 · 56045c2 · 56045c2
1 parent f5fecd3
commit 56045c2
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 4 deletions.
diff --git a/lib/Mojo/Server/Hypnotoad.pm b/lib/Mojo/Server/Hypnotoad.pm
@@ -320,8 +320,9 @@ C<http://*:8080>. See also L<Mojo::Server::Daemon/"listen"> for more examples.
   overload => 4
 
 Temporarily spawn up to this number of additional workers if there is a need,
-for example if too many workers are shutting down gracefully at the same time,
-defaults to the value of L<Mojo::Server::Prefork/"overload">.
+defaults to the value of L<Mojo::Server::Prefork/"overload">. This allows for
+new workers to be started while old ones are still shutting down gracefully,
+drastically reducing the performance cost of restarts.
 
 =head2 pid_file
 

diff --git a/lib/Mojo/Server/Prefork.pm b/lib/Mojo/Server/Prefork.pm
@@ -408,8 +408,9 @@ block the event loop.
   $prefork     = $prefork->overload(4);
 
 Temporarily spawn up to this number of additional workers if there is a need,
-for example if too many workers are shutting down gracefully at the same time,
-defaults to C<2>.
+defaults to C<2>. This allows for new workers to be started while old ones are
+still shutting down gracefully, drastically reducing the performance cost of
+restarts.
 
 =head2 pid_file