From mboxrd@z Thu Jan  1 00:00:00 1970
From: "pelzflorian (Florian Pelz)" <pelzflorian@pelzflorian.de>
Subject: bug#34574: Confusing manual entry for gexp->file
Date: Tue, 19 Feb 2019 17:21:20 +0100
Message-ID: <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]:47231)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1gw8Am-0005nt-5T
	for bug-guix@gnu.org; Tue, 19 Feb 2019 11:23:09 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1gw8Ag-00088O-KP
	for bug-guix@gnu.org; Tue, 19 Feb 2019 11:23:08 -0500
Received: from debbugs.gnu.org ([209.51.188.43]:56174)
	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 1gw8Ag-00087z-Cp
	for bug-guix@gnu.org; Tue, 19 Feb 2019 11:23:02 -0500
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1gw8Ag-0003j0-41
	for bug-guix@gnu.org; Tue, 19 Feb 2019 11:23:02 -0500
Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-Message-ID: <handler.34574.B.155059332114221@debbugs.gnu.org>
Received: from eggs.gnu.org ([209.51.188.92]:46775)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <pelzflorian@pelzflorian.de>) id 1gw89M-0004mH-HK
	for bug-guix@gnu.org; Tue, 19 Feb 2019 11:21:41 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <pelzflorian@pelzflorian.de>) id 1gw89L-0007XZ-3p
	for bug-guix@gnu.org; Tue, 19 Feb 2019 11:21:40 -0500
Received: from pelzflorian.de ([5.45.111.108]:51422 helo=mail.pelzflorian.de)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <pelzflorian@pelzflorian.de>)
	id 1gw89K-0007PS-9Q
	for bug-guix@gnu.org; Tue, 19 Feb 2019 11:21:38 -0500
Received: from pelzflorian.localdomain (unknown [5.45.111.108])
	by mail.pelzflorian.de (Postfix) with ESMTPSA id 84025360035
	for <bug-guix@gnu.org>; Tue, 19 Feb 2019 17:21:20 +0100 (CET)
Content-Disposition: inline
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: 34574@debbugs.gnu.org

Hello,

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?

Regards,
Florian