diff options
| author | Liliana Marie Prikler <liliana.prikler@gmail.com> | 2024-04-06 07:21:19 +0200 |
|---|---|---|
| committer | Liliana Marie Prikler <liliana.prikler@gmail.com> | 2024-04-20 10:35:34 +0200 |
| commit | e14bc39a97524d93068b2c6bc773ea45b6659fc5 (patch) | |
| tree | adc3faf9fbb8462a41d05db10e648b7add37e0cd /doc | |
| parent | 8600726d388da2c1e20820c8835953d6844a0d87 (diff) | |
| download | guix-e14bc39a97524d93068b2c6bc773ea45b6659fc5.tar guix-e14bc39a97524d93068b2c6bc773ea45b6659fc5.tar.gz | |
doc: Update gnome-desktop-configuration.
* doc/guix.texi (gnome-desktop-configuration): Fill in missing fields.
[gnome]: Talk about the deprecation.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guix.texi | 36 |
1 files changed, 34 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index edd464c2fd..59da6528cc 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -24463,10 +24463,42 @@ polkit with the actions from @code{gnome-settings-daemon}. @deftp {Data Type} gnome-desktop-configuration Configuration record for the GNOME desktop environment. +Available @code{gnome-desktop-configuration} fields are: @table @asis -@item @code{gnome} (default: @code{gnome}) -The GNOME package to use. +@item @code{core-services} (type: list-of-packages) +A list of packages that the GNOME Shell and applications may rely on. + +@item @code{shell} (type: list-of-packages) +A list of packages that constitute the GNOME Shell, without +applications. + +@item @code{utilities} (type: list-of-packages) +A list of packages that serve as applications to use on top of the GNOME Shell. + +@item @code{gnome} (type: maybe-package) +This field used to be the only configuration point and specified +a GNOME meta-package to install system-wide. Since the meta-package +itself provides neither sources nor the actual packages and is only +used to propagate them, this field is deprecated. + +@item @code{extra-packages} (type: list-of-packages) +A list of GNOME-adjacent packages to also include. This field is +intended for users to add their own packages to their GNOME experience. +Note, that it already includes some packages that are considered +essential by some (most?) GNOME users. + +@item @code{udev-ignorelist} (default: @code{()}) (type: list-of-strings) +A list of regular expressions denoting udev rules or hardware file names +provided by any package that should not be installed. By default, every +udev rule and hardware file specified by any package referenced in the +other fields are installed. + +@item @code{polkit-ignorelist} (default: @code{()}) (type: list-of-strings) +A list of regular expressions denoting polkit rules provided by any +package that should not be installed. By default, every polkit rule +added by any package referenced in the other fields are installed. + @end table @end deftp |