[FFmpeg-devel] [PATCH v4 2/3] lavu/opt: Mention AV_OPT_FLAG_POST_INIT_SETTABLE_PARAM in more places

[Anton Khirnov]

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