From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 4BEeIpnGaWBvUAEAgWs5BA (envelope-from ) for ; Sun, 04 Apr 2021 16:00:57 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id uArqG5nGaWCYFQAAbx9fmQ (envelope-from ) for ; Sun, 04 Apr 2021 14:00:57 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id C90501DFC3 for ; Sun, 4 Apr 2021 16:00:56 +0200 (CEST) Received: from localhost ([::1]:50578 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lT3J9-0003fg-C4 for larch@yhetil.org; Sun, 04 Apr 2021 10:00:55 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46214) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lT3Il-0003f8-Nn for help-guix@gnu.org; Sun, 04 Apr 2021 10:00:32 -0400 Received: from mout01.posteo.de ([185.67.36.65]:33406) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lT3Ic-0000wu-Ow for help-guix@gnu.org; Sun, 04 Apr 2021 10:00:29 -0400 Received: from submission (posteo.de [89.146.220.130]) by mout01.posteo.de (Postfix) with ESMTPS id C36B0160062 for ; Sun, 4 Apr 2021 16:00:18 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.de; s=2017; t=1617544818; bh=MB81ktGvnxVp9ux8p19DPFl3JIklzzVfQf+E3zcUFBs=; h=Subject:To:Cc:From:Date:From; b=fbichRl07yw/y/DWTo8o89RrN4CwsPQ3kly71zh1D8M+bfPI0DgzxpBh/qtVBdmKo t3LeQhLHyYL3rrAZjLOQUxojQ8KjV6gTT4u1EuhYIJgl6sq/Ot3zrJ7bbfce/t9AHr 2vxGvhwxIZaQ4cZmRnz+dmScz/dogDt+2BA0xQ0vrA96S755zitVB8TzqetB0jTAJQ Ka/ksZ6w3fOfhIl1N8hDe8+Qv+KL2yJIPkgVX/89EDVHMV6rdB6+aBwp3v0ArIeTDi 4kzHunQ/Tx4UYPRePeM6KSBmDVpnt3FPdh/xP4fxhcBun5JVOjIsUrNtMcfGsaroXc GJzsvweVRrJmw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4FCwQc4MLxz9rxV; Sun, 4 Apr 2021 15:59:52 +0200 (CEST) Subject: Re: About packaging documentation To: Ricardo Wurmus References: <87y2eomngw.fsf@elephly.net> <51eadb71-592c-d024-3163-85766a1a060c@posteo.de> <874khan4cn.fsf@elephly.net> <874kgo1hbo.fsf@elephly.net> From: Zelphir Kaltstahl Message-ID: <7cbb6849-f035-ee11-9e69-19ab0829ade2@posteo.de> Date: Sun, 4 Apr 2021 15:59:51 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.7.1 MIME-Version: 1.0 In-Reply-To: <874kgo1hbo.fsf@elephly.net> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Content-Language: en-US Received-SPF: pass client-ip=185.67.36.65; envelope-from=zelphirkaltstahl@posteo.de; helo=mout01.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-guix@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: help-guix@gnu.org Errors-To: help-guix-bounces+larch=yhetil.org@gnu.org Sender: "Help-Guix" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1617544857; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=dPlEsq60UuDi13cxuad7A267mdLsVA54MIcxTnpLUdc=; b=HZkIkl9U2SAdJOo2u7HOBqkHO/YeU1YaUcA3Q0ZNUTMGG1ZFxLNE2tYvfRyTt5OomOdyoX GmuH4QIrRpBeLlrTZ6GRXRn4tT1Jb5rkIezUjgvyJ2h5ObWr6/s9htOL3cAd7vqjtKgi/T JivEtJwdfLyVCpQrfFqTOUN7CE9jGA9w0EccJeyUP9EXh1xdFgqJ9+hU6aF6gSe4rwZqrT 3EWsqkRy0Q1VMmK7gFcKHWrB2OpzADecI++uv79w1KDQKcFGsSK6tNP+KZh9pXdTp0wKQw KmNzU4nkvxjiKts4c+Q/CzuFFxTy8GKqIfMIDU5CJTZg7APMbBU3I7Y8/kjMMw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1617544857; a=rsa-sha256; cv=none; b=PJfL94MXjG/PyqlCHP36j+2F9kK369WrlDU9LHYLk2mib/IGQSXBYlSn7ZWmGdhB1sGHkQ rTwXqkPmflLzNOXKeoWbaNPXuUks8QN6zRReMc0QE+p05xl7N7Boi5BE4OSWP6Shf27lbk DhVV+haRfzVXPpQZxXA/F1Z/fsn2C/1b2bs0MT4DRZxt/c++xc4hpYWCne3qhFpJ1yebHZ 5/QeHF4Ph+21SFQkeJu8/A/qim+gdqMFTp6NmGNitq3KxAwQHutXDoxl8Dfwxk2tMFFrtU 6QYY56g4cmJlx8T2FtZDvgrKq5ZBXPyNNGoxH5ADuMYo+ER4aJ2U3dInM90D1Q== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.de header.s=2017 header.b=fbichRl0; dmarc=pass (policy=none) header.from=posteo.de; spf=pass (aspmx1.migadu.com: domain of help-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=help-guix-bounces@gnu.org X-Migadu-Spam-Score: -3.14 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.de header.s=2017 header.b=fbichRl0; dmarc=pass (policy=none) header.from=posteo.de; spf=pass (aspmx1.migadu.com: domain of help-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=help-guix-bounces@gnu.org X-Migadu-Queue-Id: C90501DFC3 X-Spam-Score: -3.14 X-Migadu-Scanner: scn0.migadu.com X-TUID: I40cPSOQ25Bb On 4/2/21 11:56 PM, Ricardo Wurmus wrote: > Hi Zelphir, > >> (1) The cookbook does not even mention the guile-build-system. […] >> I guess this is, because the cookbook tries to be generic in a way, to apply to >> all languages, if only one uses autotools, as those are applicable to all >> languages. > No, you’re overthinking it :) The cookbook is pretty short. It started > because blog posts eventually go stale, so having some of these useful > blog posts updated with Guix seemed like a good idea. > > The cookbook is supposed to include useful tutorials, recipes, extensive > examples — all stuff that would bloat up the reference manual or make it > lose scope. > > The fact that the cookbook doesn’t mention the guile-build-system is due > to two reasons: > > 1) it’s not a reference manual, but a collection of tutorials > 2) nobody contributed a tutorial involving the guile-build-system. > > 1 is by design, but 2 is not. We would certainly add a tutorial for > simple Guile packages if someone contributed it. I shall share my notes, if I get it working reproducibly. Until then, I am maintaining notes at https://notabug.org/ZelphirKaltstahl/gnu-guile-gnu-guix-packaging-guide . >> (2) The hello package example is using the gnu-build-system. I guess that means, >> that Guix will go through the usual autotools steps, after extracting a tarball >> or cloning a repository. However, then it would seem, that the success of the >> installation of the package largely hinges on what is defined in the autotools >> related files, like Makefile and such, which are part of the downloaded tar. > Correct. The GNU build system commonly consists of a bootstrap step, > the execution of the configure script, followed by “make” and “make > install”. The gnu-build-system abstraction merely automates that and > assumes that these things exist and are in a functional state, so that > it can call them with certain default arguments. > >> Those however, are not described in the cookbook. If one is to create a package, >> which makes use of the gnu-build-system, then a description of how to get this >> done would be good to have. People have done it before, but documentation does >> not capture it. > I can understand the desire for comprehensive documentation, but I think > that’s too far out of scope for even the cookbook. The GNU build system > is just very *very* common, which is why the tutorial uses the > gnu-build-system abstraction. It something you are bound to encounter > when packaging non-trivial C/C++ applications. > > Guix has abstractions for many other build systems, such as the > r-build-system, or the cmake-build-system. But I think it would be > excessive to add tutorials on how to write an R package according to > specifications, or how to write CMakeList.txt for a cmake-using project. > >> Then there is another confusion: The definition you have written – Is that for >> editing the `guile.scm` in the Guix source tree > Not, for guile.scm but for gnu/packages/guile-xyz.scm or rather the (gnu > package guile-xyz) module. It works in that context because that module > already has all the necessary imports. Ah, OK. Best regards, Zelphir -- repositories: https://notabug.org/ZelphirKaltstahl