diff options
author | Liliana Marie Prikler <liliana.prikler@gmail.com> | 2024-04-06 07:21:19 +0200 |
---|---|---|
committer | Guix Patches Tester <> | 2024-04-17 14:26:06 +0200 |
commit | 0b5464ad6843c53ceee4df735a3cb9fbf172ec20 (patch) | |
tree | fea125e3404d3de6095e4efcb7519605036bad19 | |
parent | b47ae1ecc43baaf726701ab2d2f810ecfaa75428 (diff) | |
download | guix-patches-issue-70228.tar guix-patches-issue-70228.tar.gz |
doc: Update gnome-desktop-configuration.issue-70228
* doc/guix.texi (gnome-desktop-configuration): Fill in missing fields.
[gnome]: Talk about the deprecation.
-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 fc28a15980..afc5bba844 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -24460,10 +24460,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 |