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-requ...@ffmpeg.org with subject "unsubscribe".