From unknown Thu Aug 14 21:48:45 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#60661 <60661@debbugs.gnu.org> To: bug#60661 <60661@debbugs.gnu.org> Subject: Status: [DOCUMENTATION] doc: Example of selecting package output with lisp Reply-To: bug#60661 <60661@debbugs.gnu.org> Date: Fri, 15 Aug 2025 04:48:45 +0000 retitle 60661 [DOCUMENTATION] doc: Example of selecting package output with= lisp reassign 60661 guix-patches submitter 60661 Karl Hallsby severity 60661 normal tag 60661 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Jan 08 14:38:08 2023 Received: (at submit) by debbugs.gnu.org; 8 Jan 2023 19:38:08 +0000 Received: from localhost ([127.0.0.1]:34757 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pEbUe-0006Yl-Gu for submit@debbugs.gnu.org; Sun, 08 Jan 2023 14:38:08 -0500 Received: from lists.gnu.org ([209.51.188.17]:47814) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pEbUZ-0006Ya-8y for submit@debbugs.gnu.org; Sun, 08 Jan 2023 14:38:07 -0500 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 1pEbUX-0006Ki-MK for guix-patches@gnu.org; Sun, 08 Jan 2023 14:38:03 -0500 Received: from mail-qt1-x82a.google.com ([2607:f8b0:4864:20::82a]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pEbUV-0002xg-O1 for guix-patches@gnu.org; Sun, 08 Jan 2023 14:38:01 -0500 Received: by mail-qt1-x82a.google.com with SMTP id bp44so6499040qtb.0 for ; Sun, 08 Jan 2023 11:37:58 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hallsby-com.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=p07Ryt8rYxZ8Pvit82M5ttsqozUv4J8tg0u3MJUMrXs=; b=itg608xYlKh+OftJjIOig3yyw5kZhTj44Refg3UHsWWOSI0v7p9g4XLVEEwB6j+vVm /XSpeL/4Zw9M3ei5+G/V5X4Yy4bxrFTjn4/lYRS8Gzl1Vi07e5lUqI429dzxL1tK0yAT bCL+WeAJt92AbUWfMK9jXdxqCtVFWJVz5NuofF0XVKkocCyaU9cvz+H/8l/mMturj2KV m8ClrEiWonlpoWE30PoUhuDfDN8g2fWx1o20saHS7y0y+yo9Rf6lHpLhKzK+m10G2My5 VtV9R1SWW7QSw/9BGlxorW9sEHvRBr9tAlLLjqQndvA4dn3QcCoUdbIBczTnjFYYN7TV Gfhw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=p07Ryt8rYxZ8Pvit82M5ttsqozUv4J8tg0u3MJUMrXs=; b=UprkJR7Le4npXeFWfP+QY7tGHaIL7vUElnmMwEA3Hz+F6PF7z20uLjm/gD5ywlTeVu a8zAxVsHIyd9fnHgvxlVoD+GTPz/JHzAh1BAnMXcg2RfzgmSxupItfQ4w9N5SbZQWTeG o9Is93BgMJV1Zq7rfuNKmdO3FsBn1J3M3D7GBcEfszoQzCFzMAtMtep8ld15Km5g6tcz GBfFOk//EhhwN4lNQ6+8w0ZE7M1eou6MF1rbKHuVHQakkEUxmmmceff37/O9XjMDTHTF 0htZM7PsHqAijwTHLSAsDRYygR7DJysjRC3i46hEjP6vNYdbpiJZ7TgBs03wRfX2RT15 dlaA== X-Gm-Message-State: AFqh2kovWWYXmCnia07AjaLzmIbgSeNibcbGcTt6YEph8qvnzu+aQK8e LaIpe6cW8Hg4rirVNGz2wVDA8hB5YYhHk+JQ X-Google-Smtp-Source: AMrXdXtpTe55NqVGDT2rKoEofyc8z4io57IEvYdhMoschXZpHwgxpO61Xz4fA2V4mI5lW2lVJL9UBw== X-Received: by 2002:a05:622a:5145:b0:3a5:fe93:7dd9 with SMTP id ew5-20020a05622a514500b003a5fe937dd9mr75290273qtb.44.1673206678097; Sun, 08 Jan 2023 11:37:58 -0800 (PST) Received: from Karl-Desktop.raven (1459483-v115.1145-static.batvilaa.metronetinc.net. [192.69.181.148]) by smtp.gmail.com with ESMTPSA id o25-20020ac86999000000b003a606428a59sm3567559qtq.91.2023.01.08.11.37.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 08 Jan 2023 11:37:57 -0800 (PST) From: Karl Hallsby To: guix-patches@gnu.org Subject: [DOCUMENTATION] doc: Example of selecting package output with lisp Date: Sun, 8 Jan 2023 13:37:55 -0600 Message-Id: X-Mailer: git-send-email 2.38.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: none client-ip=2607:f8b0:4864:20::82a; envelope-from=karl@hallsby.com; helo=mail-qt1-x82a.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit Cc: Karl Hallsby X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) * doc/guix.texi (Packages with Multiple Outputs): Give example of how to select a package's output is a Lisp-y fashion, without using a special procedure like specification->package. --- doc/guix.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 293c3016aa..025a73f616 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -4315,6 +4315,23 @@ The command to install its documentation is: guix install glib:doc @end example +While the colon syntax works for command-line specification of package +outputs, it will not work when specifying the package by Guix name. +For example, say you want to add only @code{glib}'s documentation to +your @code{operating-system}'s globally installed packages +(@pxref{operating-system Reference}). + +@lisp +(use-modules (gnu packages glib)) +;; glib-with-documentation is the Guile symbol for the glib package +(operating-system + ... + (packages + (append + (list (list glib-with-documentation "doc")) + %base-packages))) +@end lisp + Some packages install programs with different ``dependency footprints''. For instance, the WordNet package installs both command-line tools and graphical user interfaces (GUIs). The former depend solely on the C base-commit: 812ecf7ee673a3d619d1d3664350508c67e9d92c -- 2.38.1 From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 11 12:37:44 2023 Received: (at control) by debbugs.gnu.org; 11 Jan 2023 17:37:44 +0000 Received: from localhost ([127.0.0.1]:43738 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pFf2m-0003sL-Fc for submit@debbugs.gnu.org; Wed, 11 Jan 2023 12:37:44 -0500 Received: from smtpmciv6.myservices.hosting ([185.26.106.201]:35610) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pFf2i-0003sA-5U for control@debbugs.gnu.org; Wed, 11 Jan 2023 12:37:43 -0500 Received: from mail1.netim.hosting (unknown [185.26.106.172]) by smtpmciv6.myservices.hosting (Postfix) with ESMTP id D6BFB20CE0 for ; Wed, 11 Jan 2023 18:37:37 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by mail1.netim.hosting (Postfix) with ESMTP id 96DDC80096 for ; Wed, 11 Jan 2023 18:37:37 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at mail1.netim.hosting Received: from mail1.netim.hosting ([127.0.0.1]) by localhost (mail1-1.netim.hosting [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id 7Tz7K3vXsTsV for ; Wed, 11 Jan 2023 18:37:37 +0100 (CET) Received: from [192.168.1.239] (unknown [10.192.1.83]) (Authenticated sender: lumen@makinata.eu) by mail1.netim.hosting (Postfix) with ESMTPSA id 52DDB80093 for ; Wed, 11 Jan 2023 18:37:37 +0100 (CET) Message-ID: Date: Wed, 11 Jan 2023 17:37:36 +0000 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.6.1 Content-Language: en-US To: control From: Bruno Victal Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Score: 2.0 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: retitle 60732 [PATCH] gnu: Add package python-scapy tags 60732 + patch tags 60658 + patch tags 60661 + patch tags 60539 + patch tags 60540 + patch tags 60640 + patch quit Content analysis details: (2.0 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.0 SPF_PASS SPF: sender matches SPF record 1.8 MISSING_SUBJECT Missing Subject: header 0.2 NO_SUBJECT Extra score for no subject X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.0 (+) retitle 60732 [PATCH] gnu: Add package python-scapy tags 60732 + patch tags 60658 + patch tags 60661 + patch tags 60539 + patch tags 60540 + patch tags 60640 + patch quit From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 21 16:20:09 2023 Received: (at 60661-done) by debbugs.gnu.org; 21 Mar 2023 20:20:09 +0000 Received: from localhost ([127.0.0.1]:60900 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1peiSm-0006zp-RF for submit@debbugs.gnu.org; Tue, 21 Mar 2023 16:20:09 -0400 Received: from mail-qt1-f171.google.com ([209.85.160.171]:40923) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1peiSk-0006zD-Sj for 60661-done@debbugs.gnu.org; Tue, 21 Mar 2023 16:20:07 -0400 Received: by mail-qt1-f171.google.com with SMTP id x1so19461235qtr.7 for <60661-done@debbugs.gnu.org>; Tue, 21 Mar 2023 13:20:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1679430001; h=mime-version:user-agent:message-id:in-reply-to:date:references :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=twuO9Dj4UX1RSHWKrdxWjDKOMwKR0v9dt82AhIaQcL8=; b=TagQoE6pJ7i9OixY0GEhYjECDjiQ5OoJ5coFiBOjqR2Wtz60EG7KJgKpXFTMU5bSXn vuqEeEYqV54J32IcNd5neCxB6vNS5SAAmX88sZdBaba/G+LlI5/UzmKHbWq7PrtECrxj NKgMmHgU6CODbI0jvJujYwdBNWweGCPiaKm2sjRrh5n8lrlY+aEkjJUCkjjNJNYkQBAO hrRaPZv21pj0eXUWf5KqFmpx0suyOcwWcYYEBqVIy9lMLnmAFbn+nyH2oT/qeM+Crv0Q SMUihPBx3IBw7vWjBdVy2A7ju2Q4BcSN4dWYzoC+SyZS9YcS3YdhrQKOuJP2/yMoWbZv 1juA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1679430001; h=mime-version:user-agent:message-id:in-reply-to:date:references :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=twuO9Dj4UX1RSHWKrdxWjDKOMwKR0v9dt82AhIaQcL8=; b=k7U9CoDCeUgJlnHO3PaPTQr26cWAKf5qtbN3AkyozqVSOcQ5nb/pmdC+1mc2TCHKlV jaCGkOztID1i4Y2w3uTpoRDoA71fUAkYePPa2ll4LDFtP7sI4unkeJdLWqVVWv0JE0yK 4w7bilBXNW/vij9udlPR9vQtKcn1VgfEPanHe8t88R/euqFL+ARJ5Z/ql/bn5XaJeO6Z 9ei9fAyJpYCLWujM0d5eH7whOEn6raCuU0dEnTptB10XPtU/Q8AEghy68B357Uf9JC1s dN1dULaT3i77FLbZ7DVAyKEk2frFlA6n8zy8KmCfvGPkqGJJeMEfrpO08Gtu9JvP4NRj MkAw== X-Gm-Message-State: AO0yUKXi3R2GtLHz4Sbal+Y1y8Zz9znBMojv9NATY4sDTQOZKpF4jCKl GGwIgJ8pjiPITU8eKNqyiVlJjV75fJUD6w== X-Google-Smtp-Source: AK7set8I4L1g+lw2uClw7u9TnSEBVmJlazbfviGDwVwn6/Ri2NEbyZVipfRiuyN1AXXBwdbhVbADlg== X-Received: by 2002:ac8:5c93:0:b0:3e0:3187:faf3 with SMTP id r19-20020ac85c93000000b003e03187faf3mr2365271qta.13.1679430000988; Tue, 21 Mar 2023 13:20:00 -0700 (PDT) Received: from hurd (dsl-10-130-195.b2b2c.ca. [72.10.130.195]) by smtp.gmail.com with ESMTPSA id h26-20020ac846da000000b003bfb5fd72a7sm8778477qto.86.2023.03.21.13.20.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 21 Mar 2023 13:20:00 -0700 (PDT) From: Maxim Cournoyer To: Karl Hallsby Subject: Re: bug#60661: [DOCUMENTATION] doc: Example of selecting package output with lisp References: Date: Tue, 21 Mar 2023 16:19:59 -0400 In-Reply-To: (Karl Hallsby's message of "Sun, 8 Jan 2023 13:37:55 -0600") Message-ID: <878rfpn9g0.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 60661-done Cc: 60661-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello Karl, Karl Hallsby writes: > * doc/guix.texi (Packages with Multiple Outputs): Give example of how to > select a package's output is a Lisp-y fashion, without using a special > procedure like specification->package. > --- > doc/guix.texi | 17 +++++++++++++++++ > 1 file changed, 17 insertions(+) > > diff --git a/doc/guix.texi b/doc/guix.texi > index 293c3016aa..025a73f616 100644 > --- a/doc/guix.texi > +++ b/doc/guix.texi > @@ -4315,6 +4315,23 @@ The command to install its documentation is: > guix install glib:doc > @end example > > +While the colon syntax works for command-line specification of package > +outputs, it will not work when specifying the package by Guix name. > +For example, say you want to add only @code{glib}'s documentation to > +your @code{operating-system}'s globally installed packages > +(@pxref{operating-system Reference}). > + > +@lisp > +(use-modules (gnu packages glib)) > +;; glib-with-documentation is the Guile symbol for the glib package > +(operating-system > + ... > + (packages > + (append > + (list (list glib-with-documentation "doc")) > + %base-packages))) > +@end lisp > + > Some packages install programs with different ``dependency footprints''. > For instance, the WordNet package installs both command-line tools and > graphical user interfaces (GUIs). The former depend solely on the C > > base-commit: 812ecf7ee673a3d619d1d3664350508c67e9d92c Thanks for the contribution! I've taken the liberty to reword it slightly, to voice it using the third person instead of "you", like this: --8<---------------cut here---------------start------------->8--- modified doc/guix.texi @@ -4318,10 +4318,12 @@ guix install glib:doc @end example While the colon syntax works for command-line specification of package -outputs, it will not work when specifying the package by Guix name. -For example, say you want to add only @code{glib}'s documentation to -your @code{operating-system}'s globally installed packages -(@pxref{operating-system Reference}). +outputs, it will not work when using a package @emph{variable} in Scheme +code. For example, to add the documentation of @code{glib} to the +globally installed packages of an @code{operating-system} (see +@ref{operating-system Reference}), a list of two items, the first one +being the package @emph{variable} and the second one the name of the +output to select (a string), must be used instead: --8<---------------cut here---------------end--------------->8--- I also added your name to the list of contributors to 'guix.texi'. I hope you like it. The change has now been installed. -- Thanks, Maxim From unknown Thu Aug 14 21:48:45 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 19 Apr 2023 11:24:15 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator