GNU logs - #34955, boring messages

Message sent to bug-guix@HIDDEN:

Subject: bug#34955: Manual: Service extensions not clear
Resent-From: "pelzflorian (Florian Pelz)" <pelzflorian@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-guix@HIDDEN
Resent-Date: Sat, 23 Mar 2019 15:47:02 +0000
Resent-Message-ID: <handler.34955.B.155335599626629 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 34955 <at> debbugs.gnu.org
Date: Sat, 23 Mar 2019 16:46:21 +0100
From: "pelzflorian (Florian Pelz)" <pelzflorian@HIDDEN>
Message-ID: <20190323154621.u5kjvvgcci7ikrbt@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
User-Agent: NeoMutt/20180716
Content-Transfer-Encoding: quoted-printable
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

The Guix manual (section Defining services) says about service
extensions:

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

  1. [=E2=80=A6]

  2. A list of =E2=80=9Cservice extensions=E2=80=9D, 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 =E2=80=9Cboot service type=E2=80=9D, which is the u=
ltimate
     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 =E2=80=98service-extension=E2=
=80=99
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

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: "pelzflorian (Florian Pelz)" <pelzflorian@HIDDEN>
Subject: bug#34955: Acknowledgement (Manual: Service extensions not clear)
Message-ID: <handler.34955.B.155335599626629.ack <at> debbugs.gnu.org>
References: <20190323154621.u5kjvvgcci7ikrbt@HIDDEN>
X-Gnu-PR-Message: ack 34955
X-Gnu-PR-Package: guix
Reply-To: 34955 <at> debbugs.gnu.org
Date: Sat, 23 Mar 2019 15:47:02 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-guix@HIDDEN

If you wish to submit further information on this problem, please
send it to 34955 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
34955: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D34955
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Last modified: Mon, 25 Nov 2019 12:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.