From patchwork Sun Jan 8 19:37:55 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Karl Hallsby X-Patchwork-Id: 45939 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 C54A927BBEB; Sun, 8 Jan 2023 19:39:15 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-3.7 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,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 288D127BBE9 for ; Sun, 8 Jan 2023 19:39:10 +0000 (GMT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pEbVY-0006qC-2C; Sun, 08 Jan 2023 14:39:04 -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 1pEbVW-0006po-Ot for guix-patches@gnu.org; Sun, 08 Jan 2023 14:39:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pEbVW-00036I-Gu for guix-patches@gnu.org; Sun, 08 Jan 2023 14:39:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pEbVW-0006Zz-Cz for guix-patches@gnu.org; Sun, 08 Jan 2023 14:39:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#60661] [DOCUMENTATION] doc: Example of selecting package output with lisp Resent-From: Karl Hallsby Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 08 Jan 2023 19:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 60661 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: To: 60661@debbugs.gnu.org Cc: Karl Hallsby X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.167320668825223 (code B ref -1); Sun, 08 Jan 2023 19:39:02 +0000 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 Date: Sun, 8 Jan 2023 13:37:55 -0600 Message-Id: X-Mailer: git-send-email 2.38.1 MIME-Version: 1.0 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-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 (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(+) base-commit: 812ecf7ee673a3d619d1d3664350508c67e9d92c 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