GNU bug report logs - #60661
[DOCUMENTATION] doc: Example of selecting package output with lisp

Message received at submit <at> debbugs.gnu.org:

Received: (at submit) by debbugs.gnu.org; 8 Jan 2023 19:38:08 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Jan 08 14:38:08 2023
Received: from localhost ([127.0.0.1]:34757 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pEbUe-0006Yl-Gu
	for submit <at> 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 <karl@HIDDEN>) id 1pEbUZ-0006Ya-8y
 for submit <at> 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 <karl@HIDDEN>) id 1pEbUX-0006Ki-MK
 for guix-patches@HIDDEN; 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 <karl@HIDDEN>) id 1pEbUV-0002xg-O1
 for guix-patches@HIDDEN; Sun, 08 Jan 2023 14:38:01 -0500
Received: by mail-qt1-x82a.google.com with SMTP id bp44so6499040qtb.0
 for <guix-patches@HIDDEN>; 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 <karl@HIDDEN>
To: guix-patches@HIDDEN
Subject: [DOCUMENTATION] doc: Example of selecting package output with lisp
Date: Sun,  8 Jan 2023 13:37:55 -0600
Message-Id: <dea0379eed9180efc4d5afc592caf77bbb26a21a.1673206657.git.karl@HIDDEN>
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@HIDDEN; 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 <karl@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
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