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 89E854B389 for ; Tue, 4 Jun 2024 14:49:39 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 3155468D701; Tue, 4 Jun 2024 17:49:37 +0300 (EEST) Received: from alt2.a-painless.mh.aa.net.uk (alt2.a-painless.mh.aa.net.uk [81.187.30.51]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 28D8C68D6BA for ; Tue, 4 Jun 2024 17:49:31 +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-a.thn.aa.net.uk with esmtp (Exim 4.96) (envelope-from ) id 1sEVTe-007B97-18 for ffmpeg-devel@ffmpeg.org; Tue, 04 Jun 2024 15:49:30 +0100 From: Andrew Sayers To: ffmpeg-devel@ffmpeg.org Date: Tue, 4 Jun 2024 15:47:20 +0100 Message-ID: <20240604144919.213799-1-ffmpeg-devel@pileofstuff.org> X-Mailer: git-send-email 2.45.1 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 v6 0/4] doc: 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 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: I'm making a list of little documentation patches to submit as a set once this patchset is done. I've put Sw{r,s}Context on the list, and will think about their relationship to other opaque AVOptions-enabled structs as part of that. I don't see anything in that discussion that affects this patchset, so let's park that discussion for now. One thing we haven't talked about before, but is worth stating explicitly - smart people tend to conflate "I can't think of anything complex about X" with "there are no complex things about X", so this document needs to sell people on the complexity of each problem before laying out the solution. The AVOptions section is a particularly good example, tackling the implicit question "can't you just use `getopt`?" first then moving on to describe how it solves that problem. Some parts of the document function as responses to questions an FFmpeg developer would never think to ask, because why would you even think to compare AVOptions with getopt? This version emphasises how AVOptions should only be set during configuration. It avoids the words "reflection" and "introspection" altogether, because IMHO they imply an API that can be used in any stage of a struct's lifetime. Aside: this is the latest in a series of issues where it initially seemed like I was adding unnecessary terminology in places where it was confusing, but turned out to be a symptom of a fundamental misunderstanding on my part. If there's any such language remaining in this version, we should probably look for those misunderstandings first and worry about language second. _______________________________________________ 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".