01/05: services: Document the 'delete' clause of 'modify-services'.

[guix-commits]

civodul pushed a commit to branch core-updates-frozen
in repository guix.

commit 61ad9bc2adc189f41128874649b115cfaadec48d
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Sat Nov 27 18:38:33 2021 +0100

    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.
---
 doc/guix.texi    | 9 +++++++++
 gnu/services.scm | 8 +++++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 1bb139e..59651f9 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -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
diff --git a/gnu/services.scm b/gnu/services.scm
index 1655218..68fa4eb 100644
--- a/gnu/services.scm
+++ b/gnu/services.scm
@@ -319,7 +319,13 @@ the resulting list of services.  Each clause must have the 
form:
 
 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 =>