Subject: [bug#76063] [PATCH 2/3] services: Switch to ‘shepherd-system-log-service-type’ in ‘%base-services’.

From: Ludovic Courtès <[email-masked]>
Date: Tue, 4 Feb 2025 23:57:48 +0100

* 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(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index f52d79d549..fa51630852 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -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
diff --git a/gnu/services/base.scm b/gnu/services/base.scm
index 7331c030d7..9bd76d3550 100644
--- a/gnu/services/base.scm
+++ b/gnu/services/base.scm
@@ -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")
-- 
2.48.1