From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: bug#34574: Confusing manual entry for gexp->file Date: Wed, 6 Mar 2019 19:35:19 +0100 Message-ID: <20190306183519.ws5hrx66ex4xa4d7@pelzflorian.localdomain> References: <20190219162120.7evs2ynhhdksyq2d@pelzflorian.localdomain> <871s3kjg5e.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([209.51.188.92]:37007) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h1bOd-0001fp-Ol for bug-guix@gnu.org; Wed, 06 Mar 2019 13:36:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h1bOc-00025N-3p for bug-guix@gnu.org; Wed, 06 Mar 2019 13:36:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:49352) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h1bOb-00024z-VJ for bug-guix@gnu.org; Wed, 06 Mar 2019 13:36:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1h1bOb-00088T-Ni for bug-guix@gnu.org; Wed, 06 Mar 2019 13:36:01 -0500 Sender: "Debbugs-submit" Resent-Message-ID: Content-Disposition: inline In-Reply-To: <871s3kjg5e.fsf@gnu.org> List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: "bug-Guix" To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 34574@debbugs.gnu.org On Wed, Mar 06, 2019 at 02:17:49PM +0100, Ludovic Courtès wrote: > Hi Florian, > > "pelzflorian (Florian Pelz)" 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 > > ‘%load-path’ and ‘%load-compiled-path’ to honor EXP’s imported > > modules. Look up EXP’s 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’s the difference between build-time and > run-time dependencies. > > For instance, ‘sed’ depends on ‘gcc’ and ‘gcc:lib’ at build time, but > its output depends only on ‘gcc:lib’. > > Does that make sense? > > Ludo’. Thank you. I did not know this is how the daemon determines outputs’ references. In this case I would understand the manual more easily if it said: The output(s) resulting from this derivation will be scanned for references by the daemon. They can hold references to all the dependencies of EXP or a subset thereof. Please make this more clear in the manual. Regards, Florian