[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
04/11: doc: Tweak Guix Home bits.
From: |
guix-commits |
Subject: |
04/11: doc: Tweak Guix Home bits. |
Date: |
Sun, 23 Jan 2022 17:36:41 -0500 (EST) |
civodul pushed a commit to branch master
in repository guix.
commit 68eda259647213aefd6ca82ee101e344d837d2da
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Sun Jan 23 23:12:55 2022 +0100
doc: Tweak Guix Home bits.
* doc/guix.texi (Shepherd Home Service): Tweak section name. Add
intro.
(Invoking guix home): Refer to "guix search". Use @var where
appropriate.
---
doc/guix.texi | 18 ++++++++++++------
1 file changed, 12 insertions(+), 6 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index e8c8bb9616..38090cb9a3 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -37720,9 +37720,15 @@ specifications,, mcron, GNU@tie{}mcron}).
@end deftp
@node Shepherd Home Service
-@subsection Managing User's Daemons
-
-@cindex shepherd services
+@subsection Managing User Daemons
+
+@cindex shepherd services, for users
+The @code{(gnu home services shepherd)} module supports the definitions
+of per-user Shepherd services (@pxref{Introduction,,, shepherd, The GNU
+Shepherd Manual}). You extend @code{home-shepherd-service-type} with
+new services; Guix Home then takes care of starting the @code{shepherd}
+daemon for you when you log in, which in turns starts the services you
+asked for.
@defvr {Scheme Variable} home-shepherd-service-type
The service type for the userland Shepherd, which allows one to manage
@@ -37809,7 +37815,7 @@ relevance: 1
@dots{}
@end example
-As for @command{guix package --search}, the result is written in
+As for @command{guix search}, the result is written in
@code{recutils} format, which makes it easy to filter the output
(@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual}).
@@ -37819,7 +37825,7 @@ Switching means that the activation script will be
evaluated and (in
basic scenario) symlinks to configuration files generated from
@code{home-environment} declaration will be created in @file{~}. If the
file with the same path already exists in home folder it will be moved
-to @file{~/TIMESTAMP-guix-home-legacy-configs-backup}, where TIMESTAMP
+to @file{~/@var{timestamp}-guix-home-legacy-configs-backup}, where
@var{timestamp}
is a current UNIX epoch time.
@quotation Note
@@ -37832,7 +37838,7 @@ This effects all the configuration specified in
@var{file}. The command
starts Shepherd services specified in @var{file} that are not currently
running; if a service is currently running, this command will arrange
for it to be upgraded the next time it is stopped (e.g.@: by @code{herd
-stop X} or @code{herd restart X}).
+stop @var{service}} or @code{herd restart @var{service}}).
This command creates a new generation whose number is one greater than
the current generation (as reported by @command{guix home
- branch master updated (8ef0473969 -> b45bbe561a), guix-commits, 2022/01/23
- 02/11: doc: Document search paths., guix-commits, 2022/01/23
- 03/11: gnu: Add font-charter., guix-commits, 2022/01/23
- 04/11: doc: Tweak Guix Home bits.,
guix-commits <=
- 01/11: compile: Really disable cross-module inlining and related features., guix-commits, 2022/01/23
- 05/11: gnu: Add utf-8-lineseparator., guix-commits, 2022/01/23
- 08/11: gnu: gtk-vnc: Remove dependency on GJS on non-x86_64., guix-commits, 2022/01/23
- 06/11: gnu: rofi: Add a search path for plugins., guix-commits, 2022/01/23
- 07/11: gnu: Add rofi-calc., guix-commits, 2022/01/23
- 10/11: gnu: gnome-settings-daemon: Build with correct librsvg., guix-commits, 2022/01/23
- 09/11: gnu: gtk-vnc: Build with correct librsvg., guix-commits, 2022/01/23
- 11/11: gnu: vlc: Build with correct librsvg., guix-commits, 2022/01/23