From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id 8FdJFN859WMxhQAAbAwnHQ (envelope-from ) for ; Tue, 21 Feb 2023 22:38:39 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id yNGyEt859WPW6gAAG6o9tA (envelope-from ) for ; Tue, 21 Feb 2023 22:38:39 +0100 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 1B6D43597C for ; Tue, 21 Feb 2023 22:38:38 +0100 (CET) Authentication-Results: aspmx1.migadu.com; dkim=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"; dmarc=none ARC-Seal: i=1; s=key1; d=yhetil.org; t=1677015519; a=rsa-sha256; cv=none; b=AqUeZOgy0/XZrGW5YSu7+g9Y1MaOxFd7zPddsbVX1sBkl2vd+jwOBALuFam+6Qc+f32ufP GsGnsUrWUdHY+ebv4UcKZelnYFMPqV/WIa2i2cPI9LnWBwgT+5zi+kZqh7vq+f26nqkWVe BaSEFn4CEL1I9xcfPITQXcetQC+rwkOmSbzfNtgj1cwdpQYb+mZsmBVs43Y+N0zG+GzS+P lP0EvsWXdjpDWdVtiUX6oYXA/72bE6M1bMqpt07D2/vxa1ml0QYTYncRfwUdVEd76/q+Bv kx+fwX0e4WoBnmlXmS5f2rQvP/VccSfBDpE4bab92RV7Ns/bH2/Mq9ETXXKnMQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=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"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1677015519; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: 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; bh=QiuwWf6AZN/ybZ8j2Xrg0qMzTrxAJibtCeh/5aQF5LI=; b=KjN5Kt0kF0Ztqgsc0lmgzMpsj/nfrgDY4z+PI9GymEMvJzvjesF/ycLUrxWM80XLLpr0U8 S9Ay2vz2GkMJQ4AYHBLTpVbFKxCmcUEbDWShG8xDMdAP2dYgDbR0nXJNGQY95dY7+7zNgQ hLJtU3KDw6rFHxLi7bd6nJq0dhpvSlvDT9MrdRhpffyAGsxt8K0n+tKcJ3f2V7xVeaft+m V02jmzL2W3/SCAvicIFSWMe16hhEMoJopEm0JyDxeAQNW3CMpUDU/6EYlAho9PfWcrPKNY Kz8r044lwJ7Y97cGla8wRqcXKKO4WdZRGERHuML+rTX4WFDMXCsRciYLA9+ecg== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pUaKr-00055y-A6; Tue, 21 Feb 2023 16:38:05 -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 1pUaKp-00054p-2C for guix-patches@gnu.org; Tue, 21 Feb 2023 16:38:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pUaKo-0004Oe-J1 for guix-patches@gnu.org; Tue, 21 Feb 2023 16:38:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pUaKo-0006Xy-FS for guix-patches@gnu.org; Tue, 21 Feb 2023 16:38:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#61688] [PATCH 3/3] doc: hosts-service-type: Improve documentation. Resent-From: Bruno Victal Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 21 Feb 2023 21:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 61688 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 61688@debbugs.gnu.org Cc: Bruno Victal Received: via spool by 61688-submit@debbugs.gnu.org id=B61688.167701545425118 (code B ref 61688); Tue, 21 Feb 2023 21:38:02 +0000 Received: (at 61688) by debbugs.gnu.org; 21 Feb 2023 21:37:34 +0000 Received: from localhost ([127.0.0.1]:57380 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pUaKM-0006Wy-3p for submit@debbugs.gnu.org; Tue, 21 Feb 2023 16:37:34 -0500 Received: from smtpm1.myservices.hosting ([185.26.105.232]:46266) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pUaKK-0006Wo-41 for 61688@debbugs.gnu.org; Tue, 21 Feb 2023 16:37:32 -0500 Received: from mail1.netim.hosting (unknown [185.26.106.173]) by smtpm1.myservices.hosting (Postfix) with ESMTP id 610BC20293 for <61688@debbugs.gnu.org>; Tue, 21 Feb 2023 22:37:30 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by mail1.netim.hosting (Postfix) with ESMTP id B992C8009D; Tue, 21 Feb 2023 22:37:30 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at mail1.netim.hosting Received: from mail1.netim.hosting ([127.0.0.1]) by localhost (mail1-2.netim.hosting [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id ovoekaShkAtb; Tue, 21 Feb 2023 22:37:30 +0100 (CET) Received: from guix-nuc.home.arpa (bl9-119-177.dsl.telepac.pt [85.242.119.177]) (Authenticated sender: lumen@makinata.eu) by mail1.netim.hosting (Postfix) with ESMTPSA id E81AE8009E; Tue, 21 Feb 2023 22:37:29 +0100 (CET) From: Bruno Victal Date: Tue, 21 Feb 2023 21:37:09 +0000 Message-Id: X-Mailer: git-send-email 2.39.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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: X-Migadu-Queue-Id: 1B6D43597C X-Spam-Score: -3.45 X-Migadu-Spam-Score: -3.45 X-Migadu-Scanner: scn0.migadu.com 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-TUID: hdwWLLzQy0Ch * doc/guix.texi (Base Services): Improve hosts-service-type documentation. --- doc/guix.texi | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 4143488b93..85768a4b60 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -18022,7 +18022,7 @@ Base Services @defvar hosts-service-type Type of the service that populates the entries for (@file{/etc/hosts}). -This service type can be extended by passing it a list of +This service type can be @emph{extended} by passing it a list of @code{host} records. @c TRANSLATORS: The domain names below SHOULD NOT be translated. @@ -18047,10 +18047,11 @@ Base Services For most setups this is what you want though if you find yourself in the situation where you want to change the default entries, you can -do so in @code{operating-system}.@pxref{operating-system Reference,@code{essential-services}} +do so in @code{operating-system} via @code{modify-services} +(@pxref{Service Reference,@code{modify-services}}). -The following example shows how one would unset @var{host-name} -from being an alias of @code{localhost}. +The following example shows how to unset @var{host-name} from being an +alias of @code{localhost}. @lisp (operating-system ;; @dots{} @@ -18085,9 +18086,9 @@ Base Services @end defun @quotation Note -The @code{host} data type constructor is @code{%host} though it is -tiresome to create multiple records with it so in practice the procedure -@code{host} (which wraps around @code{%host}) is used instead. +The constructor for the @code{host} record-type is @code{%host} though +the procedure @code{host} results in more concise definitions when there are +multiple @code{host} records. @end quotation @end defvar -- 2.39.1