[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
04/07: services: sddm: Deprecate 'sddm-service' procedure.
From: |
guix-commits |
Subject: |
04/07: services: sddm: Deprecate 'sddm-service' procedure. |
Date: |
Mon, 21 Oct 2019 12:16:25 -0400 (EDT) |
civodul pushed a commit to branch master
in repository guix.
commit 8cf3e167c15a0dba3166cbeee46d41f26cbf75f1
Author: Ludovic Courtès <address@hidden>
Date: Mon Oct 21 15:47:55 2019 +0200
services: sddm: Deprecate 'sddm-service' procedure.
* gnu/services/sddm.scm (sddm-service): Mark as deprecated.
* doc/guix.texi (X Window): Document 'sddm-service-type' and
'sddm-configuration'.
---
doc/guix.texi | 45 ++++++++++++++++++++++++++++++++++++---------
gnu/services/sddm.scm | 4 +++-
2 files changed, 39 insertions(+), 10 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 6eccbb9..15b6ff0 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -14193,16 +14193,43 @@ Relogin after logout.
@cindex login manager
@cindex X11 login
-@deffn {Scheme Procedure} sddm-service config
-Return a service that spawns the SDDM graphical login manager for config of
-type @code{<sddm-configuration>}.
+@defvr {Scheme Variable} sddm-service-type
+This is the type of the service to run the
+@uref{https://github.com/sddm/sddm,SSDM display manager}. Its value
+must be a @code{sddm-configuration} record (see below).
-@example
- (sddm-service (sddm-configuration
- (auto-login-user "Alice")
- (auto-login-session "xfce.desktop")))
-@end example
-@end deffn
+Here's an example use:
+
+@lisp
+(service sddm-service-type
+ (sddm-configuration
+ (auto-login-user "alice")
+ (auto-login-session "xfce.desktop")))
+@end lisp
+@end defvr
+
+@deftp {Data Type} sddm-configuration
+This data type represents the configuration of the SDDM login manager.
+The available fields are:
+
+@table @asis
+@item @code{sddm} (default: @code{sddm})
+The SDDM package to use.
+
+@item @code{display-server} (default: @code{"x11"})
+This must be either @code{"x11"} or @code{"wayland"}.
+
+@c FIXME: Add more fields.
+
+@item @code{auto-login-user} (default: @code{""})
+If non-empty, this is the user account under which to log in
+automatically.
+
+@item @code{auto-login-session} (default: @code{""})
+If non-empty, this is the @file{.desktop} file name to use as the
+auto-login session.
+@end table
+@end deftp
@cindex Xorg, configuration
@deftp {Data Type} xorg-configuration
diff --git a/gnu/services/sddm.scm b/gnu/services/sddm.scm
index f33f1f9..c89c0c6 100644
--- a/gnu/services/sddm.scm
+++ b/gnu/services/sddm.scm
@@ -30,6 +30,7 @@
#:use-module (gnu system shadow)
#:use-module (guix gexp)
#:use-module (guix records)
+ #:use-module (guix deprecation)
#:export (sddm-configuration
sddm-configuration?
sddm-service-type
@@ -319,7 +320,8 @@ Relogin=" (if (sddm-configuration-relogin?
config)
sddm-profile-service)))
(default-value (sddm-configuration))))
-(define* (sddm-service #:optional (config (sddm-configuration)))
+(define-deprecated (sddm-service #:optional (config (sddm-configuration)))
+ sddm-service-type
"Run the @uref{https://github.com/sddm/sddm,SSDM display manager}
with the given @var{config}, a @code{<sddm-configuration>} object."
(service sddm-service-type config))
- branch master updated (f6a0be2 -> cacb557), guix-commits, 2019/10/21
- 01/07: gnu: make-bootstrap: Memoize 'glibc-for-bootstrap'., guix-commits, 2019/10/21
- 03/07: services: sddm: Add default configuration., guix-commits, 2019/10/21
- 05/07: services: sddm: Add description., guix-commits, 2019/10/21
- 04/07: services: sddm: Deprecate 'sddm-service' procedure.,
guix-commits <=
- 02/07: download: Honor /etc/ssl/certs when 'SSL_CERT_DIR' is not set., guix-commits, 2019/10/21
- 07/07: doc: Add support for "guix-cookbook.texi" to 'build.scm'., guix-commits, 2019/10/21
- 06/07: services: agetty: Really import (gnu build linux-boot)., guix-commits, 2019/10/21