Re: [PATCH] doc: Clarify and consolidate modify-services documentation.

[Ludovic Courtès]

Alex Kost <address@hidden> skribis:

> Chris Marusich (2016-03-12 14:38 +0300) wrote:
>
>> From bf03c0a3fa35144342849cdf550219a185fbf10d Mon Sep 17 00:00:00 2001
>> From: Chris Marusich <address@hidden>
>> Date: Mon, 7 Mar 2016 01:55:07 -0800
>> Subject: [PATCH] doc: Clarify and consolidate modify-services documentation.
>>
>> * doc/guix.texi ("Using the Configuration System": Move the example...
>> * doc/guix.texi ("Service Reference"): ...to here, and clarify more.
>> * gnu/services.scm (modify-services): Update docstring to match.
>
> [...]
>> -This is a shorthand for:
>> +The @var{body} should evaluate to the new service parameters, which will
>> +be used to configure the new service.  This new service will replace the
>> +original in the resulting list.  Because a service's service parameters
>> +are created using @code{define-record-type*}, you can write a succint
>> address@hidden that evaluates to the new service parameters by using the
>> address@hidden feature that @code{define-record-type*} provides.
>> +
>> address@hidden the Configuration System} for example usage.
>
> Now there is a compilation warning, as makeinfo doesn't like this line:
>
>   ./doc/guix.texi:10138: warning: `.' or `,' must follow @xref

Pushed the obvious fix, thanks.

I guess most of us are using Texinfo 6.1 now and won’t notice.

Ludo’.