diff mbox series

[bug#58595,2/2] services: nginx: Improve reload action documentation.

Message ID 20221017213325.29154-1-eu@euandre.org
State Accepted
Headers show
Series None | expand

Commit Message

EuAndreh Oct. 17, 2022, 9:33 p.m. UTC 
* gnu/services/web.scm (nginx-shepherd-service): Be explicit about the
reload action not changing the configuration file, but instead
respawning worker processes.
---

Correct placement of the second patch.  I'll close the other bugs opened
when I replied to my own email, instead of debbugs' email.
 gnu/services/web.scm | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

Comments

EuAndreh Oct. 17, 2022, 9:50 p.m. UTC | #1 
close 58595
Superseded by 58590.
diff mbox series

Patch

diff --git a/gnu/services/web.scm b/gnu/services/web.scm
index 7fde8824b3..2023119037 100644
--- a/gnu/services/web.scm
+++ b/gnu/services/web.scm
@@ -819,7 +819,11 @@  (define (nginx-shepherd-service config)
               (list
                (shepherd-action
                  (name 'reload)
-                 (documentation "Reload NGINX configuration file and restart worker processes.")
+                 (documentation "Reload nginx configuration file and restart worker processes.
+This has the effect of killing old worker processes and starting new ones, using
+the same configuration file.  It is useful for situations where the same nginx
+configuration file can point to different things after a reload, such as
+renewed TLS certificates, or @code{include}d files.")
                  (procedure (nginx-action "-s" "reload"))))))))))
 
 (define nginx-service-type