[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
01/09: doc: Fix formatting of notes in multiple sections.
From: |
guix-commits |
Subject: |
01/09: doc: Fix formatting of notes in multiple sections. |
Date: |
Fri, 24 Jun 2022 17:40:42 -0400 (EDT) |
civodul pushed a commit to branch master
in repository guix.
commit 3e7b6dd149456f91b1b12e6da6812fcce2612b18
Author: swedebugia <swedebugia@riseup.net>
AuthorDate: Sun Nov 11 10:28:23 2018 +0100
doc: Fix formatting of notes in multiple sections.
* doc/guix.texi (Instantiating the system): Add suggestion to keep
config.scm under version control.
(Printing Services, Messaging Services)
(Telephony Services, Invoking guix system): Use "@quotation Note" for notes.
Co-authored-by: Ludovic Courtès <ludo@gnu.org>
---
doc/guix.texi | 21 ++++++++++++++++++---
1 file changed, 18 insertions(+), 3 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 650072937a..f3b026333e 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -15837,6 +15837,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
+We recommend that you keep this @file{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
@@ -21112,9 +21117,11 @@ You can do that directly, like this (you need to use
the
(list cups-filters epson-inkjet-printer-escpr hplip-minimal))))
@end lisp
-Note: If you wish to use the Qt5 based GUI which comes with the hplip
+@quotation 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}
@@ -25595,13 +25602,15 @@ 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.
-Note: the name @emph{virtual} host is used in configuration to avoid confusion
with
+@quotation Note
+The name @emph{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.
See @url{https://prosody.im/doc/configure#virtual_host_settings}.
+@end quotation
Available @code{virtualhost-configuration} fields are:
@@ -26202,8 +26211,10 @@ After setting this option, it is recommend that you
inspect your Mumble
server log to ensure that Mumble is using the cipher suites that you
expected it to.
-Note: Changing this option may impact the backwards compatibility of your
+@quotation Note
+Changing this option may impact the backwards compatibility of your
Mumble-Server 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{<mumble-server-public-registration-configuration>}
@@ -37578,6 +37589,10 @@ $ guix system extension-graph @var{file} | xdot -
shows the extension relations among services.
+@quotation Note
+The @command{dot} program is provided by the @code{graphviz} package.
+@end quotation
+
@anchor{system-shepherd-graph}
@item shepherd-graph
Emit to standard output the @dfn{dependency
- branch master updated (a43c3b1818 -> dc16ac2d8b), guix-commits, 2022/06/24
- 01/09: doc: Fix formatting of notes in multiple sections.,
guix-commits <=
- 03/09: gnu: guile-json: Update to 4.7.1., guix-commits, 2022/06/24
- 09/09: doc: Mention installation via distro packages., guix-commits, 2022/06/24
- 04/09: gnu: Add azpainter., guix-commits, 2022/06/24
- 02/09: gnu: python-jedi: Fix tests., guix-commits, 2022/06/24
- 07/09: services: configuration: Report the location of field type errors., guix-commits, 2022/06/24
- 06/09: gnu: Add python-asynckivy., guix-commits, 2022/06/24
- 05/09: gnu: Add python-asyncgui., guix-commits, 2022/06/24
- 08/09: services: configuration: Remove 'validate-configuration'., guix-commits, 2022/06/24