From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id gPL9Obwe8mWKewEA62LTzQ:P1 (envelope-from ) for ; Wed, 13 Mar 2024 22:46:37 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id gPL9Obwe8mWKewEA62LTzQ (envelope-from ) for ; Wed, 13 Mar 2024 22:46:37 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=nrT0KkyN; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1710366396; 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: content-transfer-encoding:content-transfer-encoding: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=/KhTJXtm53C5hK+SN1EEltcM1GIPD2Eb4NyI/T+Vtrg=; b=Gjq8hHlSdV15qVB2jAy5hRu3ZHTzRdzqUA0JwfI9ZPteHSqxr08F4pb8/vBubHJmR1UJE5 LhAoo1dUAbjOhsee49tVxIfBFWr6CHpDCwVZ6RJocnNyFAbcuBeRrBSDAEYoTozN0R+ARV Pr6rEkw9vdiVebtHmTNU9ka5kX6vLnSUlUM73OnC79TLBqDPX0FH7LDHNAmQYJ4ed7F3QD bFCBQIDAPjsyevkOCc7lJpi1oU03ddrmvoJlkrJ7scqTzWNbYxnn3HjmmxBFcIR8Tu4n26 W4omd3P7OE6K8gHNDpaugA9HbskmdmImGnvzQ7cxDh7HE2euRLYZia22htH44g== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1710366396; a=rsa-sha256; cv=none; b=BY/mqydbEUnXgpAjM7/tVbhB32X5y1DxD3ngVozbClMCCqJ2+VRtmBxqyvPMl7kW5Jg8eY MUOI+l8rhDBw8s/pccUsBbtWIJRhDqszQUEtZkcRlGPnSrEsdNNFBNc01Co169FRFNirMy 8j5pXqEEKU2gpT5ZOHpS6Af99k6fbm7s8h50V/FaPxW3+SP7ggzns3+u/gyFYVM0GnkAcq KJ+7S3NSat8745uy5jtRc7U8lc1dX9hI54gRKEgHA031E/I3BuxivSFnaDAXODWVweJ62B AHL+xmYAej9gX2sUcHPfQhU+mYN051hUBk6pSyIRlge+a672owbP97k0sjkCiA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=nrT0KkyN; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org 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 5B9D26D18D for ; Wed, 13 Mar 2024 22:46:36 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rkWQg-0005ne-3U; Wed, 13 Mar 2024 17:46:30 -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 1rkWQd-0005nP-Gz for guix-patches@gnu.org; Wed, 13 Mar 2024 17:46:28 -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 1rkWQd-00020l-8k for guix-patches@gnu.org; Wed, 13 Mar 2024 17:46:27 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rkWRC-0000rL-H3 for guix-patches@gnu.org; Wed, 13 Mar 2024 17:47:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#69587] [PATCH] doc: Add =?UTF-8?Q?=E2=80=9CSource?= Tree =?UTF-8?Q?Structure=E2=80=9D?= section. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 13 Mar 2024 21:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 69587 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: "pelzflorian (Florian Pelz)" Cc: 69587@debbugs.gnu.org Received: via spool by 69587-submit@debbugs.gnu.org id=B69587.17103663863252 (code B ref 69587); Wed, 13 Mar 2024 21:47:02 +0000 Received: (at 69587) by debbugs.gnu.org; 13 Mar 2024 21:46:26 +0000 Received: from localhost ([127.0.0.1]:47543 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rkWQc-0000qN-4F for submit@debbugs.gnu.org; Wed, 13 Mar 2024 17:46:26 -0400 Received: from eggs.gnu.org ([209.51.188.92]:40640) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rkWQZ-0000q6-Dn for 69587@debbugs.gnu.org; Wed, 13 Mar 2024 17:46:24 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rkWPu-0001w5-2g; Wed, 13 Mar 2024 17:45:42 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=/KhTJXtm53C5hK+SN1EEltcM1GIPD2Eb4NyI/T+Vtrg=; b=nrT0KkyN3jhcpElnMre4 +Z43yXRIHM9+3SZv+5W7nrPMXQwlQ4jWrfV75A+bQX9Cv0VWM49ME0QtboLKGfTWWTsOmFNyDoBGe Y8R8jSwGLixFnIH1/+qCPZvKthnyxcBPxJ3+6jQhJ8JHXBY5ldWYWp3b8c+mefbdT8m6hQWEnXICo ghrzH9OK/CMDehCmBr3o84qO8AJeLsVuDfYEcm403qUo64LJpO0xK+qesiP49Nm8TMHTIioiFj8iE wnXsFXeun4LRV+Egr7KF4V9errsR8u1D+bZgRuhap1Wh+mjg8aDOOYvVfWRhZ5PVTDoxsbcQYhsAJ CZfsgsa9vFzVPQ==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= In-Reply-To: <87jzm8prmg.fsf@pelzflorian.de> (pelzflorian@pelzflorian.de's message of "Mon, 11 Mar 2024 19:09:43 +0100") References: <878r2sa9hd.fsf@pelzflorian.de> <877cic2xa6.fsf@gnu.org> <878r2r8o7f.fsf@pelzflorian.de> <87le6oog1j.fsf@gnu.org> <87jzm8prmg.fsf@pelzflorian.de> Date: Wed, 13 Mar 2024 22:45:01 +0100 Message-ID: <877ci5iz6q.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -7.19 X-Spam-Score: -7.19 X-Migadu-Queue-Id: 5B9D26D18D X-Migadu-Scanner: mx11.migadu.com X-TUID: 6PvhD7ZCQ11w Hello, "pelzflorian (Florian Pelz)" skribis: > Ludovic Court=C3=A8s writes: >>> Nice things like (guix swh) or (gnu system), (gnu build), (gnu >>> installer), (gnu machine), or po, still seem not useful for the general >>> populace to me. >> >> This is in the =E2=80=9CContributing=E2=80=9D chapter, so we=E2=80=99re = talking about a subset >> of the general populace. :-) >> >> You might argue that few current contributors care about the modules you >> mention, but by exposing the structure of the code, my hope is that more >> people would dare take a look and fiddle with it. [...] > Still I would prefer if (gnu system), (gnu build), (gnu installer), (gnu > machine), and especially po, were not part of the list. I expect that > most contributors want to provide a package or (home) service with docs > and tests. They will not customize the operating-system record type. I disagree here. This section is intended for people willing to contribute to Guix or to learn about it beyond packages (perhaps that intention should be more clearly stated though; perhaps that=E2=80=99s the = crux of our difference of interpretation?). I wouldn=E2=80=99t assume that this= or that part is not worthy. If the section is deemed too long, it probably makes sense to trim it a bit, but I don=E2=80=99t find it this long. Or we can use different examples, though I would keep those that are already documented elsewhere in the manual (like (gnu system)). WDYT? >> I think =E2=80=9Cmurky=E2=80=9D is a strong word, or at least it shouldn= =E2=80=99t be >> interpreted as meaning that the guix/gnu distinction is arbitrary. I=E2= =80=99ll >> try to clarify that as well. > > Hmm what is the difference between, let=E2=80=99s say, (gnu packages) and= (guix > package)? (guix packages) defines a type and associated mechanisms (the =E2=80=9Cpackage Reference=E2=80=9D section). (gnu packages) lets you browse packages defined in (gnu packages =E2=80=A6), etc. The former is abstract; the latter is about concrete package definitions. >> +@code{(guix @dots{})} modules@footnote{For this reason, @code{(guix >> +@dots{})} modules must generally not depend on @code{(gnu @dots{})} >> +modules, with one notable exception: @code{(guix build-system @dots{})} >> +modules may look up packages at run time---e.g., @code{(guix >> +build-system cmake)} needs to access the @code{cmake} variable at run >> +time.}. > > I think the (guix build-system @dots{}) never use (gnu =E2=80=A6)? They do, as in the =E2=80=98cmake=E2=80=99 example above. > scripts and importers do. Oh right, that=E2=80=99s true. So there=E2=80=99s more than one notable ex= ception. :-) Ludo=E2=80=99.