From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id QIfPJ6Ru32GHBAAAgWs5BA (envelope-from ) for ; Thu, 13 Jan 2022 01:13:24 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id yNKuJKRu32EjQwEAauVa8A (envelope-from ) for ; Thu, 13 Jan 2022 01:13:24 +0100 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 4211329EDB for ; Thu, 13 Jan 2022 01:13:24 +0100 (CET) Received: from localhost ([::1]:45390 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n7nk3-0002IY-Et for larch@yhetil.org; Wed, 12 Jan 2022 19:13:23 -0500 Received: from eggs.gnu.org ([209.51.188.92]:57016) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7njj-0002IQ-2P for bug-guix@gnu.org; Wed, 12 Jan 2022 19:13:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:38300) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n7nji-0002qM-M5 for bug-guix@gnu.org; Wed, 12 Jan 2022 19:13:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n7nji-0005Wn-HD for bug-guix@gnu.org; Wed, 12 Jan 2022 19:13:02 -0500 X-Loop: help-debbugs@gnu.org Subject: bug#53224: Cookbook recipe about profile collisions Resent-From: Leo Famulari Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Thu, 13 Jan 2022 00:13:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 53224 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 53224@debbugs.gnu.org X-Debbugs-Original-To: bug-guix@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.164203273721191 (code B ref -1); Thu, 13 Jan 2022 00:13:02 +0000 Received: (at submit) by debbugs.gnu.org; 13 Jan 2022 00:12:17 +0000 Received: from localhost ([127.0.0.1]:59436 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n7niz-0005Vj-94 for submit@debbugs.gnu.org; Wed, 12 Jan 2022 19:12:17 -0500 Received: from lists.gnu.org ([209.51.188.17]:47030) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n7niu-0005VY-60 for submit@debbugs.gnu.org; Wed, 12 Jan 2022 19:12:16 -0500 Received: from eggs.gnu.org ([209.51.188.92]:56848) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7nit-0002Fe-EW for bug-guix@gnu.org; Wed, 12 Jan 2022 19:12:12 -0500 Received: from wout5-smtp.messagingengine.com ([64.147.123.21]:42861) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7nir-0002mw-7w for bug-guix@gnu.org; Wed, 12 Jan 2022 19:12:11 -0500 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.west.internal (Postfix) with ESMTP id 347803201D7C; Wed, 12 Jan 2022 19:12:05 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute5.internal (MEProxy); Wed, 12 Jan 2022 19:12:05 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name; h=date:from:to:cc:subject:message-id:mime-version:content-type; s=mesmtp; bh=lGH8VyVL8PwxvGC803I/aMODiT2l/8OH9LoUm7GZMFg=; b=UD k+1egusefn7Xf4LooHP628vsrevSQanlgATo15GbxF4kWgs92ZvkmIRWI5StZElz lNZgZyi6O1CBERIAPFtzeg9xfe43CSeLpaJ3bYtv+v9sdCWBM5bBEoLlIIUcu9tY xP0Fzm8XNO5Kj7RiI5otqUJVCifgJLGq/ONGOYeA4= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:message-id :mime-version:subject:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm1; bh=lGH8VyVL8PwxvGC803I/aMODiT2l/ 8OH9LoUm7GZMFg=; b=hZTVLb2fRzYLI+k35LLb+wDxrWjdEshfHKfDuuWNEZ9aJ SlDiJ8d5Y75qQuitECdsWzInAFT3/Ybg5usyCrVmrASw03hWLpzbksaEsht4QJ1G JR9aHmULuxOneY/6MliI3DilnLrzENz9TlF6LqxZDQ2QHBTqcKAYzzxY39u0a958 KMm+c8xVeXwfkCWaZDgV+QnBPyyeFJLlXYHFsAs7jTjudgBejvfPT2quUp9rvNlA 9flpx9G2JF1AeiOykFQmld4zbJPSGnE2RcSBb431Z4Nti20cCKysT/eyDg9QJpuc 1wmztNTxRmy036hByGSQ8NoGwChopLFrrD/trMFGg== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvvddrtddvgddukecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepfffhvffukfggtggusehttdertddttd dvnecuhfhrohhmpefnvghoucfhrghmuhhlrghrihcuoehlvghosehfrghmuhhlrghrihdr nhgrmhgvqeenucggtffrrghtthgvrhhnpeehveethedvteetfffhledukedtheekkedtfe ethefhieehffehueffvdejffehheenucffohhmrghinhepghhnuhdrohhrghdpvgigtggr lhgrmhhushdrtghomhenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrih hlfhhrohhmpehlvghosehfrghmuhhlrghrihdrnhgrmhgv X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 12 Jan 2022 19:12:04 -0500 (EST) Date: Wed, 12 Jan 2022 19:11:59 -0500 From: Leo Famulari Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Received-SPF: pass client-ip=64.147.123.21; envelope-from=leo@famulari.name; helo=wout5-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Matt Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1642032804; 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:resent-cc:resent-from:resent-sender: resent-message-id:list-id:list-help:list-unsubscribe:list-subscribe: list-post:dkim-signature; bh=lGH8VyVL8PwxvGC803I/aMODiT2l/8OH9LoUm7GZMFg=; b=TgisWTeT9jioD96JzuN3w3sJ+KwGkN29656v1kGjg3l6AcSbtJyOYzhs57k0wGFinEP6hI N9AKZhnoBEbE6/qF3uqqLE/6RwyT5bU4kUevF5VpYaIQO0ho66/RGJw4746tffDau46DRw f95VbwgJHaWyUSIaP1+VQlfEyH5gPnqggIJpgB7YgiIQgKTvTdM5VHvFbLD3422hzMcew/ tInAZyGCf++ch2p2kF/XbFj3dGj0zPywcmYGQtC/twAaoOFGcdYn3ZrF6QKovbIPXPKle9 zUApPnWljKRH6e21G8JNnfbQeo1g4BovNAYA3dQXskOZALUkoDk+NmlwiPvgRA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1642032804; a=rsa-sha256; cv=none; b=foj6cXI6maYTZlXDQqvQrTtYWTHLDeNtCZ3zPwAV2ymHsARVvw6NjBolCwlVQ1lPa3++OP HmwwZhuEe0IjT+pljvbeAO2qwV35jJ1NtvNNQ0Cegt7qeT0nT3S3cUQm0yOMJA8GYcbuBm 9hhjsal5+sP2i9ble4S7echXDAP9bSOnPtr1lyNcZ1hJ7khSVCf1kCWhTIygvhlKEiMOL3 dnrU1TWf1Tm8QuNFKYVH+YJg/CgywlNV0ceFm/xrBcjwe70DjE1azLqRYGS1Ivm0AHByqL V674YIXw/XyUvJ5lZKdtckMEZoLypJkfVtFPPkCbHJHhWunfyA0LbxNk9A08ZA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=famulari.name header.s=mesmtp header.b="UD k+1eg"; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm1 header.b=hZTVLb2f; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.42 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=famulari.name header.s=mesmtp header.b="UD k+1eg"; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm1 header.b=hZTVLb2f; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 4211329EDB X-Spam-Score: -3.42 X-Migadu-Scanner: scn0.migadu.com X-TUID: FyPmTf0MaL1y Recently, Matt pointed out that profile collisions can be confusing and difficult to resolve: https://lists.gnu.org/archive/html/guix-devel/2022-01/msg00115.html Specifically see this blog post: http://excalamus.com/2021-10-06-guix-debug.html I think we should add a Cookbook chapter on the subject. This particular error state seems unavoidable given the size of the distro and the number of packages that use propagation. So, let's help users understand it and give them the knowledge to even help resolve such collisions as contributors. Speaking as somebody who understands intimately what a profile is, what propagated inputs are, and how they can interact to cause "profile contains conflicting entries", I am sympathetic. Although I know exactly how to resolve such errors, I have also explained the situation to new Guix users several times on IRC. Many people come to Guix, install some packages, use them, then want to upgrade them, and they have never learned what a profile is or how it is the fundamental mechanism by which Guix implements package management. It also seems to me that plenty of people would prefer not to ask for help, but rather go searching online and in the documentation, which does not include the string "contains conflicting entries". I envision a Cookbook chapter that explains what a profile is, what propagation does, what profile generations are, and then how they all combine to cause this error state. And an example of a resolution, whether by adjusting a package definition, uninstalling a package, etc. There are some older Guix presentation videos that I think do a great job of explaining profiles and generations, including slides with good illustrations of the subject. It would be nice to try using that style of illustration, as I found it clear and illuminating when I first learned about Guix.