From patchwork Thu Sep 28 09:32:58 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Efraim Flashner X-Patchwork-Id: 54373 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 C5B9927BBEA; Thu, 28 Sep 2023 10:33:59 +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_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,SPF_HELO_PASS autolearn=ham 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 EB18727BBE2 for ; Thu, 28 Sep 2023 10:33:58 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qlnP4-0004Cd-Hh; Thu, 28 Sep 2023 05:33:50 -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 1qlnP2-0004CT-UH for guix-patches@gnu.org; Thu, 28 Sep 2023 05:33:48 -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 1qlnP2-0000sY-19 for guix-patches@gnu.org; Thu, 28 Sep 2023 05:33:48 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qlnPG-0003Yd-1s for guix-patches@gnu.org; Thu, 28 Sep 2023 05:34:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#66250] [PATCH] doc: Document specification->package+output. Resent-From: Efraim Flashner Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 28 Sep 2023 09:34:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 66250 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66250@debbugs.gnu.org Cc: Efraim Flashner X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.169589361613636 (code B ref -1); Thu, 28 Sep 2023 09:34:01 +0000 Received: (at submit) by debbugs.gnu.org; 28 Sep 2023 09:33:36 +0000 Received: from localhost ([127.0.0.1]:53018 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qlnOq-0003Xr-E5 for submit@debbugs.gnu.org; Thu, 28 Sep 2023 05:33:36 -0400 Received: from lists.gnu.org ([2001:470:142::17]:55700) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qlnOm-0003XZ-L7 for submit@debbugs.gnu.org; Thu, 28 Sep 2023 05:33:35 -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 1qlnOR-0004B4-MS for guix-patches@gnu.org; Thu, 28 Sep 2023 05:33:12 -0400 Received: from mail-wr1-x429.google.com ([2a00:1450:4864:20::429]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qlnOO-0000oL-Ft for guix-patches@gnu.org; Thu, 28 Sep 2023 05:33:09 -0400 Received: by mail-wr1-x429.google.com with SMTP id ffacd0b85a97d-3248e90f032so167566f8f.1 for ; Thu, 28 Sep 2023 02:33:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1695893586; x=1696498386; darn=gnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:sender:from:to:cc:subject:date:message-id:reply-to; bh=rQbFKv0VtFLSOjRL2V91IZnn0b7O4nrJEmZ0VfgMzMU=; b=H6wyC0lhMGXMuQ9qbUB+IyBAd9X1Exn4sVmiNcxbdQQotOmCMS3kao86PWK9oePAzK bo52IGJ100t5rmhwdjDiV3Q98XkV0QPs8YB2G44EnQ+f6gP74c9bH03znWYeJ7AmvcOU ponqtX1uTRlydQtQKtMsTZlWfTMmOjRXE5nTikDc0ex+UIxyG9n/j8ezaQEBx5WGWh0U OdvvNMUU8Y3jXIiR9bM/QSGZXt104chT4pyaw7hS/bz2+FdsLSCjlyhBAQKXAoD17Uoo WmpRACralyIT6tPZz+E7oHy0mCCsxemm9HLEc8KM9UviD3z8zuxBHouBt12waxpFhF7z 57Qg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695893586; x=1696498386; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:sender:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=rQbFKv0VtFLSOjRL2V91IZnn0b7O4nrJEmZ0VfgMzMU=; b=PpKAaNeNhEAbHIrM+eDe6kKdq/3QLSkYO/stQiph83Oe00Moi3TmnSZCUh8eANLIji JIyc7p0kvjlEh1dX4NjhqtW6fkC2b5ycRn6Ct0A+An3ensHQwH/fNO/lFej7Wk1Tbt2M Z/8UOprw7jBOoFTqi2tLx97nI+bkTLIEnvBd5KAhHHY5l5WXz3JdXv3HB7P89j0oU4ar tn+PYhnWWc5ScO/G7gLmmNNXfGHiiXTOJIp1xGw5cvYaktw5t+/JE1zaZoaDZMliuMvB fhzvv08/Ol/+TeuZH/lvLjasQeYvZdU+VzTEAaBCUCP4OrqU/SyQqm2FFF0vg+SQPqNV vfaA== X-Gm-Message-State: AOJu0YzoiKLuuv0Tf3x+x9t252wMSjf93KfSnhwxnfaFRVmR87VSU3fq AB+olv7XKcfJHpVNYm2N4SlgravD3q4O9A== X-Google-Smtp-Source: AGHT+IF5oME5rnQWsknAReA05VCl7fOV6QxwmwflSLBRf4QY6rUX0mJfGqE37rRr3et2AfLgh8dO8Q== X-Received: by 2002:a05:6000:1cd:b0:31f:a256:4bbb with SMTP id t13-20020a05600001cd00b0031fa2564bbbmr612152wrx.71.1695893585484; Thu, 28 Sep 2023 02:33:05 -0700 (PDT) Received: from localhost ([2a02:ed3:916:6300:c3db:b80e:a694:a54f]) by smtp.gmail.com with ESMTPSA id x6-20020a5d60c6000000b0031f300a4c26sm18925632wrt.93.2023.09.28.02.33.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 28 Sep 2023 02:33:05 -0700 (PDT) From: Efraim Flashner Date: Thu, 28 Sep 2023 12:32:58 +0300 Message-ID: X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::429; envelope-from=efraim.flashner@gmail.com; helo=mail-wr1-x429.google.com X-Spam_score_int: -14 X-Spam_score: -1.5 X-Spam_bar: - X-Spam_report: (-1.5 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, 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 Reported by nutcase on IRC. * doc/guix.texi (Using the Configuration System): Add a section about using specification->package+output. --- doc/guix.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index f49ed894a7..d9865f4ac0 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -16936,6 +16936,23 @@ Using the Configuration System %base-packages))) @end lisp +@findex specification->package+output +When a package has more than one output it can be a challenge to refer to +specific output instead of just to the standard @code{out} output. For these +situations one can use the @code{specification->package+output} procedure from +the @code{(gnu packages)} module. For example: + +@lisp +(use-modules (gnu packages)) + +(operating-system + ;; ... + (packages (append (map specification->package+output + '("nss-certs" "git" "git:send-email")) + %base-packages))) + +@end lisp + @unnumberedsubsec System Services @cindex services