From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id +F+fJjcp+2W6qwAAe85BDQ:P1 (envelope-from ) for ; Wed, 20 Mar 2024 19:21:43 +0100 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id +F+fJjcp+2W6qwAAe85BDQ (envelope-from ) for ; Wed, 20 Mar 2024 19:21:43 +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=FGH1q8Ot; 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=1710958903; 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=2GMkYNOfIBHGdLOgPrSdZTrFRtRZjH3mpuCsVD0HVaw=; b=s7HoZ1Vul+xZ1TqmR8O3sLaZqT100j0KwuYGhFBBXtSC4s0Dk/Ckag4Og1GIqrYgJ6xtLh kNNblc6KyF/GZtIb76Yc0MWH02gHlq+2N1TuIIywanmHPDsVchGXkBxQlSDIitCzbEJ5T9 ZkLaRw8c0RkUz5IK6BDWv1S422TVxS7RT/2UE27c7f4pguY4xcxCsic3qucAjJQ1mDlZaf ad7LXD88uqRrQtCKNGOxvbanOHTUa+VWpOZ/9A3WOKhG355d58m99b7WMDuoNOMzduQkns BI39emN9nSkrc4FVcMqTQWuDokpC423veVaZ+BbkIt8RZWqW642HwyyzNNTqzw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=FGH1q8Ot; 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=1710958903; a=rsa-sha256; cv=none; b=lFpfQJCQNFu40FJbrVGKAETJRVhJ0+RZ5GXbGVJWBXhvZzdsAVtNldpU4E0bdhn+mgolFd 6WvTSZ24mdvvGEFMJZUZ5Z6TxsA7+R06TR+ULhfbZHZ/wf3Nurq7aVGpoI2TX3QC7oWMiO KQSspJQ6fHk8RnqavXnyaEoiI5EzzPm5PsFR5uUkqP2IfCRwnABzxZzP6QX4Q2TiF6tkjv xynmNDII8Uk/e/HFZZSn5IkUproLShbydEm6zjSRabLTEMmHJwworJrKyWudheh8oOO0wY N6WE+claAvXzdmagObMkXIbJiqz4C+NRTp81m4U4ixbffIANlNZpqLUB9lG14Q== 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 7EA401BB66 for ; Wed, 20 Mar 2024 19:21:43 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rn0Z3-0007l4-N6; Wed, 20 Mar 2024 14:21:25 -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 1rn0Z1-0007iy-9Z for guix-patches@gnu.org; Wed, 20 Mar 2024 14:21:23 -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 1rn0Z1-0002lg-0f for guix-patches@gnu.org; Wed, 20 Mar 2024 14:21:23 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rn0Ze-0000k2-7L for guix-patches@gnu.org; Wed, 20 Mar 2024 14:22:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#69587] [PATCH v2] 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: Wed, 20 Mar 2024 18:22: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.17109589202837 (code B ref 69587); Wed, 20 Mar 2024 18:22:02 +0000 Received: (at 69587) by debbugs.gnu.org; 20 Mar 2024 18:22:00 +0000 Received: from localhost ([127.0.0.1]:54550 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rn0Zb-0000jg-Ek for submit@debbugs.gnu.org; Wed, 20 Mar 2024 14:21:59 -0400 Received: from relay.yourmailgateway.de ([188.68.63.98]:59693) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rn0ZY-0000jU-Uy for 69587@debbugs.gnu.org; Wed, 20 Mar 2024 14:21:58 -0400 Received: from mors-relay-2501.netcup.net (localhost [127.0.0.1]) by mors-relay-2501.netcup.net (Postfix) with ESMTPS id 4V0FMW6GMqz62jm; Wed, 20 Mar 2024 18:05:11 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1710954311; bh=SjXQFEH21SpycDqVmnrI2Pwr+jxjzYe1ZTNtws1PmzI=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=FGH1q8OtHdOx5TMvhbIv39eloBSc8VR0XbL/c49FCO8iK2Pk1Aug2Fsg3DiR04bnA k3QUdkJlkeQtNC7Z/Xt4IbPQqAGUtLxlMaXpVKTduTDv9sK55qXuHMu/k7RN+CfE0k qF+TY48g3mtBME6ZrOGdQ6NNb9a6m+WbPWgNrdEO+unEdDfO88v0PKR/6/DdVBB8O5 dP4mySAkeYr5gFyt3P61lpOHq7RhAFspXpZ0YXg0i5/mPyWHUrf+6K+qJpKLS6N//W 09K4JsvitbUmneAGtHh1kbCBpbBJPBMmcPsHp0AVrsEQi5KL5OY53sRtIHe0kt6Gbn O+XK6ZxHkzp+A== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by mors-relay-2501.netcup.net (Postfix) with ESMTPS id 4V0FMW5ZJRz4xwc; Wed, 20 Mar 2024 18:05:11 +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 4V0FMW39Myz8sb8; Wed, 20 Mar 2024 18:05:11 +0100 (CET) Received: from florianrock64 (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id C799B833F2; Wed, 20 Mar 2024 18:05:05 +0100 (CET) From: "pelzflorian (Florian Pelz)" In-Reply-To: <4b50aca680226c4eeba9b83f1d82d935aaae382d.1710931512.git.ludo@gnu.org> ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Wed, 20 Mar 2024 11:49:13 +0100") References: <87wmpy2tow.fsf@gnu.org> <4b50aca680226c4eeba9b83f1d82d935aaae382d.1710931512.git.ludo@gnu.org> Date: Wed, 20 Mar 2024 18:05:04 +0100 Message-ID: <87bk78u94v.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: C799B833F2 X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: Hwf/NRScGShhs/oLnCKM2rE4va7vNnpio4kYThtXFfs8o6Niq2KszTSC 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-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Spam-Score: -5.32 X-Spam-Score: -5.32 X-Migadu-Queue-Id: 7EA401BB66 X-Migadu-Scanner: mx12.migadu.com X-TUID: dgoyP3S8kIeC Hello, some small things to fix: 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} The file@file should be @file, I presume. > [=E2=80=A6] > +The directories we have seen so far all live under @file{guix/}. The > +other important place is the @file{gnu/} directory, which contains > +primarily package definitions as well as libraries and tools for Guix > +System (@pxref{System Configuration}) and Guix Home (@pxref{Home > +Configuration}), all of which build upon functionality provided by > +@code{(guix @dots{})} modules@footnote{For this reason, @code{(guix > +@dots{})} modules The double space is inappropriate. > must generally not depend on @code{(gnu @dots{})} > +modules, with one notable exception: Perhaps better mention all three exceptions, not only build-system but also direct #:use-module in scripts like pack and to a lesser degree import. > +@item po > +This is the location of translations of Guix itself, of package synopses > +and descriptions, of the manual, and of the cookbook. Note that > +@file{.po} files that live here are pulled directly from Weblate > +(@pxref{Translating Guix}).` At the end is a stray `. > +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! The word =E2=80=9Cuse=E2=80=9D is duplicated. Otherwise I=E2=80=99m happy and it LGTM. Thank you! Regards, Florian