[bug#76063,2/3] services: Switch to ‘shepherd-system-log-service-type’ in ‘%base-services’.
Commit Message
* gnu/services/base.scm (%base-services): Replace ‘syslog-service-type’
by ‘shepherd-system-log-service-type’.
* doc/guix.texi (Base Services): Update ‘syslog-service-type’
documentation.
(Shepherd Services): Mention that ‘system-log-service-type’ is in
‘%base-services’. Add anchor.
Change-Id: I21082300f6a052865a6ab1bdff27fbe71f73d492
---
doc/guix.texi | 17 +++++++++++++----
gnu/services/base.scm | 2 +-
2 files changed, 14 insertions(+), 5 deletions(-)
@@ -19867,11 +19867,17 @@ Base Services
external name servers do not even need to be queried.
@end defvar
-@cindex syslog
-@cindex logging
+@cindex syslog, with external syslogd
+@cindex logging, syslog
@defvar syslog-service-type
-Type of the service that runs the syslog daemon, whose value is a
-@code{<syslog-configuration>} object.
+Type of the service that runs the syslog daemon (@command{syslogd}),
+whose value is a @code{<syslog-configuration>} object (see below).
+
+@quotation Note
+This service is redundant with and for the most part superseded by
+@code{shepherd-system-log-service-type} (@pxref{shepherd-system-log, the
+Shepherd system log}).
+@end quotation
@end defvar
To have a modified @code{syslog-configuration} come into effect after
@@ -45757,6 +45763,7 @@ Shepherd Services
on the @code{timer} service.
@end defvar
+@anchor{shepherd-system-log}
@cindex system log service, from Shepherd
@cindex syslogd, Shepherd system log service
@defvar shepherd-system-log-service-type
@@ -45767,6 +45774,8 @@ Shepherd Services
The value of services of this type must be a
@code{system-log-configuration} record, as described below.
+
+This service is part of @code{%base-services} (@pxref{Base Services}).
@end defvar
@c %start of fragment
@@ -3722,7 +3722,7 @@ (define %base-services
(cons tty %default-console-font))
'("tty1" "tty2" "tty3" "tty4" "tty5" "tty6")))
- (service syslog-service-type)
+ (service shepherd-system-log-service-type)
(service agetty-service-type (agetty-configuration
(extra-options '("-L")) ; no carrier detect
(term "vt100")