ryan77627/guix
1
0
Fork 0
mirror of https://git.in.rschanz.org/ryan77627/guix.git synced 2024-12-24 21:38:07 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: Tweak Guix Home bits.

Browse source 
* doc/guix.texi (Shepherd Home Service): Tweak section name.  Add
intro.
(Invoking guix home): Refer to "guix search".  Use @var where
appropriate.
This commit is contained in:
Ludovic Courtès 2022-01-23 23:12:55 +01:00
parent 4b4b981a2c
commit 68eda25964
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5
1 changed files with 11 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
doc/guix.texi
View file

@ -37720,9 +37720,15 @@ specifications,, mcron, GNU@tie{}mcron}).
@end deftp @end deftp
@node Shepherd Home Service @node Shepherd Home Service
@subsection Managing User's Daemons @subsection Managing User Daemons
@cindex shepherd services @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 @defvr {Scheme Variable} home-shepherd-service-type
The service type for the userland Shepherd, which allows one to manage The service type for the userland Shepherd, which allows one to manage
@ -37809,7 +37815,7 @@ relevance: 1
@dots{} @dots{}
@end example @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 @code{recutils} format, which makes it easy to filter the output
(@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual}). (@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 basic scenario) symlinks to configuration files generated from
@code{home-environment} declaration will be created in @file{~}. If the @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 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. is a current UNIX epoch time.
@quotation Note @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 starts Shepherd services specified in @var{file} that are not currently
running; if a service is currently running, this command will arrange 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 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 This command creates a new generation whose number is one greater than
the current generation (as reported by @command{guix home the current generation (as reported by @command{guix home