summary refs log tree commit diff
path: root/gnu
diff options
context:
space:
mode:
authorEuAndreh via Guix-patches via <guix-patches@gnu.org>2022-10-17 18:28:11 -0300
committerChristopher Baines <mail@cbaines.net>2022-10-18 10:48:32 +0100
commitdbdc8f64e7e2d35abbfbfc40ac06cf103207d99e (patch)
tree2f2c7cafa77d6c5df6262ae926ca9295cdf98ece /gnu
parent117b0a65c832dcec592a64284910c01f595aa84a (diff)
downloadguix-dbdc8f64e7e2d35abbfbfc40ac06cf103207d99e.tar.gz
services: nginx: Improve reload action documentation.
* gnu/services/web.scm (nginx-shepherd-service): Be explicit about the
reload action not changing the configuration file, but instead
respawning worker processes.

Signed-off-by: Christopher Baines <mail@cbaines.net>
Diffstat (limited to 'gnu')
-rw-r--r--gnu/services/web.scm6
1 files changed, 5 insertions, 1 deletions
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 @@ of index files."
               (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