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 iMzdGLF07GW90gAA62LTzQ:P1 (envelope-from ) for ; Sat, 09 Mar 2024 15:39:45 +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 iMzdGLF07GW90gAA62LTzQ (envelope-from ) for ; Sat, 09 Mar 2024 15:39:45 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=YZm418U3; 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=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1709995185; 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=9D2zWrCrYRcKxR3EnMNoDyTaE7vc8C5fDd22gAarAyA=; b=RRZHoeMDH/TOGvu25s8tpTLVILe0KVNPyhpQRrFVJt1FDY3w7Krs0afSc67yEQiTjEtxFX I3PVG//CmaV0c0YUhyhMlshDRalUbA/RTiV0Y94JWit2fJdQi718dCwEaMI43pqHIualA1 r8zKqFxJOpWfuWUhNXzgZ6jj8dw41iRkUNACyyMEwcdZzy0ABJaTdmk8eULLh0c6Voc2lv Xaf8aUlb5e46/T+HIjuNHcb7nzCsKCkHw/xWpMMkZFV/FeqINlC/SwqN7/HgRni58OWRRq XkpIcDAA8T/cz2Nce+aPIHZ3dQE5t/G785Uu2uoORfXToTA/Z9upoM+MYUzUOA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1709995185; a=rsa-sha256; cv=none; b=o1TyiS1UCwXOHHGbzE5h2HMA7dahXpabqaMB4SR5LrGELPH9VPyF4yAJeMc2uUx49wj83Y RMfjf72V+ltlz4RNt1kr+q/+DTvxdpB2+7NwBvXCD86Ncn613nyGioY1BPLLWLU5Sk0O2M 32KAKsukyzG0M1M6i886FkTagPNFe/Xznuw+wIFjEce0nrQEpT9YYVMuC6PVaV5gj8zkTb w0NEnZ1SwnASkI6SiTLxEUJKPuqgGoJzEKlrxj3mzo4wF1/gjTzUoFPBBYTLUznkPc9cnQ sp/sVcy2zrorWFTGYf0dQ0EOmeQdhQRSjNWryXHjB/HE62Vhh88HfyKLq29Kxg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=YZm418U3; 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=none 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 1095F748DD for ; Sat, 9 Mar 2024 15:39:45 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rixrJ-0005tQ-9S; Sat, 09 Mar 2024 09:39:33 -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 1rixrG-0005su-27 for guix-patches@gnu.org; Sat, 09 Mar 2024 09:39:30 -0500 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 1rixrF-00072X-QM for guix-patches@gnu.org; Sat, 09 Mar 2024 09:39:29 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rixrm-00089Z-BB for guix-patches@gnu.org; Sat, 09 Mar 2024 09:40:02 -0500 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: "pelzflorian (Florian Pelz)" Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sat, 09 Mar 2024 14:40: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: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 69587@debbugs.gnu.org Received: via spool by 69587-submit@debbugs.gnu.org id=B69587.170999517131291 (code B ref 69587); Sat, 09 Mar 2024 14:40:02 +0000 Received: (at 69587) by debbugs.gnu.org; 9 Mar 2024 14:39:31 +0000 Received: from localhost ([127.0.0.1]:60999 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rixrH-00088d-1D for submit@debbugs.gnu.org; Sat, 09 Mar 2024 09:39:31 -0500 Received: from relay.yourmailgateway.de ([46.38.247.119]:55979) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rixrE-00088T-8m for 69587@debbugs.gnu.org; Sat, 09 Mar 2024 09:39:29 -0500 Received: from mors-relay-8404.netcup.net (localhost [127.0.0.1]) by mors-relay-8404.netcup.net (Postfix) with ESMTPS id 4TsQdp1W3Vz80xR; Sat, 9 Mar 2024 15:38:54 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1709995134; bh=kUSiU9ACBfmA6ajy5nyfcNx1pR4A+tvItVlnxl+VKdw=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=YZm418U3fuaQLU22rJhZd7jXWIx6upYzugFMUMbT3XK4F8QCarHuhEGqnl8nYihfG H9HCMzAT8hnIEze+1SUc+pnQ/DpUSKq6A1FBBjO2oJ18zldAaNUdRdiLlUS3SiUUGI UNZ9YOezENIo6dA5OrNWQmo1G0i05AUaOVozCTFPC1MLleVI7txxmVvjF4UU5NT/1f BkoS/YC/RgUKW0SJL7qxP5SZ9Nfty9945fXG82kYt2qUFIzDsVgBGRXYd6uiSHnRfs rB8M1cRdMjG9a6V6JBGlK+nx4jCoteqDOu7oZq0W7EBtTI0yKp6ErMD8yyJyISmZnf iOCP4Pxgq2aMw== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by mors-relay-8404.netcup.net (Postfix) with ESMTPS id 4TsQdp16rlz4yDg; Sat, 9 Mar 2024 15:38:54 +0100 (CET) Received: from mxe217.netcup.net (unknown [10.243.12.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by policy02-mors.netcup.net (Postfix) with ESMTPS id 4TsQdn5wkZz8svW; Sat, 9 Mar 2024 15:38:53 +0100 (CET) Received: from florianrock64 (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id 4513E82EAA; Sat, 9 Mar 2024 15:38:46 +0100 (CET) From: "pelzflorian (Florian Pelz)" In-Reply-To: <877cic2xa6.fsf@gnu.org> ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Fri, 08 Mar 2024 23:06:57 +0100") References: <878r2sa9hd.fsf@pelzflorian.de> <877cic2xa6.fsf@gnu.org> Date: Sat, 09 Mar 2024 15:38:44 +0100 Message-ID: <878r2r8o7f.fsf@pelzflorian.de> 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-Rspamd-Queue-Id: 4513E82EAA X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: fGlopATOmv4cjmsEH+NdOCun6iKV1wDsVRv97F1HgY9cQq+c+PtS1Y8i 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: -5.28 X-Spam-Score: -5.28 X-Migadu-Queue-Id: 1095F748DD X-Migadu-Scanner: mx11.migadu.com X-TUID: hBVR3G4NppR4 Hi Ludo. Josselin=E2=80=99s talk is different in that it is a talk of more than 30 minutes. In so much time, it can give more detailed guidance to almost the whole guix source tree, even including build-aux and nix. Josselin also gives hints to use git grep (like you) but also to read the commentary at the top of the file. This may be a helpful hint to someone starting out, but someone starting out maybe does not want to read as much as a complete talk. If they wanted it all, then better link to Josselin=E2=80=99s talk. Ludovic Court=C3=A8s writes: > The order I chose is (roughly) from lower-level to higher-level: > > (guix store) -> (guix derivation) -> (guix packages) -> =E2=80=A6 > =E2=80=A6 -> (gnu packages) -> (gnu system) -> =E2=80=A6 > > Does that make sense? In your section the modules directly in (guix =E2=80=A6) appeared unsorted = to me. Could you explicitly state this order in the manual section? 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. > Are you suggesting to remove the examples? I like tests and gnu/tests. Also that your section lists (guix build-system =E2=80=A6) and the occasional duality with (guix build =E2=80=A6-build-system), Rightfully you also list non-dual utilities like (= guix build syscalls) to make clear not all in (guix build) is about build systems. The explanation about guix/scripts containing the entry points is useful. >> What does core mean? > > The examples were meant to illustrate what is meant by =E2=80=9Ccore=E2= =80=9D. Do you > think some other adjective or a longer description would help? > >> Perhaps (guix =E2=80=A6) should be listed after (gnu =E2=80=A6) and def= ined as the >> Guix mechanisms that do not belong in gnu? Not quite sure either. Josselin called the distinction between (guix =E2=80=A6) and (gnu =E2=80=A6= ) murky, explaining that most of (guix =E2=80=A6) must not import (gnu =E2=80=A6) ex= cept by module-ref, while (guix scripts =E2=80=A6) and such can just use-modules (g= nu =E2=80=A6). To me, gnu/packages.scm looks like core as well, but it rightf= ully is in gnu. Regards, Florian