From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id KCQZItP4WF8cTAAA0tVLHw (envelope-from ) for ; Wed, 09 Sep 2020 15:46:27 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id Q6niHdP4WF98QwAAbx9fmQ (envelope-from ) for ; Wed, 09 Sep 2020 15:46:27 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 20F319400C7 for ; Wed, 9 Sep 2020 15:46:27 +0000 (UTC) Received: from localhost ([::1]:41114 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kG2Ij-0000zr-UD for larch@yhetil.org; Wed, 09 Sep 2020 11:46:25 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:45776) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kG2IM-0000Va-CR for bug-guix@gnu.org; Wed, 09 Sep 2020 11:46:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:49693) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kG2IL-00016x-Ku for bug-guix@gnu.org; Wed, 09 Sep 2020 11:46:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kG2IL-0005zN-Ig for bug-guix@gnu.org; Wed, 09 Sep 2020 11:46:01 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#26170: Bug #26170 Hunting: doc: Explanation of propagated-inputs unclear Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Wed, 09 Sep 2020 15:46:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 26170 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: "pelzflorian (Florian Pelz)" Received: via spool by 26170-submit@debbugs.gnu.org id=B26170.159966635723011 (code B ref 26170); Wed, 09 Sep 2020 15:46:01 +0000 Received: (at 26170) by debbugs.gnu.org; 9 Sep 2020 15:45:57 +0000 Received: from localhost ([127.0.0.1]:33006 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kG2IH-0005z5-CB for submit@debbugs.gnu.org; Wed, 09 Sep 2020 11:45:57 -0400 Received: from mail-wr1-f66.google.com ([209.85.221.66]:42750) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kG2IE-0005yr-UY for 26170@debbugs.gnu.org; Wed, 09 Sep 2020 11:45:55 -0400 Received: by mail-wr1-f66.google.com with SMTP id c18so3479807wrm.9 for <26170@debbugs.gnu.org>; Wed, 09 Sep 2020 08:45:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=aDHNxNclAAIF1V5Vl6OoK5Yuo8KUq4EJc7o5oPtCFQk=; b=ejhxFYTh4riSRRhqpwNplLtkj2PSOATIkAuv+ynLRQh98M4C5jo0Vk1L6nNK7cGqeU 7rTf8g6qStz/AMKTzFckBwnP63uRjFMSn6iiKg+Gy51ymq3wchTFasZq+Yl6G+thUJ7y lKEeIbhrmu2LQRd4ID2Wgn7u+K1q8BoRkRYi2lG7kktBMGmmLyu5uqYa0UcThRNjIfVC wmRRBhUJDfYXl6iGeVru2C6klnFyV+AZWo9JWkG9/YmpzhrgnE6/hQvLZX77MC2wuYGO BN5nU1goG2CUhtMulEs88orLqWeNoh+OveEe+zKd4WKxkMu/42PKEoQIV9kGO4Zr7ASN 4WFw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=aDHNxNclAAIF1V5Vl6OoK5Yuo8KUq4EJc7o5oPtCFQk=; b=kSNuJqN+dUYpMiYbYBHc+/59ixwGvGgHwBiDZjb8WDaoIWLVK2/cTjXpfjucZYeZbJ wODJV6DsHt2SdBlpynL+MC4SVpHJotVm9mfl1BjDb1PqAcRTjEs1Ey9BXx7gwsmKYAii sFQaGNi54IKCzPtO9+S/CQPGnwryeMlgHmlgUnIVrZOa/m+tbtDbn7URmxu2kKHl9me1 gR7NR4ptu0HpZK90KF5K9xCZyDrFCn+a8iDhGAL84d6kSba+GkWqZnud8f0V8npPf3+q ad7DDH4rnvXV6Agnm6jQlQjSU7if1kmMGIOcBqL+QClD+oVBS3Gp0QWUGVpIERA0r6u0 tyWA== X-Gm-Message-State: AOAM5332zk/lnjvH3DRSyGg5HE2+KAnFylZqE0bRDRuGlAnL/6DlBBr6 GBPfdKb7P9hsOT523WJrHCMQmqd2hnY= X-Google-Smtp-Source: ABdhPJwMrJiFf3NqQ6w02KsBvAzZG01HlBjK21VRssQR5JV+brev+SXJamy8Cw9WBrALLGENmmHJcg== X-Received: by 2002:adf:fc92:: with SMTP id g18mr4864244wrr.201.1599666348745; Wed, 09 Sep 2020 08:45:48 -0700 (PDT) Received: from pfiuh02 ([193.48.40.241]) by smtp.gmail.com with ESMTPSA id t22sm5166476wmt.1.2020.09.09.08.45.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 09 Sep 2020 08:45:48 -0700 (PDT) From: zimoun References: <20191203124904.lotocvk7htki2ill@pelzflorian.localdomain> <87h7s7ulo4.fsf@gmail.com> <20200909151021.dnte7uodi3gj5t6r@pelzflorian.localdomain> Date: Wed, 09 Sep 2020 17:45:47 +0200 In-Reply-To: <20200909151021.dnte7uodi3gj5t6r@pelzflorian.localdomain> (pelzflorian@pelzflorian.de's message of "Wed, 9 Sep 2020 17:10:21 +0200") Message-ID: <874ko7uf6c.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -1.0 (-) X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: 26170@debbugs.gnu.org Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=fail (rsa verify failed) header.d=gmail.com header.s=20161025 header.b=ejhxFYTh; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Spam-Score: 0.09 X-TUID: tRzeRNdD8CiM On Wed, 09 Sep 2020 at 17:10, "pelzflorian (Florian Pelz)" wrote: > Thank you for bringing up this bug again with detailed > cross-referencing. Sorry for not sending a patch earlier. My pleasure. :-) >>>From fd4955cd0a61e92c37a371e4c5411a505ad5ac76 Mon Sep 17 00:00:00 2001 > From: Florian Pelz > Date: Wed, 9 Sep 2020 16:54:04 +0200 > Content-Type: text/plain; charset=UTF-8 > Content-Transfer-Encoding: 8bit > Subject: [PATCH] doc: Clarify what propagated inputs are. > > Fixes . > > * doc/guix.texi (package Reference)[package-propagated-inputs]: Clarify. > --- > doc/guix.texi | 10 +++++----- > 1 file changed, 5 insertions(+), 5 deletions(-) > > diff --git a/doc/guix.texi b/doc/guix.texi > index 1d6782e6fa..0a5640b174 100644 > --- a/doc/guix.texi > +++ b/doc/guix.texi > @@ -6360,21 +6360,21 @@ this area (@pxref{Invoking guix lint}). > > @anchor{package-propagated-inputs} > Lastly, @code{propagated-inputs} is similar to @code{inputs}, but the > -specified packages will be automatically installed alongside the package > +specified packages will be automatically installed to profiles (@pxref{Features, the role of profiles in Guix}) alongside the package Do not forget the correct filling length. :-) > they belong to (@pxref{package-cmd-propagated-inputs, @command{guix > package}}, for information on how @command{guix package} deals with > propagated inputs). > > -For example this is necessary when a C/C++ library needs headers of > +For example this is necessary when packaging a C/C++ library that needs headers of Idem. > another library to compile, or when a pkg-config file refers to another > one @i{via} its @code{Requires} field. > > Another example where @code{propagated-inputs} is useful is for languages > that lack a facility to record the run-time search path akin to the > @code{RUNPATH} of ELF files; this includes Guile, Python, Perl, and > -more. To ensure that libraries written in those languages can find > -library code they depend on at run time, run-time dependencies must be > -listed in @code{propagated-inputs} rather than @code{inputs}. > +more. When packaging libraries written in those languages, ensure they can find > +library code they depend on at run time by listing run-time dependencies > +in @code{propagated-inputs} rather than @code{inputs}. Idem. And my English is not good enough to read the difference. :-) > @item @code{outputs} (default: @code{'("out")}) > The list of output names of the package. @xref{Packages with Multiple All the best, simon