summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBruno Victal <mirai@makinata.eu>2023-02-25 18:57:47 +0000
committerLudovic Courtès <ludo@gnu.org>2023-03-03 17:55:31 +0100
commitcb00e600ffe7ec493464788dd16308b7b8e87d20 (patch)
tree2ad2be72f9adb8553063447bf74a89d276167d23 /doc
parentc6480edbe3260a3bfb48361ca73e666b6d473f42 (diff)
services: base: Deprecate 'host-name-service' procedure.
* doc/guix.texi (operating-system Reference): Reorder cross-reference. Add an anchor to be used ... (Base services): ... here by host-name-service-type. Document host-name-service-type. * gnu/services/base.scm: Export host-name-service-type. (host-name-service): Deprecate procedure. * gnu/system.scm (operating-system-default-essential-services): Use host-name-service-type. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi16
1 files changed, 10 insertions, 6 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 6ff525d0ff..537b8e19f5 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -16640,12 +16640,14 @@ details.
@item @code{services} (default: @code{%base-services})
A list of service objects denoting system services. @xref{Services}.
+@anchor{operating-system-essential-services}
@cindex essential services
@item @code{essential-services} (default: ...)
The list of ``essential services''---i.e., things like instances of
-@code{system-service-type} and @code{host-name-service-type} (@pxref{Service
-Reference}), which are derived from the operating system definition itself.
-As a user you should @emph{never} need to touch this field.
+@code{system-service-type} (@pxref{Service Reference}) and
+@code{host-name-service-type}, which are derived from the operating
+system definition itself. As a user you should @emph{never} need to
+touch this field.
@item @code{pam-services} (default: @code{(base-pam-services)})
@cindex PAM
@@ -18018,9 +18020,11 @@ symlink:
@end lisp
@end deffn
-@deffn {Scheme Procedure} host-name-service @var{name}
-Return a service that sets the host name to @var{name}.
-@end deffn
+@defvar host-name-service-type
+Type of the service that sets the system host name, whose value
+is a string. This service is included in @code{operating-system} by
+default (@pxref{operating-system-essential-services,@code{essential-services}}).
+@end defvar
@defvar console-font-service-type
Install the given fonts on the specified ttys (fonts are per