From mboxrd@z Thu Jan  1 00:00:00 1970
From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=)
Subject: Re: [PATCH] doc: Clarify and consolidate modify-services
	documentation.
Date: Thu, 17 Mar 2016 09:52:41 +0100
Message-ID: <87y49htrja.fsf@gnu.org>
References: <87vb4ypn9s.fsf@gmail.com> <87io0t14pi.fsf@gnu.org>
	<87lh5ohr1z.fsf@gmail.com> <87h9gchqnl.fsf@gmail.com>
	<87d1qted5d.fsf@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42223)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1agTfo-0001tu-HB
	for guix-devel@gnu.org; Thu, 17 Mar 2016 04:52:53 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1agTfk-00085V-AU
	for guix-devel@gnu.org; Thu, 17 Mar 2016 04:52:52 -0400
In-Reply-To: <87d1qted5d.fsf@gmail.com> (Alex Kost's message of "Thu, 17 Mar
	2016 11:12:30 +0300")
List-Id: "Development of GNU Guix and the GNU System distribution."
	<guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=subscribe>
Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org
Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org
To: Alex Kost <alezost@gmail.com>
Cc: guix-devel@gnu.org

Alex Kost <alezost@gmail.com> skribis:

> Chris Marusich (2016-03-12 14:38 +0300) wrote:
>
>> From bf03c0a3fa35144342849cdf550219a185fbf10d Mon Sep 17 00:00:00 2001
>> From: Chris Marusich <cmmarusich@gmail.com>
>> Date: Mon, 7 Mar 2016 01:55:07 -0800
>> Subject: [PATCH] doc: Clarify and consolidate modify-services documentat=
ion.
>>
>> * 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
>> +@var{body} that evaluates to the new service parameters by using the
>> +@code{inherit} feature that @code{define-record-type*} provides.
>> +
>> +@xref{Using 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=E2=80=99t notice.

Ludo=E2=80=99.