From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@gnu.org>
Subject: bug#34574: Confusing manual entry for gexp->file
Date: Wed, 06 Mar 2019 14:17:49 +0100
Message-ID: <871s3kjg5e.fsf@gnu.org>
References: <20190219162120.7evs2ynhhdksyq2d@pelzflorian.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([209.51.188.92]:32839)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1h1WQt-0000iH-3e
	for bug-guix@gnu.org; Wed, 06 Mar 2019 08:18:03 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1h1WQs-00014d-ET
	for bug-guix@gnu.org; Wed, 06 Mar 2019 08:18:03 -0500
Received: from debbugs.gnu.org ([209.51.188.43]:48508)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1h1WQs-00014Z-AE
	for bug-guix@gnu.org; Wed, 06 Mar 2019 08:18:02 -0500
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1h1WQr-0004fL-V0
	for bug-guix@gnu.org; Wed, 06 Mar 2019 08:18:01 -0500
Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-Message-ID: <handler.34574.B34574.155187827417919@debbugs.gnu.org>
In-Reply-To: <20190219162120.7evs2ynhhdksyq2d@pelzflorian.localdomain>
	(pelzflorian's message of "Tue, 19 Feb 2019 17:21:20 +0100")
List-Id: Bug reports for GNU Guix <bug-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-guix/>
List-Post: <mailto:bug-guix@gnu.org>
List-Help: <mailto:bug-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=subscribe>
Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
Sender: "bug-Guix" <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
To: "pelzflorian (Florian Pelz)" <pelzflorian@pelzflorian.de>
Cc: 34574@debbugs.gnu.org

Hi Florian,

"pelzflorian (Florian Pelz)" <pelzflorian@pelzflorian.de> skribis:

> The Guix manual contains the following description of gexp->file:
>
>  -- Monadic Procedure: gexp->file NAME EXP [#:set-load-path? #t]
>           [#:module-path %load-path]  [#:splice? #f]  [#:guile
>      (default-guile)] Return a derivation that builds a file NAME
>      containing EXP. When SPLICE? is true, EXP is considered to be a
>      list of expressions that will be spliced in the resulting file.
>
>      When SET-LOAD-PATH? is true, emit code in the resulting file to set
>      =E2=80=98%load-path=E2=80=99 and =E2=80=98%load-compiled-path=E2=80=
=99 to honor EXP=E2=80=99s imported
>      modules. Look up EXP=E2=80=99s modules in MODULE-PATH.
>
>      The resulting file holds references to all the dependencies of EXP
>      or a subset thereof.
>
> I do not understand this last sentence.  How can it be a subset?  A
> subset of what?  Can this be explained more clearly or removed?

It can be a subset of the references of EXP because, when a build
completes, the daemon scan the output(s) to determine the set of
residual references.  That=E2=80=99s the difference between build-time and
run-time dependencies.

For instance, =E2=80=98sed=E2=80=99 depends on =E2=80=98gcc=E2=80=99 and =
=E2=80=98gcc:lib=E2=80=99 at build time, but
its output depends only on =E2=80=98gcc:lib=E2=80=99.

Does that make sense?

Ludo=E2=80=99.