From a3d5dc72ecd8dccfca2e9b333e2ed0242f41fd6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sergio=20Pastor=20P=C3=A9rez?=
 <sergio.pastor-perez@inria.fr>
Date: Thu, 4 Jun 2026 10:13:05 +0200
Subject: services: kmonad: Add missing accessors and adjust documentation.

* doc/guix.texi (Desktop Services): Use generated documentation for
`kmonad-configuration'.
* gnu/services/desktop.scm (kmonad-configuration): Export accessors.

Change-Id: I3b5dadd86b1234004222105013dcf0e635f585c4
Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
---
 doc/guix.texi            | 20 +++++++++++++-------
 gnu/services/desktop.scm |  4 +++-
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index fccdd1d876e..7c37c2aba16 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -27657,22 +27657,28 @@ This is the type of the service that runs
 @uref{https://github.com/kmonad/kmonad, KMonad}.  Its value is a
 @code{kmonad-configuration} object.  This service allows spawning
 @command{kmonad} configurations to manage keyboards.
+@end defvar
+
+@c %start of fragment
 
 @deftp {Data Type} kmonad-configuration
-Configuration record for the KMonad service.
+Available @code{kmonad-configuration} fields are:
 
 @table @asis
-@item @code{kmonad} (default: @code{kmonad})
+@item @code{kmonad} (default: @code{kmonad}) (type: package)
 The KMonad package to use.
 
-@item @code{keymaps}
-A list of files with KMonad configurations. One shepherd service will be
-created to control each configuration. Each configuration should target
-a distinct input device as KMonad operates on a per-input basis.
+@item @code{keymaps} (default: @code{()}) (type: list-of-file-likes)
+A list of KMonad configurations (file-like objects).  See
+@uref{https://github.com/kmonad/kmonad/blob/master/keymap/tutorial.kbd,KMonad
+- Keymap Tutorial}
 
 @end table
+
 @end deftp
-@end defvar
+
+
+@c %end of fragment
 
 @defvar colord-service-type
 This is the type of the service that runs @command{colord}, a system
diff --git a/gnu/services/desktop.scm b/gnu/services/desktop.scm
index 617a8dd072b..0d0f6d949c2 100644
--- a/gnu/services/desktop.scm
+++ b/gnu/services/desktop.scm
@@ -124,9 +124,11 @@
 
             colord-service-type
 
-            kmonad-service-type
             kmonad-configuration
+            kmonad-configuration-keymaps
+            kmonad-configuration-kmonad
             kmonad-configuration?
+            kmonad-service-type
 
             geoclue-application
             geoclue-configuration
-- 
cgit v1.2.3