Archived
1
0
Fork 0

doc: hosts-service-type: Improve documentation.

* doc/guix.texi (Base Services): Improve hosts-service-type documentation.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
This commit is contained in:
Bruno Victal 2023-02-21 21:37:09 +00:00 committed by Ludovic Courtès
parent c742615b76
commit 4372abfb0f
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5

View file

@ -18022,7 +18022,7 @@ package or any valid argument to @command{setfont}, as in this example:
@defvar hosts-service-type @defvar hosts-service-type
Type of the service that populates the entries for (@file{/etc/hosts}). 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. @code{host} records.
@c TRANSLATORS: The domain names below SHOULD NOT be translated. @c TRANSLATORS: The domain names below SHOULD NOT be translated.
@ -18047,10 +18047,11 @@ By default @file{/etc/host} comes with the following entries:
For most setups this is what you want though if you find yourself in 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 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} The following example shows how to unset @var{host-name} from being an
from being an alias of @code{localhost}. alias of @code{localhost}.
@lisp @lisp
(operating-system (operating-system
;; @dots{} ;; @dots{}
@ -18085,9 +18086,9 @@ Procedure for creating @code{host} records.
@end defun @end defun
@quotation Note @quotation Note
The @code{host} data type constructor is @code{%host} though it is The constructor for the @code{host} record-type is @code{%host} though
tiresome to create multiple records with it so in practice the procedure the procedure @code{host} results in more concise definitions when there are
@code{host} (which wraps around @code{%host}) is used instead. multiple @code{host} records.
@end quotation @end quotation
@end defvar @end defvar