Subject: [PATCH 2/2] doc: Write about depending on the ‘user-processes’ Shepherd service.

From: Ludovic Courtès <[email-masked]>
Date: Sat, 22 Feb 2025 23:23:49 +0100

* doc/guix.texi (Shepherd Services): Add paragraph on ‘user-processes’.

Suggested-by: Dariqq <[email-masked]>
Change-Id: I76fb11779eefc90d13dbc11368ddf64f7450f5e6
---
 doc/guix.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 1bfe76f016d..b525913c151 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -46142,6 +46142,13 @@ Shepherd Services
 @item @code{requirement} (default: @code{'()})
 List of symbols denoting the Shepherd services this one depends on.
 
+@cindex @code{user-processes} Shepherd service
+With very few exceptions, services that start a daemon must depend at
+least on the @code{user-processes} service; this ensures that these
+daemons are started after all the file systems have been mounted and
+that, during shutdown, they are stopped before attempting to terminate
+remaining user processes.
+
 @cindex one-shot services, for the Shepherd
 @item @code{one-shot?} (default: @code{#f})
 Whether this service is @dfn{one-shot}.  One-shot services stop immediately
-- 
2.48.1