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 026B74B97B for ; Tue, 2 Jul 2024 10:16:37 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 1EC6168D8D4; Tue, 2 Jul 2024 13:16:35 +0300 (EEST) Received: from mail0.khirnov.net (red.khirnov.net [176.97.15.12]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id E949268D7B1 for ; Tue, 2 Jul 2024 13:16:27 +0300 (EEST) Authentication-Results: mail0.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=WPv1pjlq; dkim-atps=neutral Received: from localhost (localhost [IPv6:::1]) by mail0.khirnov.net (Postfix) with ESMTP id 45163240DAC for ; Tue, 2 Jul 2024 12:16:27 +0200 (CEST) Received: from mail0.khirnov.net ([IPv6:::1]) by localhost (mail0.khirnov.net [IPv6:::1]) (amavis, port 10024) with ESMTP id 5k_7KOHzfbs1 for ; Tue, 2 Jul 2024 12:16:24 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=khirnov.net; s=mail; t=1719915384; bh=k9PGI/GKfGI9W6bDkNl7FsEdvt9UAhD2qL9GcS2Mzqk=; h=Subject:From:To:In-Reply-To:References:Date:From; b=WPv1pjlqqg6ONJqfND44XUYfPzjrAYZbD+m7swAV6JIfRGQV8004aG8HcjX63QLsp Cm3B/SKQhzoHIiTIVd/d2+qZVWLdeh+12TcPY6YKfMiMg9DhmkqFf07YainGNwj0Y5 htPvzD6Wehrm8UUvFNQKQhghK5moIjqb509j3yWz0Ya1UXWfv/Fm76Txjcri0L8pMy kINhtWXsDVKYLIeC1Kl/BsxRTC79eS4HLcLO0rTDZym/3aep7fIceV45aja+9+N69v nskDEPOzZefcCN3MzyAFPpbDs3UQl+/KHqUCwFIhx4iIQrmRzOcb8ZC+yqGeDGRC36 l7kFB53ZCmCjw== Received: from lain.khirnov.net (lain.khirnov.net [IPv6:2001:67c:1138:4306::3]) (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 "lain.khirnov.net", Issuer "smtp.khirnov.net SMTP CA" (verified OK)) by mail0.khirnov.net (Postfix) with ESMTPS id C6DAB2404E5 for ; Tue, 2 Jul 2024 12:16:24 +0200 (CEST) Received: by lain.khirnov.net (Postfix, from userid 1000) id A23DB1601B9; Tue, 2 Jul 2024 12:16:24 +0200 (CEST) From: Anton Khirnov To: FFmpeg development discussions and patches In-Reply-To: References: <20240702090917.319956-1-ffmpeg-devel@pileofstuff.org> <20240702090917.319956-3-ffmpeg-devel@pileofstuff.org> <171991394975.21847.16790103422177595236@lain.khirnov.net> Mail-Followup-To: FFmpeg development discussions and patches Date: Tue, 02 Jul 2024 12:16:24 +0200 Message-ID: <171991538463.21847.8552188356995036725@lain.khirnov.net> User-Agent: alot/0.8.1 MIME-Version: 1.0 Subject: Re: [FFmpeg-devel] [PATCH v4 2/3] lavu/opt: Mention AV_OPT_FLAG_POST_INIT_SETTABLE_PARAM in more places 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: Quoting Andrew Sayers (2024-07-02 12:13:16) > On Tue, Jul 02, 2024 at 11:52:29AM +0200, Anton Khirnov wrote: > > Quoting Andrew Sayers (2024-07-02 11:08:39) > > > An inattentive user might not see the explanation at the top of this file. > > > Paste the explanation to all the places they might see it. > > > > Duplication is bad, and the premise doesn't work anyway. Inattentive > > users will happily ignore arbitrary amounts of text. In fact the more > > text there is, the more of it they will ignore. > > Meanwhile you make actual information harder to find for people who > > actually bother to read. > > That's a reasonable argument, but incompatible with your other one[1]. > If users are inattentive and will ignore arbitrary amounts of text, > the explanation needs to go in the one place they have to look (the > macro name). I don't understand your point. In my other email I'm objecting to breaking API for flimsy reasons, how is that related to documentation? -- Anton Khirnov _______________________________________________ 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".