summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJan (janneke) Nieuwenhuizen <janneke@gnu.org>2023-03-05 17:38:50 +0100
committerJanneke Nieuwenhuizen <janneke@gnu.org>2023-03-16 14:32:50 +0100
commit193f547ca35eb49ef57bd9a25b67cb3965f10b03 (patch)
tree6bf8fa7915d2b148f50c756627d467afce547b99 /doc
parent2c2f382e757d5eef39e8460a20ac75a1b1f8b22e (diff)
gnu: home: services: Add home-znc-service-type.
* gnu/home/services/messaging.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * po/guix/POTFILES.in: Likewise. * doc/guix.texi (Messaging Home Services): Document it in new subsection.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi37
1 files changed, 37 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 8baa2f32240..a823d5f27d8 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -41705,6 +41705,7 @@ services)}.
41705* Guix: Guix Home Services. Services for Guix. 41705* Guix: Guix Home Services. Services for Guix.
41706* Fonts: Fonts Home Services. Services for managing User's fonts. 41706* Fonts: Fonts Home Services. Services for managing User's fonts.
41707* Sound: Sound Home Services. Dealing with audio. 41707* Sound: Sound Home Services. Dealing with audio.
41708* Messaging: Messaging Home Services. Services for managing messaging.
41708@end menu 41709@end menu
41709@c In addition to that Home Services can provide 41710@c In addition to that Home Services can provide
41710 41711
@@ -42797,6 +42798,42 @@ Stopping the Shepherd service turns off broadcasting.
42797This is the multicast address used by default by the two services above. 42798This is the multicast address used by default by the two services above.
42798@end defvar 42799@end defvar
42799 42800
42801@node Messaging Home Services
42802@subsection Messaging Home Services
42803
42804@cindex znc
42805The @uref{https://znc.in, ZNC bouncer} can be run as a daemon to manage
42806your IRC presence. With the @code{(gnu home services znc)} service, you
42807can configure ZNC to run upon login.
42808
42809You will have to provide a @file{~/.znc/configs/znc.conf} seperately.
42810
42811Here is an example of a service and its configuration that you could add
42812to the @code{services} field of your @code{home-environment}:
42813
42814@lisp
42815(service home-znc-service-type)
42816@end lisp
42817
42818@defvr {Scheme Variable} home-znc-service-type
42819This is the type of the @code{git daemon} home service, whose value is an
42820@code{home-znc-configuration} object.
42821@end defvr
42822
42823@deftp {Data Type} home-znc-configuration
42824Available @code{home-znc-configuration} fields are:
42825
42826@table @asis
42827@item @code{git} (default: @code{git}) (type: file-like)
42828The git package to use.
42829
42830@item @code{extra-options} (default: @code{'()})
42831Extra options will be passed to @command{znc}, please run @command{man
42832znc} for more information.
42833
42834@end table
42835@end deftp
42836
42800@node Invoking guix home 42837@node Invoking guix home
42801@section Invoking @command{guix home} 42838@section Invoking @command{guix home}
42802 42839