Browse Source

services: Add a description and location for each service type.

* gnu/services.scm (<service-type>)[description, location]: New field.
* doc/guix.texi (Service Types and Services): Document 'description'.
version-0.14.0
Ludovic Courtès 5 years ago
parent
commit
b714395a39
No known key found for this signature in database GPG Key ID: 90B11993D9AEBB5
  1. 4
      doc/guix.texi
  2. 13
      gnu/services.scm

4
doc/guix.texi

@ -18020,6 +18020,10 @@ Udev extensions are composed into a list of rules, but the udev service
value is itself a @code{<udev-configuration>} record. So here, we
extend that record by appending the list of rules it contains to the
list of contributed rules.
@item description
This is a string giving an overview of the service type. The string can
contain Texinfo markup (@pxref{Overview,,, texinfo, GNU Texinfo}).
@end table
There can be only one instance of an extensible service type such as

13
gnu/services.scm

@ -49,6 +49,9 @@
service-type-compose
service-type-extend
service-type-default-value
service-type-description
service-type-location
service
service?
@ -145,7 +148,15 @@
;; Optional default value for instances of this type.
(default-value service-type-default-value ;Any
(default &no-default-value)))
(default &no-default-value))
;; Meta-data.
(description service-type-description ;string
(default #f))
(location service-type-location ;<location>
(default (and=> (current-source-location)
source-properties->location))
(innate)))
(define (write-service-type type port)
(format port "#<service-type ~a ~a>"

Loading…
Cancel
Save