From unknown Fri Jun 13 10:40:24 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#33342] [PATCH] doc: Fix formatting of notes in multiple sections. Add note Resent-From: swedebugia Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 11 Nov 2018 09:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 33342 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 33342@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.154192878125870 (code B ref -1); Sun, 11 Nov 2018 09:33:02 +0000 Received: (at submit) by debbugs.gnu.org; 11 Nov 2018 09:33:01 +0000 Received: from localhost ([127.0.0.1]:45305 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLm73-0006j9-2t for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:33:01 -0500 Received: from eggs.gnu.org ([208.118.235.92]:52207) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLm70-0006iv-BG for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:32:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLm6r-0005qq-PU for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:32:53 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:38975) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gLm6m-0005Hd-Eq for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:32:45 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33554) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLm6l-0005TJ-1H for guix-patches@gnu.org; Sun, 11 Nov 2018 04:32:44 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLm6h-0004kf-5y for guix-patches@gnu.org; Sun, 11 Nov 2018 04:32:42 -0500 Received: from mx1.riseup.net ([198.252.153.129]:52046) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gLm6g-0004XO-AG for guix-patches@gnu.org; Sun, 11 Nov 2018 04:32:38 -0500 Received: from cotinga.riseup.net (cotinga-pn.riseup.net [10.0.1.164]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.riseup.net (Postfix) with ESMTPS id E9DA11A019E for ; Sun, 11 Nov 2018 01:32:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1541928757; bh=u94hFZs14MkHYo+Rw9sq7aC1snLkDDUWoBoACAlpA8A=; h=To:From:Subject:Date:From; b=ILQdHnBMQ+lblOUnYpxDsMaiB2OVEmWOvVstjraODyiUu5LPjDzaV1clJkPsGrPkL 7FrkQBG0BqgqfAXnEc+blwaD2afO7ht84i1T7GH3XDMZm7ib+d6Bkz2rr4iPUT/IXx eIZnQu5olCFbjgHgvUR0rNtYVUkeLsvp8SLV6yt0= X-Riseup-User-ID: FD717A454BA634001E9B405290F42B6551AE61B3831246EA3DF096AEC10281BA Received: from [127.0.0.1] (localhost [127.0.0.1]) by cotinga.riseup.net with ESMTPSA id 53CF91027A1 for ; Sun, 11 Nov 2018 01:32:36 -0800 (PST) From: swedebugia Message-ID: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> Date: Sun, 11 Nov 2018 10:32:33 +0100 MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="------------34E435219500CAA37A458332" Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) 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: -5.1 (-----) This is a multi-part message in MIME format. --------------34E435219500CAA37A458332 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit -- Cheers Swedebugia --------------34E435219500CAA37A458332 Content-Type: text/x-patch; name="0001-doc-Fix-formatting-of-notes-in-multiple-sections.-Ad.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename*0="0001-doc-Fix-formatting-of-notes-in-multiple-sections.-Ad.pa"; filename*1="tch" >From 27ee648a921f1586f6a2d145de06fe93635102cd Mon Sep 17 00:00:00 2001 From: swedebugia Date: Sun, 11 Nov 2018 10:28:23 +0100 Subject: [PATCH] doc: Fix formatting of notes in multiple sections. Add note * doc/guix.texi (Instantiating the system): Add suggestion to keep config.scm under version control. --- doc/guix.texi | 40 ++++++++++++++++++++++++++++++---------- 1 file changed, 30 insertions(+), 10 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index c74351dd8..cbf65c2df 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -9780,6 +9780,11 @@ file, the @command{guix system reconfigure my-system-config.scm} command instantiates that configuration, and makes it the default GRUB boot entry (@pxref{Invoking guix system}). +@quotation Note +Note: We recommend that you keep this my-system-config.scm-file safe and under +version control to easily track changes to your configuration. +@end quotation + The normal way to change the system configuration is by updating this file and re-running @command{guix system reconfigure}. One should never have to touch files in @file{/etc} or to run commands that modify the @@ -12853,9 +12858,11 @@ like this (you need to use the @code{(gnu packages cups)} module): (list cups-filters escpr hplip-minimal)))) @end example +@quotation Note Note: If you wish to use the Qt5 based GUI which comes with the hplip package then it is suggested that you install the @code{hplip} package, either in your OS configuration file or as your user. +@end quotation The available configuration parameters follow. Each parameter definition is preceded by its type; for example, @samp{string-list foo} @@ -15930,11 +15937,13 @@ example if you want your users to have addresses like @samp{"john.smith@@example.com"} then you need to add a host @samp{"example.com"}. All options in this list will apply only to this host. +@quotation Note Note: the name "virtual" host is used in configuration to avoid confusion with the actual physical host that Prosody is installed on. A single Prosody instance can serve many domains, each one defined as a VirtualHost entry in Prosody's configuration. Conversely a server that hosts a single domain would have just one VirtualHost entry. +@end quotation See @url{https://prosody.im/doc/configure#virtual_host_settings}. @@ -16274,9 +16283,11 @@ before setting it here, to get a feel for which cipher suites you will get. After setting this option, it is recommend that you inspect your Murmur log to ensure that Murmur is using the cipher suites that you expected it to. +@quotation Note Note: Changing this option may impact the backwards compatibility of your Murmur server, and can remove the ability for older Mumble clients to be able to connect to it. +@end quotation @item @code{public-registration} (default: @code{#f}) Must be a @code{} record or @code{#f}. @@ -18048,13 +18059,15 @@ configuration: (service ddclient-service-type) @end example -Note that ddclient needs to access credentials that are stored in a +@quotation Note +Note: ddclient needs to access credentials that are stored in a @dfn{secret file}, by default @file{/etc/ddclient/secrets} (see @code{secret-file} below.) You are expected to create this file manually, in an ``out-of-band'' fashion (you @emph{could} make this file part of the service configuration, for instance by using @code{plain-file}, but it will be world-readable @i{via} @file{/gnu/store}.) See the examples in the @file{share/ddclient} directory of the @code{ddclient} package. +@end quotation @c %start of fragment @@ -21609,10 +21622,12 @@ to the @code{packages} field of the @code{operating-system} declaration @code{nss-certs}, which is a set of CA certificates provided as part of Mozilla's Network Security Services. -Note that it is @emph{not} part of @var{%base-packages}, so you need to +@quotation Note +Note: @code{nss-certs} is @emph{not} part of @var{%base-packages}, so you need to explicitly add it. The @file{/etc/ssl/certs} directory, which is where most applications and libraries look for certificates by default, points to the certificates installed globally. +@end quotation Unprivileged users, including users of Guix on a foreign distro, can also install their own certificate package in @@ -21700,13 +21715,14 @@ Do not worry: the @code{%mdns-host-lookup-nss} variable (see below) contains this configuration, so you will not have to type it if all you want is to have @code{.local} host lookup working. -Note that, in this case, in addition to setting the -@code{name-service-switch} of the @code{operating-system} declaration, -you also need to use @code{avahi-service} (@pxref{Networking Services, -@code{avahi-service}}), or @var{%desktop-services}, which includes it -(@pxref{Desktop Services}). Doing this makes @code{nss-mdns} accessible -to the name service cache daemon (@pxref{Base Services, -@code{nscd-service}}). +@quotation Note +Note: In addition to setting the @code{name-service-switch} of the +@code{operating-system} declaration, you also need to use @code{avahi-service} +(@pxref{Networking Services, @code{avahi-service}}), or +@var{%desktop-services}, which includes it (@pxref{Desktop Services}). Doing +this makes @code{nss-mdns} accessible to the name service cache daemon +(@pxref{Base Services, @code{nscd-service}}). +@end quotation For convenience, the following variables provide typical NSS configurations. @@ -22542,6 +22558,10 @@ $ guix system extension-graph @var{file} | dot -Tpdf > services.pdf produces a PDF file showing the extension relations among services. +@quotation Note +Note: The @command{dot} program is provided by the @code{graphviz} package. +@end quotation + @anchor{system-shepherd-graph} @item shepherd-graph Emit in Dot/Graphviz format to standard output the @dfn{dependency @@ -22660,7 +22680,7 @@ VM. To enable that you'll also have to pass the following flags to @command{qem name=com.redhat.spice.0 @end example -You'll also need to add the @pxref{Miscellaneous Services, Spice service}. +You'll also need to add the @code{(spice-service)}, @pxref{Miscellaneous Services, Spice service}. @node Defining Services @subsection Defining Services -- 2.18.0 --------------34E435219500CAA37A458332-- From unknown Fri Jun 13 10:40:24 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#33342] [PATCH] doc: Fix formatting of notes in multiple sections. Add note Resent-From: swedebugia Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 03 Jan 2019 16:16:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33342 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 33342@debbugs.gnu.org Received: via spool by 33342-submit@debbugs.gnu.org id=B33342.154653212023488 (code B ref 33342); Thu, 03 Jan 2019 16:16:01 +0000 Received: (at 33342) by debbugs.gnu.org; 3 Jan 2019 16:15:20 +0000 Received: from localhost ([127.0.0.1]:45894 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gf5eR-00066l-Rh for submit@debbugs.gnu.org; Thu, 03 Jan 2019 11:15:20 -0500 Received: from mx1.riseup.net ([198.252.153.129]:41012) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gf5eQ-00066e-C7 for 33342@debbugs.gnu.org; Thu, 03 Jan 2019 11:15:18 -0500 Received: from piha.riseup.net (piha-pn.riseup.net [10.0.1.163]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.riseup.net (Postfix) with ESMTPS id 05EDC1A160B for <33342@debbugs.gnu.org>; Thu, 3 Jan 2019 08:15:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1546532118; bh=sfO64aTVFLCNK1SX4sP7OnsGiLDsxmd7Wv3e6FDQiyU=; h=Subject:From:To:References:Date:In-Reply-To:From; b=OQcjaffsRMj0+EsZUZtuWM0gaDVEkDaMkBmuiqimcx6WZK2UQTx6aGDIeK+mPWgCO fuakEEoEQ2Z7n3G4zJjzj6hKT0rzOPre+3LvEViJg72SRcVrro5Ia/kBUyfglzXy/w nU9yF80gnYXI1yL32/GlxnXnTyGAgtEZf2zmXGMk= X-Riseup-User-ID: 01C8CD17C9834287F88D22D2D4CBD6A8C32CA0FD2AA2ADD785E433947C290BCB Received: from [127.0.0.1] (localhost [127.0.0.1]) by piha.riseup.net with ESMTPSA id 30C781C0945 for <33342@debbugs.gnu.org>; Thu, 3 Jan 2019 08:15:16 -0800 (PST) From: swedebugia References: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> Message-ID: Date: Thu, 3 Jan 2019 17:21:59 +0100 MIME-Version: 1.0 In-Reply-To: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) 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: -1.7 (-) On 2018-11-11 10:32, swedebugia wrote: > Ping -- Cheers Swedebugia From unknown Fri Jun 13 10:40:24 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#33342] [PATCH] doc: Fix formatting of notes in multiple sections. Add note Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 07 Apr 2022 11:55:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33342 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: swedebugia , ludo@gnu.org Cc: 33342@debbugs.gnu.org Received: via spool by 33342-submit@debbugs.gnu.org id=B33342.16493324708583 (code B ref 33342); Thu, 07 Apr 2022 11:55:02 +0000 Received: (at 33342) by debbugs.gnu.org; 7 Apr 2022 11:54:30 +0000 Received: from localhost ([127.0.0.1]:60038 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ncQic-0002EM-2l for submit@debbugs.gnu.org; Thu, 07 Apr 2022 07:54:30 -0400 Received: from mail-wr1-f52.google.com ([209.85.221.52]:36389) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ncQiZ-0002Dw-RH for 33342@debbugs.gnu.org; Thu, 07 Apr 2022 07:54:29 -0400 Received: by mail-wr1-f52.google.com with SMTP id u3so7503017wrg.3 for <33342@debbugs.gnu.org>; Thu, 07 Apr 2022 04:54:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=8Q9TPU0bxzecXaxEIWvsWrhKQqErftpHlasRvJa2MuY=; b=RAMFhTOSQFW3q6VNCU/kPPSN6SAHMW53/yRBFnnzYKjIuF0nwXTG4kEJ5vw0pJGVrE RG8JBaoCWj6vNvPeLuAhiP/gPBGPm64boVdpqCNsCsYuJFGDa2IGZa8IisznCi5mwAL4 k8jaePJp+B9th58VjWvvejHnjhmwO9DPJXX3n79Vu1hqGO8pqhM+nIFoPFD2re21uu+E fm0z/+fVn1I+dIeamQgGMWWBZ22K3g6B/zU1HSLEqXqbV62fEOhUjaAmDcf2MS/QTm+E 3G+VvdpQj93FKkpQ+4e9BIQNx3sOpZzYBjxvr11v6WrqHoGbZBEyCWMmXjsy4J03oTLf yMEg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=8Q9TPU0bxzecXaxEIWvsWrhKQqErftpHlasRvJa2MuY=; b=ohon+sDuh++iyDGK+awNX/UIbvbrNjIFWaLUdylQFbTPAmfPo1osgam1EvOeZjH/dR wtdCj1onGTesoyVrvJyF8Ov5gK4rYvPNAhGrswpQC7Dc5HVaoCBdgFY6Fyq03oeI0UdD KXsTsidy6h/vQDHGkW5fZEUYRcIc9RM5S5qp/dIYIyIk6t5JZyLkHthMEIUXpl3iv53o lkTAJ2vdFQT4RT+g1XXY3nbSz30pOj8UweSZlmr5RPbs60/YcWZSIThAy18coVwLB+fF JENy4P/01pWFJoLtFOzFZnWSMPhBbsROkz0Osd6UwrX7O/WCJnEbSp/6kp3jPsW/BEuo InFQ== X-Gm-Message-State: AOAM530yM0ttY9d78WDTqHCE7aMc3aGM08SnFjJ0SVZYSLd6GOA/ZSAd Go4FvLdhECFWTuWiyGxrttY8C3FoEfE= X-Google-Smtp-Source: ABdhPJzf+fm46KyQzuChIc4+UeZv99LzT7+RbsQt07qnxWebgCeYoBe06RpIaBfn5ePiggF6qa7I/Q== X-Received: by 2002:adf:f5c4:0:b0:205:2836:f1e5 with SMTP id k4-20020adff5c4000000b002052836f1e5mr10326073wrp.519.1649332462124; Thu, 07 Apr 2022 04:54:22 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id p125-20020a1c2983000000b0038e6c62f527sm10600788wmp.14.2022.04.07.04.54.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 07 Apr 2022 04:54:21 -0700 (PDT) From: zimoun References: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> Date: Thu, 07 Apr 2022 13:51:07 +0200 In-Reply-To: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> (swedebugia@riseup.net's message of "Sun, 11 Nov 2018 10:32:33 +0100") Message-ID: <86a6cx3ydw.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) 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: -1.0 (-) Hi, This patch#33342 seems felt into the cracks: http://issues.guix.gnu.org/issue/33342 and it appears to me an improvement. The commit title and the commit message are not ready tough. Do we apply it? On Sun, 11 Nov 2018 at 10:32, swedebugia wrote: >>>From 27ee648a921f1586f6a2d145de06fe93635102cd Mon Sep 17 00:00:00 2001 > From: swedebugia > Date: Sun, 11 Nov 2018 10:28:23 +0100 > Subject: [PATCH] doc: Fix formatting of notes in multiple sections. Add note > > * doc/guix.texi (Instantiating the system): Add suggestion to keep > config.scm under version control. > --- > doc/guix.texi | 40 ++++++++++++++++++++++++++++++---------- > 1 file changed, 30 insertions(+), 10 deletions(-) > > diff --git a/doc/guix.texi b/doc/guix.texi > index c74351dd8..cbf65c2df 100644 > --- a/doc/guix.texi > +++ b/doc/guix.texi > @@ -9780,6 +9780,11 @@ file, the @command{guix system reconfigure my-system-config.scm} command > instantiates that configuration, and makes it the default GRUB boot > entry (@pxref{Invoking guix system}). > > +@quotation Note > +Note: We recommend that you keep this my-system-config.scm-file safe and under > +version control to easily track changes to your configuration. > +@end quotation > + > The normal way to change the system configuration is by updating this > file and re-running @command{guix system reconfigure}. One should never > have to touch files in @file{/etc} or to run commands that modify the > @@ -12853,9 +12858,11 @@ like this (you need to use the @code{(gnu packages cups)} module): > (list cups-filters escpr hplip-minimal)))) > @end example > > +@quotation Note > Note: If you wish to use the Qt5 based GUI which comes with the hplip > package then it is suggested that you install the @code{hplip} package, > either in your OS configuration file or as your user. > +@end quotation > > The available configuration parameters follow. Each parameter > definition is preceded by its type; for example, @samp{string-list foo} > @@ -15930,11 +15937,13 @@ example if you want your users to have addresses like > @samp{"john.smith@@example.com"} then you need to add a host > @samp{"example.com"}. All options in this list will apply only to this host. > > +@quotation Note > Note: the name "virtual" host is used in configuration to avoid confusion with > the actual physical host that Prosody is installed on. A single Prosody > instance can serve many domains, each one defined as a VirtualHost entry in > Prosody's configuration. Conversely a server that hosts a single domain would > have just one VirtualHost entry. > +@end quotation > > See @url{https://prosody.im/doc/configure#virtual_host_settings}. > > @@ -16274,9 +16283,11 @@ before setting it here, to get a feel for which cipher suites you will get. > After setting this option, it is recommend that you inspect your Murmur log > to ensure that Murmur is using the cipher suites that you expected it to. > > +@quotation Note > Note: Changing this option may impact the backwards compatibility of your > Murmur server, and can remove the ability for older Mumble clients to be able > to connect to it. > +@end quotation > > @item @code{public-registration} (default: @code{#f}) > Must be a @code{} record or @code{#f}. > @@ -18048,13 +18059,15 @@ configuration: > (service ddclient-service-type) > @end example > > -Note that ddclient needs to access credentials that are stored in a > +@quotation Note > +Note: ddclient needs to access credentials that are stored in a > @dfn{secret file}, by default @file{/etc/ddclient/secrets} (see > @code{secret-file} below.) You are expected to create this file manually, in > an ``out-of-band'' fashion (you @emph{could} make this file part of the > service configuration, for instance by using @code{plain-file}, but it will be > world-readable @i{via} @file{/gnu/store}.) See the examples in the > @file{share/ddclient} directory of the @code{ddclient} package. > +@end quotation > > @c %start of fragment > > @@ -21609,10 +21622,12 @@ to the @code{packages} field of the @code{operating-system} declaration > @code{nss-certs}, which is a set of CA certificates provided as part of > Mozilla's Network Security Services. > > -Note that it is @emph{not} part of @var{%base-packages}, so you need to > +@quotation Note > +Note: @code{nss-certs} is @emph{not} part of @var{%base-packages}, so you need to > explicitly add it. The @file{/etc/ssl/certs} directory, which is where > most applications and libraries look for certificates by default, points > to the certificates installed globally. > +@end quotation > > Unprivileged users, including users of Guix on a foreign distro, > can also install their own certificate package in > @@ -21700,13 +21715,14 @@ Do not worry: the @code{%mdns-host-lookup-nss} variable (see below) > contains this configuration, so you will not have to type it if all you > want is to have @code{.local} host lookup working. > > -Note that, in this case, in addition to setting the > -@code{name-service-switch} of the @code{operating-system} declaration, > -you also need to use @code{avahi-service} (@pxref{Networking Services, > -@code{avahi-service}}), or @var{%desktop-services}, which includes it > -(@pxref{Desktop Services}). Doing this makes @code{nss-mdns} accessible > -to the name service cache daemon (@pxref{Base Services, > -@code{nscd-service}}). > +@quotation Note > +Note: In addition to setting the @code{name-service-switch} of the > +@code{operating-system} declaration, you also need to use @code{avahi-service} > +(@pxref{Networking Services, @code{avahi-service}}), or > +@var{%desktop-services}, which includes it (@pxref{Desktop Services}). Doing > +this makes @code{nss-mdns} accessible to the name service cache daemon > +(@pxref{Base Services, @code{nscd-service}}). > +@end quotation > > For convenience, the following variables provide typical NSS > configurations. > @@ -22542,6 +22558,10 @@ $ guix system extension-graph @var{file} | dot -Tpdf > services.pdf > > produces a PDF file showing the extension relations among services. > > +@quotation Note > +Note: The @command{dot} program is provided by the @code{graphviz} package. > +@end quotation > + > @anchor{system-shepherd-graph} > @item shepherd-graph > Emit in Dot/Graphviz format to standard output the @dfn{dependency > @@ -22660,7 +22680,7 @@ VM. To enable that you'll also have to pass the following flags to @command{qem > name=com.redhat.spice.0 > @end example > > -You'll also need to add the @pxref{Miscellaneous Services, Spice service}. > +You'll also need to add the @code{(spice-service)}, @pxref{Miscellaneous Services, Spice service}. > > @node Defining Services > @subsection Defining Services Cheers, simon From debbugs-submit-bounces@debbugs.gnu.org Thu May 19 17:36:05 2022 Received: (at control) by debbugs.gnu.org; 19 May 2022 21:36:05 +0000 Received: from localhost ([127.0.0.1]:36753 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nrnoT-00084e-Bh for submit@debbugs.gnu.org; Thu, 19 May 2022 17:36:05 -0400 Received: from mail-wm1-f41.google.com ([209.85.128.41]:55850) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nrnoQ-00083o-JD for control@debbugs.gnu.org; Thu, 19 May 2022 17:36:02 -0400 Received: by mail-wm1-f41.google.com with SMTP id ay35so1975350wmb.5 for ; Thu, 19 May 2022 14:36:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=date:message-id:to:from:subject; bh=cTjYgEqfs4lSCRVOJV/n2cisvkZxAWPzFeWHqve0WPw=; b=B+SpA4p2ChB/Djx8t2nOXjNxxtgD0F7M8besXCsL3xEf+zq/G+SinGkq2iGtEGpv7K QXV3KH+D62RdY3uwRgpG5Dw9n24fxXvVP2F3e3yi3Avmz+f1YhAZ7HvuC/peaXsZvLlu yVJLsO2NrHb5UgA2a839lxxeJ+m/1ND1Iziwzjpa4O50z3OQeGMxISAIDn2/pXSUmzO7 fP3N8p6i+8ZgEYMut4JuWAbDMF3ZCAu70mTVonwY/03yLxVsz9AjO8AarDp3UACNKJ7M pj9XlYrGq+qL8/rqj9wIVYGiTcfO2W0wwu1Q/1CDT7W/DqVtkkEy6cC0P1Rs35f03QJW eIRg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:message-id:to:from:subject; bh=cTjYgEqfs4lSCRVOJV/n2cisvkZxAWPzFeWHqve0WPw=; b=cH5THasMwHlzCPZXZd8arIcJyaA1ze1TttyGH5dhTLVRqSh/9oWsU2tb+jsenDUfz8 RGLO4qBi3x1h6VySAZ9DqmcHKqf3QSVphq6bBA52B1QtPTxzIKYWvd3ZsCaCUJc/7Lge r5maaLSdo3NdlblOqczkxnzHjcJi3BYvAJVoiHtKfRlHlJcbGNIX3JZyEb2QhZ/5c8CC xtVSimkIy7+jMw/79Ty7CuvWWvbs4lSY/OMdaBMY8jrX3EFNu3skc6/lpRJpikkNScYG a3RA/IZoF9yU/i8eazwIB+zXtlLWBLOTuh3sVeFtVnjGzBPjzlKx220zV5fVBlKPHljz 2XPg== X-Gm-Message-State: AOAM531cUb82B87wD8iEp1goJes6k53lsPkTflfXa3FeHAQpACLzycjE 0H/pPYyIXsitAUHUW1A5lmXQ/JAYb14= X-Google-Smtp-Source: ABdhPJzYp06WBWkmahsAM5c0/NrAdI07WxEBjHADoz00mVsTi2jUP3ULvH1Vxzwqn9vPf2pou/JZOQ== X-Received: by 2002:a05:600c:4f03:b0:394:6499:21c7 with SMTP id l3-20020a05600c4f0300b00394649921c7mr5547450wmq.103.1652996156945; Thu, 19 May 2022 14:35:56 -0700 (PDT) Received: from lili ([146.0.30.100]) by smtp.gmail.com with ESMTPSA id s11-20020adfbc0b000000b0020c5253d8f3sm703575wrg.63.2022.05.19.14.35.56 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 May 2022 14:35:56 -0700 (PDT) Date: Thu, 19 May 2022 23:26:28 +0200 Message-Id: <86bkvt8b97.fsf@gmail.com> To: control@debbugs.gnu.org From: zimoun Subject: control message for bug #33342 X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: control 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: -1.0 (-) tags 33342 + moreinfo quit From unknown Fri Jun 13 10:40:24 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#33342] [PATCH] doc: Fix formatting of notes in multiple sections. Add note Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 23 Jun 2022 10:03:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 33342 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: moreinfo patch To: swedebugia Cc: ludo@gnu.org, 33342@debbugs.gnu.org Received: via spool by 33342-submit@debbugs.gnu.org id=B33342.165597857913733 (code B ref 33342); Thu, 23 Jun 2022 10:03:03 +0000 Received: (at 33342) by debbugs.gnu.org; 23 Jun 2022 10:02:59 +0000 Received: from localhost ([127.0.0.1]:37491 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o4Jfv-0003ZP-6H for submit@debbugs.gnu.org; Thu, 23 Jun 2022 06:02:59 -0400 Received: from mail-wm1-f51.google.com ([209.85.128.51]:39835) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o4Jfh-0003Xt-UP for 33342@debbugs.gnu.org; Thu, 23 Jun 2022 06:02:51 -0400 Received: by mail-wm1-f51.google.com with SMTP id c130-20020a1c3588000000b0039c6fd897b4so1194150wma.4 for <33342@debbugs.gnu.org>; Thu, 23 Jun 2022 03:02:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=8H7qZPkFLjgdyfpftB4ywjbkvl1Til6s6nhLDu6sL2g=; b=Tdu12V4fIAwm/t1LATnNfg9IMztbE4PQ2K3pngFoj+3wdtxYUGKJWMzjhUfTtO0Hsd wzq9Wemp5MD4636llLgsDoafsMApRbxA0ZzdjGPGRB9vSaI06J5r7Z5gRBSdau3G1IEf KFfM4jLM4WAa+vda8jN30oKzyO298EjjSuws4UUmFnuxggeT2aZ4TTgAl3L1E+9EBrvu PBLX3EYqfJw8v/x5FdusjjRT7Jz5EHqhKd1BhF9pCcdWp/FSJ52fG1rfJht7GLGuKC75 mpMHL0usumyyIQ8aO3QCQWvOU7+wiHN8wc5waeVP6gsj2Xv+Q9ijXBd4u7MgtKIV3UIl A65A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=8H7qZPkFLjgdyfpftB4ywjbkvl1Til6s6nhLDu6sL2g=; b=QWRTAm1KHdiFNePCrK4jAtu0VA3GO+74iKyHHnIHCf+ySWaecFMBfmOlio4Ave2GVq Mlb49AiozxwPh1TDle4GcNWkG/DwC52Wbx0XTiv064IbGamDgL+ibMrMle46nvXPQWo+ d7nIrPhqcm/xUfx4kdIOEJxYpzG4gVPk7dClCv6/7XZ1YQHDx8rpuKTaVNuDa1DuNrKr 3xu3OL3L6ceaqCsaTurUf308/gg26srn+ZTLEawD6yrpwrAEcKknUljwQvuBX+yR/HVS gkJ96Ix2k2m9q7mKICftPIUxIX+ITtxJCtaKtLtFOqwaD9W0a9V1ScYsBJ1zfqhSy93t 9z1A== X-Gm-Message-State: AJIora8F6e5TJv7wI9ELlLGYjgdfyk9dlL/xxFgTKCSG/VGbKPzExvNw K342iSwwFLEXl709DTi8QV23TdsJR4c= X-Google-Smtp-Source: AGRyM1ta7AyKYhgnM34NgsazEm3PvvwEz7wXQZ+QcuH+e18n48ZDP0IuCn9Mg2oK7RVD3dCss5FJVQ== X-Received: by 2002:a05:600c:149:b0:3a0:2e60:8daa with SMTP id w9-20020a05600c014900b003a02e608daamr3180049wmm.126.1655978560270; Thu, 23 Jun 2022 03:02:40 -0700 (PDT) Received: from lili ([147.99.27.198]) by smtp.gmail.com with ESMTPSA id y6-20020a5d6206000000b0021350f7b22esm24424555wru.109.2022.06.23.03.02.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 23 Jun 2022 03:02:39 -0700 (PDT) From: zimoun References: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> <86a6cx3ydw.fsf@gmail.com> Date: Thu, 23 Jun 2022 11:57:52 +0200 In-Reply-To: <86a6cx3ydw.fsf@gmail.com> (zimoun's message of "Thu, 07 Apr 2022 13:51:07 +0200") Message-ID: <86r13f7lcv.fsf_-_@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) 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: -1.0 (-) Hi, On Thu, 07 Apr 2022 at 13:51, zimoun wrote: > This patch#33342 seems felt into the cracks: > > http://issues.guix.gnu.org/issue/33342 > > and it appears to me an improvement. The commit title and the commit > message are not ready tough. > > Do we apply it? Friendly ping? Cheers, simon From unknown Fri Jun 13 10:40:24 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: swedebugia Subject: bug#33342: closed (Re: bug#33342: [PATCH] doc: Fix formatting of notes in multiple sections. Add note) Message-ID: References: <87o7yiuqg3.fsf_-_@gnu.org> <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> X-Gnu-PR-Message: they-closed 33342 X-Gnu-PR-Package: guix-patches X-Gnu-PR-Keywords: moreinfo patch Reply-To: 33342@debbugs.gnu.org Date: Fri, 24 Jun 2022 13:45:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1656078302-31030-1" This is a multi-part message in MIME format... ------------=_1656078302-31030-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #33342: [PATCH] doc: Fix formatting of notes in multiple sections. Add note which was filed against the guix-patches package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 33342@debbugs.gnu.org. --=20 33342: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D33342 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1656078302-31030-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 33342-done) by debbugs.gnu.org; 24 Jun 2022 13:44:09 +0000 Received: from localhost ([127.0.0.1]:41452 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o4jbV-000833-JK for submit@debbugs.gnu.org; Fri, 24 Jun 2022 09:44:09 -0400 Received: from eggs.gnu.org ([209.51.188.92]:53694) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1o4jbR-00082R-U4 for 33342-done@debbugs.gnu.org; Fri, 24 Jun 2022 09:44:08 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:60392) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o4jbM-0005Qz-Jb; Fri, 24 Jun 2022 09:44:00 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To: From; bh=F/Ux9NAU633Ux7KWts4fAL1uba6jLifbSzH0dUjzuhg=; b=fjS/6nANPcgzh7lIskwP 6saXNtP3Tpc07yCTP1Mhdb92m9D/yPJ+TfYfB7W42GBlsqNzjRMj0oUN2/xIyXAGdXonr6djjAOEq +NEwNgFM+d5zDqC812X8PR4eqUIduk7Y9PPTBmjPssayGl9RmSo4Wb6d9DNqemd71DhA5Wdlwh9F3 rNm5Ticx7lKwRyVT3O2Oy5ytf9fyyHBUC1d/i+Q8LZKpmgE6uDs0TQlCYc8NbZ0XGUahLLe328bzA 7f6BV0R6223rg7SoUANZQjADGzQjQebWRDGU6GlUrDPcylp3wnqlZfQVc2G887pWPUAoUoqt+kyRD e/QOdKDo22nhow==; Received: from [193.50.110.235] (port=59980 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o4jbL-00080L-3T; Fri, 24 Jun 2022 09:44:00 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: zimoun Subject: Re: bug#33342: [PATCH] doc: Fix formatting of notes in multiple sections. Add note References: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> <86a6cx3ydw.fsf@gmail.com> Date: Fri, 24 Jun 2022 15:43:56 +0200 In-Reply-To: <86a6cx3ydw.fsf@gmail.com> (zimoun's message of "Thu, 07 Apr 2022 13:51:07 +0200") Message-ID: <87o7yiuqg3.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 33342-done Cc: swedebugia , 33342-done@debbugs.gnu.org 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: -3.3 (---) Hi, zimoun skribis: > This patch#33342 seems felt into the cracks: > > http://issues.guix.gnu.org/issue/33342 Took a few years (!) but I=E2=80=99ve finally applied it with minor changes. Thanks! Ludo=E2=80=99. ------------=_1656078302-31030-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 11 Nov 2018 09:33:01 +0000 Received: from localhost ([127.0.0.1]:45305 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLm73-0006j9-2t for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:33:01 -0500 Received: from eggs.gnu.org ([208.118.235.92]:52207) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLm70-0006iv-BG for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:32:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLm6r-0005qq-PU for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:32:53 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:38975) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gLm6m-0005Hd-Eq for submit@debbugs.gnu.org; Sun, 11 Nov 2018 04:32:45 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33554) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLm6l-0005TJ-1H for guix-patches@gnu.org; Sun, 11 Nov 2018 04:32:44 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLm6h-0004kf-5y for guix-patches@gnu.org; Sun, 11 Nov 2018 04:32:42 -0500 Received: from mx1.riseup.net ([198.252.153.129]:52046) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gLm6g-0004XO-AG for guix-patches@gnu.org; Sun, 11 Nov 2018 04:32:38 -0500 Received: from cotinga.riseup.net (cotinga-pn.riseup.net [10.0.1.164]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.riseup.net (Postfix) with ESMTPS id E9DA11A019E for ; Sun, 11 Nov 2018 01:32:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1541928757; bh=u94hFZs14MkHYo+Rw9sq7aC1snLkDDUWoBoACAlpA8A=; h=To:From:Subject:Date:From; b=ILQdHnBMQ+lblOUnYpxDsMaiB2OVEmWOvVstjraODyiUu5LPjDzaV1clJkPsGrPkL 7FrkQBG0BqgqfAXnEc+blwaD2afO7ht84i1T7GH3XDMZm7ib+d6Bkz2rr4iPUT/IXx eIZnQu5olCFbjgHgvUR0rNtYVUkeLsvp8SLV6yt0= X-Riseup-User-ID: FD717A454BA634001E9B405290F42B6551AE61B3831246EA3DF096AEC10281BA Received: from [127.0.0.1] (localhost [127.0.0.1]) by cotinga.riseup.net with ESMTPSA id 53CF91027A1 for ; Sun, 11 Nov 2018 01:32:36 -0800 (PST) To: guix-patches@gnu.org From: swedebugia Subject: [PATCH] doc: Fix formatting of notes in multiple sections. Add note Message-ID: <2fcb93ed-1639-67e6-a9c2-603d64f56c4c@riseup.net> Date: Sun, 11 Nov 2018 10:32:33 +0100 MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="------------34E435219500CAA37A458332" Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) 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: -5.1 (-----) This is a multi-part message in MIME format. --------------34E435219500CAA37A458332 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit -- Cheers Swedebugia --------------34E435219500CAA37A458332 Content-Type: text/x-patch; name="0001-doc-Fix-formatting-of-notes-in-multiple-sections.-Ad.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename*0="0001-doc-Fix-formatting-of-notes-in-multiple-sections.-Ad.pa"; filename*1="tch" >From 27ee648a921f1586f6a2d145de06fe93635102cd Mon Sep 17 00:00:00 2001 From: swedebugia Date: Sun, 11 Nov 2018 10:28:23 +0100 Subject: [PATCH] doc: Fix formatting of notes in multiple sections. Add note * doc/guix.texi (Instantiating the system): Add suggestion to keep config.scm under version control. --- doc/guix.texi | 40 ++++++++++++++++++++++++++++++---------- 1 file changed, 30 insertions(+), 10 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index c74351dd8..cbf65c2df 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -9780,6 +9780,11 @@ file, the @command{guix system reconfigure my-system-config.scm} command instantiates that configuration, and makes it the default GRUB boot entry (@pxref{Invoking guix system}). +@quotation Note +Note: We recommend that you keep this my-system-config.scm-file safe and under +version control to easily track changes to your configuration. +@end quotation + The normal way to change the system configuration is by updating this file and re-running @command{guix system reconfigure}. One should never have to touch files in @file{/etc} or to run commands that modify the @@ -12853,9 +12858,11 @@ like this (you need to use the @code{(gnu packages cups)} module): (list cups-filters escpr hplip-minimal)))) @end example +@quotation Note Note: If you wish to use the Qt5 based GUI which comes with the hplip package then it is suggested that you install the @code{hplip} package, either in your OS configuration file or as your user. +@end quotation The available configuration parameters follow. Each parameter definition is preceded by its type; for example, @samp{string-list foo} @@ -15930,11 +15937,13 @@ example if you want your users to have addresses like @samp{"john.smith@@example.com"} then you need to add a host @samp{"example.com"}. All options in this list will apply only to this host. +@quotation Note Note: the name "virtual" host is used in configuration to avoid confusion with the actual physical host that Prosody is installed on. A single Prosody instance can serve many domains, each one defined as a VirtualHost entry in Prosody's configuration. Conversely a server that hosts a single domain would have just one VirtualHost entry. +@end quotation See @url{https://prosody.im/doc/configure#virtual_host_settings}. @@ -16274,9 +16283,11 @@ before setting it here, to get a feel for which cipher suites you will get. After setting this option, it is recommend that you inspect your Murmur log to ensure that Murmur is using the cipher suites that you expected it to. +@quotation Note Note: Changing this option may impact the backwards compatibility of your Murmur server, and can remove the ability for older Mumble clients to be able to connect to it. +@end quotation @item @code{public-registration} (default: @code{#f}) Must be a @code{} record or @code{#f}. @@ -18048,13 +18059,15 @@ configuration: (service ddclient-service-type) @end example -Note that ddclient needs to access credentials that are stored in a +@quotation Note +Note: ddclient needs to access credentials that are stored in a @dfn{secret file}, by default @file{/etc/ddclient/secrets} (see @code{secret-file} below.) You are expected to create this file manually, in an ``out-of-band'' fashion (you @emph{could} make this file part of the service configuration, for instance by using @code{plain-file}, but it will be world-readable @i{via} @file{/gnu/store}.) See the examples in the @file{share/ddclient} directory of the @code{ddclient} package. +@end quotation @c %start of fragment @@ -21609,10 +21622,12 @@ to the @code{packages} field of the @code{operating-system} declaration @code{nss-certs}, which is a set of CA certificates provided as part of Mozilla's Network Security Services. -Note that it is @emph{not} part of @var{%base-packages}, so you need to +@quotation Note +Note: @code{nss-certs} is @emph{not} part of @var{%base-packages}, so you need to explicitly add it. The @file{/etc/ssl/certs} directory, which is where most applications and libraries look for certificates by default, points to the certificates installed globally. +@end quotation Unprivileged users, including users of Guix on a foreign distro, can also install their own certificate package in @@ -21700,13 +21715,14 @@ Do not worry: the @code{%mdns-host-lookup-nss} variable (see below) contains this configuration, so you will not have to type it if all you want is to have @code{.local} host lookup working. -Note that, in this case, in addition to setting the -@code{name-service-switch} of the @code{operating-system} declaration, -you also need to use @code{avahi-service} (@pxref{Networking Services, -@code{avahi-service}}), or @var{%desktop-services}, which includes it -(@pxref{Desktop Services}). Doing this makes @code{nss-mdns} accessible -to the name service cache daemon (@pxref{Base Services, -@code{nscd-service}}). +@quotation Note +Note: In addition to setting the @code{name-service-switch} of the +@code{operating-system} declaration, you also need to use @code{avahi-service} +(@pxref{Networking Services, @code{avahi-service}}), or +@var{%desktop-services}, which includes it (@pxref{Desktop Services}). Doing +this makes @code{nss-mdns} accessible to the name service cache daemon +(@pxref{Base Services, @code{nscd-service}}). +@end quotation For convenience, the following variables provide typical NSS configurations. @@ -22542,6 +22558,10 @@ $ guix system extension-graph @var{file} | dot -Tpdf > services.pdf produces a PDF file showing the extension relations among services. +@quotation Note +Note: The @command{dot} program is provided by the @code{graphviz} package. +@end quotation + @anchor{system-shepherd-graph} @item shepherd-graph Emit in Dot/Graphviz format to standard output the @dfn{dependency @@ -22660,7 +22680,7 @@ VM. To enable that you'll also have to pass the following flags to @command{qem name=com.redhat.spice.0 @end example -You'll also need to add the @pxref{Miscellaneous Services, Spice service}. +You'll also need to add the @code{(spice-service)}, @pxref{Miscellaneous Services, Spice service}. @node Defining Services @subsection Defining Services -- 2.18.0 --------------34E435219500CAA37A458332-- ------------=_1656078302-31030-1--