From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id yHNFC+s9U2GJMgEAgWs5BA (envelope-from ) for ; Tue, 28 Sep 2021 18:08:11 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id CGrSBus9U2ExLwAAbx9fmQ (envelope-from ) for ; Tue, 28 Sep 2021 16:08:11 +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 62EBAE328 for ; Tue, 28 Sep 2021 18:08:10 +0200 (CEST) Received: from localhost ([::1]:57988 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mVFeL-0008VL-I2 for larch@yhetil.org; Tue, 28 Sep 2021 12:08:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58222) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVFZO-0002G7-Oh for guix-patches@gnu.org; Tue, 28 Sep 2021 12:03:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:35214) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mVFZO-0003Qp-Gc for guix-patches@gnu.org; Tue, 28 Sep 2021 12:03:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mVFZO-0004y1-96 for guix-patches@gnu.org; Tue, 28 Sep 2021 12:03:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#50620] [PATCH 1/2] guix: packages: Document 'computed-origin-method'. Resent-From: Liliana Marie Prikler Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 28 Sep 2021 16:03:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50620 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Mark H Weaver , zimoun Cc: 50620@debbugs.gnu.org Received: via spool by 50620-submit@debbugs.gnu.org id=B50620.163284492419017 (code B ref 50620); Tue, 28 Sep 2021 16:03:02 +0000 Received: (at 50620) by debbugs.gnu.org; 28 Sep 2021 16:02:04 +0000 Received: from localhost ([127.0.0.1]:46760 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVFYS-0004we-7y for submit@debbugs.gnu.org; Tue, 28 Sep 2021 12:02:04 -0400 Received: from mail-wr1-f66.google.com ([209.85.221.66]:36440) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVFYM-0004w6-L0 for 50620@debbugs.gnu.org; Tue, 28 Sep 2021 12:02:02 -0400 Received: by mail-wr1-f66.google.com with SMTP id g16so58936326wrb.3 for <50620@debbugs.gnu.org>; Tue, 28 Sep 2021 09:01:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=message-id:subject:from:to:cc:date:in-reply-to:references :user-agent:mime-version; bh=IxM5UgeJGpQnUDmMsd6rP22VIUDbJ4knH5+UMAdA/p0=; b=IWmAS3pHGBqBpelbw14TFVilnAl/IhZp0YtYzTFApzg90U+vYtlSd9wBufKTfFDdDu knjxq6O4A2ruNHFPe6UriQSeENwT+JIlYu07Aoo2F4TaYv9qBYcctO2eJB94IJb8XFGM glpckUsf+fd++y/ZNnDLF+VER7nmMZ91LINkEtX5TKUc24KajE5dPHmnnSUb/yERe5kj 7GXZ6I4VGAwcPiCKreieisa2rjlg9kM8wMJUSINgqMRtQ9Xkqpsi96G+t1zsB9/8NgZI r44kqtYOUxQySDJEDIa0mTF6LnCYErk9OgKhZsuXOXRwizSmZ3WhWrCB9TQQWmjOxPIe BdFQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:subject:from:to:cc:date:in-reply-to :references:user-agent:mime-version; bh=IxM5UgeJGpQnUDmMsd6rP22VIUDbJ4knH5+UMAdA/p0=; b=NuX1b9OF1PUWrOfeDUZSn1iTaZ5YghbAb9l53sw1wSyu1DX3swtGnwiMosO6J79mhy Wy88XDf0Vc1yimahu7uxj4jmd8hcI0o+LbPYsj6AfYvbrewtUZqLNSLMpIIQwVl0T2zZ CXVpsDLQadgR96xWSVFTxPOnQcL1Opw+KGZXVWrcw6YNPFhKjUzyk0ljkHdFXHI1vDQC EYR1vi5owpVECjiVTbQWog1Zv79CTniVQ1Uk+3BEvJY42bTBvRWnZNqUjSTXCY4jd72u C4d4LBjDyC2wfxTeVUH5jamGJl6w20tS2wfs1sj+mNdY7VO0L3wdB3IzqcICW350W+3h NTIw== X-Gm-Message-State: AOAM5317GxkF/0f/D66TJAW5cBxaXQvDijd9kHMdguoZfGIn7nDqYx3l cbee1ZiYMmUodANIUYriw7I= X-Google-Smtp-Source: ABdhPJzSFDhvGUrTiIHCrfn5E9XFc4k2ksFLOyZ5s76NgnLYOHgjYecj0riOPd64AX3NlYsiVwn8Kg== X-Received: by 2002:a5d:4608:: with SMTP id t8mr1056448wrq.136.1632844912795; Tue, 28 Sep 2021 09:01:52 -0700 (PDT) Received: from nijino.fritz.box (85-127-52-93.dsl.dynamic.surfer.at. [85.127.52.93]) by smtp.gmail.com with ESMTPSA id e21sm3130424wme.42.2021.09.28.09.01.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Sep 2021 09:01:52 -0700 (PDT) Message-ID: From: Liliana Marie Prikler Date: Tue, 28 Sep 2021 18:01:51 +0200 In-Reply-To: <87pmstghx0.fsf@netris.org> References: <20210916114734.2686426-1-zimon.toutoune@gmail.com> <9b6ee27ff10e1042a5d61d0f93d957cf760e9ecb.camel@gmail.com> <87v930ay5y.fsf@netris.org> <87pmstghx0.fsf@netris.org> Content-Type: multipart/mixed; boundary="=-qrcXMPYMoD8D+wjRq+BR" User-Agent: Evolution 3.34.2 MIME-Version: 1.0 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+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1632845290; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post: dkim-signature; bh=IxM5UgeJGpQnUDmMsd6rP22VIUDbJ4knH5+UMAdA/p0=; b=P0XXw681TjtGBoNsrZ9rT+6zMc+Xi6fJtT0Jzbeqf2TMkVWZL/rLXuRfTtY5G8MHYjm/OX D3HI/1w5XuaB5weHkKcR7/w0utGrR8o2eIkoK7/cQuCF8ekP7mWcw9cphyblvxG+4lh68Z wQ0AA3KtDDkQvu57VA8PTeHwiTbkMiWyUJYU5u2gPJwemyHCjE6gNUstalcZj24D5JJWvU K8Ppz9d7JFYhluc7iWsoKga7N3VyBR2/Jbwxnng2E+Lj0nYDmVNnNn6LfZmJk2fZYqQZrO w5FEOgF/o9UYBeL2BDFjokmoCVU24OzNMjjTgU0SV//45dyY3eSU3LIif/f0iQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1632845290; a=rsa-sha256; cv=none; b=XGd7NERZnZpXdXyxRN0OrqaOpuqkhnbUzGzrZp7z1SSyzlmiLl324xvK+tTpjRerGFRqDv XAEzk0wURjF2n7rB0a7setRRXtyTKV5e+fVA4fkuTibiSLCF2nlxcAUAT5WfcCjBiX3Cwq eOldrj2csDZdlGTWCeBjzR7hGEYZ+gS5hm6yPhQPegrT9gxzZAzY+FHQ6k4vjs1sWA7RNz Du3YivaPdkXzC9ZNSKniTnyjRwHuxNCSUKnq2qeqm9s1CuWEFXtyPw/RIVnGHOYEjQunZ1 wTzVY+lUieytd/YqfH6fQM+j1AW+rXSf3VQpPWfgGF/vcp11X5fgVfOLndQrSQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=IWmAS3pH; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Spam-Score: -1.20 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=IWmAS3pH; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Queue-Id: 62EBAE328 X-Spam-Score: -1.20 X-Migadu-Scanner: scn0.migadu.com X-TUID: yh2Rk80jE/CB --=-qrcXMPYMoD8D+wjRq+BR Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit Hi everyone, Am Dienstag, den 28.09.2021, 05:36 -0400 schrieb Mark H Weaver: > Hi Simon, > > zimoun writes: > > On Fri, 17 Sept 2021 at 01:40, Mark H Weaver > > wrote: > > > Liliana Marie Prikler wrote: > [...] > > > > If done this way, there'd be the benefit that modules with > > > > packages > > > > using this thing would have to explicitly request the presence > > > > of the > > > > symbol through their use-modules clauses. > > > > > > Actually, for better or worse, Guile's '@@' form does not require > > > the named module to be imported using 'use-modules', so I don't > > > think this benefit strictly exists as stated above. However, I > > > agree that it's good practice to list all imported modules in > > > the '#:use-module' clauses at the top of the file wherever > > > possible [*], and that there may be somebenefit in declaring the > > > use of 'computed-origins' at the top of each file. > > > > I am not deeply familiar with Guile module. > > > > I chose to put this in (guix packages) instead of its own module > > because the module would contain only one function and nothing > > exported. The aim for now, as discussed, is to not make this > > 'method' part of the public API. If so, one could argue that (gnu packages) is a better location to hide it, but my main issue is that we still need to hide it! This will cause other channels to refer to it using @@ or roll their own implementations. > > Then if the function is not exported by the module, the '#:use- > > module' does not have an effect, right? > > It's true that it would have no effect on the set of available > bindings, and that's an excellent point. Perhaps Liliana could > clarify what she had in mind, or better yet, propose a patch. I would argue that something like computed-origin-method *does* deserve to be an exported binding, but ought not to be grouped together into (guix packages). The latter only provides record types, not methods (which are typically implemented elsewhere), and I'd like to keep it that way. I've attached a patch to illustrate my point, but please don't apply it as is. I have not put in the necessary git blame research to find out who would need to be copyrighted here. Regards, Liliana --=-qrcXMPYMoD8D+wjRq+BR Content-Disposition: attachment; filename="0001-guix-Add-computed-origins.patch" Content-Type: text/x-patch; name="0001-guix-Add-computed-origins.patch"; charset="UTF-8" Content-Transfer-Encoding: base64 RnJvbSBlYTEzOGZkYjE0NTIyNGEwNGEyYmFkMjdlMjE0ZGY3ZTI4M2NjZWU3IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBMaWxpYW5hIE1hcmllIFByaWtsZXIgPGxpbGlhbmEucHJpa2xl ckBnbWFpbC5jb20+CkRhdGU6IFR1ZSwgMjggU2VwIDIwMjEgMTc6NTQ6MjMgKzAyMDAKU3ViamVj dDogW1BBVENIXSBndWl4OiBBZGQgY29tcHV0ZWQtb3JpZ2lucy4KTUlNRS1WZXJzaW9uOiAxLjAK Q29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PVVURi04CkNvbnRlbnQtVHJhbnNmZXIt RW5jb2Rpbmc6IDhiaXQKClRoaXMgYWRkcyB0aGUg4oCYY29tcHV0ZWQtb3JpZ2luLW1ldGhvZOKA mSB1c2VkIGJ5IGxpbnV4LWxpYnJlIG9yIGljZWNhdCB1bmRlcgp0aGUgbmV3IG5hbWUg4oCYY29t cHV0ZS1vcmlnaW7igJkgYXMgcHVibGljIEd1aXggQVBJLgoKKiBndWl4L2NvbXB1dGVkLW9yaWdp bnM6IE5ldyBmaWxlLgotLS0KIE1ha2VmaWxlLmFtICAgICAgICAgICAgICAgfCAgMSArCiBndWl4 L2NvbXB1dGVkLW9yaWdpbnMuc2NtIHwgMzcgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKwogMiBmaWxlcyBjaGFuZ2VkLCAzOCBpbnNlcnRpb25zKCspCiBjcmVhdGUgbW9kZSAx MDA2NDQgZ3VpeC9jb21wdXRlZC1vcmlnaW5zLnNjbQoKZGlmZiAtLWdpdCBhL01ha2VmaWxlLmFt IGIvTWFrZWZpbGUuYW0KaW5kZXggYjY2Nzg5ZmEwYi4uZThmMGM2M2UyYiAxMDA2NDQKLS0tIGEv TWFrZWZpbGUuYW0KKysrIGIvTWFrZWZpbGUuYW0KQEAgLTk4LDYgKzk4LDcgQEAgTU9EVUxFUyA9 CQkJCQlcCiAgIGd1aXgvYnpyLWRvd25sb2FkLnNjbSAgICAgICAgICAgIAkJXAogICBndWl4L2dp dC1kb3dubG9hZC5zY20JCQkJXAogICBndWl4L2hnLWRvd25sb2FkLnNjbQkJCQlcCisgIGd1aXgv Y29tcHV0ZWQtb3JpZ2lucy5zY20JCQkJXAogICBndWl4L3N3aC5zY20JCQkJCVwKICAgZ3VpeC9t b25hZHMuc2NtCQkJCVwKICAgZ3VpeC9tb25hZC1yZXBsLnNjbQkJCQlcCmRpZmYgLS1naXQgYS9n dWl4L2NvbXB1dGVkLW9yaWdpbnMuc2NtIGIvZ3VpeC9jb21wdXRlZC1vcmlnaW5zLnNjbQpuZXcg ZmlsZSBtb2RlIDEwMDY0NAppbmRleCAwMDAwMDAwMDAwLi5mN2M4M2RmMGJmCi0tLSAvZGV2L251 bGwKKysrIGIvZ3VpeC9jb21wdXRlZC1vcmlnaW5zLnNjbQpAQCAtMCwwICsxLDM3IEBACis7Ozsg R05VIEd1aXggLS0tIEZ1bmN0aW9uYWwgcGFja2FnZSBtYW5hZ2VtZW50IGZvciBHTlUKKzs7OyBD b3B5cmlnaHQgwqkgMTMxMiBNYXggTcO8bGxlciA8bWF4QG3DvGxsZXIuZ21iaD4KKzs7OworOzs7 IFRoaXMgZmlsZSBpcyBwYXJ0IG9mIEdOVSBHdWl4LgorOzs7Cis7OzsgR05VIEd1aXggaXMgZnJl ZSBzb2Z0d2FyZTsgeW91IGNhbiByZWRpc3RyaWJ1dGUgaXQgYW5kL29yIG1vZGlmeSBpdAorOzs7 IHVuZGVyIHRoZSB0ZXJtcyBvZiB0aGUgR05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UgYXMgcHVi bGlzaGVkIGJ5Cis7OzsgdGhlIEZyZWUgU29mdHdhcmUgRm91bmRhdGlvbjsgZWl0aGVyIHZlcnNp b24gMyBvZiB0aGUgTGljZW5zZSwgb3IgKGF0Cis7OzsgeW91ciBvcHRpb24pIGFueSBsYXRlciB2 ZXJzaW9uLgorOzs7Cis7OzsgR05VIEd1aXggaXMgZGlzdHJpYnV0ZWQgaW4gdGhlIGhvcGUgdGhh dCBpdCB3aWxsIGJlIHVzZWZ1bCwgYnV0Cis7OzsgV0lUSE9VVCBBTlkgV0FSUkFOVFk7IHdpdGhv dXQgZXZlbiB0aGUgaW1wbGllZCB3YXJyYW50eSBvZgorOzs7IE1FUkNIQU5UQUJJTElUWSBvciBG SVRORVNTIEZPUiBBIFBBUlRJQ1VMQVIgUFVSUE9TRS4gIFNlZSB0aGUKKzs7OyBHTlUgR2VuZXJh bCBQdWJsaWMgTGljZW5zZSBmb3IgbW9yZSBkZXRhaWxzLgorOzs7Cis7OzsgWW91IHNob3VsZCBo YXZlIHJlY2VpdmVkIGEgY29weSBvZiB0aGUgR05VIEdlbmVyYWwgUHVibGljIExpY2Vuc2UKKzs7 OyBhbG9uZyB3aXRoIEdOVSBHdWl4LiAgSWYgbm90LCBzZWUgPGh0dHA6Ly93d3cuZ251Lm9yZy9s aWNlbnNlcy8+LgorCisoZGVmaW5lLW1vZHVsZSAoZ3VpeCBjb21wdXRlZC1vcmlnaW5zKQorICAj OnVzZS1tb2R1bGUgKGd1aXggbW9uYWRzKQorICAjOnVzZS1tb2R1bGUgKGd1aXggc3RvcmUpCisg ICM6dXNlLW1vZHVsZSAoZ3VpeCBwYWNrYWdlcykKKyAgIzp1c2UtbW9kdWxlIChndWl4IGdleHAp CisgICM6ZXhwb3J0IChjb21wdXRlLW9yaWdpbikpCisKKyhkZWZpbmUqIChjb21wdXRlLW9yaWdp biBnZXhwLXByb21pc2UgaGFzaC1hbGdvIGhhc2gKKyAgICAgICAgICAgICAgICAgICAgICAgICAj Om9wdGlvbmFsIChuYW1lICJzb3VyY2UiKQorICAgICAgICAgICAgICAgICAgICAgICAgICM6a2V5 IChzeXN0ZW0gKCVjdXJyZW50LXN5c3RlbSkpCisgICAgICAgICAgICAgICAgICAgICAgICAgKGd1 aWxlIChkZWZhdWx0LWd1aWxlKSkpCisgICJSZXR1cm4gYSBkZXJpdmF0aW9uIHRoYXQgZXhlY3V0 ZXMgdGhlIEctZXhwcmVzc2lvbiB0aGF0IHJlc3VsdHMKK2Zyb20gZm9yY2luZyBHRVhQLVBST01J U0UuIgorICAobWxldCAlc3RvcmUtbW9uYWQgKChndWlsZSAocGFja2FnZS0+ZGVyaXZhdGlvbiBn dWlsZSBzeXN0ZW0pKSkKKyAgICAoZ2V4cC0+ZGVyaXZhdGlvbiAob3IgbmFtZSAiY29tcHV0ZWQt b3JpZ2luIikKKyAgICAgICAgICAgICAgICAgICAgICAoZm9yY2UgZ2V4cC1wcm9taXNlKQorICAg ICAgICAgICAgICAgICAgICAgICM6Z3JhZnQ/ICNmICAgICAgIDtub3RoaW5nIHRvIGdyYWZ0Cisg ICAgICAgICAgICAgICAgICAgICAgIzpzeXN0ZW0gc3lzdGVtCisgICAgICAgICAgICAgICAgICAg ICAgIzpndWlsZS1mb3ItYnVpbGQgZ3VpbGUpKSkKLS0gCjIuMzMuMAoK --=-qrcXMPYMoD8D+wjRq+BR--