[FFmpeg-devel] [PATCH v4 2/3] lavu/opt: Mention AV_OPT_FLAG_POST_INIT_SETTABLE_PARAM in more places
Andrew Sayers
ffmpeg-devel at pileofstuff.org
Tue Jul 2 13:13:16 EEST 2024
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
More information about the ffmpeg-devel
mailing list