From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.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 SETrI2mBsmWrJQEAqHPOHw:P1 (envelope-from ) for ; Thu, 25 Jan 2024 16:42:33 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id SETrI2mBsmWrJQEAqHPOHw (envelope-from ) for ; Thu, 25 Jan 2024 16:42:33 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=none ("invalid DKIM record") header.d=freakingpenguin.com header.s=x header.b=Z6ehQAn3; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1706197353; a=rsa-sha256; cv=none; b=boJDToaLm64wVMhfo4rEFHfOA5FpH+10i6WR9RENKlbAMM/+dYP/OfgXMYoaFg/MhtgM7/ ODKGVCbjkDfL3MYl+SA5jJy42ycB/i0wBunpwjA8K9rRY8pp+DDfs3+T8pXZxVS/VWEfBr la5cP6r/UuuvgPYxmKwpdo6Vj5U1v9lP0TaX4ROJfvPW4J1alsYIzaD3V6JoWgDdTK3pSm 2/SWT/vaaTCOWlWl6QQk8LoxPCPz7iMHxfWBCzijDocoWNxFNTpNmCV1CCxImfsnSFE2da zXT8X03RIxvyItbJ1wXNkPBxFe0SLG1jeodVn325xR74JEGMRwXQh18rJl6E2w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none ("invalid DKIM record") header.d=freakingpenguin.com header.s=x header.b=Z6ehQAn3; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1706197353; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=dx4xurOnwRxZ07ltGi/AjxJh6rWGTZxKQZaRr5L2I98=; b=Km28MpfYIoMEbvA5t3EPPxTrjbMj9tW0saiKUWSBn5cKWhyxWuGIb0iiPfcX4ISoRbLAyc 1izTYcl9JCaRcLbBJCuoDgi/NNwPrvm2e9qSfXEaRvdFVw52CYGoj8+NWOLTEJSQKqtxqv QjZZ49OJVHipcei90MSZaUZTAAFva2ILx4yh2EyipI/ZzI1/T+6xeq5TJptR8sqXSj2qNG lBzckh+DQE6xplIlxOaadEgTrJUP0rW0YaovYyp2XnDiVrn64bd5g+Im8J1CQz0CxBqpT7 CmoTACh4mbuw0IsjCzx6+7eGHZQBD+ScVVqZzIcZotXNCB1GVaX8acmXLo1Fjg== 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 703DA74130 for ; Thu, 25 Jan 2024 16:42:33 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rT1re-0004eX-GP; Thu, 25 Jan 2024 10:42:02 -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 1rT1rb-0004bx-M3 for bug-guix@gnu.org; Thu, 25 Jan 2024 10:42:00 -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 1rT1rY-0006JU-EK for bug-guix@gnu.org; Thu, 25 Jan 2024 10:41:58 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rT1re-0006SQ-AM for bug-guix@gnu.org; Thu, 25 Jan 2024 10:42:02 -0500 X-Loop: help-debbugs@gnu.org Subject: bug#68715: Undocumented base services in Guix manual Resent-From: Richard Sent Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Thu, 25 Jan 2024 15:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 68715 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 68715@debbugs.gnu.org X-Debbugs-Original-To: bug-guix@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.170619728424770 (code B ref -1); Thu, 25 Jan 2024 15:42:02 +0000 Received: (at submit) by debbugs.gnu.org; 25 Jan 2024 15:41:24 +0000 Received: from localhost ([127.0.0.1]:48926 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rT1r2-0006RR-A1 for submit@debbugs.gnu.org; Thu, 25 Jan 2024 10:41:24 -0500 Received: from lists.gnu.org ([2001:470:142::17]:53994) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rT1r0-0006Qy-MN for submit@debbugs.gnu.org; Thu, 25 Jan 2024 10:41:23 -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 1rT1qn-0004CR-Up for bug-guix@gnu.org; Thu, 25 Jan 2024 10:41:09 -0500 Received: from mail-108-mta104.mxroute.com ([136.175.108.104]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rT1qm-0006Fo-7E for bug-guix@gnu.org; Thu, 25 Jan 2024 10:41:09 -0500 Received: from filter006.mxroute.com ([136.175.111.2] filter006.mxroute.com) (Authenticated sender: mN4UYu2MZsgR) by mail-108-mta104.mxroute.com (ZoneMTA) with ESMTPSA id 18d414828e80003727.001 for (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Thu, 25 Jan 2024 15:41:04 +0000 X-Zone-Loop: 17d58ada27b2282f7f15949699f301c6e554a6ccafac X-Originating-IP: [136.175.111.2] DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=freakingpenguin.com; s=x; h=Content-Transfer-Encoding:Content-Type: MIME-Version:Message-ID:Date:Subject:To:From:Sender:Reply-To:Cc:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=dx4xurOnwRxZ07ltGi/AjxJh6rWGTZxKQZaRr5L2I98=; b=Z6ehQAn3Glmzzg75A47o3nmCxL iF4Y1d2hrz91YtUTGq9m6FiHarhfxk+97RBuOW8D4JT3GVoh3AaCqZ9ZQGYjripPeA4WaGPxTS2Sx GZsSVPsvDV3xutKPDajEjesRsAuGM1370e7+PzIvIS/3B7vNQPA+Xdl46nZv637Cxv7qUT6m8jwRT HRN/IqfDyEBdCL50deBnxJe+60jJdZu15RmDxOBePQub+CcBv83r49g+FCLPxOcNldp2QLrN/B9ev k0jais9hxf2VF2aQK3gTcIsk8sBLw4jc/9SawVzlRC1W+bVF1VLnzNNaicaJQRb0qPIQm8aAkPOlq ithNmNEQ==; From: Richard Sent Date: Thu, 25 Jan 2024 10:40:57 -0500 Message-ID: <87r0i5s9o6.fsf@freakingpenguin.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Authenticated-Id: richard@freakingpenguin.com Received-SPF: pass client-ip=136.175.108.104; envelope-from=richard@freakingpenguin.com; helo=mail-108-mta104.mxroute.com X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: bug-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Scanner: mx10.migadu.com X-Spam-Score: -3.73 X-Migadu-Queue-Id: 703DA74130 X-Migadu-Spam-Score: -3.73 X-TUID: gt05wTbu+tif Hi all, Despite being exported by gnu/services/base.scm, and despite Section 11.9.1= Base Services saying --8<---------------cut here---------------start------------->8--- The =E2=80=98(gnu services base)=E2=80=99 module provides definitions for t= he basic services that one expects from the system. The services exported by this module are listed below. --8<---------------cut here---------------end--------------->8--- the following services and/or types are exported by base.scm, but are not documented in the reference manual (commit 250477d869). I marked extendable services with (e). - fstab-service-type (e) - root-file-system-service - file-system-service-type (e) - swap-service An argument could be made for not documenting root-file-system-service and swap-service, since they're a) not extensible b) not service types and c) likely not relevant for the vast majority of users. Personally I'd still lean towards documenting them, if only to match what the manual says. fstab-service-type and file-system-service-type, however, are extensible and conceivably could be extended by a user. For instance, a custom NAS client service that creates a mount point. As such, I believe those two should be documented. That should help make them a bit more discoverable to users. --=20 Take it easy, Richard Sent Making my computer weirder one commit at a time.