Manual: Service extensions not clear

  • Open
  • quality assurance status badge
Details
One participant
  • pelzflorian (Florian Pelz)
Owner
unassigned
Submitted by
pelzflorian (Florian Pelz)
Severity
normal

Debbugs page

pelzflorian (Florian Pelz) wrote 6 years ago
(address . bug-guix@gnu.org)
20190323154621.u5kjvvgcci7ikrbt@pelzflorian.localdomain
The Guix manual (section Defining services) says about service
extensions:

[The example guix-service-type definition] defines three things:

1. […]

2. A list of “service extensions”, where each extension designates the
target service type and a procedure that, given the parameters of
the service, returns a list of objects to extend the service of
that type.

Every service type has at least one service extension. The only
exception is the “boot service type”, which is the ultimate
service.

This is confusing to me because previously it was explained that
services extend services but now it says types extend types which does
not fit the previous explanation.

Later it says:

There can be only one instance of an extensible service type such as
UDEV-SERVICE-TYPE. If there were more, the ‘service-extension’
specifications would be ambiguous.

I believe before the example for the definition of service types,
service extensions should be explained.

E.g.

A service type definition specifies which services can be extended by
an instance of the service type. For each service extension, exactly
one service of the target service type of the extension must appear
in the services field of the operating-system declaration.

Regards,
Florian
?
Your comment

Commenting via the web interface is currently disabled.

To comment on this conversation send an email to 34955@debbugs.gnu.org

To respond to this issue using the mumi CLI, first switch to it
mumi current 34955
Then, you may apply the latest patchset in this issue (with sign off)
mumi am -- -s
Or, compose a reply to this issue
mumi compose
Or, send patches to this issue
mumi send-email *.patch
You may also tag this issue. See list of standard tags. For example, to set the confirmed and easy tags
mumi command -t +confirmed -t +easy
Or, remove the moreinfo tag and set the help tag
mumi command -t -moreinfo -t +help