02/05: doc: Add a note about elogind and XDG_RUNTIME_DIR for Guix Home.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit a8b5b40f62e8907b0e82c5088a8fb647d05a7737
Author: Andrew Tropin <andrew@trop.in>
AuthorDate: Mon Nov 8 12:22:04 2021 +0300

    doc: Add a note about elogind and XDG_RUNTIME_DIR for Guix Home.
    
    * doc/guix.texi (Declaring the Home Environment): Add a note about elogind 
and
    XDG_RUNTIME_DIR.
    
    Co-authored-by: Ludovic Courtès <ludo@gnu.org>
---
 doc/guix.texi | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index a5f38e1..1b10e2d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -35975,6 +35975,14 @@ guix home reconfigure config.scm
 This ``builds'' your home environment and creates @file{~/.guix-home}
 pointing to it.  Voilà!
 
+@quotation Note
+Make sure the operating system has elogind, systemd, or a similar
+mechanism to create the XDG run-time directory and has the
+@env{XDG_RUNTIME_DIR} variable set.  Failing that, the
+@file{on-first-login} script will not execute anything, and processes
+like user Shepherd and its descendants will not start.
+@end quotation
+
 @node Configuring the Shell
 @section Configuring the Shell
 This section is safe to skip if your shell or shells are managed by