aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruno Victal <mirai@makinata.eu>2023-02-25 18:58:11 +0000
committerLudovic Courtès <ludo@gnu.org>2023-03-03 17:55:35 +0100
commit7c23dab85ca9d507ceeb078150c56d9fd0e4fd4d (patch)
treec177a5c411f5e4895e6b07ad5d93a675b06a59f9
parente24555234a2914ccd2f6291f9ca95f60f137d74f (diff)
downloadguix-7c23dab85ca9d507ceeb078150c56d9fd0e4fd4d.tar
guix-7c23dab85ca9d507ceeb078150c56d9fd0e4fd4d.tar.gz
services: spice: Deprecate 'spice-vdagent-service' procedure.
* doc/guix.texi (Miscellaneous Services): Replace 'spice-vdagent-service' with 'spice-vdagent-service-type'. Document <spice-vdagent-configuration>. * gnu/services/spice.scm (spice-vdagent-service): Deprecate procedure. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
-rw-r--r--doc/guix.texi25
-rw-r--r--gnu/services/spice.scm7
2 files changed, 22 insertions, 10 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 54b75dd1f8..704c125b10 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -37759,16 +37759,27 @@ Additional command-line options to pass to @command{lircd}.
@c TODO: Document <lirc-configuration>, preferably by refactoring this to use
@c define-configuration and generating documentation from it.
-@cindex spice
-@subsubheading Spice Service
+@cindex SPICE
+@subsubheading SPICE Service
The @code{(gnu services spice)} module provides the following service.
-@deffn {Scheme Procedure} spice-vdagent-service [#:spice-vdagent]
-Returns a service that runs @url{https://www.spice-space.org,VDAGENT}, a daemon
-that enables sharing the clipboard with a vm and setting the guest display
-resolution when the graphical console window resizes.
-@end deffn
+@defvar spice-vdagent-service-type
+Type of the service that runs @url{https://www.spice-space.org, VDAGENT},
+a daemon that enables sharing the clipboard with a vm and setting the
+guest display resolution when the graphical console window resizes.
+@end defvar
+
+@deftp {Data Type} spice-vdagent-configuration
+Data type representing the configuration of
+@code{spice-vdagent-service-type}.
+
+@table @asis
+@item @code{spice-vdagent} (default: @code{spice-vdagent}) (type: file-like)
+Package object for VDAGENT.
+
+@end table
+@end deftp
@cindex inputattach
@subsubheading inputattach Service
diff --git a/gnu/services/spice.scm b/gnu/services/spice.scm
index e5ec46b9b5..b8d2f8486e 100644
--- a/gnu/services/spice.scm
+++ b/gnu/services/spice.scm
@@ -21,12 +21,13 @@
#:use-module (gnu packages spice)
#:use-module (gnu services)
#:use-module (gnu services shepherd)
+ #:use-module (guix deprecation)
#:use-module (guix gexp)
#:use-module (guix records)
#:export (spice-vdagent-configuration
spice-vdagent-configuration?
spice-vdagent-service-type
- spice-vdagent-service))
+ spice-vdagent-service)) ; deprecated
(define-record-type* <spice-vdagent-configuration>
spice-vdagent-configuration make-spice-vdagent-configuration
@@ -74,8 +75,8 @@
from the @code{spice-vdagent} package to enable window resizing and clipboard
sharing for @acronym{VM, virtual machine} guests.")))
-(define* (spice-vdagent-service
- #:optional (config (spice-vdagent-configuration)))
+(define-deprecated (spice-vdagent-service
+ #:optional (config (spice-vdagent-configuration)))
"Start the @command{vdagentd} and @command{vdagent} daemons
from @var{spice-vdagent} to enable guest window resizing and
clipboard sharing."