From patchwork Sun Jan 28 12:28:36 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Khirnov X-Patchwork-Id: 45867 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a21:8786:b0:199:de12:6fa6 with SMTP id ph6csp994497pzb; Sun, 28 Jan 2024 04:30:02 -0800 (PST) X-Google-Smtp-Source: AGHT+IG9l5i9wp9V/48QYkmvvXSpjTtHgaXblgWGWSOXLPgNEe95/V2hg7l2m1acI3pwuFKyrnsI X-Received: by 2002:ac2:5fae:0:b0:511:e8f:45ca with SMTP id s14-20020ac25fae000000b005110e8f45camr470742lfe.31.1706445002613; Sun, 28 Jan 2024 04:30:02 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1706445002; cv=none; d=google.com; s=arc-20160816; b=qbnIQKmgRreV2Jnkkcr9D1Bp7YvR7qkCxRlQ/arHqBZQnzmQ8y1bC4hqmvhZlp96PX Up9rCaNLhf/q9TXSYM0pyutJNcgF7xsX9hF1vNvry8zrd5zazePG1KK55hD+uJMjjUCv tx3eVUuYmhMjFKT6O1o2tYBGQcDkyk6LrbqLKsIN9MnEVUN5feAdehSFHktkliqKd3J+ E+o+xDNNEW6I0Urk/J0fPo2i3l4+Rv4EqSgd9mMDGCsqXLTeTa5icQhF17uATAl9GS1X VbMnICj8qcO7DqIF8kNcmkq6fQwAajEPrNogK4ufv++ZgS4LE48q9+aZiJgk/hXgaiGC u1UA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:reply-to:list-subscribe :list-help:list-post:list-archive:list-unsubscribe:list-id :precedence:subject:mime-version:message-id:date:to:from :dkim-signature:delivered-to; bh=EE+JIiSf3cOqkxgVfyqUE+JubHMpUre8glEK1V22zTA=; fh=YOA8vD9MJZuwZ71F/05pj6KdCjf6jQRmzLS+CATXUQk=; b=D8sTWmYilz1PlYzCwKoRkBwUO2QpIuY7mizeX+2g/UUhFw0vfrIws9BZa0pAoTkSng CmEzq6hej1FKoPnQ04sOxLSHHWN/lp4Jam7efRFQ0YEcmUMKqVHT9aRh75gL9TK8ImBw didRaPI5NHmDT+BKvciE6LO4XcUB+fN7ED8iGt3IjEcFy0JogrM9Wi1Z4t7RG/Ik+vuH b0pp6PK7VxiVciIsphzZ+u8zzVOjlmq/E/t2ZceppEUuIJ16AYJHoMuXl7mZRzctHd8n ofiac3LWCueAQfKXcbs1yBJqW96qyVOd/wgViDH4XVAcL/IDZlwPAyfkAZE645nlw+Df ZD4w== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@khirnov.net header.s=mail header.b=dhftuO0T; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id s18-20020a170906355200b00a318fea1e02si2439372eja.145.2024.01.28.04.30.02; Sun, 28 Jan 2024 04:30:02 -0800 (PST) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@khirnov.net header.s=mail header.b=dhftuO0T; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 493EA68D17E; Sun, 28 Jan 2024 14:29:59 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail1.khirnov.net (quelana.khirnov.net [94.230.150.81]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 91B8D68CE0C for ; Sun, 28 Jan 2024 14:29:52 +0200 (EET) Authentication-Results: mail1.khirnov.net; dkim=pass (2048-bit key; unprotected) header.d=khirnov.net header.i=@khirnov.net header.a=rsa-sha256 header.s=mail header.b=dhftuO0T; dkim-atps=neutral Received: from localhost (mail1.khirnov.net [IPv6:::1]) by mail1.khirnov.net (Postfix) with ESMTP id C32F51A09 for ; Sun, 28 Jan 2024 13:29:51 +0100 (CET) Received: from mail1.khirnov.net ([IPv6:::1]) by localhost (mail1.khirnov.net [IPv6:::1]) (amavis, port 10024) with ESMTP id VVGPrldtEflK for ; Sun, 28 Jan 2024 13:29:50 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=khirnov.net; s=mail; t=1706444990; bh=C4PC2ad/LmnBOhIKD6hXQnQ3047UXT/5XGsGh7YO55Y=; h=From:To:Subject:Date:From; b=dhftuO0TbVgR3AokOJTn0ckAO+VQXOqLS2IMOyiWXzGt0zrEWTwXXXtC9OGYWeKK2 p6cummcZnSoLAU7Y3wMMqWke91/GNzg69yk6thGHor4S+8I51wPmuYi27clBp9Bc7V Uv5GEFILcecYbAf1Lj+e9i7N+nvRUZnwsq2vCnORiHH0ZG90NegfelWOXcLvo3zn+g cHlwMFarzqcZYLWFcVZ6QmvYPqbVUulv7Ll1MrnETU16ZS/Klh9Eby/G7WK+P6orBw V+XNcrU9nIDcPNSWQDSueaWtj/pG6aJvMxTUTZGP+gPm4B95J+xYlQ1YNT0r2ric3A oKtpoP1+ZWADQ== Received: from libav.khirnov.net (libav.khirnov.net [IPv6:2a00:c500:561:201::7]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "libav.khirnov.net", Issuer "smtp.khirnov.net SMTP CA" (verified OK)) by mail1.khirnov.net (Postfix) with ESMTPS id A807791F for ; Sun, 28 Jan 2024 13:29:50 +0100 (CET) Received: from libav.khirnov.net (libav.khirnov.net [IPv6:::1]) by libav.khirnov.net (Postfix) with ESMTP id 80BED3A0534 for ; Sun, 28 Jan 2024 13:29:50 +0100 (CET) From: Anton Khirnov To: ffmpeg-devel@ffmpeg.org Date: Sun, 28 Jan 2024 13:28:36 +0100 Message-ID: <20240128122944.10889-1-anton@khirnov.net> X-Mailer: git-send-email 2.42.0 MIME-Version: 1.0 Subject: [FFmpeg-devel] [RFC/PATCH] doc/developer: clarify the criterion for removing deprecated APIs X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: qUR1DYEH3Aoq Previously, the implicit standard was to wait 2 years before deprecation and removal, but it has been widely agreed at developer meetings that time-based measures do not make sense and we should switch to a release-based one instead. --- Feel welcome to argue for other numbers than 2, or suggest alternative criteria, but please try to limit bikeshedding. --- doc/developer.texi | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/developer.texi b/doc/developer.texi index dd96e3b36a..3f3218f66a 100644 --- a/doc/developer.texi +++ b/doc/developer.texi @@ -552,7 +552,8 @@ the negative effects on our callers, who are required to adapt their code, backward-incompatible changes during a major bump should be limited to: @itemize @bullet @item -Removing previously deprecated APIs. +Removing APIs that were marked as deprecated in at least two previous +major releases. @item Performing ABI- but not API-breaking changes, like reordering struct contents.