From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id cDsKJ24YU2GF5AAAgWs5BA (envelope-from ) for ; Tue, 28 Sep 2021 15:28:14 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id GOqtIm4YU2GSZgAAB5/wlQ (envelope-from ) for ; Tue, 28 Sep 2021 13:28:14 +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 2FBCC32F2F for ; Tue, 28 Sep 2021 15:28:14 +0200 (CEST) Received: from localhost ([::1]:53514 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mVD9Z-0007wC-8X for larch@yhetil.org; Tue, 28 Sep 2021 09:28:13 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:39768) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVCgW-0006D6-D9 for guix-devel@gnu.org; Tue, 28 Sep 2021 08:58:13 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:42574) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mVCgW-0004Wf-5x for guix-devel@gnu.org; Tue, 28 Sep 2021 08:58:12 -0400 Received: from [2001:660:6102:320:e120:2c8f:8909:cdfe] (port=60494 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVCgV-0008Pe-IN for guix-devel@gnu.org; Tue, 28 Sep 2021 08:58:12 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Guix Devel Subject: Dealing with interface deprecation X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 7 =?utf-8?Q?Vend=C3=A9miaire?= an 230 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: Tue, 28 Sep 2021 14:58:09 +0200 Message-ID: <87r1d8amce.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1632835694; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=H+y1Oiajj52BCzxkgCKT0jqTFl9q8oJePRvNdCpIOis=; b=jhP9LCg0tf1vuXt1J/zUz/+RzcRT8ALmwS4/ggQwCatoWE/PEXq1U+TEUGByLcxnUOXqNj sJXazITzp0K5GKffNSWth0P31dqgkVCSsTvSMkmdB9PSjsrQ3mYfI7QNQEmLUWuXJJfiNF EyJ25WB1SQMtrfl1iPP0Z6/xkpLOdtQ7IiN3OnbmnglqWCg6osUuUcQbGFcomziHzWc7xd x2m6QcSiOBfq7EYi4SqauD4r6BJGhFsFD4rrVbA1jtheaBkE1MxW96Jw2JrvlcJZ7Y8hAi +pioUOhqYa1wTt0UcMF2CcLaIlVx03VxHofDU/cYW2UgIyDNAiGp8OFQco8yuQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1632835694; a=rsa-sha256; cv=none; b=jgx0OOmsx/61PzmSJmQ3M4MYddgJi6QMJrd+HowCx+quFOmrff+OVTg0ViqymwLlMHg1Q1 7ScpvYdEoGCu+1mUANMB8mztm+J4TNbFKO5ZUTc15OQ6BAdn5YunFYN5hI9CSjsmKl5blW flhQdDiJjoD8DLnkPlw0yd2aY6oZ6r1qWHt2ZhTQ2IaPQg1X2u/L2w166EvJmjKT/NmEBr gtmmyLRYvc2Oj4x2wRP8XvGh+RWOHx1t2o517JnfMmLu3fQ998+Ri3YtNT4HyCTceDgkoD 3KpL3ICTc7SVJj7tLRsRpNuvhf2jipNFbZ8lfXXpfXh7Hwsa5/PUYD837SycuQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Spam-Score: -2.90 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Queue-Id: 2FBCC32F2F X-Spam-Score: -2.90 X-Migadu-Scanner: scn0.migadu.com X-TUID: VNXvfKtbdHyr Hello Guix! In Guix, configuration is code, which is great! But that also means users occasionally have to deal with things like =E2=80=9CAPI deprecation= =E2=80=9D, which never sounds exciting, especially when all you want is to get your system upgraded Right Now. So I think it=E2=80=99s important to be very careful in how we deal with API deprecation, in particular in Guix System (and in Guix Home once we=E2=80= =99ve removed the =E2=80=9Ctechnology preview=E2=80=9D label). There were two examples where, with my =E2=80=9Cregular user=E2=80=9D hat o= n (which I particularly enjoy), I got deprecation messages that were not actionable for me because they lacked source location info. This was addressed by these changes: https://git.savannah.gnu.org/cgit/guix.git/commit?id=3De0bd47b4fd5eb009f3= 4004242e16b976e58756b0 https://git.savannah.gnu.org/cgit/guix.git/commit?id=3Dbaf4272df2350a40bf= a198f5cdb42e707e32ad71 As you can see, providing good actionable messages for record field deprecation is a bit of a craft, but hopefully that gives an idea of how to get there; maybe we=E2=80=99ll eventually come up with a high-level way = to express that. Packages may also be part of the =E2=80=9CAPI=E2=80=9D. On =E2=80=98core-u= pdates=E2=80=99, several TeX Live packages were deprecated but still used because there wasn=E2=80=99t a= ny warning. This is how I addressed it: https://git.savannah.gnu.org/cgit/guix.git/commit?id=3D3dc8052b51241fe785= 7059d3300dad3a0f9f68fd Thoughts? Tips and tricks? Ludo=E2=80=99.