services: Document the 'delete' clause of 'modify-services'.

* doc/guix.texi (Service Reference): Mention the 'delete' clause of
'modify-services'.
* gnu/services.scm (modify-services): Likewise in docstring.
This commit is contained in:
Ludovic Courtès 2021-11-27 18:38:33 +01:00
parent 29b2ac570a
commit 61ad9bc2ad
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5
2 changed files with 16 additions and 1 deletions

View file

@ -35724,6 +35724,15 @@ are created using @code{define-record-type*}, you can write a succinct
@var{body} that evaluates to the new service parameters by using the
@code{inherit} feature that @code{define-record-type*} provides.
Clauses can also have the following form:
@lisp
(delete @var{type})
@end lisp
Such a clause removes all services of the given @var{type} from
@var{services}.
@xref{Using the Configuration System}, for example usage.
@end deffn

View file

@ -319,7 +319,13 @@ (define-syntax modify-services
where TYPE is a service type, such as 'guix-service-type', and VARIABLE is an
identifier that is bound within BODY to the value of the service of that
TYPE. Consider this example:
TYPE.
Clauses can also remove services of a given type:
(delete TYPE)
Consider this example:
(modify-services %base-services
(guix-service-type config =>