From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.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 4OAnOhyi8GVhYAEAe85BDQ:P1 (envelope-from ) for ; Tue, 12 Mar 2024 19:42:37 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id 4OAnOhyi8GVhYAEAe85BDQ (envelope-from ) for ; Tue, 12 Mar 2024 19:42:37 +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=CbxkWFJQ; 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=1710268956; a=rsa-sha256; cv=none; b=XIJ5dDHKI1ydq2xuWrUPX1W6PdW7jmshFsXp/+jjP7a8J/xjp9cP6E9Zlb8NtVEVE0mXbn 5k9hdMsqVEp/piZstaQpRkbZiihPuXK/0koEzPIDooTpCqE636rF96rGc3yDjd6ThbFjnf D8tnzPk0MleOkEL0N6732RVBqUE3MqBPXzsgLQEs6uKv3tcaEQIt6hb6dxkwRg4ELNixol f9IO7Kc5VXdFNJzKw1j9JU91pkVrHULtWtoGnoXgoYDlCJCAgtVS+4O7S2FP5kst81xdQx mGIruHvM6FyHDNvFzpzncHbF1a0WkwiQ7SChf4s44xqoAOMP8xcR30UdBt0QTg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=CbxkWFJQ; 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=1710268956; 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=d7++GbaFPpeAqKZdRColA9OBYe1QsTEjnB0ZpHhZPaQ=; b=ieo+oJ3/mLl0tCXKNNhEQKkYd99rTF7alKDaw72ETdzAQgvOJsoV0T3SIck1Xa/C5TguGv 84ZCGmVoEK1E09XwrUDsH7FUDkN02fU0w8JKEnawBU/aCOlSoXyAxPpT7fqDNfEausq5GF s5bfJqqex2z0LTN499AL1H94XwyK84oyWzcy/5ncXL/8YTeWfkpADzaLSV4kvlWF+lxsG7 mSw3XvBrD361T0MTsdF0y3XlmqdTKTq67P6FKGcuEvtYXNmNLvsuki2v+HPdZwMKVG/JiJ UpnWJDfiH5js695CkzeU+Ej2P2tcSaLrux1HqIzNupCAZvIFvOr/1xWkttsabQ== 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 93411242CE for ; Tue, 12 Mar 2024 19:42:36 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rk74I-0000U4-CN; Tue, 12 Mar 2024 14:41:42 -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 1rk744-0000MU-81 for guix-patches@gnu.org; Tue, 12 Mar 2024 14:41:29 -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 1rk743-0001NI-Vn for guix-patches@gnu.org; Tue, 12 Mar 2024 14:41:27 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rk74c-0006Po-9N for guix-patches@gnu.org; Tue, 12 Mar 2024 14:42: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: "pelzflorian (Florian Pelz)" Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 12 Mar 2024 18:42: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: Giovanni Biscuolo Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= , 69587@debbugs.gnu.org Received: via spool by 69587-submit@debbugs.gnu.org id=B69587.171026891524645 (code B ref 69587); Tue, 12 Mar 2024 18:42:02 +0000 Received: (at 69587) by debbugs.gnu.org; 12 Mar 2024 18:41:55 +0000 Received: from localhost ([127.0.0.1]:43808 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rk74V-0006PR-0h for submit@debbugs.gnu.org; Tue, 12 Mar 2024 14:41:55 -0400 Received: from relay.yourmailgateway.de ([194.59.206.189]:40077) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rk74R-0006PH-Kz for 69587@debbugs.gnu.org; Tue, 12 Mar 2024 14:41:53 -0400 Received: from relay02-mors.netcup.net (localhost [127.0.0.1]) by relay02-mors.netcup.net (Postfix) with ESMTPS id 4TvMt338XXz45QY; Tue, 12 Mar 2024 19:41:15 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1710268875; bh=xNljVR9lr9ZXNa9NLkTHdS7ydVKXERUwF3EM8d0swuY=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=CbxkWFJQ36FJogpZKyc/YqxeLq6iutEH6LoZLJNGbX9V0wTD4etYs32DmjfaQI/ps jqmgzIAEz8fO6/VJ9ghbsZItcVx4lVRTC1OmfpPtUzrTp0NqVHpbBx+/Tb0ePnJmZk 2ExVCJLhhBYDKOmTT2MAcYG8PBZKZEjERt0mqksd1V+oSMwBwCc1bT4ZTnmevtcqiZ dD9ITdVylqoBHNUBSbUitmZ/kqUkrTyOg2WvWi6EtjQCALmuRsDedN6VSvHG0s/E/9 B3Za7TukzgnEs2gXINYHTTYCsIW5BMTDWd3t0mZKM8m6HsOTcYwJWQMQoyVJ0t55YR 85RveHQOpR5qw== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by relay02-mors.netcup.net (Postfix) with ESMTPS id 4TvMt32lfGz7wvF; Tue, 12 Mar 2024 19:41:15 +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 4TvMt14fbZz8sZf; Tue, 12 Mar 2024 19:41:13 +0100 (CET) Received: from florianrock64 (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id 3D1F382F14; Tue, 12 Mar 2024 19:41:07 +0100 (CET) From: "pelzflorian (Florian Pelz)" In-Reply-To: <877ci7tnki.fsf@xelera.eu> (Giovanni Biscuolo's message of "Tue, 12 Mar 2024 17:35:57 +0100") References: <878r2sa9hd.fsf@pelzflorian.de> <877cic2xa6.fsf@gnu.org> <878r2r8o7f.fsf@pelzflorian.de> <87le6oog1j.fsf@gnu.org> <877ci7tnki.fsf@xelera.eu> Date: Tue, 12 Mar 2024 19:41:06 +0100 Message-ID: <87edcfthrx.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: 3D1F382F14 X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: tjDLQ/aw+Ck6u43rBfekfHslUj7lWHDgVVlrD8URdBrltvRR9D6aQiqq 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.29 X-Spam-Score: -2.29 X-Migadu-Queue-Id: 93411242CE X-TUID: +12bHM/RtnSO Thank you Giovanni for voicing support; I=E2=80=99m afraid I sounded more opposed than I am. Giovanni Biscuolo writes: > Also, please don't (dis)miss the usefulness of such documentation as a > sort of meta-literate programming, probably also useful for expert Guix > programmers too, IMHO Do you think the following controversial parts should stay? But what is their audience, and why explain them but not the directories build-aux and nix and some other not so important files in guix? =E2=80=98gnu/system=E2=80=99 These are core Guix System modules, such as: =E2=80=98(gnu system)=E2=80=99 Defines =E2=80=98operating-system=E2=80=99 (*note operating-system Reference::). =E2=80=98(gnu system file-systems)=E2=80=99 Defines =E2=80=98file-system=E2=80=99 (*note File Systems::). =E2=80=98(gnu system mapped-devices)=E2=80=99 Defines =E2=80=98mapped-device=E2=80=99 (*note Mapped Devices::). =E2=80=98gnu/build=E2=80=99 These are modules that are either used on the =E2=80=9Cbuild side=E2= =80=9D when building operating systems or packages, or at run time by operating systems. =E2=80=98(gnu build accounts)=E2=80=99 Creating =E2=80=98/etc/passwd=E2=80=99, =E2=80=98/etc/shadow=E2= =80=99, etc. (*note User Accounts::). =E2=80=98(gnu build activation)=E2=80=99 Activating an operating system at boot time or reconfiguration time. =E2=80=98(gnu build file-systems)=E2=80=99 Searching, checking, and mounting file systems. =E2=80=98(gnu build linux-boot)=E2=80=99 =E2=80=98(gnu build hurd-boot)=E2=80=99 Booting GNU/Linux and GNU/Hurd operating systems. =E2=80=98(gnu build linux-initrd)=E2=80=99 Creating a Linux initial RAM disk (*note Initial RAM Disk::). [=E2=80=A6] =E2=80=98gnu/installer=E2=80=99 This contains the text-mode graphical system installer (*note Guided Graphical Installation::). =E2=80=98gnu/machine=E2=80=99 These are the =E2=80=9Cmachine abstractions=E2=80=9D used by =E2=80=98= guix deploy=E2=80=99 (*note Invoking guix deploy::). [=E2=80=A6] =E2=80=98po=E2=80=99 This is the location of translations of Guix itself, of package synopses and descriptions, of the manual, and of the cookbook (*note Translating Guix::). > Last but not least, I have a feeling it's time to split the Guix manual > in two: one for users, like "GNU Guix User Manual" and one for > programmers [1], like "GNU Guix Programmer Manual", with chapters like > "Programming Interface", "Platforms", "Bootstrapping", "Porting", > "Contributing"... but that's another story, OT here. Hmm why? But yes, another story. Regards, Florian