[FFmpeg-devel] [PATCH] doc/ffmpeg - rewrite Stream Selection chapter

[Gyan Doshi]

On 25-05-2018 06:08 AM, Michael Niedermayer wrote:

> This is very detailed. I think this could byte us if we want to change some
> of the logic.

The current chapter already does. Many askers at SE sites and even on 
the User ML show confusion over command line operation, including stream 
selection. Many of these users don't read docs in the first place, but 
those who do, will have an accurate picture; and for those who don't, 
there will be a link to point to, without having to regurgitate the same 
quirks over and over again. Much of the current behavior is not 
documented anywhere and this is the best place for it.

The rewrite turned out longer that I anticipated as I checked the code 
for gotchas of which there are a few. The burden is on doc maintainers, 
like me, to track code changes and update. But that shouldn't be a 
reason to not document the behavior.

Regards,
Gyan