From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id IIIDBXOn1WaJMgAAqHPOHw:P1 (envelope-from ) for ; Mon, 02 Sep 2024 11:54:27 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id IIIDBXOn1WaJMgAAqHPOHw (envelope-from ) for ; Mon, 02 Sep 2024 13:54:27 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=QQVsxvNz; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=Ddh6ftlj; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1725278067; 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:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=xlswur1wnQFaxHSzPHdWNARZTmr02EgdYT5JFp96/68=; b=YvrQh6tW/vYtl/mfo0Lf8R6hges6y273f4ECeBm0k7Dw6BRmUFcB5iKwfvpN9CHlecZAXR gf0JqvBTE8UW+oyXgqknj6BAiE06+uN+YwhsX00kHzgIi4CBdET5q+ltpkETRq1FZ4MbrW SpDRHE/YctD6NPuyAYCSEzeCSJsqApZO6+8CgKQ75wPfK3D7By2QTsoeZlzSZEWgIXIkSU mbmzcFUnHbr5dOgrcwQQCdS4MKSsJixV11uyXo1V2gbyWtq/cSeo+7WDD+uc/hLQI7H7P8 +vMxunf6nKupaA0YeYeoEJz4viTUJca3gG6RWfopmVdZ88ZTNxQK+ESC4cVFHA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1725278067; a=rsa-sha256; cv=none; b=d9fsRqWtUcY0oXMS2o6NUrrPR/BS5sSAAJKSKMgIp7+EwmKgQqXXPm9V9RbESoA2pAkvZy fU5hmy1vrIaVP+e0GjpKjrIGDidi904MZGUusKauiHWNIKUaWU9wQdfD83td3P9Ug9iHwb 53zdXG1yfn/nnwrDLm5+DohYD2qkWlrMjAeIcGIGVg7ysylCQrYdoj7pC/sgn11tdGV3Vm rVg4dJYxzcHkKle73akccXXCo7d0Vzj2P/U4VYVkIl/+ucI40Lh1koRR+8/8WnGTZFmHHF 4gM3jUl20Ecu9SVmqjvkoD9EscFBfEcxoM27odyyANMl5t00cJskGc1lS9mnFQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=QQVsxvNz; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=Ddh6ftlj; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" 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 C489B3C894 for ; Mon, 02 Sep 2024 13:54:26 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sl5dF-00012O-L8; Mon, 02 Sep 2024 07:54:05 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sl5dD-00011h-M5 for guix-patches@gnu.org; Mon, 02 Sep 2024 07:54:03 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sl5dD-00039G-Cy for guix-patches@gnu.org; Mon, 02 Sep 2024 07:54:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=xlswur1wnQFaxHSzPHdWNARZTmr02EgdYT5JFp96/68=; b=QQVsxvNzFqfiD2MvhlRtIaPWgWQ7nZVGi2RJbxz9cnw21pIvqpeHAFCsh+PGL5Gftwl/4w6bpoTeHrvxiW8/a56ZePeWVWwP53pEOIUb/3gK23qTkb3XbE0XUHSaXD9loEKu6gYDYDLJ4u9I+AwAClumfB1/AOIc4woltaZjkm4t3R0xkyH0NGQCdr4KFl6+qNJCfabkPX4NqwicEeN3JoNx3GeHbnB8G3lhOnane5ethA/Xcpx7Om/x1S/0/b3DxA75Ggf9eA0KA0qu+hn3VbnW3LqAfUMrxc2X/bKJKWhEpgGLYh06BsRCKuxGGhJo3jaEhurH9N0UOH3MOSE5Fg==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sl5eA-0008B9-3s for guix-patches@gnu.org; Mon, 02 Sep 2024 07:55:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#72840] [PATCH RFC] DRAFT doc: Add =?UTF-8?Q?=E2=80=9CDeprecation_?= =?UTF-8?Q?Policy=E2=80=9D?= section. Resent-From: "pelzflorian (Florian Pelz)" Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 02 Sep 2024 11:55:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72840 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: Maxim Cournoyer , Matthew Trzcinski , 72840@debbugs.gnu.org Received: via spool by 72840-submit@debbugs.gnu.org id=B72840.172527808831401 (code B ref 72840); Mon, 02 Sep 2024 11:55:02 +0000 Received: (at 72840) by debbugs.gnu.org; 2 Sep 2024 11:54:48 +0000 Received: from localhost ([127.0.0.1]:46820 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sl5dv-0008AN-Ue for submit@debbugs.gnu.org; Mon, 02 Sep 2024 07:54:48 -0400 Received: from relay.yourmailgateway.de ([188.68.63.102]:37637) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sl5ds-00089v-MD for 72840@debbugs.gnu.org; Mon, 02 Sep 2024 07:54:46 -0400 Received: from mors-relay-2502.netcup.net (localhost [127.0.0.1]) by mors-relay-2502.netcup.net (Postfix) with ESMTPS id 4Wy6bV4R8xz61lS; Mon, 2 Sep 2024 13:53:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1725278022; bh=Qgwn1svyM7qHlSdXPkuV6RAdFYiJBLlYWlmJsm/rQg0=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=Ddh6ftljxWLLHX+YRxMzUUQqZBRPAWy4dDX2SDBM/7IpfX0Tr/CHMFhSeb8z7QMJr iKqJgZoYNSJbCEpDCgPo9mewgZ/wORjjkOd9eHukhipNgRVyajZIv/6Hd/sYIqGeYd kDsBdyjs2T7O6PMSCVZsVWR4NlPYrpV9DfdFMV62q/jlPxSn5RInIZ5kIxstO4quWT TthMHqwuDgi6ZC1QUOY+edxc02EYFQcVjDMTPIDu0Q7DW9BiDqK/BBAIZH0t1R+7D3 LP91s6LDlfX4Fy5wH/0dWFtD+1NdRxQY+XsI+xUGgeyUlHenf/kEeoWSCPcK7CiBpe ozVS22EYPqYdQ== Received: from policy01-mors.netcup.net (unknown [46.38.225.35]) by mors-relay-2502.netcup.net (Postfix) with ESMTPS id 4Wy6bV3jmXz4xQc; Mon, 2 Sep 2024 13:53:42 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at policy01-mors.netcup.net Received: from mxe217.netcup.net (unknown [10.243.12.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by policy01-mors.netcup.net (Postfix) with ESMTPS id 4Wy6bS6F0fz8tYF; Mon, 2 Sep 2024 13:53:40 +0200 (CEST) Received: from florianhp (ipb2186896.dynamic.kabel-deutschland.de [178.24.104.150]) by mxe217.netcup.net (Postfix) with ESMTPSA id C3073840AB; Mon, 2 Sep 2024 13:53:32 +0200 (CEST) From: "pelzflorian (Florian Pelz)" In-Reply-To: <80f8b603ecd73cb9f46b1ea43797e143f16d2f17.1724785788.git.ludo@gnu.org> ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Tue, 27 Aug 2024 21:30:35 +0200") References: <80f8b603ecd73cb9f46b1ea43797e143f16d2f17.1724785788.git.ludo@gnu.org> Date: Mon, 02 Sep 2024 13:53:32 +0200 Message-ID: <877cbunuf7.fsf@pelzflorian.de> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: C3073840AB X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: 1HqIlGWemXlQAW6C+s42JaMNZ7aBx4w5G15sL4Crb3yf3pOvhlp3XCN/ X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -6.02 X-Spam-Score: -6.02 X-Migadu-Queue-Id: C489B3C894 X-Migadu-Scanner: mx11.migadu.com X-TUID: HIaN8If/98fN Hello Ludo. Having a deprecation policy clarifies things. Thank you for writing a good one! Ludovic Court=C3=A8s writes: > +@item Package removal > +Packages that their upstream developers have declared as having reach typo: reached > +``end of life'' or being unmaintained may be removed. There is no > +formal deprecation mechanism for this case, unless a replacement exists, > +in which case the @code{deprecated-package} procedure mentioned above > +can be used. > + > +If the package being removed is a ``leaf'' (no other packages depend on > +it), it may be removed after a one-month review period of the patch > +removing it. > + Could you also reference this one-month period in the Commit Access section, where policy is one or two weeks? Thinking of package removals for security reasons, it should be clearer that this one-month period applies even in this case. (IMHO some period should apply. It is the user=E2=80=99s decision to use software despite security problems. We all know web browsers=E2=80=99 security track record; not everone puts the web to use everywhere, but Guix thankfully does ship web browsers.) > [=E2=80=A6] > +@cindex deprecation of programming interfaces > +@item Core interfaces > +Core programming interfaces, in particular the @code{(guix ...)} > +modules, may be relied on by a variety of external tools and channels. > +Any incompatible change must be formally deprecated with > +@code{define-deprecated}, as shown above, for at least one year before > +removal. The manual must clearly document the new interface and, except > +in obvious cases, explain how to migrate from the old one. > + > +As an example, the @code{build-expression->derivation} procedure was > +superseded by @code{gexp->derivation} and remained available as a > +deprecated symbol: This cannot be an absolute truth. It is not always reasonable to make changes bacwards-compatible. For example, the switch from xz repacking to zstd repacking in recent core-updates did break guile-manual in doc/build.scm and perhaps did break outside code, but it was right nonetheless. Also Guix is in one big guix.git repository so that we can make changes. Regards, Florian