From patchwork Wed May 15 15:54:18 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Sayers X-Patchwork-Id: 35122 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a21:3a48:b0:1af:fc2d:ff5a with SMTP id zu8csp1689499pzb; Wed, 15 May 2024 08:55:09 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCXlje85Wja2haNP2tskTNYEk3U8Rf8CIazvn9M/k5LoRkFh0HqH4hX7mv4tqwIv6Kf+BvHy5pVxxms6Y+XYF/QCuxKn4hzZAdsjbw== X-Google-Smtp-Source: AGHT+IGdMXSgo2YvtWUPbJ9rITKF6p3RDTqGGf44+LjyIH39tdIGfsVaB6MIRT6/uWV0SLki1IbR X-Received: by 2002:a17:906:d054:b0:a59:b1dc:57a8 with SMTP id a640c23a62f3a-a5a2d5ee320mr1097931766b.33.1715788509428; Wed, 15 May 2024 08:55:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1715788509; cv=none; d=google.com; s=arc-20160816; b=qelcpldaWU/PheCWo/fX/wDyLNrl0G6FyVGDVLGcvBdTLjLIfGvUCjx+PVCABtT0+Y DIqv+by0JuyMQMA9pTSv1kh6U81gKYuuVjRBJnNVM9W6HX2whOlSM+6v9REwNnd+EWH2 8fakptG8VKp5qYY4ZN3b9hzoEfsfgYCLOrEAhPKSJl3IkfC0QuiPxdhzKq3wz5amfH+u dqYhUdrYVNrf5GaYIa5qPKaTH497u4FnMRgwYBxLRUmd9pc1nSrw0Bl+Qt0LFViR3h95 ObgCbc4CwLIblrNAaaD7NNTg4Gm8ECr0OzM1vGZhMmUeIz6uoW7niH7WB69bdzJXOpH9 y+1Q== 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:references:in-reply-to:message-id :date:to:from:delivered-to; bh=Uiq8zFrlqMAPyLg/chczwmoXPni+/n6saxiLI8A4aig=; fh=YOA8vD9MJZuwZ71F/05pj6KdCjf6jQRmzLS+CATXUQk=; b=Sv8mLaEURRGz9FuTbwqtnpfKg3OL9rgEwVSCk1wqJTe4zBo0RJ/uDwMEO01/8nNDzD vBt09agNVu2ej++fxYMbFiwqe2iFh+R6V6jr7K+/MHzSnzcazSARyAaA3eFlzsS0HuH5 2zbQs+WpHlZrRTOQ3myShiVLIKmFE3MlFDsVnZ2v1ueEjV7EoWVZ6sUnYKzC9yyWs9LH Bu4Un8yIB8emXYlVs54DPWK43YrwVn7U0wsxk6I+mw+aSqHMa3ynWQNBXnvAajZOX5Ad egqlIERkz97XJNZLbsDPPJRMduOHIfoE9x1Rpc+xwcoOzQSFSSW6EnA5z7JQk5E3tc86 tMLQ==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; 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 a640c23a62f3a-a5a17c2c899si836818466b.1033.2024.05.15.08.55.08; Wed, 15 May 2024 08:55:09 -0700 (PDT) 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; 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 0595B68C197; Wed, 15 May 2024 18:55:04 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from b-painless.mh.aa.net.uk (b-painless.mh.aa.net.uk [81.187.30.52]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 3623C68C15A for ; Wed, 15 May 2024 18:54:57 +0300 (EEST) Received: from 0.b.4.b.7.4.0.8.c.4.a.5.d.8.b.2.0.5.8.0.9.1.8.0.0.b.8.0.1.0.0.2.ip6.arpa ([2001:8b0:819:850:2b8d:5a4c:8047:b4b0] helo=andrews-2024-laptop.lan) by painless-b.tch.aa.net.uk with esmtp (Exim 4.96) (envelope-from ) id 1s7Gy0-00127b-1P for ffmpeg-devel@ffmpeg.org; Wed, 15 May 2024 16:54:56 +0100 From: Andrew Sayers To: ffmpeg-devel@ffmpeg.org Date: Wed, 15 May 2024 16:54:18 +0100 Message-ID: <20240515155446.3589239-1-ffmpeg-devel@pileofstuff.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240418150614.3952107-1-ffmpeg-devel@pileofstuff.org> References: <20240418150614.3952107-1-ffmpeg-devel@pileofstuff.org> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v4 0/4] Explain what "context" means 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: ZsTNlgxRTPgO This version strongly implies AVClass is only used alongside AVOption. I'm not sure when or if e.g. AVClass::category would be used by an external API developer, but happy to change the text if anyone has a use case. I accept the argument that the previous version was linked more widely than it was useful, but instead of reducing links I've tried to widen its usefulness. The new version discusses how e.g. FFmpeg contexts differ from curl, which could be useful to developers coming from other projects. And it goes into more detail about e.g. context lifetime, which could be useful for even an intermediate developer.