futurile/guix-play
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: Restructure the list of desktop services.

Browse Source 
* doc/guix.texi (Desktop Services): Use a straight list for the list of
service types, rather than hiding them in one growing paragraph of prose.
Explain their purpose in general terms beneath it.

Change-Id: I2408ccf38dd62323138854cc5aa46051d2a076ac
This commit is contained in:
Tobias Geerinckx-Rice 2024-08-11 02:00:00 +02:00
parent 38f2c90133
commit b39a39ff60
No known key found for this signature in database
GPG Key ID: 0DB0FF884F556D79
1 changed files with 20 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
doc/guix.texi
View File

@ -24618,28 +24618,26 @@ The @code{%desktop-services} variable can be used as the @code{services}
field of an @code{operating-system} declaration (@pxref{operating-system field of an @code{operating-system} declaration (@pxref{operating-system
Reference, @code{services}}). Reference, @code{services}}).
Additionally, the @code{gnome-desktop-service-type}, Additionally, the following procedures add one (or more!) desktop
@code{xfce-desktop-service}, @code{mate-desktop-service-type}, environments to a system.
@code{lxqt-desktop-service-type} and @code{enlightenment-desktop-service-type}
procedures can add GNOME, Xfce, MATE and/or Enlightenment to a system. To @itemize
``add GNOME'' means that system-level services like the backlight adjustment @item @code{gnome-desktop-service-type} adds GNOME,
helpers and the power management utilities are added to the system, extending @item @code{plasma-desktop-service-type} adds KDE Plasma,
@code{polkit} and @code{dbus} appropriately, allowing GNOME to operate with @item @code{enlightenment-desktop-service-type} adds Enlightenment,
elevated privileges on a limited number of special-purpose system interfaces. @item @code{lxqt-desktop-service-type} adds LXQt,
Additionally, adding a service made by @code{gnome-desktop-service-type} adds @item @code{mate-desktop-service-type} adds MATE, and
the GNOME metapackage to the system profile. Likewise, adding the Xfce @item @code{xfce-desktop-service} adds Xfce.
service not only adds the @code{xfce} metapackage to the system profile, but @end itemize
it also gives the Thunar file manager the ability to open a ``root-mode'' file
management window, if the user authenticates using the administrator's These service types add ``metapackages'' such as @code{gnome} or
password via the standard polkit graphical interface. To ``add MATE'' means @code{plasma} to the system profile, but most of them also set up other useful
that @code{polkit} and @code{dbus} are extended appropriately, allowing MATE services that mere packages can't do.
to operate with elevated privileges on a limited number of special-purpose
system interfaces. Additionally, adding a service of type For example, they may elevate privileges on a limited number of
@code{mate-desktop-service-type} adds the MATE metapackage to the system special-purpose system interfaces and programs. This allows backlight
profile. ``Adding Enlightenment'' means that @code{dbus} is extended adjustment helpers, power management utilities, screen lockers, and
appropriately, and several of Enlightenment's binaries are set as setuid, other integrated functionality to work as expected.
allowing Enlightenment's screen locker and other functionality to work as
expected.
The desktop environments in Guix use the Xorg display server by The desktop environments in Guix use the Xorg display server by
default. If you'd like to use the newer display server protocol default. If you'd like to use the newer display server protocol