From patchwork Sat Apr 6 05:21:19 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Liliana Marie Prikler X-Patchwork-Id: 62763 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 73F5027BBE9; Sat, 6 Apr 2024 06:26:15 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.7 required=5.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI, SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 6BA3527BBE2 for ; Sat, 6 Apr 2024 06:26:14 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rsyZ1-0001Og-HM; Sat, 06 Apr 2024 01:26:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rsyYz-0001OP-BY for guix-patches@gnu.org; Sat, 06 Apr 2024 01:26:01 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rsyYz-0000QH-2H for guix-patches@gnu.org; Sat, 06 Apr 2024 01:26:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rsyZ2-0006gj-3b; Sat, 06 Apr 2024 01:26:04 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#70228] [PATCH] doc: Update gnome-desktop-configuration. Resent-From: Liliana Marie Prikler Original-Sender: "Debbugs-submit" Resent-CC: liliana.prikler@gmail.com, maxim.cournoyer@gmail.com, rg@raghavgururajan.name, vivien@planete-kraus.eu, guix-patches@gnu.org Resent-Date: Sat, 06 Apr 2024 05:26:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 70228 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 70228@debbugs.gnu.org Cc: liliana.prikler@gmail.com, maxim.cournoyer@gmail.com, rg@raghavgururajan.name, vivien@planete-kraus.eu X-Debbugs-Original-To: guix-patches@gnu.org X-Debbugs-Original-Xcc: liliana.prikler@gmail.com, maxim.cournoyer@gmail.com, rg@raghavgururajan.name, vivien@planete-kraus.eu Received: via spool by submit@debbugs.gnu.org id=B.171238114325565 (code B ref -1); Sat, 06 Apr 2024 05:26:03 +0000 Received: (at submit) by debbugs.gnu.org; 6 Apr 2024 05:25:43 +0000 Received: from localhost ([127.0.0.1]:37948 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rsyYg-0006eF-Li for submit@debbugs.gnu.org; Sat, 06 Apr 2024 01:25:43 -0400 Received: from lists.gnu.org ([2001:470:142::17]:56790) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rsyYd-0006e0-HU for submit@debbugs.gnu.org; Sat, 06 Apr 2024 01:25:41 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rsyYR-0001L3-Tc for guix-patches@gnu.org; Sat, 06 Apr 2024 01:25:27 -0400 Received: from mail-ed1-x543.google.com ([2a00:1450:4864:20::543]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rsyYQ-0000Mq-2N for guix-patches@gnu.org; Sat, 06 Apr 2024 01:25:27 -0400 Received: by mail-ed1-x543.google.com with SMTP id 4fb4d7f45d1cf-56e480e770fso33365a12.3 for ; Fri, 05 Apr 2024 22:25:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1712381123; x=1712985923; darn=gnu.org; h=mime-version:to:subject:date:from:message-id:from:to:cc:subject :date:message-id:reply-to; bh=zfRqnHJyYb6F281p+573BZQ/OdsUzncPxDOPW8bDvR0=; b=HpnzU4FkNjW9Fi4A0ezdRZfpvcjHoqIY4a/7U+AfBzY/blO3v8Edwla14/8q4FPXTV vLeCzq0Fq/NKSO2YxD9uEQRwiPHpcUm+6lZdqKfbObO4Wg7B38kxDD63JBc7eOTsOus5 LvNe/RH5LwlXGdUeD2EQczuXGjrzynltjhyml/FwjWeWkWKXIcrX5ewxCTl9YeT/r2F3 3vHPTig+9UtpWy8TNzAeOPOrdmBY8jC7KbPsSyzx99DT2uHNBHApNNMFDegO60DfNgqy ZRwzUyvy5fps23WacAt0bf3qo5SVyR8F+iwow6pUlGf1YJRrCYfMJrjBMezIdIhd7X89 dDnA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712381123; x=1712985923; h=mime-version:to:subject:date:from:message-id:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=zfRqnHJyYb6F281p+573BZQ/OdsUzncPxDOPW8bDvR0=; b=GP/VYhqjjokq9uW8X24ilvZ7fu//rp27xIwZfgkjeChvLxVo5q3SoxZGX54WfwGL/m 7w80nndUOrbjofej/oVcjOJoyPwD3yJiIOx0RCfJmuFbiq3HQPq5aNVljCscx9Mbe4mO qAD8hoQdHMDZ6rrXh7hbwRh2tKTxJq3LfBuckBtElFcTDSrOwKlJ1zFM/PWJE/OZ3uER QHaNHYBfM1ckTunTgiSuNuMmsscmJr6WEn4+bEkIYLTHDUyaGOx0ia+qG+cher6qshxx QGRcPl1qFB5CCFF5VH8IzqHEWcQrQZs/9u94smlYyb3UHjoAAgv/N5nSlX5njqmkIpor uJsw== X-Gm-Message-State: AOJu0YxyrroJS25B5Eij+bct2YDlSDWcc8cA1DAdiqEh5mcEOgcPccww 3L6Qj2a1W33+i7BjJcCi9Q8n9LEbkED7rSu0Zn1RrxrD8QXE2+UpLmoeSxcFsNg= X-Google-Smtp-Source: AGHT+IGI4t6zW2VZeBn5rRsHsyU1JKsdzX/o5wv7st9wBXnboepFQa3QtkVDm6bgRabYm1anozdK6Q== X-Received: by 2002:a17:907:7245:b0:a4e:768a:1445 with SMTP id ds5-20020a170907724500b00a4e768a1445mr2872788ejc.16.1712381123385; Fri, 05 Apr 2024 22:25:23 -0700 (PDT) Received: from lumine.fritz.box (85-127-52-93.dsl.dynamic.surfer.at. [85.127.52.93]) by smtp.gmail.com with ESMTPSA id qx28-20020a170907b59c00b00a51a80028e8sm1340609ejc.65.2024.04.05.22.25.22 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 05 Apr 2024 22:25:22 -0700 (PDT) Message-ID: <72ce110b29c2a54f369b3f95131811058fd2592b.1712380995.git.liliana.prikler@gmail.com> From: Liliana Marie Prikler Date: Sat, 6 Apr 2024 07:21:19 +0200 MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::543; envelope-from=liliana.prikler@gmail.com; helo=mail-ed1-x543.google.com X-Spam_score_int: -10 X-Spam_score: -1.1 X-Spam_bar: - X-Spam_report: (-1.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, MALFORMED_FREEMAIL=1.049, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches * doc/guix.texi (gnome-desktop-configuration): Fill in missing fields. [gnome]: Talk about the deprecation. --- Hi Guix, this patch updates the gnome-desktop-configuration documentation, that really ought to have been updated sooner. It does not quite match the auto-generated documentation, because I took some stylistic choices and went further in some places. There is IIRC already a bug report talking about this, but I cannot at the top of my head recall its number. Cheers doc/guix.texi | 36 ++++++++++++++++++++++++++++++++++-- 1 file changed, 34 insertions(+), 2 deletions(-) base-commit: bfc614397b5f146056bda4b5a8e3a67bd1ca7b23 diff --git a/doc/guix.texi b/doc/guix.texi index acfe60b47a..e856e95fb5 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -24818,10 +24818,42 @@ Desktop Services @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