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 C5C454B979 for ; Tue, 2 Jul 2024 10:13:28 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id CD00068D87F; Tue, 2 Jul 2024 13:13:25 +0300 (EEST) 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 ED31168D683 for ; Tue, 2 Jul 2024 13:13:18 +0300 (EEST) Received: from a.0.4.0.3.4.0.7.b.f.1.8.d.d.c.c.0.5.8.0.9.1.8.0.0.b.8.0.1.0.0.2.ip6.arpa ([2001:8b0:819:850:ccdd:81fb:7043:40a] helo=andrews-2024-laptop.sayers) by painless-b.tch.aa.net.uk with smtp (Exim 4.96) (envelope-from ) id 1sOaVh-00DFHD-1R for ffmpeg-devel@ffmpeg.org; Tue, 02 Jul 2024 11:13:17 +0100 Date: Tue, 2 Jul 2024 11:13:16 +0100 From: Andrew Sayers To: FFmpeg development discussions and patches Message-ID: References: <20240702090917.319956-1-ffmpeg-devel@pileofstuff.org> <20240702090917.319956-3-ffmpeg-devel@pileofstuff.org> <171991394975.21847.16790103422177595236@lain.khirnov.net> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <171991394975.21847.16790103422177595236@lain.khirnov.net> 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: 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). [1] https://ffmpeg.org/pipermail/ffmpeg-devel/2024-July/330559.html _______________________________________________ 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".