From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id wNLzMsRS62WC+AAA62LTzQ:P1 (envelope-from ) for ; Fri, 08 Mar 2024 19:02:44 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id wNLzMsRS62WC+AAA62LTzQ (envelope-from ) for ; Fri, 08 Mar 2024 19:02:44 +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=Sehr93SV; dmarc=none; 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" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1709920964; a=rsa-sha256; cv=none; b=K2KQxM00x5osw4/QxeAUajxvAyc8ee7hskMOpdV/IRczOJPighvrhm3oH5pHuz+lGX5D/R N9J5DDncsZaUyJtPIHa+X6tR6wE75s5NJ4Si9LkU5JCHvhbAxBG+OHulNKmlJYgDksHb6b U8Ty03WjXjkWth13VLynTIvr/e1pAm7tu6lnNbEFEvXpEFOjeQvw2nMulfpav1qq6iLt1I t9VknnQ1gXmgxV1YlsNnkkli76bP8pYqej8fqn4e1vyYDtTVXIJh9henFWW61WUtSZ1Fa0 BjbnMCDd+cFAPc7rBA7pFvBTjmjwppd70VfYKwTbyzCr5OOAl/VMzMGJJREttw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=Sehr93SV; dmarc=none; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1709920964; 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=WKaKAg0LZgyhAhquAD/PByP8AOushf/FJVMQmiWDGGs=; b=RNIa9+bSXIiGOpFjNRs9smfvFVbQzOHptkkb3/dtvOtVWwGGcSjNjv6ysqTdw7H8FDrhoH 7G4m90v8gWDrJtjC32S3cuvMIpfMkdU4QHs4EK0waAUXr3wEsfSEDn0165q+Ds5lK+L9IO PmSmategx89ZBPLiCRzjKlumvrTFPK1Rpupheo20g2Yqpu4qVHOrfuEavS+FmIa5W9xYZS HtD82j6XHjCRyj29yrvhmZO9CqYuvSkAj9gua8el9Fv6NknQj7R++mqHIJS1ZVGhZm5uuA LNtjcR6SFKbIRfzSvGDClbIO/QIVFUMsNbRuawGDki5RK/DtrIJmn4in3wz8yQ== 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 79AD974287 for ; Fri, 8 Mar 2024 19:02:44 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rieYC-0005hz-Ag; Fri, 08 Mar 2024 13:02:32 -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 1rieYA-0005hq-6V for guix-patches@gnu.org; Fri, 08 Mar 2024 13:02: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 1rieY9-00041p-U9 for guix-patches@gnu.org; Fri, 08 Mar 2024 13:02:29 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rieYf-0007VZ-R0 for guix-patches@gnu.org; Fri, 08 Mar 2024 13:03:01 -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: Fri, 08 Mar 2024 18:03:01 +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.170992093928804 (code B ref 69587); Fri, 08 Mar 2024 18:03:01 +0000 Received: (at 69587) by debbugs.gnu.org; 8 Mar 2024 18:02:19 +0000 Received: from localhost ([127.0.0.1]:59517 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rieXz-0007UV-3M for submit@debbugs.gnu.org; Fri, 08 Mar 2024 13:02:19 -0500 Received: from relay.yourmailgateway.de ([188.68.63.162]:46399) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rieXu-0007UK-Sc for 69587@debbugs.gnu.org; Fri, 08 Mar 2024 13:02:17 -0500 Received: from mors-relay-8201.netcup.net (localhost [127.0.0.1]) by mors-relay-8201.netcup.net (Postfix) with ESMTPS id 4TrvBD6vDLz3vXv; Fri, 8 Mar 2024 19:01:40 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1709920901; bh=t774KE+s3TFt/LGKluauo/yPFYuLIfY+gQmDOg+DjRY=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=Sehr93SV0fys6WkJ7CGnWBa3S00KwkGAWRP7gmNG5Uiwyx0AbKUvBTtM21EEn4WGn mfBHG3NGWZInr0IcpZYKo89OZZpMpmywxYTBxbkG9eAjfP4/3SbGVZICmoNo1T9+bh 9Lj3MlZlllKaa1oDl38EmbN7t4ZQIBP874x7nBfDRVjLxV7TYBORhPboHplPt0zL9K 4gm7BYRDjopJ8lOiTfS/4H19GEK9yNjM7xMNducuronEIfs68kLTM7jVP2E6LRt0og MSY1rZvo1rnq0WA+B6pHREfDT8lBWeDwlCwLnXNQzFJL1ln3lfvmYD9m7Ac6Eu4lzb GfaklUj4URryA== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by mors-relay-8201.netcup.net (Postfix) with ESMTPS id 4TrvBD67yMz3vXD; Fri, 8 Mar 2024 19:01:40 +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 4TrvBD4RtWz8sb8; Fri, 8 Mar 2024 19:01:40 +0100 (CET) Received: from florianrock64 (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id F419B82F77; Fri, 8 Mar 2024 19:01:34 +0100 (CET) From: "pelzflorian (Florian Pelz)" In-Reply-To: ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Wed, 6 Mar 2024 17:37:47 +0100") References: Date: Fri, 08 Mar 2024 19:01:34 +0100 Message-ID: <878r2sa9hd.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: F419B82F77 X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: rG5UIwSqaXYUbpvEkrNm7Bp5hK4xgfaHPCEQFo8qKpq4Ji5ZKs95u+jZ 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-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -2.28 X-Spam-Score: -2.28 X-Migadu-Queue-Id: 79AD974287 X-TUID: 2dPYXvby/iiR Hi Ludo. Good that I now have finally watched Josselin=E2=80=99s talk. This section seems to be a good idea in general, but the examples are an opinionated selection. I believe the list should be small. Listing individual modules directly in ~/src/guix/guix directory is not useful to newcomers or often self-explanatory. gnu/installer, gnu/system, gnu/build, gnu/machine is not useful to know. po is better not talked about, otherwise people edit translations directly in po, when they should use Weblate. Ludovic Court=C3=A8s writes: > +The following table gives an overview of the main directories and what > +they contain. Remember that in Guile, each module name is derived from > +its file name---e.g., the module in file@file{guix/packages.scm} is file@file should be @file > +called @code{(guix packages)}. > + > +@table @file > +@item guix > +This is the location of core Guix mechanisms. A few examples: What does core mean? Perhaps (guix =E2=80=A6) should be listed after (gnu = =E2=80=A6) and defined as the Guix mechanisms that do not belong in gnu? Not quite sure either. > [=E2=80=A6] > +With all this, a fair chunk of your operating system is at your > +fingertips! Beyond @command{grep} and @command{git grep}, @pxref{The > +Perfect Setup} on how to navigate code from your editor, and > +@pxref{Using Guix Interactively} for information on how to use > +interactively use Scheme modules. Enjoy! Remove duplicate =E2=80=9Cuse=E2=80=9D. Regards, Florian