From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTP id 1B7FC456B1 for ; Mon, 20 Mar 2023 22:26:24 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 793D468C586; Tue, 21 Mar 2023 00:26:22 +0200 (EET) Received: from mail-wr1-f41.google.com (mail-wr1-f41.google.com [209.85.221.41]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 9AD3468C2EF for ; Tue, 21 Mar 2023 00:26:15 +0200 (EET) Received: by mail-wr1-f41.google.com with SMTP id y14so11896775wrq.4 for ; Mon, 20 Mar 2023 15:26:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1679351174; h=user-agent:in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:to:from:date:from:to:cc:subject :date:message-id:reply-to; bh=jVvZ/hyYiF9XlN61mRueqt4rAFNEh/PR1jzHl842JHQ=; b=enODtjnNVsewgWs+DCPWe8j+P6M6IZCpRbGGpFm0wiphw3ajoThoonZn3mQPclzZ6U MxEXARVRdiRm5tpPdOpIu0Pn9j56t5UlrWu7ePIao8rqlEDr+XSnZzO1yP82eBAMFaD/ OROlbkmB41nArptuUAS0Krth5pMdcRg+cuu4m3rHjmo9S+yzwj773tRtDHMV8V24oCra vMo1e8iQkGB3wWV799dwGuPfhlK8Ebi1Kzx6nirSjxR+f/l9RFYrm8HxWqH1UcNg3MVr ggY82OCbwtVEtA9PxMdsBg04tZ0RNLl6ex/QHQFQkgcSFwEJWSlriX/kgUBzEqRB8MiN WkeA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1679351174; h=user-agent:in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:to:from:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=jVvZ/hyYiF9XlN61mRueqt4rAFNEh/PR1jzHl842JHQ=; b=zA2yL8957D6WDATnGEEku/ilTp1WDTMeKQX+3aXb0ICWRT8w4j/6ySCoOBWg4EWrgb pOa+9471O5U79GC539j/w3JeXhqgyWqizU1JtRbQG5OUf6MnhT1GnGQ7WBd5mhh+dLGb lG3x2q46rEjsT2xZt7T7lUDHZJx3bG3t4jV/iqjpQUKl37hTlOMzmevClF7c6LPUtaBr U6Wd1YuBJdyz4/f3Um3JTMDOavsOmHvViHJSKlljMEwqqxI//BRuSL8o1j9/yZK2byyQ zQJnt/VH5IhAWZbj6O5f+uk3ThWrG9jhv+y0vIfxwzwUutzjp/FDHjdd+8/AUyz0gRqo c/YQ== X-Gm-Message-State: AO0yUKWFAUQgGeUbfY0RqNYfjfusaWGeMRMyQfPEbDjwqlHUtoxMBwdf we/Umd+MckWVnxpiR0Dl6/dXiEDkSc57JA== X-Google-Smtp-Source: AK7set+KjH6/qCBXI5uiI9aH6LAj25YWgSf5NqxU6xz1gqpDWkYPXeOEJKEYU670WV4/Xx4faAJBeQ== X-Received: by 2002:a5d:68cc:0:b0:2d0:bba8:38f3 with SMTP id p12-20020a5d68cc000000b002d0bba838f3mr666282wrw.14.1679351174224; Mon, 20 Mar 2023 15:26:14 -0700 (PDT) Received: from mariano (dynamic-adsl-62-10-98-143.clienti.tiscali.it. [62.10.98.143]) by smtp.gmail.com with ESMTPSA id z6-20020a056000110600b002c557f82e27sm9797780wrw.99.2023.03.20.15.26.13 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 20 Mar 2023 15:26:13 -0700 (PDT) Received: by mariano (Postfix, from userid 1000) id EFE0FBFB73; Mon, 20 Mar 2023 23:26:11 +0100 (CET) Date: Mon, 20 Mar 2023 23:26:11 +0100 From: Stefano Sabatini To: FFmpeg development discussions and patches Message-ID: <20230320222611.GI48946@mariano> Mail-Followup-To: FFmpeg development discussions and patches References: <20230315140746.14692-1-anton@khirnov.net> <20230315140746.14692-3-anton@khirnov.net> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20230315140746.14692-3-anton@khirnov.net> User-Agent: Mutt/1.13.2 (2019-12-18) Subject: Re: [FFmpeg-devel] [PATCH 3/3] doc/developer.texi: add a section on API/ABI compatibility 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 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Archived-At: List-Archive: List-Post: On date Wednesday 2023-03-15 15:07:46 +0100, Anton Khirnov wrote: > Document established practices in it. > --- > doc/developer.texi | 162 ++++++++++++++++++++++++++++++++++++++++----- > 1 file changed, 146 insertions(+), 16 deletions(-) > > diff --git a/doc/developer.texi b/doc/developer.texi > index 5e283227be..c625a9feed 100644 > --- a/doc/developer.texi > +++ b/doc/developer.texi > @@ -217,6 +217,7 @@ int myfunc(int my_parameter) > ... > @end example > > +@anchor{Naming conventions} > @section Naming conventions [...] > + > +@anchor{Major version bumps} > +@subsection Major version bumps > +A major version bump signifies an API and/or ABI compatibility break. To reduce > +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. > + > +@item > +Performing ABI- but not API-breaking changes, like reordering struct contents. > +@end itemize > + This sounds a bit ambiguous. What qualifies "previously deprecated APIs"? It looks to me that the current practice is to drop deprecated symbols after 2 major bumps, so that users have the opportunity to adapt their code depending on the deprecations warnings before the deprecated symbols are finally removed at the next bump. If that's so, maybe this can be formalized here. [...] LGTM otherwise, thanks. _______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org https://ffmpeg.org/mailman/listinfo/ffmpeg-devel To unsubscribe, visit link above, or email ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".