From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id wK1pD2s5nV8GRQAA0tVLHw (envelope-from ) for ; Sat, 31 Oct 2020 10:16:11 +0000 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 eC4wC2s5nV8LFwAAbx9fmQ (envelope-from ) for ; Sat, 31 Oct 2020 10:16:11 +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 AD2B8940148 for ; Sat, 31 Oct 2020 10:16:10 +0000 (UTC) Received: from localhost ([::1]:56708 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kYnvc-0005Jl-Pz for larch@yhetil.org; Sat, 31 Oct 2020 06:16:08 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:49350) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kYnvW-0005Je-Om for guix-patches@gnu.org; Sat, 31 Oct 2020 06:16:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:49028) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kYnvW-0001TF-Fb for guix-patches@gnu.org; Sat, 31 Oct 2020 06:16:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kYnvW-0006UQ-9A for guix-patches@gnu.org; Sat, 31 Oct 2020 06:16:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#44321] [PATCH 6/6] doc: Add "Defining Package Variants" section. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sat, 31 Oct 2020 10:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 44321 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: zimoun Cc: 44321@debbugs.gnu.org Received: via spool by 44321-submit@debbugs.gnu.org id=B44321.160413930424852 (code B ref 44321); Sat, 31 Oct 2020 10:16:02 +0000 Received: (at 44321) by debbugs.gnu.org; 31 Oct 2020 10:15:04 +0000 Received: from localhost ([127.0.0.1]:60574 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYnua-0006Sl-8n for submit@debbugs.gnu.org; Sat, 31 Oct 2020 06:15:04 -0400 Received: from eggs.gnu.org ([209.51.188.92]:49164) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYnuY-0006Ry-U0 for 44321@debbugs.gnu.org; Sat, 31 Oct 2020 06:15:03 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:36171) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kYnuT-0000yR-N1; Sat, 31 Oct 2020 06:14:57 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=56724 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kYnuS-0005jh-Eb; Sat, 31 Oct 2020 06:14:57 -0400 From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: <20201029231000.14568-1-ludo@gnu.org> <20201029231000.14568-6-ludo@gnu.org> <875z6s6jv1.fsf@gmail.com> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 10 Brumaire an 229 de la =?UTF-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Sat, 31 Oct 2020 11:14:55 +0100 In-Reply-To: <875z6s6jv1.fsf@gmail.com> (zimoun's message of "Fri, 30 Oct 2020 12:20:18 +0100") Message-ID: <87eelewvkw.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -3.3 (---) X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Scanner: ns3122888.ip-94-23-21.eu Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Spam-Score: -1.51 X-TUID: QrD3x+tokwvr Hi, zimoun skribis: > On Fri, 30 Oct 2020 at 00:10, Ludovic Court=C3=A8s wrote: > >> -* Invoking guix repl:: Programming Guix in Guile. >> +* Invoking guix repl:: Programming Guix in Guile > > This change is already in commit 729d4ba025bc8556d00041f9af5b6609eeec9d80. OK, I=E2=80=99ll have to rebase and regenerate the menus maybe. >> +You can just as well define variants with a different set of >> +dependencies than the original package. For example, the default >> +@code{gdb} package depends on @code{guile}, but since that is an >> +optional dependency, you can define a variant that removes that >> +dependency like so: >> + >> +@lisp >> +(use-modules (gnu packages gdb) ;for 'gdb' >> + (srfi srfi-1)) ;for 'alist-delete' >> + >> +(define gdb-sans-guile >> + (package >> + (inherit gdb) >> + (inputs (alist-delete "guile" >> + (package-inputs gdb))))) >> +@end lisp > > Does it make sense to add a sentence explaining that the =E2=80=9Cguile= =E2=80=9D is the > name provided by the string in the =E2=80=99inputs=E2=80=99 list of the p= ackage =E2=80=99gdb=E2=80=99, Yeah, I=E2=80=99ll add a sentence like: +The @code{alist-delete} call above removes the tuple from the +@code{inputs} field that has @code{"guile"} as its first element +(@pxref{SRFI-1 Association Lists,,, guile, GNU Guile Reference +Manual}). >> +@deffn {Scheme Procedure} options->transformation @var{opts} >> +Return a procedure that, when passed an object to build (package, >> +derivation, etc.), applies the transformations specified by @var{opts} = and returns >> +the resulting objects. @var{opts} must be a list of symbol/string pair= s such as: >> + >> +@example >> +((with-branch . "guile-gcrypt=3Dmaster") >> + (without-tests . "libgcrypt")) >> +@end example > > Is it on purpose that here you use =E2=80=99without-tests=E2=80=99 and th= en=E2=80=A6 [...] > =E2=80=A6you use =E2=80=99with-debug-info=E2=80=99 as example? Yeah, the two examples are independent of one another so I guess it=E2=80= =99s fine to have some diversity, no? >> +@lisp >> +(define libressl-instead-of-openssl >> + ;; Replace all the packages called "openssl" with LibreSSL. >> + (package-input-rewriting/spec `(("openssl" . ,(const libressl))))) >> +@end lisp > > It is already in the manual but why this =E2=80=99const=E2=80=99? Because =E2=80=98package-input-rewriting/spec=E2=80=99 takes a list of spec= /procedure pairs. Thanks! Ludo=E2=80=99.