From debbugs-submit-bounces@debbugs.gnu.org Thu Jan 25 10:41:24 2024 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 To: bug-guix@gnu.org Subject: Undocumented base services in Guix manual 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-Spam-Score: 0.9 (/) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.1 (/) 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.