services: mate-desktop: Deprecate the 'mate-desktop-service' procedure.

* gnu/services/desktop.scm (mate-desktop-service): Deprecate.
* doc/guix.texi (Desktop Services): Document 'mate-desktop-service-type'
and 'mate-desktop-configuration'.  Fix spelling of "Enlightenment".
This commit is contained in:
Ludovic Courtès 2019-03-11 14:37:26 +01:00
parent 984a61624c
commit 082c648d28
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
2 changed files with 23 additions and 7 deletions

View File

@ -14165,7 +14165,7 @@ field of an @code{operating-system} declaration (@pxref{operating-system
Reference, @code{services}}). Reference, @code{services}}).
Additionally, the @code{gnome-desktop-service}, Additionally, the @code{gnome-desktop-service},
@code{xfce-desktop-service}, @code{mate-desktop-service} and @code{xfce-desktop-service}, @code{mate-desktop-service-type} and
@code{enlightenment-desktop-service-type} procedures can add GNOME, XFCE, MATE @code{enlightenment-desktop-service-type} procedures can add GNOME, XFCE, MATE
and/or Enlightenment to a system. To ``add GNOME'' means that system-level and/or Enlightenment to a system. To ``add GNOME'' means that system-level
services like the backlight adjustment helpers and the power management services like the backlight adjustment helpers and the power management
@ -14181,8 +14181,8 @@ administrator's password via the standard polkit graphical interface.
To ``add MATE'' means that @code{polkit} and @code{dbus} are extended To ``add MATE'' means that @code{polkit} and @code{dbus} are extended
appropriately, allowing MATE to operate with elevated privileges on a appropriately, allowing MATE to operate with elevated privileges on a
limited number of special-purpose system interfaces. Additionally, limited number of special-purpose system interfaces. Additionally,
adding a service made by @code{mate-desktop-service} adds the MATE adding a service of type @code{mate-desktop-service-type} adds the MATE
metapackage to the system profile. ``Adding ENLIGHTENMENT'' means that metapackage to the system profile. ``Adding Enlightenment'' means that
@code{dbus} is extended appropriately, and several of Enlightenment's binaries @code{dbus} is extended appropriately, and several of Enlightenment's binaries
are set as setuid, allowing Enlightenment's screen locker and other are set as setuid, allowing Enlightenment's screen locker and other
functionality to work as expetected. functionality to work as expetected.
@ -14209,13 +14209,26 @@ file system as root from within a user session, after the user has
authenticated with the administrator's password. authenticated with the administrator's password.
@end deffn @end deffn
@deffn {Scheme Procedure} mate-desktop-service @deffn {Scheme Variable} mate-desktop-service-type
Return a service that adds the @code{mate} package to the system This is the type of the service that runs the @uref{https://mate-desktop.org/,
MATE desktop environment}. Its value is a @code{mate-desktop-configuration}
object (see below.)
This service adds the @code{mate} package to the system
profile, and extends polkit with the actions from profile, and extends polkit with the actions from
@code{mate-settings-daemon}. @code{mate-settings-daemon}.
@end deffn @end deffn
@deffn {Scheme Procedure} enlightenment-desktop-service-type @deftp {Data Type} mate-desktop-configuration
Configuration record for the MATE desktop environment.
@table @asis
@item @code{mate} (default @code{mate})
The MATE package to use.
@end table
@end deftp
@deffn {Scheme Variable} enlightenment-desktop-service-type
Return a service that adds the @code{enlightenment} package to the system Return a service that adds the @code{enlightenment} package to the system
profile, and extends dbus with actions from @code{efl}. profile, and extends dbus with actions from @code{efl}.
@end deffn @end deffn

View File

@ -909,7 +909,10 @@ and extends polkit with the actions from @code{gnome-settings-daemon}."
(default-value (mate-desktop-configuration)) (default-value (mate-desktop-configuration))
(description "Run the MATE desktop environment."))) (description "Run the MATE desktop environment.")))
(define* (mate-desktop-service #:key (config (mate-desktop-configuration))) (define-deprecated (mate-desktop-service #:key
(config
(mate-desktop-configuration)))
mate-desktop-service-type
"Return a service that adds the @code{mate} package to the system profile, "Return a service that adds the @code{mate} package to the system profile,
and extends polkit with the actions from @code{mate-settings-daemon}." and extends polkit with the actions from @code{mate-settings-daemon}."
(service mate-desktop-service-type config)) (service mate-desktop-service-type config))